shush - Online na nuvem

PROGRAMA:

NOME

shush - executa um comando e, opcionalmente, relata sua saída por e-mail

SINOPSE

fazer calar [ -h | -V ]

fazer calar [ -c dir ] [ -S | -s facilidade ] [ -vfmk ] nome [ ID ]

fazer calar [ -c dir ] [ -H para ] [ -R para ] [ -T para ] -C nome [ stdout [ stderr ]]

fazer calar [ -i | -u | -r ] [ -c dir ]

DESCRIÇÃO

fazer calar executa um comando e, opcionalmente, relata sua saída por correio. É um invólucro útil
em torno de trabalhos cron. Por padrão, fazer calar não produzirá nenhuma saída quando executado como
tudo (se houver) é relatado por e-mail. No entanto, a configuração, bem como crítica
os erros serão relatados no erro padrão e (opcionalmente) no syslog. Porque
interrompendo fazer calar tem consequências terríveis, incluindo a provável perda de qualquer produção do
comando, os seguintes sinais comumente usados ​​são ignorados por fazer calar: SIGHUP, SIGINT, SIGQUIT
e SIGTERM. Se alguém realmente deseja matar uma instância em execução de fazer calar ao invés de matar
o comando gerenciado em execução, SIGKILL pode ser usado e deve servir como um lembrete de como
inadequada, tal ação normalmente é.

Para que um comando seja executado usando fazer calar, um arquivo de configuração nome deve existir no
diretório de configuração ($ HOME / .shush por padrão). Este arquivo define como o comando
deve ser executado também quando enviar relatórios por correio. Para detalhes disponíveis
parâmetros de configuração, consulte o CONFIGURAÇÃO seção abaixo.

Podem existir dois arquivos de configuração adicionais: nome.stdout e nome.stderr (por padrão).
Esses arquivos são usados ​​para ver a saída padrão e o erro padrão (respectivamente)
produzido pelo comando. Para obter detalhes sobre como usá-los, consulte o COMANDO SAÍDA seção
abaixo.

Quando o -C opção é especificada, fazer calar irá apenas carregar a configuração, opcionalmente
analisar a saída padrão e o erro padrão dos arquivos especificados e, finalmente,
produzir relatórios de amostra, se desejado. Isso também pode ser usado para produzir relatórios se fazer calar
falhou ao terminar corretamente ao executar um comando. (A saída padrão e o erro de
os comandos são normalmente encontrados em arquivos localizados em / tmp.)

fazer calar é capaz de gerenciar crontab(5) entradas baseadas em configurações definidas pelo usuário.
Isso pode ser feito de duas maneiras. Se um arquivo chamado "cronograma"existe no
diretório de configuração, então ele é lido para informações de agendamento. Cada linha deve
contém uma única entrada contendo três campos separados por espaços em branco. Os campos são
(em ordem) o nome do host para o qual a entrada se aplica ou o caractere "*" para incluir todos
hosts, a configuração nomee, finalmente, as informações de agendamento no mesmo formato
como é usado pelo cronograma parâmetro (veja abaixo). Para especificar um ID, usar nome:ID como o
segundo campo. Se não houver nenhum arquivo chamado "cronograma", então fazer calar verifica a configuração
diretório para arquivos de configuração e os adiciona ao do usuário atual crontab(5) arquivo como
especificado pelo incluído cronograma parâmetro (veja abaixo). Arquivos cujos nomes começam com
o caractere "#" ou termina com o caractere "~" são ignorados.

OPÇÕES

-h Exibe uma breve mensagem de ajuda.

-V Exibe as informações da versão. Prefixo com -v para exibir os padrões de tempo de compilação.

-c dir Especifique o diretório onde as configurações são armazenadas.

-s facilidade
Define o recurso syslog a ser usado para registro.

-S Desative o registro do syslog.

-v Copie as mensagens de registro de informações para a saída padrão.

-f Modo rápido: qualquer configurado atraso aleatório é ignorado.

-m Monitore e exiba a saída padrão do comando e o erro em tempo real.

-k Mantenha os arquivos de log de saída do comando em vez de excluí-los após a conclusão.

-C Verifique a configuração sem executar nenhum comando.

-H para Envie um relatório HTML de amostra para o (s) destinatário (s) especificado (s).

-R para Envie uma amostra de relatório enriquecido para o (s) destinatário (s) especificado (s).

-T para Envie um relatório de texto de amostra para o (s) destinatário (s) especificado (s).

-i Use crontab(1) instalar um novo crontab(5) arquivo para o usuário atual. O usuário
já não deve ter um crontab(5) arquivo.

-u Use crontab(1) para atualizar o usuário atual crontab(5) arquivo, que já deve
existir.

-r Remova qualquer entrada adicionada pelo -u opção do usuário atual crontab(5).

CONFIGURAÇÃO

fazer calar os arquivos de configuração consistem em uma seção principal, seção (ões) de relatório e parâmetros.
A seção principal define parâmetros globais, bem como padrões para relatórios. Cada relatório
a seção começa com o nome do relatório entre colchetes. Linhas começando com o
caractere "#" são ignorados. Os parâmetros devem ser especificados apenas uma vez. Se especificado
várias vezes, todas as ocorrências, exceto a última, serão ignoradas, a menos que seja indicado o contrário.
Os parâmetros são definidos usando a seguinte sintaxe:

nome=valor

ou:

nome@hostname=valor

ou:

nome%ID=valor

ou finalmente:

nome@hostname%ID=valor

O segundo e o quarto formatos serão ignorados, a menos que fazer calar está sendo executado no especificado
nome de anfitrião. O terceiro e o quarto formatos permitem definir várias instâncias de um único
arquivo de configuração. Esses arquivos de configuração requerem uma instância ID a ser especificado em
ordem para correr. Qualquer linha de configuração usando o terceiro ou quarto formato será ignorada se
da ID encontrado nessa linha não corresponde à instância ID costumava correr fazer calar.

Os seguintes parâmetros podem aparecer na seção principal:

comando
O comando real a ser executado. fazer calar define duas variáveis ​​de ambiente antes de executar o
comando: SHUSH_NAME está definido para nome e SHUSH_ID está definido para ID.

configuração O padrão é o caminho completo do arquivo de configuração principal. Os outros dois
os nomes dos arquivos de configuração são obtidos anexando-se ".stdout" e ".stderr"
sufixos para o valor deste parâmetro.

trancar Se definido, este parâmetro instrui fazer calar para obter um arquivo de bloqueio antes de executar o
comando, e define as ações a serem tomadas no caso de arquivo de bloqueio é segurado por outro
processo. O formato é uma lista de ações separadas por vírgulas. As ações válidas são: a
duração do tempo (durante o qual fazer calar deve simplesmente esperar e continuar tentando obter o
arquivo de bloqueio), a string "abort" (indicando que fazer calar deve terminar imediatamente
se o arquivo de bloqueio já existe), a string "ignore" (indicando que fazer calar rede de apoio social
ignorar um existente arquivo de bloqueio), a string "loop" (para marcar onde começar novamente
quando todas as ações foram executadas) e a string "notificar =" seguida por e-mail
endereços para os quais um e-mail de notificação deve ser enviado. As ações são executadas no
ordem em que são fornecidos, e fazer calar vai esperar para sempre tentando obter o arquivo de bloqueio
uma vez que todas as ações foram executadas, a menos que a string "loop" seja uma das
ações. As durações de tempo podem ser especificadas em unidades de w (eeks), d (ays), h (nosso),
m (inutos) ou s (econds). Se nenhuma unidade for especificada, presume-se que sejam minutos.

arquivo de bloqueio
Por padrão, o fazer calar usará um arquivo localizado no mesmo diretório que o
arquivo de configuração e nomeado após a configuração e os nomes do host. Uma alternativa
nome do arquivo pode ser especificado usando este parâmetro.

mensagem de bloqueio
Se definida, esta string será usada como assunto para mensagens de e-mail de notificação de bloqueio.
O padrão é "[% u @% h] ** PENDING **% N [% t]". Veja o MAIL ASSUNTO seção para
detalhes sobre o formato.

caminho fazer calar não modifica o ambiente, exceto para definir o PATH variável se o caminho
parâmetro está definido.

atraso aleatório
Se este parâmetro for definido, fazer calar vai esperar a quantidade de tempo especificada antes
iniciar o comando, a menos que seja invocado com o -f. As unidades de tempo válidas são: s (econds),
m (inutos), h (nossos), d (ays), w (eeks). Se nenhuma unidade for especificada, presume-se que seja
minutos.

cronograma
Isso define quando executar este comando como um cron job, em um crontab(5) compatível
formato. Várias entradas podem ser especificadas usando o caractere ";" como separador.
As entradas prefixadas pelo caractere "#" serão ignoradas. Este parâmetro não é
usado diretamente por fazer calar para executar o comando, mas usado pelo -i e -u opções.

enviar correio
Isso pode ser usado para substituir o comando usado para enviar e-mail.

concha Por padrão, o shell Bourne sh(1) é usado para executar o comando, permitindo qualquer concha
sintaxe a ser usada. Um shell alternativo pode ser definido usando este parâmetro.

declarado
Isso define o diretório onde o status do fazer calar é salvo e o padrão é o
Diretório ".state" no qual a configuração está localizada. Um erro é gerado
se o diretório não existir, a menos que esta opção não tenha sido definida. Configurando isso
opção para uma string vazia irá prevenir fazer calar de salvar seu status. shlast(1)
usa esses arquivos de estado para relatar sobre as instâncias em execução de fazer calar bem como anterior
corre.

syslog Este parâmetro é só usado pelo -i e -u opções e não tem outro efeito sobre
fazer calar. Ele permite substituir o recurso de syslog padrão usado para registro e
definido em tempo de compilação. Se deixado em branco, suprime o uso de syslog.

tempo limite
Este parâmetro permite controlar por quanto tempo o comando pode ser executado. Deveria ser um
lista de ações separadas por vírgulas. As ações válidas são: uma duração de tempo (durante a qual
fazer calar deve simplesmente esperar pelo comando para terminar), um sinal (seja "SIGNAME"
ou "-SIGNUMBER") que deve ser enviado ao comandogrupo de processo de, um sinal
("= SIGNAME" ou "= SIGNUMBER") que deve ser enviado para o concha costumava gerar
da comando, a string "loop" (para marcar onde começar de novo quando todas as ações
foram executados) e a string "notificar =" seguida por endereços de e-mail para os quais um
e-mail de notificação deve ser enviado. As ações são executadas na ordem em que são
fornecido, e fazer calar vai esperar para sempre se o comando ainda está em execução uma vez que todos os
as ações foram executadas, a menos que a string "loop" seja uma das ações definidas.
As durações de tempo podem ser especificadas em unidades de w (eeks), d (ays), h (nosso), m (inutos) ou
s (econds). Se nenhuma unidade for especificada, presume-se que sejam minutos.

mensagem de tempo limite
Se definido, esta string será usada como assunto para e-mail de notificação de tempo limite
mensagens. O padrão é "[% u @% h] ** TIMEOUT **% N [% t]". Veja o MAIL ASSUNTO
seção para detalhes sobre o formato.

Os parâmetros a seguir podem aparecer em qualquer lugar na configuração. Se especificado no
seção principal, eles definem as configurações padrão que se aplicarão a qualquer relatório para o qual o
mesmo parâmetro não foi definido.

para, cc, bcc
Para onde enviar o relatório de email.

sujeito
Assunto do relatório de correio. Veja o MAIL ASSUNTO seção para detalhes sobre o
formato.

cabeçalho Cabeçalhos de correio adicionais. Observe que este parâmetro pode ser repetido para especificar
vários cabeçalhos. No entanto, apenas cabeçalhos do relatório (se especificado) ou do
a seção principal será usada para um determinado relatório.

prefixo de host
Por padrão, os assuntos especificados são prefixados com o nome do host entre colchetes.
Este parâmetro permite personalizar este prefixo. Um número inteiro positivo indica
quantos componentes do nome de host totalmente qualificado devem ser mostrados. Um negativo
inteiro indica quantos componentes finais do nome de host totalmente qualificado
deve ser aparado. O zero inteiro indica que o prefixo deve ser omitido.
Este parâmetro é ignorado se o "sujeito"contém qualquer caractere"% ".

prefixo do usuário
Por padrão, os assuntos especificados são prefixados com o nome de usuário entre colchetes.
Este parâmetro permite desativar este prefixo. Qualquer valor diferente de zero indica
que o nome de usuário deve ser mostrado enquanto zero faz com que o prefixo seja omitido. Esse
parâmetro é ignorado se o "sujeito"contém qualquer caractere"% ".

saída (anteriormente "stderr ")

Este define como da comando padrão saída e padrão erro e guarante que os mesmos estão capturados e
relatado para da usuário: "errprimeiro", "misturado", "outfirst". Quando utilização "misturado", da
nome.stderr • Configuração lima is ignorado. Quando utilização "errprimeiro" or "outfirst",
Individual relatórios pode usar um of da seguinte dois adicional opções "outonly"
e "erroneamente".

formato Mensagens de correio enviando a saída do comando pode ser enviado em três diferentes
formatos: "texto" (o padrão), texto "enriquecido" ou "html".

limite de tamanho
Por padrão, toda a saída do comando é enviado em relatórios de correio. Esse
O parâmetro pode ser usado para limitar o tamanho da saída incluída em um relatório. Observação
que o tamanho total da correspondência enviada será maior, pois este limite não tem efeito sobre
cabeçalhos de correio. O tamanho pode ser especificado em unidades de m, k, b, c (MB, KB, Bytes).
Se nenhuma unidade for especificada, será considerado KB. Um limite de zero indica que
a saída não deve ser truncada.

if Um relatório só é enviado se não if condição é especificada ou se o especificado if
condição é verdadeira. A sintaxe da condição permite os operadores lógicos usuais
("||", "&&", "!"), operadores de comparação ("==", "! =", "<", "<=", ">", "> =") e
operadores aritméticos básicos ("+", "-"). Além dos contadores definidos pelo
configuração (veja o COMANDO SAÍDA seção abaixo), as seguintes variáveis ​​podem
ser usado:

$ exit Se o comando terminou normalmente, este é o seu código de saída. Caso contrário, é
negativo e indica o número do sinal que causou o comando para
terminar (por exemplo, -1 indica que o sinal número 1 fez com que o comando
terminar).

$ tamanho tamanho de saída (em bytes), o mesmo que "$ outsize + $ errsize"

$ outsize
tamanho (em bytes) da saída padrão

$ errsize
tamanho (em bytes) do erro padrão

$ linhas número de linhas de saída

$ outlines
número de linhas de saída padrão

$ errlines
número de linhas de erro padrão

$ runtime
comando tempo de execução (em segundos)

$ utime tempo do usuário usado pelo comando

$ stime tempo do sistema usado pelo comando

$ tty 1 se fazer calar é executado a partir de um terminal (por exemplo, interativamente), 0 caso contrário.

MAIL ASSUNTOS

O "mensagem de bloqueio""mensagem de tempo limite"E"sujeito"parâmetros podem conter os seguintes tokens
que são expandidos conforme descrito abaixo:

%% O personagem

%h O nome do host

%
ou "% - "

A parcialmente nome de anfitrião: A positivo dígito indicam como muitos componentes of da
totalmente qualificado hostname para guarda; a negativo dígito indicam como muitos
à direita componentes of da totalmente qualificado hostname para guarnição.

%i A instância ID

%n A configuração nome

%N A configuração nome e instância ID

%r O nome do relatório

%t O tempo decorrido.

%u O nome de usuário.

%U O ID do usuário.

Se o caractere "%" for encontrado no "sujeito"parâmetro, então o
"prefixo de host"E"prefixo do usuário"parâmetros são ignorados.

COMANDO SAÍDA

Após comando termina, fazer calar usará o conteúdo do nome.stdout e
nome.stderr arquivos (se existirem) para olhar a saída produzida pelo comando.

Esses arquivos seguem um formato simples. Cada linha é composta por um único caractere (o
nome do contador) seguido por uma expressão regular.

Todos os contadores são inicializados em 0 (zero). Cada linha de saída é comparada a estes
expressões regulares até que uma correspondência seja encontrada. Se uma correspondência for encontrada, o contador associado
é incrementado em um. Esses contadores podem então ser usados ​​como parte da configuração principal,
em um "if"parâmetro de configuração, permitindo que a decisão de enviar um relatório por e-mail seja
com base em quantas vezes certas expressões regulares foram correspondidas.

Finalmente, as expressões regulares podem definir subexpressões que serão renderizadas em negrito em
relatórios de correio.

As linhas que começam com o caractere "#" são consideradas comentários e são ignoradas. Por
padrão, expressões regulares padrão são usadas, a menos que a primeira linha seja "#pcre" na qual
maiúsculas e minúsculas expressões regulares compatíveis com Perl são usadas.

MEIO AMBIENTE VARIÁVEIS

CASA Se o -c opção não é usada, fazer calar irá procurar por arquivos de configuração em
$ HOME / .shush.

SHUSH_SENDMAIL
Se definido, isso deve apontar para o enviar correio(1) binário. Esta variável substitui
o "enviar correio"definição de configuração e deve ser usado com cuidado.

TMPDIR Diretório onde os arquivos temporários são criados.

EXEMPLO

A configuração a seguir executa "shush -c / etc / shush -u" diariamente às 9h, atualizando o usuário
(raiz) crontab:

comando = shush -c / etc / shush -u
cronograma = 0 9 * * *
lock = notificar = root-logs, abortar
tempo limite = 5m, loop, notificação = root-logs, 15m
stderr = primeiro
format = text
Assunto = Crontab Daily Update
[Histórico]
to = root-logs
[leitores]
if = $ exit! = 0 || $ outlines! = 1 || $ errsize> 0 || você
to = root
format = rich

A configuração associada para saída padrão é:
Oshush: crontab atualizado \. $
U ^. + $

e para erro padrão:
U ^ (. +) $

Um bloqueio será definido durante a execução do comando e o e-mail será enviado para "root" e "root-logs" se
o bloqueio é mantido por outro processo quando fazer calar começa, caso em que fazer calar vai abortar. UMA
o e-mail também será enviado para "root" e "root-logs" se "shush -c / etc / shush -u" for executado para mais
de 5 minutos e a cada 15 minutos após os primeiros 5 minutos.

Após a conclusão, a saída sempre será enviada para "root-logs". Além disso, a saída
será enviado para "root" se a condição "$ exit! = 0 || $ outlines! = 1 || $ errsize> 0 ||
U "é verdadeiro. Para esta condição ser verdadeira, uma das seguintes opções deve ser verdadeira: a saída
o código é diferente de zero, a saída padrão do comando não era uma única linha, havia saída em
erro padrão ou, finalmente, o contador "U" é diferente de zero. Para o contador "U" ser não
zero, deve haver uma saída na saída padrão diferente da linha "shush: crontab
atualizado. ". Finalmente, qualquer linha de saída produzida no erro padrão será exibida
em negrito nos e-mails enviados para "root".

Use shush online usando serviços onworks.net