eclusa - Online na nuvem

PROGRAMA:

NOME

eclusa - uma ferramenta para controlar o fluxo de dados a uma taxa especificada

SINOPSE

eclusa [opções]

DESCRIÇÃO

eclusa lê a entrada e produz uma taxa de dados especificada. Possui vários controles de taxa de dados
mecanismos que podem ser ajustados para casos de uso específicos, quando necessário.

OPÇÕES

as opções de eclusa são as seguintes:

-a anexa a saída a um arquivo (usado em conjunto com as opções -t 'tee' ou -O).
Em vez de criar um novo arquivo ou truncar um arquivo existente, esta opção anexa
dados para o arquivo.

-c atraso
permite um tempo de atraso constante (em segundos) entre as gravações. Esta opção ajusta o
tamanho do buffer de saída para tentar manter a taxa de dados constante. O tamanho do buffer de saída
neste modo, é inicialmente definido para a taxa de dados × o atraso.

Esta opção é mutuamente exclusiva para a opção -i e habilita implicitamente o -o
opções de gerenciamento de buffer de overrun e -u underrun para redimensionar dinamicamente o
buffer de leitura / gravação para manter a taxa de dados constante. Por padrão, isso ajusta o
buffer com base na quantidade total de dados transferidos e o tempo para escrever isso
(equivalente ao modo de rotação -s 0). No entanto, se o valor de deslocamento -s for maior
do que 0, então o novo tamanho é ajustado pelo tamanho anterior deslocado para a direita pelo
valor de deslocamento.

-d descartar dados, não os copie para stdout. Isso faz com que a comporta atue como um coletor de dados.

-D modo
selecione o modo de atraso. Existem várias abordagens para quando realizar a taxa de dados
atrasos. O padrão é realizar a leitura, a seguir escrever e, finalmente, o atraso para
cada iteração. No entanto, a opção -D permite selecionar o modo de atraso como
segue:

Moda Demora estratégia Demora Duração
0 Leitura, Gravação, Atraso (padrão) 1 × tempo de atraso
1 atraso, leitura, gravação 1 × tempo de atraso
2 leitura, atraso, gravação 1 × tempo de atraso
3 Atraso, leitura, atraso, gravação 2 × 1/2 tempo de atraso
4 Leitura, Atraso, Gravação, Atraso 2 × 1/2 tempo de atraso
5 Atraso, Leitura, Atraso, Gravação, Atraso 3 × 1/3 tempo de atraso

Observe que os modos 3 e 4 executam dois atrasos, cada um compreendendo 1/2 do tempo de atraso
e o modo 5 executa 3 atrasos, cada um compreendendo 1/3 do tempo de atraso.

Os modos 1, 3, 5 podem ser considerados como não totalmente precisos em termos de execução total
duração. Nestes modos, um atraso estranho ocorre antes do fim do arquivo final
uma leitura vazia é executada.

-e ignorar erros de leitura. A leitura com falha é substituída por zeros.

-f frequencia
especifica a frequência de atualizações de estatísticas detalhadas -v. O padrão é 1/4 de a
segundo. Observe que a eclusa tentará emitir atualizações perto da frequência solicitada,
no entanto, se a taxa de leitura / gravação for menor do que a frequência, as atualizações ocorrem
apenas na taxa de leitura / gravação.

-h mostre ajuda

-i tamanho
especifique o tamanho de leitura / gravação em bytes. Os sufixos K, M, G, T e P permitem que
especifique o tamanho em Kilobytes, Megabytes, Gigabytes, Terabytes e Petabytes
respectivamente. Esta opção é mutuamente exclusiva para a opção -c.

Neste modo, os atrasos entre as gravações são usados ​​para controlar a taxa de dados. Por
padrão o atraso é baseado na quantidade total de dados transferidos e o tempo
levado para escrever isso. Isso é equivalente ao modo de ajuste -s 0. No entanto, se o
-s valor de deslocamento é maior que 0, então o novo atraso é ajustado pelo anterior
atraso deslocado para a direita pelo valor de deslocamento.

Um modo de controle de taxa híbrida especial pode ser invocado usando também o overflow -o e
-u opções de underflow para habilitar o redimensionamento dinâmico do buffer de leitura / gravação. Por
padrão isso ajusta o buffer com base na quantidade total de dados transferidos e
o tempo para escrever isso (equivalente ao modo de rotação -s 0). No entanto, se o -s
valor de deslocamento é maior que 0, então o novo tamanho é ajustado pelo tamanho anterior
deslocado para a direita pelo valor de deslocamento.

-I lima
leia a entrada do arquivo em vez de stdin.

-m tamanho
especificar a quantidade de dados a processar, o tamanho padrão é em bytes, mas o K, M, G, T
e os sufixos P podem especificar o tamanho em Kilobytes, Megabytes, Gigabytes, Terabytes e
Petabytes respectivamente. Se este tamanho for menor do que o tamanho de gravação, a gravação
size é truncado para ser o tamanho -m.

-n sem controle de taxa. Esta é apenas uma cópia direta de dados, muito parecida com gato e todas as taxas de dados
controles não podem ser usados. Combinado com as opções -v e -S, pode-se observar o
taxas de dados da cópia.

-o detectar saturação e redimensionar o tamanho do buffer de leitura / gravação para tentar interromper a saturação. Esse
encolherá o buffer cada vez que saturações consecutivas forem detectadas. Veja o -s
opção para obter detalhes do mecanismo de reajuste de tamanho.

-O lima
envia a saída para o arquivo, equivalente ao arquivo -dt

-p habilitar estatísticas detalhadas mostrando% de progresso e informações de ETA. Isso só é válido
usando a opção -I ou -m e se o tamanho do arquivo for diferente de zero. Veja a opção -v para
mais detalhes.

-P arquivo pid
escreva o ID do processo da eclusa no arquivo pidfile. O arquivo é removido durante a eclusa
saídas.

-r taxas
especifique a taxa de dados em bytes por segundo. Os sufixos K, M, G e T podem especificar
a taxa em Kilobytes / seg, Megabytes / seg, Gigabytes / seg e Terabytes / seg.
respectivamente. Esta opção deve ser sempre fornecida, exceto quando a opção -n for
usava.

-R não leia de stdin, em vez disso leia dados aleatórios de / dev / urandom.

-s mudança
modificar a mudança de ajuste de taxa. Este é um fator de escala de ajuste de taxa de dados usado por
as opções -r, -c, -o e -.

Para a opção -r, o atraso entre cada gravação é controlado pela modificação do
atraso anterior adicionando ou subtraindo o atraso anterior deslocado para a direita por este
valor de deslocamento. Quanto maior o valor de deslocamento, mais tempo leva para ajustar para cima / baixo para
a taxa especificada. Quanto menor o valor de deslocamento, mais rápido leva para alcançar o
atraso ideal, no entanto, isso pode resultar em taxas altamente flutuantes no
começando porque o atraso varia em uma grande quantidade, causando grandes estouros e
underruns. Um valor de deslocamento de 3 funciona bem para a maioria das taxas rápidas.

Para as opções -c, -o e -u, o tamanho do buffer é modificado adicionando ou
subtraindo o tamanho anterior deslocado pelo valor de deslocamento. Novamente, um valor de deslocamento de 3
funciona bem para a maioria das taxas rápidas.

Se o valor de deslocamento for definido como 0, o mecanismo de ajuste de ajuste da taxa de deslocamento é
explicitamente desligado e as taxas de dados são ajustadas com base na quantidade total de dados
transferido e o tempo para escrever isso.

Valores de deslocamento pequenos de 1 e 2 podem causar oscilações rápidas antes da taxa de dados
o amortecimento entra em ação totalmente. O valor de -s 0 (o padrão) é recomendado para
transferências de dados precisas de baixa velocidade.

-S imprimir várias estatísticas de desempenho e buffer para stderr quando o final do arquivo for
alcançado.

-t lima
tee output para o arquivo especificado. A saída é escrita tanto no stdout quanto no named
Arquivo. Por padrão, o arquivo será criado se não existir ou reescrito se ele
já existe. Use a opção -a para anexar a um arquivo existente.

-T t pare o teste de fatia após t segundos. Também é possível especificar as unidades de tempo em segundos,
minutos, horas, dias ou anos com o sufixo s, m, h, d ou y.

-u detectar underrun e redimensionar o tamanho do buffer de leitura / gravação para tentar interromper o underrun. Esse
irá expandir o buffer cada vez que underruns consecutivos forem detectados. O buffer
não será expandido mais do que 4 MB de tamanho. Veja a opção -s para detalhes de
o mecanismo de reajuste de tamanho.

-v escrever estatísticas detalhadas para stderr. Por padrão, isso exibirá os dados atuais
taxa, o último ajuste da taxa de dados ('-' = underrun, '+' = overrun), total de bytes
transferido, duração e o tamanho do buffer atual.

Com a opção -p, as estatísticas de progresso são exibidas. Isso exibirá o
taxa de dados atual, total de bytes transferidos, duração, porcentagem concluída até agora
e o tempo estimado para conclusão. Observe que a estimativa está disponível usando
as opções -I e -m e se o tamanho do arquivo for diferente de zero.

-V imprimir informações da versão para padronizar e sair com sucesso.

-w avisar se uma longa rajada de subexecução de taxa de dados contínua ocorrer, o aviso é emitido
só uma vez. Para superar o underrun, aumente o tamanho do buffer de leitura / gravação -i ou use
a opção -u para expandir automaticamente o buffer de leitura / gravação. Muitos underruns implicam
que um buffer muito pequeno ou CPU insuficiente está disponível para acompanhar o necessário
taxa de dados.

-z não leia de stdin, em vez disso gere um fluxo de zeros (equivalente à leitura
de / dev / zero).

SIGUSR1 SIGINFO
O envio de SIGUSR1 (ou SIGINFO em sistemas BSD) irá alternar o modo de taxa de dados detalhados
Ligado desligado.

SIGUSR2
Ative / desative as opções underrun / overrun (-u, -o).

NOTAS

Se nenhuma das opções -i ou -c forem usadas, o padrão da eclusa é usar um tamanho de buffer de gravação de
1/32 da taxa de dados e limitado entre os limites de 1 byte e 64 MB. Sluice vai tentar
para manter a taxa de dados estável ajustando o atraso entre as gravações. Para ajustar isso, consulte o
opção -s.

EXEMPLOS

Leia / dev / zero e escreva em tamanhos de 4 K a uma taxa de 1 MB / s no arquivo 'example.dat'
cat / dev / zero | eclusa -i 4K -r 1M> exemplo.dat

Leia 32 MB de / dev / zero e escreva a uma taxa de 64 K / seg para stdout com feedback ativado
duração e ETA em stderr usando gravações de buffer de 4 K e uma mudança de ajuste de 4.
cat / dev / zero | eclusa -r 64K -vp -m 32M -i 4K -s 4

Gere um fluxo de zeros e escreva a uma taxa de 1 MB / s em um fifo chamado 'myfifo' com
gerenciamento de buffer underrun e overrun
eclusa -z -u -o -r 1MB -O myfifo

Grava dados aleatórios a 5 MB por segundo no arquivo 'meuarquivo', fazendo uma gravação a cada 0.1 segundos
eclusa -R -r 5M -c 0.1> meuarquivo

Grave zeros no arquivo 'arquivo de exemplo' em blocos de 64K e meça a taxa de gravação como um bruto
teste de rendimento
sluice -nzSv -f 0.1 -i 64K> arquivo de exemplo

Leia os dados de somehost.com na porta 1234 a uma taxa de 2 MB por segundo e descarte os dados,
por exemplo, este é um coletor de dados de taxa constante.
nc somehost.com 1234 | eclusa -d -r 2MB -i 8K

SAIR STATUS

Sluice define o status de saída da seguinte forma:

Status Decription
0 Saiu com sucesso.
1 Opção inválida ou fora do intervalo fornecida.
2 Erro ao abrir o arquivo.
3 Erro de suspensão.
4 Falha ao obter a hora do dia.
5 Erro de configuração do manipulador de sinal.
6 Erro de leitura (arquivo ou stdin).
7 Erro de gravação (arquivo ou stdout).
8 Falha na alocação do buffer.

Use eclusa online usando serviços onworks.net