# Il manuale di &kcron;

## Introduzione

&kcron; è un'applicazione che pianifica i programmi che devono essere lanciati in sottofondo (background). È un'interfaccia grafica per l'utente a `cron`, il sistema di pianificazione &UNIX;. (NdT: Le immagini della guida sono in lingua inglese, quindi si raccomanda di lanciare kcron per capire a cosa ci si riferisce).

## Usare &kcron;

Non si dimentichi di dire al sistema di lanciare per primo il demone cron `crond`, altrimenti &kcron; non vorrà funzionare

### L'avvio di &kcron;

Quando &kcron; parte si vedrà una vista sommaria delle operazioni pianificate esistenti e le relative variabili di ambiente. Se lo si è lanciato come utente root, si vedranno questi oggetti per tutti gli utenti del computer come i compiti pianificati del sistema. Ogni cartella può essere espansa o contratta.

&kcron; all'avvio. &kcron; all'avvio.

#### Operazioni pianificate

Le operazioni pianificate appaiono sotto la cartella Operazioni. Per ogni operazione pianificata, sono mostrati i seguenti:

Nome

- Nome per identificare un'operazione pianificata.

Valore

- Il file del programma e i parametri

Descrizione

- Descrizione a parole di un'operazione pianificata.

Se un'operazione è stata disabilitata, né il file del programma né i parametri appariranno, e la descrizione sarà disabilitata.

#### Variabili d'ambiente

Le variabili d'ambiente appaiono sotto Variabili. Per ogni variabile ambientale, sono mostrate le seguenti cose:

Nome

- Nome della variabile.

Valore

- Valore della variabile

Descrizione

- Descrizione a parole della variabile.

Le variabili d'ambiente che compaiono qui, si sovrapporranno ad ogni variabile d'ambiente esistente per tutte le operazioni pianificate. Se una variabile d'ambiente è stata disabilitata, nessun valore apparirà e la descrizione sarà disabilitata.

La finestra principale di &kcron; La finestra principale di &kcron;

### Aggiungere operazioni pianificate

Per creare una nuova operazione pianificata, prima si selezioni la cartella Operazioni. Quindi scegliere dal menu Modifica Nuovo... . Alternativamente si può usare il bottone destro del mouse sulla cartella e dal menu contestualescegliere Nuovo..., o semplicemente premere insieme i tasti Ctrl N.

#### La finestra di dialogo Modifica operazione

La finestra Modifica operazione. Finestra Modifica operazione

Commento

- Immettere una descrizione dell'operazione da pianificare.

Programma

- Immettere il nome del programma. Si può specificare sia il percorso relativo sia il percorso assoluto. Se si vuole cercare il programma, basta premere il bottone Sfoglia....

Abilitato

- Per abilitare o disabilitare l'operazione, selezionare o deselezionare Abilitato.

Muto

- Spegne il log (il registro) del comando e l'output dal comando.

Mesi

- Seleziona i mesi durante i quali l'operazione sarà pianificata.

Giorni del mese

- Seleziona i giorni del mese durante i quali l'operazione sarà pianificata.

Giorni della settimana

- Seleziona i giorni della settimana in cui l'operazione sarà pianificata.

Quotidiano

- Se si vuole pianificare di lanciare quotidianamente l'operazione, selezionare Esegui ogni giorno.

Ore

- Seleziona le ore in cui l'operazione sarà pianificata.

Minuti

- Selezionare il minuto in cui l'operazione deve essere eseguita. &kcron; non supporta la pianificazione di compiti ad intervalli più piccoli di cinque minuti.

OK

- Completa la creazione di questa operazione.

Annulla

- Annulla la creazione di questa operazione.

Se si selezionano sia i giorni del mese sia i giorni della settimana, l'operazione partirà quando almeno una condizione è soddisfatta. Per un'ipotetica istanza, se si selezionano il primo ed il 15esimo del mese, e si seleziona Domenica, il programma verrà eseguito ogni primo e quindicesimo giorno del mese, così come ogni domenica del mese selezionato (senza preoccuparsi del giorno del mese).

L'operazione pianificata non è impostata fino a quando `crontab` non viene salvato.

### Gestire le operazioni pianificate

Così con la creazione di nuove operazioni, i cambiamenti alle operazioni non vengono fatti fino a che non si salva il file `crontab`.

#### Tagliare operazioni pianificate

Per tagliare un'operazione pianificata, prima selezionare l'operazione da tagliare, quindi scegliere dal menu Modifica Taglia.

Alternativamente, si può usare il tasto destro del mouse e dal menu contestuale scegliere Taglia, o semplicemente premere la combinazione Ctrl X.

#### Copiare operazioni pianificate

Per copiare una operazione pianificata, prima selezionare l'operazione da copiare, quindi scegliere dal menu Modifica Copia.

Alternativamente, si può usare il tasto destro del mouse e dal menu contestuale scegliere Copia, o semplicemente premere la combinazione Ctrl C.

#### Incollare operazioni pianificate

Per incollare una operazione pianificata, prima un'operazione pianificata deve già essere stata tagliata o copiata negli appunti. Una volta che l'operazione pianificata è stata tagliata o copiata, la funzione incolla sarà abilitata. Quindi selezionare la cartella Operazioni, scegliere infine dal menu Modifica Incolla.

Alternativamente, si può usare il tasto destro del mouse e dal menu contestuale scegliere Incolla, o semplicemente premere la combinazione Ctrl V.

#### Modificare le operazioni pianificate

Per modificare un'operazione pianificata, prima selezionare l'operazione da modificare, quindi selezionare Modifica Modifica....

Alternativamente, si può usare il tasto destro del mouse e dal menu contestuale scegliere Modifica... , o semplicemente premere la combinazione Ctrl O. Si vedrà la finestra di dialogo Modifica operazione, che vorreste modificare come descritto sopra.

#### Cancellare operazioni pianificate

Per cancellare un'operazione pianificata, prima selezionare l'operazione da cancellare, poi selezionare dal menu Modifica Elimina .

In un altro modo, si può usare il tasto destro del mouse e dal menu contestuale scegliere Elimina.

#### Abilitare/disabilitare le operazioni pianificate

Per abilitare o disabilitare un'operazione pianificata, prima selezionare l'operazione disabilitata. Le operazioni disabilitate avranno Disabilitato nella loro descrizione. Quindi selezionare Modifica Abilitato .

In un altro modo, si può usare il tasto destro del mouse e dal menu contestuale scegliere Abilitato. Ci si accerti che il nome del programma, i parametri e la descrizione dell'operazione pianificata siano mostrati correttamente.

#### Lanciare le operazioni pianificate

Per lanciare immediatamente un'operazione pianificata, prima si selezioni l'operazione. Quindi scegliere Modifica Esegui ora .

In altro modo, si può usare il pulsante destro del mouse e dal menu contestuale scegliere Esegui ora.

### Aggiungere variabili ambientali

Per creare una nuova variabile ambientale, prima c'è da selezionare la cartella Variabili. Quindi scegliere Modifica Nuovo... .

In altro modo, si può usare il pulsante destro del mouse e dal menu contestuale scegliere Nuovo..., o più semplicemente basta premere i tastiCtrl N.

#### La finestra di dialogo Modifica variabile

Finestra di dialogo Modifica variabile Finestra di dialogo Modifica variabile

Variabile

- Immettere il nome della variabile d'ambiente. Si può usare il menu combo per selezionare una dalle più comuni delle variabili possibili usate dalle operazioni pianificate. Queste includono:

  HOME

- Da usare al posto della directory home predefinita dell'utente.

MAILTO

- Per mandare un'email come output ad un indirizzo che non sia quello predefinito dell'utente.

PATH

- Da usarsi per cercare directory contenenti file dei programmi.

SHELL

- Da usare al posto del valore predefinito dell'utente.

Valore

- Immettere il valore della variabile d'ambiente.

Commento

- Immettere una descrizione per la variabile d'ambiente, come il suo scopo, ad esempio.

Abilitato

- Per abilitare o disabilitare la variabile, selezionare o meno Abilitato.

OK

- Completa la messa a punto della variabile in questione.

Annulla

- Annulla la messa a punto della variabile in questione.

La variabile d'ambiente non è attiva fino a quando `crontab` non viene salvato.

### Amministrare variabili d'ambiente

Così come nel creare nuove variabili, i cambiamenti alle variabili non saranno eseguiti fino a che `crontab` non viene salvato.

#### Tagliare variabili d'ambiente

Per tagliare variabili d'ambiente, prima selezionare la variabile che si desidera tagliare, quindi scegliere Modifica Taglia .

Alternativamente, si può usare il tasto destro del mouse e dal menu contestuale scegliere Taglia, o semplicemente premere la combinazione Ctrl X.

#### Copiare variabili ambientali

Per copiare una variabile ambientale, prima selezionare la variabile da copiare. Quindi scegliere Modifica Copia .

In un altro modo, premere il tasto destro del mouse e dal menu contestuale scegliere Copia, o semplicemente premere Ctrl C.

#### Incollare variabili ambientali

Per incollare una variabile d'ambiente, prima una variabile deve già essere stata tagliata o copiata negli appunti. Una volta che la variabile è stata tagliata o copiata, la funzione incolla sarà abilitata. Quindi selezionare la cartella Variabili, scegliere infine dal menu Modifica Incolla.

Alternativamente, si può usare il tasto destro del mouse e dal menu contestuale scegliere Incolla, o semplicemente premere la combinazione Ctrl V.

#### Modificare variabili ambientali

Per modificare una variabile ambientale, prima selezionare la variabile da modificare. Quindi selezionare Modifica Modifica... . Oppure si può usare il tasto destro del mouse e dal menu contestuale scegliere Modifica..., ancora più semplicemente basta premere Ctrl O. Si vedrà la finestra di dialogo Modifica variabile, che si potrebbe modificare come descritto sopra.

#### Cancellare variabili ambientali

Per cancellare una variabile ambientale, prima selezionare la variabile, quindi al solito scegliere Modifica Elimina .

In un altro modo, si può usare il tasto destro del mouse e dal menu contestuale scegliere Elimina.

#### Abilitare/disabilitare variabili d'ambiente

Per abilitare o disabilitare variabili d'ambiente, prima selezionare la variabile disabilitata. Le variabili disabilitate avranno Disabilitato nella relativa descrizione. A questo punto selezionare Modifica Abilitato .

Come sempre, si può procedere con il tasto destro del mouse e dal menu contestuale scegliere Abilitato. Controllare la corretta visualizzazione dei vari parametri della variabile d'ambiente.

### Salvare il file `crontab`

Una volta che tutte le operazioni pianificate e le varibili ambientali sono state create e/o propriamente modificate, si salvi il file `crontab` selezionando File Salva .

Alternativamente, si può semplicemente premere contemporaneamente&Ctrl;S. Aggiunte o cambiamenti non saranno messi in atto fino a quando non si è fatto questo.

### Stampare il file `crontab`

Per stampare il file `crontab` così come è stato salvato, selezionare File Stampa.

Stampare il file `crontab`. Stampare il file `crontab`.

La finestra di dialogo standard per la stampante di &kde; apparirà sullo schermo. Se si sceglie Espandi si noterà che ci sono due opzioni in più, specifiche di &kcron;, nella finestra di dialogo della stampante.

Stampa la crontab

- Stampa la `crontab` per l'attuale utente.

Stampa tutti gli utenti

- Stampa il file `crontab` per tutti gli utenti. Questa opzione è abilitata solo per gli utenti con privilegi di super-user.

## Rassegna dei comandi

### La finestra principale di &kcron;

#### Il menu File

&Ctrl;S File Salva

- Salva i cambiamenti sulla`crontab`.

File Stampa...

- Stampala`crontab`.

&Ctrl;Q Esci

- Si esce da &kcron;.

#### Il menu Modifica

&Ctrl;X Modifica Taglia

- Taglia l'operazione o la variabile selezionata.

&Ctrl;C Modifica Copia

- Copia l'operazione o la variabile selezionata.

&Ctrl;V Modifica Incolla

- Incolla l'operazione o la variabile che è stata tagliata o copiata.

&Ctrl;N Modifica Nuovo...

- Crea un'operazione o una variabile nuova.

&Ctrl;O Modifica Modifica...

- Modifica l'operazione o la variabile selezionata.

Modifica Elimina

- Cancella l'operazione o la variabile selezionata.

Modifica Abilitato

- Abilita/disabilita l'operazione o la variabile selezionata.

Modifica Esegui ora

- Esegue subito l'operazione selezionata.

#### Il menu Impostazioni

Impostazioni Barra degli strumenti

- Mostra la barra degli strumenti.

Impostazioni Mostra la barra di stato

- Mostra la barra di stato.

#### Il menu Aiuto

&help.menu.documentation;

## Domande e risposte

Perché i cambiamenti che sto facendo alle operazioni pianificate e/o alle variabili ambientali non stanno avendo effetto?

Le aggiunte o i cambiamenti alle operazioni pianificate non avvengono fino a che `crontab`non viene salvato.

## Riconoscimenti e licenze

&kcron;

Copyright del programma 2000 di Gary Meyergary@meyer.net

Copyright della documentazione 2000 Morgan N. Sandquist morgan@pipeline.com

Valerio Passinivalerio.p@libero.it

&underFDL; &underGPL;

## Installazione

### Come ottenere &kcron;

&install.intro.documentation;

### Requisiti

Per compilare con successo &kcron;, si necessitano delle seguenti librerie:

- `cron`, così come `vixie-cron`. &kcron; usa il comando `crontab` per modificare le operazioni pianificate dell'utente.

- POSIX-compliant &UNIX; (aderente alle specifiche POSIX), così come provveduto da glibc. &kcron; usa alcune chiamate di sistema di tipo &UNIX; standard per la localizzazione delle date e dei tempi.

### Compilazione ed installazione

&install.compile.documentation;
&documentation.index;