# O Manual do &kcron;

Morgan
N.
Sandquist

    morgan@pipeline.com

Gary
Meyer

    gary@meyer.net

Programador
Lauri
Watts

    lauri@kde.org

Revisor
José
Pires

    jncp@netcabo.pt

Tradução
2000
Morgan N. Sandquist
&FDLNotice;
2002-10-03
3.0.8
KDE
kdeadmin
KCron
cron
crontab
escalonador

O &kcron; é uma aplicação que faz o escalonamento das aplicações a serem executadas.

## 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 Ctrln.

#### 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 CtrlX.

#### 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 Ctrlc.

#### 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 CtrlV.

#### 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 Ctrlo. 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 CtrlN

#### 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 CtrlX.

#### 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 CtrlC.

#### 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 CtrlV.

#### 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 CtrlO. 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;