# O Manual do &kcron;

## Introdução

O &kcron; é uma aplicação para escalonar os programas para serem executados em segundo plano. É uma interface gráfica de utilizador para o cron, o escalonador do sistema &UNIX;.

## Usar o &kcron;

Não te esqueças de indicar ao sistema para iniciar antecipadamente o servidor `crond`, senão o &kcron; não irá funcionar.

### Arranque do &kcron;

Quando o &kcron; arranca irás ter uma vista geral sobre as tarefas já existentes em escalonamento e as variáveis de ambiente. Se estiveres a correr como administrador, irás ver esses itens para todos os utilizadores no computador, assim como as tarefas de sistema escalonadas. Cada uma das pastas pode ser expandida ou fechada.

O &kcron; no arranque O &kcron; no arranque

#### Tarefas Escalonadas

As tarefas escalonadas aparecem dentro duma pasta Tarefas. Para cada tarefa escalonada é apresentado o seguinte:

Nome

- Nome para identificar a tarefa escalonada.

Valor

- Ficheiro do programa e os parâmetros.

Descrição

- Descrição em língua natural da tarefa escalonada.

Se uma tarefa foi desactivada, nenhum programa nem nenhuns parâmetros irão aparecer, e a descrição está desactivada.

#### Variáveis de Ambiente

As variáveis de ambiente aparecem dentro duma pasta Variáveis. Para cada variável de ambiente, é mostrado o seguinte:

Nome

- Nome da variável.

Valor

- Valor da variável.

Descrição

- Descrição em língua natural da variável.

As variáveis de ambiente que aqui aparecem irão sobrepor qualquer variável de ambiente existente para todas as tarefas escalonadas. Se uma variável de ambiente foi desactivada, o seu valor não aparecerá e a descrição estará desactivada.

A janela principal do &kcron; A janela principal do &kcron;

### Adicionar Tarefas Escalonadas

Para criar uma nova tarefa escalonável, primeiro selecciona a pasta Tarefas. Depois selecciona Editar Novo... . Alternativamente, podes usar o menu do botão direito e escolher Novo..., ou simplesmente carregar em Ctrl n.

#### A Janela Editar Tarefa

a janela Editar Tarefa. a janela Editar Tarefa

Comentário

- Indica uma descrição da tarefa a escalonar.

Programa

- Indica o nome do programa. Podes especificar um caminho ou directoria relativo ou absoluto. Se quiseres procurar pelo programa, carrega em Procurar....

Activa

- Para activar ou desactivar a tarefa, selecciona ou deselecciona a opção Activa.

Silencioso

- Desliga o registo do comando e do seu resultado.

Meses

- Selecciona os meses durante os quais a tarefa deve ser executada.

Dias do Mês

- Selecciona os meses durante os quais a tarefa deve ser executada.

Dias da Semana

- Selecciona os dias da semana nos quais a tarefa deve ser executada.

Diariamente

- Se queres que a tarefa se execute diariamente, selecciona Correr todos os dias.

Horas

- Selecciona as horas nas quais a tarefa deve ser executada.

Minutos

- Selecciona os minutos nos quais a tarefa deve ser executada. O &kcron; não suporta escalonar tarefas em intervalos menores do que cinco minutos.

OK

- Completa a criação desta tarefa.

Cancelar

- Cancela a criação desta tarefa.

Se seleccionares tanto os dias do mês como os da semana, a tarefa será executada em qualquer uma das condições. Por exemplo, se seleccionares o dia 1 e o dia 15 e seleccionares o Domingo, o programa será executado em todos os dias 1 e 15 dos meses seleccionados (independentemente do dia da semana) assim como em todos os Domingos dos meses seleccionados (independentemente do dia do mês).

A tarefa escalonada não está completamente configurada até o `crontab` ser gravado.

### Gerir as Tarefas Escalonadas

Assim como ao criar tarefas novas, as alterações não terão efeito até o ficheiro `crontab` ser gravado.

#### Cortar Tarefas Escalonadas

Para cortares uma tarefa escalonada, primeiro selecciona a tarefa a ser cortada. Depois selecciona Editar Cortar.

Alternativamente podes usar o menu do botão direito do rato e escolher Cortar, ou simplesmente carregar em Ctrl X.

#### Copiar Tarefas Escalonadas

Para copiares uma tarefa escalonada, primeiro selecciona a tarefa a ser copiada. Depois selecciona Editar Copiar.

Alternativamente, podes usar o menu do botão direito do rato e escolher Copiar, ou simplesmente carregar em Ctrl c.

#### Colar Tarefas Escalonadas

Para colares uma tarefa escalonada, é preciso ter cortado ou copiado uma tarefa escalonada para a Área de Transferência em primeiro lugar. Logo que uma tarefa tenha sido cortada ou copiada, a colagem estará activa. Então aí selecciona a pasta Tarefas. Finalmente selecciona Editar Colar .

Alternativamente, podes usar o menu do botão direito do rato e escolher Colar, ou simplesmente carrega em Ctrl V.

#### Modificar Tarefas Escalonadas

Para modificares uma tarefa escalonada, primeiro selecciona a tarefa a ser modificada. Então selecciona Editar Modificar... .

Alternativamente, podes usar o menu do botão direito do rato e escolher Modificar..., ou carregar simplesmente em Ctrl o. Irás ver a janela de Editar Tarefa, com a qual irás modificar como descrito acima.

#### Apagar Tarefas Escalonadas

Para apagares uma tarefa escalonada, primeiro selecciona a tarefa a ser removida. Então selecciona Editar Apagar .

Alternativamente, podes usar o menu do botão direito do rato e escolher Apagar.

#### Activar/Desactivar Tarefas Escalonadas

Para activares ou desactivares uma tarefa escalonada, primeiro selecciona a tarefa desactivada. As tarefas desactivadas terão Desactivado nas suas descrições. Então selecciona Editar Activo .

Alternativamente, podes usar o menu do botão direito do rato e escolher Activo. Deves confirmar se o nome do programa, os seus parâmetros e a descrição estão correctamente apresentados.

#### Correr Tarefas Escalonadas

Para correres uma tarefa escolanada imediatamente, primeiro selecciona a tarefa. Depois selecciona Editar Executar .

Alternativamente, podes usar o menu do botão direito do rato e escolher Executar.

### Adicionar Variáveis de Ambiente

Para criares uma nova variável de ambiente, primeiro selecciona a pasta Variáveis. Depois selecciona Editar Novo... .

Alternativamente, podes usar o menu do botão direito e escolher Novo..., ou simplesmente carregar em Ctrl N

#### A janela de Editar Variável

A janela de Editar Variável. A janela de Editar Variável.

Variável

- Indica o nome da variável de ambiente. Podes usar a lista correspondente para seleccionares o nome das variáveis de ambiente mais comuns que são usadas pelas tarefas escalonadas. Estas incluem:

  HOME

- A ser usada em vez da directoria pessoal do utilizador por omissão.

MAILTO

- Para enviar o resultado por 'email' para um endereço diferente do endereço de 'email' do utilizador por omissão.

PATH

- A ser usada para procurar pelos programas nas directorias indicadas.

SHELL

- A ser usada em vez da linha de comandos por omissão do utilizador.

Valor

- Indica o nome da variável de ambiente.

Comentário

- Indica uma descrição da variável de ambiente, por exemplo para que serve.

Activa

- Para activar ou desactivar a variável, activa ou desactiva a opção Activo.

OK

- Completa a alteração desta variável.

Cancelar

- Cancela a alteração desta variável.

De facto, a variável de ambiente não é definida até o ficheiro `crontab` ser gravado.

### Gerir as Variáveis de Ambiente

Assim como na criação de novas variáveis, as alterações às mesmas não terão efeito até o ficheiro `crontab` ser gravado.

#### Cortar as Variáveis de Ambiente

Para cortares uma variável de ambiente, primeiro selecciona a variável a ser cortada. Depois selecciona Editar Cortar .

Alternativamente podes usar o menu do botão direito do rato e escolher Cortar, ou simplesmente carregar em Ctrl X.

#### Copiar Variáveis de Ambiente

Para copiares uma variável de ambiente, primeiro selecciona a variável a ser copiada. Depois selecciona Editar Copiar .

Alternativamente, podes usar o menu do botão direito do rato e escolher Copiar, ou simplesmente carregar em Ctrl C.

#### Colar Variáveis de Ambiente

>Para colares uma variável de ambiente, primeiro é necessário ter sido copiada ou colada uma variável de ambiente para a Área de Transferência. Logo que uma variável de ambiente tenha sido cortada ou copiada, a colagem estará activada. Então deves seleccionar a pasta Variáveis. Finalmente selecciona Editar Colar .

Alternativamente, podes usar o menu do botão direito do rato e escolher Colar, ou simplesmente carrega em Ctrl V.

#### Modificar Variáveis de Ambiente

Para modificares uma variável de ambiente, primeiro selecciona a variável a ser modificada. Depois selecciona Editar Modificar... . Alternativamente, podes usar o menu do botão direito do rato e escolher Modificar..., ou simplesmente carregar em Ctrl O. Irás ver a janela de Editar Variável, com a qual irás modificar tal como foi descrito acima.

#### Apagar Variáveis de Ambiente

Para apagares uma variável de ambiente, primeiro selecciona a variável a ser apagada. Depois selecciona Editar Apagar

Alternativamente, podes usar o menu do botão direito do rato e escolher Apagar.

#### Activar/Desactivar Variáveis de Ambiente

Para activares ou desactivares, selecciona em primeiro lugar a variável desactivada. As variáveis desactivadas terão como descrição Desactivada. Então selecciona Editar Activo .

Alternativamente, podes usar o menu do botão direito do rato e escolher Activo.Deves confirmar se o nome e o valor da variável de ambiente estão apresentados correctamente.

### Gravar o ficheiro `crontab`

Logo que todas as tarefas escalonadas e variáveis de ambiente tenham sido criadas e/ou modificadas convenientemente, deves gravar o ficheiro `crontab`, seleccionando para isso Ficheiro Gravar .

Alternativamente, pode simplesmente carregar em &Ctrl;s. As adições ou alterações não serão realizadas até isto ser feito.

### Imprimir o ficheiro `crontab`

Para imprimires o ficheiro `crontab` tal como foi gravado, selecciona Ficheiro Imprimir.

Imprimir o ficheiro `crontab`. Imprimir o ficheiro `crontab`.

A janela de impressão normal do &kde; irá aparecer. Se seleccionares Expandir irás ver duas opções adicionais do &kcron; nesta janela.

Imprimir o Crontab

- Imprime o ficheiro `crontab` para o utilizador actual.

Imprimir Todos os Utilizadores

- Imprime os ficheiros `crontab` para todos os utilizadores. Esta opção só está activada para os utilizadores que tenham privilégios de super-utilizador.

## Referência de Comandos

### A janela principal do &kcron;

#### O Menu Ficheiro

&Ctrl;S Ficheiro Gravar

- Grava as alterações no ficheiro crontab.

Ficheiro Imprimir...

- Imprime o ficheiro `crontab`.

&Ctrl;Q Ficheiro Sair

- Sai do &kcron;.

#### O Menu Editar

&Ctrl;X Editar Cortar

- Corta a tarefa ou variável seleccionada.

&Ctrl;C Editar Copiar

- Copia a tarefa ou variável seleccionada.

&Ctrl;V Editar Colar

- Cola uma tarefa ou variável que tenha sido cortada ou copiada.

&Ctrl;N Editar Nova...

- Cria uma nova tarefa ou variável.

&Ctrl;O Editar Modificar...

- Modifica a tarefa ou variável seleccionada.

Editar Apagar

- Apaga a tarefa ou variável seleccionada.

Editar Activo

- Activa/desactiva a tarefa ou variável seleccionadas.

Editar Executar Agora

- Corre a tarefa seleccionada agora.

#### O Menu Opções

Opções Mostrar a Barra de Ferramentas

- Mostra a barra de ferramentas.

Opções Mostrar a Barra de Estado

- Mostra a barra de estado onde aparecem as informações.

#### O Menu Ajuda

&help.menu.documentation;

## Perguntas e Respostas

Porque é que as alterações que estou a fazer às tarefas escalonadas e variáveis de ambiente não estão a fazer efeito?

As adições ou alterações às tarefas escalonadas não ocorrem de facto até o ficheiro `crontab` ter sido gravado.

## Créditos e Licença

&kcron;

Programa copyright 2000 Gary Meyer gary@meyer.net

Documentação copyright 2000 Morgan N. Sandquist morgan@pipeline.com

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL; &underGPL;

## Instalação

### Como obter o &kcron;

&install.intro.documentation;

### Requisitos

Para compilar com sucesso o &kcron;, precisas das seguintes bibliotecas:

- Um `cron`, como por exemplo o `vixie-cron`. O &kcron; usa o comando `crontab` para modificar as tarefas escalonadas do utilizador.

- Um &UNIX; compatível com o POSIX, tal como o oferecido pela glibc. O &kcron; usa algumas chamadas de sistema 'standard' do &UNIX; para a localização de datas e horas.

### Compilação e Instalação

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