# 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 se esqueça de indicar ao sistema para iniciar antecipadamente o servidor `crond`, senão o &kcron; não irá funcionar.

### Arranque do &kcron;

O &kcron; inicia-se com vista sumária sobre as tarefas já existentes em escalonamento e as variáveis de ambiente. Se estiver a correr como administrador, irá 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 seleccione a pasta Tarefas. Depois seleccione Editar Novo... . Alternativamente, pode 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

- Indique uma descrição para a tarefa a escalonar.

Programa

- Indique o nome do programa. Podes indicar uma localização relativa ou absoluta. Se quiser procurar pelo programa, carregue em Procurar....

Activa

- Para activar ou desactivar a tarefa, seleccione ou deseleccione a opção Activa.

Silencioso

- Desliga o registo do comando e do seu resultado.

Meses

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

Dias do Mês

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

Dias da Semana

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

Diário

- Se quer que a tarefa se execute diariamente, seleccione Executar todos os dias.

Horas

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

Minutos

- Seleccione 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 seleccionar tanto os dias do mês como os da semana, a tarefa será executada em qualquer uma das condições. Por exemplo, se seleccionar o dia 1 e o dia 15 e seleccionar 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 cortar uma tarefa escalonada, primeiro seleccione a tarefa a ser cortada. Depois seleccione Editar Cortar.

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

#### Copiar Tarefas Escalonadas

Para copiar uma tarefa escalonada, primeiro seleccione a tarefa a ser copiada. Depois seleccione Editar Copiar.

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

#### Colar Tarefas Escalonadas

Para colar 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í seleccione a pasta Tarefas. Finalmente seleccione Editar Colar .

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

#### Modificar Tarefas Escalonadas

Para modificar uma tarefa escalonada, primeiro seleccione a tarefa a ser modificada. Então seleccione Editar Modificar... .

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

#### Apagar Tarefas Escalonadas

Para apagar uma tarefa escalonada, primeiro seleccione a tarefa a ser removida. Então seleccione Editar Apagar .

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

#### Activar/Desactivar Tarefas Escalonadas

Para activar ou desactivar uma tarefa escalonada, primeiro seleccione a tarefa desactivada. As tarefas desactivadas terão Desactivada nas suas descrições. Então seleccione Editar Activa .

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

#### Correr Tarefas Escalonadas

Para correr uma tarefa escalonada imediatamente, primeiro seleccione a tarefa. Depois seleccione Editar Executar .

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

### Adicionar Variáveis de Ambiente

Para criar uma nova variável de ambiente, primeiro seleccione a pasta Variáveis. Depois seleccione Editar Nova... .

Alternativamente, pode 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

- Indique o nome da variável de ambiente. Pode usar a lista correspondente para seleccionar 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 pasta pessoal do utilizador por omissão.

MAILTO

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

PATH

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

SHELL

- A ser usada em vez do valor por omissão do utilizador.

Valor

- Indique o nome da variável de ambiente.

Comentário

- Indique uma descrição da variável de ambiente, por exemplo a sua finalidade.

Activa

- Para activar ou desactivar a variável, active ou desactive a opção Activa.

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 cortar uma variável de ambiente, primeiro seleccione a variável a ser cortada. Depois seleccione Editar Cortar .

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

#### Copiar Variáveis de Ambiente

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

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

#### Colar Variáveis de Ambiente

Para colar uma variável de ambiente, primeiro é necessário ter sido copiada ou cortada 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 deve seleccionar a pasta Variáveis. Finalmente seleccione Editar Colar .

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

#### Modificar Variáveis de Ambiente

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

#### Apagar Variáveis de Ambiente

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

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

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

Para activar ou desactivar uma variável de ambiente, seleccione em primeiro lugar a variável desactivada. As variáveis desactivadas terão como descrição Desactivada. Então seleccione Editar Activa .

Alternativamente, pode usar o menu do botão direito do rato e escolher Activo.Deve 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, deve 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 imprimir o ficheiro `crontab` tal como foi gravado, seleccione Ficheiro Imprimir.

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

A janela de impressão normal do &kde; irá aparecer. Se seleccionar Expandir irá 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.

&Ctrl;P 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 seleccionada.

Editar Executar Agora

- Corre a tarefa seleccionada agora.

#### O Menu Configuração

Configuração Mostrar a Barra de Ferramentas

- Mostra a barra de ferramentas.

Configuração Mostrar a Barra de Estado

- Mostra a barra de estado.

#### 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 normais do &UNIX; para a localização de datas e horas.

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

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