sluice - Online en la nube

PROGRAMA:

NOMBRE

sluice: una herramienta para controlar el flujo de datos a una velocidad específica

SINOPSIS

compuerta [opciones]

DESCRIPCIÓN

sluice lee la entrada y emite una velocidad de datos especificada. Tiene varios controles de velocidad de datos.
mecanismos que se pueden ajustar para casos de uso específicos cuando sea necesario.

OPCIONES

Las opciones de compuerta son las siguientes:

-a anexar salida a un archivo (usado junto con las opciones -t 'tee' u -O).
En lugar de crear un archivo nuevo o truncar un archivo existente, esta opción agrega
datos al archivo.

-c retrasar
habilita un tiempo de retardo constante (en segundos) entre escrituras. Esta opción ajusta el
tamaño del búfer de salida para intentar mantener constante la velocidad de datos. El tamaño del búfer de salida
en este modo se establece inicialmente en la velocidad de datos × el retraso.

Esta opción es mutuamente exclusiva de la opción -i e implícitamente habilita la opción -o
opciones de gestión de búfer overrun y -u underrun para redimensionar dinámicamente el
búfer de lectura / escritura para mantener constante la tasa de datos. Por defecto, esto ajusta el
búfer basado en la cantidad total de datos transferidos y el tiempo para escribir esto
(equivalente al modo de giro -s 0). Sin embargo, si el valor de desplazamiento -s es mayor
que 0, el nuevo tamaño se ajusta por el tamaño anterior desplazado a la derecha por el
valor de cambio.

-d descarte los datos, no los copie a la salida estándar. Esto hace que la compuerta actúe como un sumidero de datos.

-D modo
seleccione el modo de retardo. Hay varios enfoques sobre cuándo realizar la tasa de datos
retrasos. El valor predeterminado es realizar la lectura, luego la escritura y finalmente el retraso para
cada iteración. Sin embargo, la opción -D permite seleccionar el modo de retardo como
manera:

Moda Retrasar estrategia Retrasar Duración
0 lectura, escritura, retardo (predeterminado) 1 × tiempo de retardo
1 retardo, lectura, escritura 1 × tiempo de retardo
2 lectura, retardo, escritura 1 × tiempo de retardo
3 Retardo, lectura, retardo, escritura 2 × 1/2 tiempo de retardo
4 Lectura, retardo, escritura, retardo 2 × 1/2 tiempo de retardo
5 Retardo, lectura, retardo, escritura, retardo 3 × 1/3 de tiempo de retardo

Tenga en cuenta que los modos 3 y 4 realizan dos retrasos, cada uno de los cuales comprende la mitad del tiempo de retraso.
y el modo 5 realiza 3 retrasos, cada uno de los cuales comprende 1/3 del tiempo de retraso.

Los modos 1, 3, 5 pueden considerarse no del todo precisos en términos de ejecución total
duración. En estos modos, se produce un retraso extraño antes del final del archivo final.
Se realiza una lectura vacía.

-e ignorar los errores de lectura. La lectura fallida se reemplaza por ceros.

-f frecuencia
especificar la frecuencia de -v actualizaciones de estadísticas detalladas. El valor predeterminado es 1/4 de
segundo. Tenga en cuenta que la esclusa intentará emitir actualizaciones cercanas a la frecuencia solicitada,
Sin embargo, si la velocidad de lectura / escritura es menor que la frecuencia, se producen las actualizaciones.
solo a la velocidad de lectura / escritura.

-h mostrar ayuda

-i tamaño
especifique el tamaño de lectura / escritura en bytes. Los sufijos K, M, G, T y P permiten
especificar el tamaño en kilobytes, megabytes, gigabytes, terabytes y petabytes
respectivamente. Esta opción es mutuamente exclusiva de la opción -c.

En este modo, los retrasos entre escrituras se utilizan para controlar la velocidad de datos. Por
predeterminado, el retraso se basa en la cantidad total de datos transferidos y el tiempo
tomado para escribir esto. Esto es equivalente al modo de sintonización -s 0. Sin embargo, si el
-s valor de cambio es mayor que 0, entonces el nuevo retraso se ajusta por el anterior
retardo desplazado a la derecha por el valor de desplazamiento.

Se puede invocar un modo de control de velocidad híbrido especial utilizando también el desbordamiento -o y
-u opciones de subdesbordamiento para habilitar también el redimensionamiento dinámico del búfer de lectura / escritura. Por
predeterminado, esto ajusta el búfer en función de la cantidad total de datos transferidos y
el tiempo para escribir esto (equivalente al modo de giro -s 0). Sin embargo, si la -s
el valor de cambio es mayor que 0, luego el nuevo tamaño se ajusta por el tamaño anterior
desplazado a la derecha por el valor de cambio.

-I presentar
leer la entrada desde el archivo en lugar de desde stdin.

-m tamaño
especificar la cantidad de datos a procesar, el tamaño predeterminado es en bytes, pero el K, M, G, T
y los sufijos P pueden especificar el tamaño en kilobytes, megabytes, gigabytes, terabytes y
Petabytes respectivamente. Si este tamaño es menor que el tamaño de escritura, entonces la escritura
el tamaño se trunca para ser el tamaño -m.

-n sin control de tasa. Esta es solo una copia de datos directa muy parecida a cat y todas las velocidades de datos
los controles no se pueden utilizar. Combinado con las opciones -v y -S se puede observar el
velocidades de datos de la copia.

-o detecta el desbordamiento y redimensiona el tamaño del búfer de lectura / escritura para intentar detener el desbordamiento. Esta
reducirá el búfer cada vez que se detecten desbordamientos consecutivos. Ver las -s
opción para obtener detalles del mecanismo de reajuste de tamaño.

-O presentar
enviar la salida a un archivo, equivalente a un archivo -dt

-p habilite estadísticas detalladas que muestren% de progreso e información de ETA. Esto solo es válido
usando la opción -I o -m y el tamaño del archivo si no es cero. Vea la opción -v para
más detalles.

-P archivo pid
escriba el ID de proceso de la esclusa en el archivo pidfile. El archivo se elimina cuando la esclusa
salidas

-r y
especifique la velocidad de datos en bytes por segundo. Los sufijos K, M, G y T pueden especificar
la tasa en Kilobytes / seg, Megabytes / seg, Gigabytes / seg y Terabytes / seg
respectivamente. Esta opción siempre debe proporcionarse, excepto cuando la opción -n es
usado.

-R no lea de stdin, en su lugar lea datos aleatorios de / dev / urandom.

-s Turno
modificar el cambio de ajuste de la tasa. Este es un factor de escala de ajuste de velocidad de datos utilizado por
las opciones -r, -c, -o y -.

Para la opción -r, el retraso entre cada escritura se controla modificando el
retraso anterior sumando o restando el retraso anterior desplazado a la derecha por este
valor de cambio. Cuanto mayor sea el valor de cambio, más tiempo se necesitará para ajustar hacia arriba / abajo para
la tasa especificada. Cuanto menor es el valor de cambio, más rápido se tarda en alcanzar el
retardo óptimo, sin embargo, esto puede resultar en tasas muy fluctuantes en el
comenzando porque el retraso varía en una gran cantidad causando grandes sobrecostos y
insuficiente. Un valor de cambio de 3 funciona bien para la mayoría de las velocidades rápidas.

Para las opciones -c, -o y -u, el tamaño del búfer se modifica agregando o
restando el tamaño anterior desplazado por el valor de cambio. Nuevamente, un valor de cambio de 3
funciona bien para la mayoría de las tarifas rápidas.

Si el valor de cambio se establece en 0, entonces el mecanismo de sintonización de ajuste de la tasa de cambio es
desactivado explícitamente y las velocidades de datos se ajustan en función de la cantidad total de datos
transferido y el tiempo para escribir esto.

Los valores de desplazamiento pequeños de 1 y 2 pueden causar oscilaciones rápidas antes de la velocidad de datos.
la amortiguación entra en acción por completo. El valor de -s 0 (el predeterminado) se recomienda para
Transferencias de datos precisas a baja velocidad.

-S Imprime varias estadísticas de rendimiento y almacenamiento en búfer en stderr cuando se finaliza el archivo.
alcanzado.

-t presentar
Tee salida al archivo especificado. La salida se escribe tanto en stdout como en el nombre
expediente. De forma predeterminada, el archivo se creará si no existe o se volverá a escribir si
ya existe. Utilice la opción -a para agregar a un archivo existente.

-T t detener la prueba de corte después de t segundos. También se pueden especificar las unidades de tiempo en segundos,
minutos, horas, días o años con el sufijo s, m, h, d o y.

-u detecta la insuficiencia y redimensiona el tamaño del búfer de lectura / escritura para intentar detener la insuficiencia. Esta
expandirá el búfer cada vez que se detecten insuficiencias consecutivas. El tampón
no se ampliará más de 4 MB de tamaño. Consulte la opción -s para obtener detalles de
el mecanismo de reajuste de tamaño.

-v escribir estadísticas detalladas en stderr. De forma predeterminada, esto mostrará los datos actuales
tasa, el último ajuste de tasa de datos ('-' = infrautilización, '+' = superación), bytes totales
transferido, la duración y el tamaño actual del búfer.

Con la opción -p, se muestran las estadísticas de progreso. Esto mostrará el
velocidad de datos actual, bytes totales transferidos, duración, porcentaje completado hasta ahora
y el tiempo estimado hasta su finalización. Tenga en cuenta que la estimación está disponible utilizando
las opciones -I y -m y si el tamaño del archivo es distinto de cero.

-V imprima la información de la versión a la salida estándar y salga correctamente.

-w advertir si se produce una ráfaga prolongada de insuficiencia continua de la velocidad de datos, se emite la advertencia
sólo una vez. Para superar la insuficiencia de datos, aumente el tamaño del búfer de lectura / escritura -i o utilice
la opción -u para expandir automáticamente el búfer de lectura / escritura. Demasiados infracostes implica
que un búfer demasiado pequeño o no hay suficiente CPU disponible para mantenerse al día con los requisitos
velocidad de datos.

-z no lea desde stdin, en su lugar genere un flujo de ceros (equivalente a leer
desde / dev / zero).

SIGUSR1 SIGNIFICAR
El envío de SIGUSR1 (o SIGINFO en sistemas BSD) alternará el modo de velocidad de datos detallada
encendido apagado.

SIGUSR2
Active / desactive las opciones de insuficiencia / saturación (-u, -o).

NOTAS

Si no se utilizan las opciones -i o -c, entonces sluice utiliza de forma predeterminada un tamaño de búfer de escritura de
1/32 de la velocidad de datos y delimitado entre los límites de 1 byte y 64 MB. La esclusa lo intentará
para mantener estable la velocidad de datos ajustando el retraso entre escrituras. Para ajustar esto, vea el
-s opción.

EJEMPLOS

Leer / dev / zero y escribir en tamaños de 4K a una velocidad de 1 MB / seg en el archivo 'example.dat'
cat / dev / zero | esclusa -i 4K -r 1M> example.dat

Lea 32 MB de / dev / zero y escriba a una velocidad de 64 K / seg en la salida estándar con comentarios sobre
duración y ETA en stderr usando escrituras de búfer de 4K y un cambio de ajuste de 4.
cat / dev / zero | esclusa -r 64K -vp -m 32M -i 4K -s 4

Genere una secuencia de ceros y escriba a una velocidad de 1 MB / seg en un quince llamado 'myfifo' con
gestión de búfer de saturación e insuficiencia
esclusa -z -u -o -r 1MB -O myfifo

Escriba datos aleatorios a 5 MB por segundo en el archivo 'myfile' haciendo una escritura cada 0.1 segundos
esclusa -R -r 5M -c 0.1> miarchivo

Escriba ceros en el archivo 'example-file' en trozos de 64K y mida la tasa de escritura como un crudo
prueba de rendimiento
sluice -nzSv -f 0.1 -i 64K> archivo de ejemplo

Leer datos de somehost.com en el puerto 1234 a una velocidad de 2 MB por segundo y descartar los datos.
por ejemplo, este es un sumidero de datos de tasa constante.
nc somehost.com 1234 | esclusa -d -r 2MB -i 8K

SALIR ESTADO

Sluice establece el estado de salida de la siguiente manera:

Estado decription
0 Salió con éxito.
1 Se ha proporcionado una opción no válida o fuera de rango.
2 Error de apertura de archivo.
3 Error de suspensión.
4 No se pudo obtener la hora del día.
5 Error de configuración del manejador de señales.
6 Error de lectura (archivo o stdin).
7 Error de escritura (archivo o salida estándar).
8 Falló la asignación de búfer.

Use sluice en línea usando los servicios de onworks.net