# Livro de Bolso do &kcron;.

Morgan
N.
Sandquist

    morgan@pipeline.com

Gary
Meyer

    gary@meyer.net

Desenvolvedor
Lauri
Watts

    lauri@kde.org

Revisor
Henrique
Marks

    henrique@if.ufrgs.br

Tradução
2000
Morgan N. Sandquist
&FDLNotice;
2003-09-16
3.1.91

O &kcron; é um aplicativo que agenda programas para serem executados.

KDE
kdeadmin
KCron
cron
crontab
agendador

## Introdução

O &kcron; é um aplicativo feito para agendar programas que rodam em segundo plano. Ele é uma interface gráfica para o `cron`, o agendador de sistema do &UNIX;.

## Usando o &kcron;

Não esqueça de informar ao seu sistema para iniciar o daemon do cron (`crond` anteriormente, pois de outro modo o &kcron; não vai funcionar.

### inicialização do &kcron;

Quando o &kcron; inicia você vê um resumo das tarefas agendadas existentes e das variáveis de ambiente associadas. Se você está rodando como superusuário, você verá os itens de todos os usuários além dos itens de sistema agendados. Cada uma das pastas pode ser expandida ou contraída.

&kcron; na inicializaçõa.
&kcron; na inicialização.

#### Tarefas Agendadas

As tarefas agendadas aparecem sob uma pasta chamadaTarefas. Para cada tarefa agendada, o seguinte será mostrado:

Nome

  Nome que i8dentifica a tarefa agendada.

Valor

  Arquivo do programa e parãmetros.

Descrição

  Descrição em linguagem cotidiana da tarefa agendada.

Se uma tarefa foi desabilitada, nenhum arquivo do programa ou parãmetros irá aparecer, e a descrição estará desabilitada.

#### Variáveis de Ambiente

Variáveis de ambiente aparecem sob uma pasta Variáveis. Para cada variável de ambiente, o seguinte será mostrado:

Nome

  Nome da Variável

Valor

  Valor da Variável.

Descrição

  Descrição em linguagem cotidiana da variável.

Variáveis de ambientes que aparecerem aqui irão sobrescrever qualquer variável de ambiente previamente existente para todas as tarefas agendadas. Se uma variável de ambiente for desabilitada, nenhum valor irá aparecer e a descrição estará desabilitada.

Janela principal do &kcron;
Janela principal do &kcron;

### Agendando novas tarefas.

Para agendar uma nova tarefa, selecione inicialmente a pastas Tarefas. Entao selecione Editar Novo.... Alternativamente, você pode usar o botãodireito do mouse e escolher Novo..., ou simplesmente pressionar Ctrl N.

#### O Diálogo Editar Tarefa.

Diálogo Editar Tarefa.
Diálogo Editar Tarefa

Comentário

  Entre uma descrição da tarefa a ser agendada.

Programa

  Entre o nome do programa. Você pode especificar tanto um caminho relativo quanto absoluto. Se você quiser procurar pelo programa, pressione Procurar....

Habilitado

  Para habilitar ou desabilitar a tarefa, selecione ou desmarque Habilitado.

Silencioso

  Desliga os registros do comando e sua informações de saída.

Meses

  Selecione os meses durante os quais a tarefa deve ser realizada.

Dias do Mês

  Selecione os dias do mês nos quais a tarefa será realizada.

Dias da Semana

  Selecione os dias da semana nos quais a tarefa será realizada.

Diariamente

  Se você quer agendar a tarefa para ser executada diariamente, selecione Rodar todos os dias.

Horas

  Selecione aa horas nas quais a tarefa será realizada.

Minutos

  Selecione o minuto de agendamento da tarefa. O &kcron; não suporta agendamento de tarefas em intervalos menores do que cinco minutos.

OK

  Completa a criação desta tarefa.

Cancelar

  Cancela a criação desta tarefa.

Se você selecionou tanto dias do mês, quanto dias da semana, a tarefa será executada quando quaisquer das condições for satisfeita. Por exemplo, se você selecionou o 1° e 15° dias do mês, e selecionou Domingo, o programa será executado todos os dias primeiro e quinze (independente do dia da semana) e também todos os domingos do mês (independente do dia do mês).

A tarefa não será agendada até que o `crontab` tenha sido salvo.

### Gerenciando Tarefas Agendadas

Assim como ao criar novas tarefas, as mudanças a estas só serão feitas após o `crontab` ter sido salvo.

#### Cortando Tarefas Agendadas

Para cortar uma tarefa agendada, primeiramente selecione a tarefa a ser cortada. Então selecione Editar Cortar.

Alternativamente, você pode usar o botão direito do mouse e escolher Cortar, ou simplesmente pressionar Ctrl X.

#### Copiando Tarefas Agendadas

Para copiar uma tarefa agendada, primeiramente selecione a tarefa a ser copiada. Então selecione Editar Copiar.

Alternativamente, você pode usar o botão direito do mouse e escolher Copiar, ou simplesmente pressionar Ctrl C.

#### Colando Tarefas Agendadas

Para colar uma tarefa agendada, primeiramente deve-se copiar ou cortar uma tarefa para a área de transferência. Uma vez que esta ação tenha sido realizada, pode-se colar a tarefa. Selecione então a pasta Tarefas. Finalmente, selecione Editar Colar.

Alternativamente, você pode usar o botão direito do mouse e escolher Colar, ou simplesmente pressionar Ctrl V.

#### Modificando Tarefas Agendadas

Para modificar uma tarefa agendada, primeiramente selecione a tarefa a ser modificada. Então selecione Editar Modificar....

Alternativamente, você pode usar o botão direito do mouse e escolher Modificar..., ou simplesmente pressionar Ctrl O. Você verá o diálogo Editar Tarefa, que você pode modificar como descrito anteriormente.

#### Apagando Tarefas Agendadas

Para apagar uma tarefa agendada, primeiramente selecione a tarefa a ser excluida. Então selecione Editar Apagar

Alternativamente, você pode usar o botão direito do mouse e escolher Apagar.

#### Habilitando/Desabilitando Tarefas Agendadas

Para habilitar ou desabilitar uma tarefa agendada, primeiramente selecione a tarefa desabilitada. Tarefas desabilitadas mostrarão Desabilitado em sua descrição. Então selecione Editar Habilitado

Alternativamente, você pode usar o botão direito do mouse e escolher Habilitado. Confirme que o nome do programa, os parâmetros e a descrição da tarefa agendada são mostrados corretamente.

#### Executando Tarefas Agendadas

Para executar uma tarefa agendada imediatamente, primeiramente selecione-a. Então escolha Editar Executar Agora.

Alternativamente, você pode usar o botão direito do mouse e escolher Executar agora.

### Adicionando Variáveis de Ambiente

Para criar uma nova variável de ambiente, selecione a pasta Variáveis. Após, selecione Editar Novo....

Alternativamente, você pode usar o botão direito do mouse e escolher Novo..., ou simplesmente pressionar Ctrl N.

#### O Diálogo Editar Variável.

diálogoEditar Variável
diálogoEditar Variável

Variável

  Entre o nome da variável de ambiente. Você pode usar a caixa da lista suspensa para selecionar dentre as variáveis de ambiente mais comuns utilizadas em tarefas agendadas. Estas incluem:

  HOME

    Para ser utilizada ao invés da pasta padrão do usuário

  MAILTO

    Para enviar um correio eletrônico para um endereço que não seja o padrão do usuário.

  PATH

    Será usada para procurar pastas que contenham arquivos executáveis.

  SHELL

    Será usada ao invés do shell padrão do usuário

Valor

  Digite o valor da variável de ambiente.

Comentário

  Digite uma descrição da a variável de ambiente, como o seu propósito.

Habilitado

  Para habilitar ou desabilitar uma variável, selecione ou desmarque o botão Habilitado.

OK

  Completa a configuração desta variável.

Cancelar

  Cancela a configuração desta variável.

A variável de ambiente não é realmente configurada até que o `crontab` tenha sido salvo.

### Gerenciando Variáveis de Ambiente

Assim como na criação de novas variáveis, as mudanças às variáveis não serão realmente realizadas até que o `crontab` tenha sido salvo.

#### Recortando Variáveis de Ambiente

Para recortar uma variável de ambiente, primeiro selecione-a. Após, clique em Editar Remover.

Alternativamente, você pode usar o botão direito do mouse e escolher Cortar, ou simplesmente pressionar Ctrl X.

#### Copiando Variáveis de Ambiente

Para copiar uma variável de ambiente, primeiro selecione-a. Após, clique em Editar Copiar.

Alternativamente, você pode usar o botão direito do mouse e escolher Copiar, ou simplesmente pressionar Ctrl C.

#### Colando Variáveis de Ambiente

Para colar uma variável de ambiente, primeiramente uma variável deve ter sido recortada ou copiada para a área de transferência. Uma vez que isto tenha ocorrido, a opção de colar será habilitada. Então selecione a pasta Variáveis. Finalmente, selecione Editar Colar.

Alternativamente, você pode usar o botão direito do mouse e escolher Colar, ou simplesmente pressionar Ctrl V.

#### Modificando Váriaveis de Ambiente

Para modificar uma variável de ambiente, primeiro selecione-a. Entaõ clique em Editar Modificar.... Alternativamente, você pode usar o botão direito do mouse e escolher Modificar..., ou simplesmente pressionar Ctrl O. Você verá o diálogo Editar Variável, que você pode modificar conforme descrito anteriormente.

#### Removendo Variáveis de Ambiente

Para remover uma variável de ambiente, primeiro selecione-a. Após clique em Editar Remover.

Alternativamente, você pode usar o botão direito do mouse e escolher Apagar.

#### Habilitando/Desabilitando Variáveis de Ambiente

Para habilitar ou desabilitar uma variável de ambiente, primeiro selecione a variável desabilitada. Variáveis neste estado mostrarão a palavra Desabilitada em sua descrição. Então clique em Editar Habilitar.

Alternativamente, você pode usar o botão direito do mouse e escolherHabilitado. Confirme que o nome e o velor da variável de ambiente são mostrados corretamente.

### Salvando o `crontab`

Uma vez que todas as tarefas agendadas tenham sido criadas e/ou propriamente modificadas, salve o `crontab` selecionando Arquivo Salvar .

Alternativamente, você pode simplesmente pressionar&Ctrl;S. Adições ou mudanças não serão efetuadas até que isto seja feito.

### Imprimindo o `crontab`

Para imprimir o `crontab` como ele foi salvo, clique em Arquivo imprimir.

Imprimindo o `crontab`
Imprimindo o `crontab`

O diálogo de impressão padrão do &kde; será mostrado. Se você selecionar Expandir você verá duas opções extra específicas do &kcron; na caixa do diálogo de impressão.

Imprimir Crontab

  Imprime o `crontab` para o suário atual

Imprimir todos os usuários

  Imprime os `contab`s para todos os usuários. Esta opção é habilitada apenas para usuários com privilégios de super-usuário.

## Referência dos comandos

### A janela principal do &kcron;

#### O Menu Arquivo

&Ctrl;S Arquivo Salvar

  Salva mudanças para o `crontab`

&Ctrl;P Arquivo Imprimir...

  Imprimeo `crontab`

&Ctrl;Q Arquivo Sair

  Sair do &kcron;

#### O Menu Editar

&Ctrl;X Editar Recortar

  Recorta a tarefa ou variável selecionada

&Ctrl;C Editar Copiar

  Copia a tarefa ou variável selecionada.

&Ctrl;V Editar Colar

  Cola a tarefa ou variável previamente recortada ou copiada.

&Ctrl;N Editar Novo...

  Cria uma nova tarefa ou variável

&Ctrl;O Editar Modificar...

  Modifica a tarefa ou variável.

Editar Remover

  Remove a tarefa ou variável selecionada

Editar Habilitado

  Habilta ou desabilita a tarefa ou variável selecionada.

Editar Executar Agora

  Executa a tarefa selecionada imediatamente.

#### O Menu Configurações

Configurações Mostrar Barra de Ferramentas

  Mostra a Barra de Ferramentas

Configurações Mostrar Barra de Satus

  Mostra a Barra de Status

#### O Menu Ajuda

&help.menu.documentation;

## Perguntas e Respostas

Por que as mudanças que estou fazendo para tarefas agendadas e/ou variáveis de ambiente não estão surtindo efeito?

Adições ou mudanças à tarefas agendadas não são efetivadas até que o `crontab` tenha sido salvo.

## Créditos e Licença

&kcron;

Direitos do Programa Gary Meyer gary@meyer.net 2000

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

Tradução Henrique Markshenrique@if.ufrgs.br

&underFDL; &underGPL;

## Instalação

### Como obter o &kcron;

&install.intro.documentation;

### Requisitos

De modo a compilar com sucesso o &kcron;, você precisa das seguintes bibliotecas

- `cron`, por exemplo `vixie-cron`. O &kcron; usa o `crontab` para modificar as tarefas agendadas dos usuários.

- &UNIX; de acordo com o padrão POSIX, como o disponibilizado pela glibc. O &kcron; usa algumas chamadas de sistema &UNIX; padrão para a localização de datas e horas.

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

&install.compile.documentation;

&documentation.index;