sluice - 云端在线

程序：

您的姓名

sluice - 以指定速率控制数据流的工具

概要

水闸 [选项]

商品描述

sluice 读取输入并输出指定的数据速率。 它具有各种数据速率控制
必要时可以针对特定用例进行调整的机制。

配置

水闸选项如下：

-a 将输出附加到文件（与 -t 'tee' 或 -O 选项结合使用）。
此选项不是创建新文件或截断现有文件，而是附加
数据到文件。

-c 延迟
启用写入之间的恒定延迟时间（以秒为单位）。 此选项调整
输出缓冲区大小以尝试保持数据速率不变。 输出缓冲区大小
在此模式下，初始设置为数据速率 × 延迟。

此选项与 -i 选项互斥并隐式启用 -o
overrun 和 -u underrun 缓冲区管理选项以动态重新调整大小
读/写缓冲区以保持数据速率恒定。 默认情况下，这会调整
基于传输的数据总量和写入时间的缓冲区
（相当于 -s 0 转动模式）。 但是，如果 -s 移位值更大
大于 0，则新的大小由前一个大小右移
移位值。

-d 丢弃数据，不要将其复制到标准输出。 这使得水闸充当数据接收器。

-D 模式
选择延迟模式。 何时执行数据速率的各种方法
延误。 默认是执行读取，然后写入，最后延迟
每次迭代。 但是，-D 选项允许选择延迟模式为
如下：

时尚 延迟 策略 延迟 时间长度
0 读、写、延迟（默认） 1 × 延迟时间
1 延迟、读取、写入 1 × 延迟时间
2 读取、延迟、写入 1 × 延迟时间
3 Delay, Read, Delay, Write 2 × 1/2 延迟时间
4 Read, Delay, Write, Delay 2 × 1/2 延迟时间
5 Delay, Read, Delay, Write, Delay 3 × 1/3 延迟时间

请注意，模式 3 和 4 执行两个延迟，每个延迟时间为延迟时间的 1/2
模式 5 执行 3 个延迟，每个延迟时间为延迟时间的 1/3。

就总运行而言，模式 1、3、5 可能被认为不完全准确
期间。 在这些模式中，在最后的文件结束之前会发生一个额外的延迟
执行空读。

-e 忽略读取错误。 失败的读取被零替换。

-f 频率
指定 -v 详细统计信息更新的频率。 默认值为 a 的 1/4
第二。 请注意， sluice 将尝试发出接近请求频率的更新，
但是，如果读/写速率小于频率，则会发生更新
仅以读/写速率。

-h 显示帮助

-i 尺寸
以字节为单位指定读/写大小。 K、M、G、T 和 P 后缀允许一个
以千字节、兆字节、千兆字节、太字节和拍字节为单位指定大小
分别。 此选项与 -c 选项互斥。

在这种模式下，写入之间的延迟用于控制数据速率。 经过
默认延迟基于传输的数据总量和时间
采取写这个。 这相当于 -s 0 调整模式。 然而，如果
-s 移位值大于 0，则新的延迟由前一个调整
延迟右移移位值。

还可以使用 -o 溢出和
-u 下溢选项还可以动态调整读/写缓冲区的大小。 经过
默认情况下，这会根据传输的数据总量调整缓冲区，并且
写这个的时间（相当于 -s 0 转模式）。 但是，如果 -s
shift 值大于 0，则新的大小由之前的大小调整
右移移位值。

-I 文件
从文件而不是从标准输入读取输入。

-m 尺寸
指定要处理的数据量，默认大小以字节为单位，但 K、M、G、T
和 P 后缀可以以千字节、兆字节、千兆字节、太字节和
分别为 PB。 如果此大小小于写入大小，则写入
size 被截断为 -m 大小。

-n 没有速率控制。 这只是一个直接的数据副本，很像 cat 和所有数据速率
无法使用控件。 结合 -v 和 -S 选项可以观察到
副本的数据速率。

-o 检测溢出并重新调整读/写缓冲区大小以尝试停止溢出。 这个
每次检测到连续溢出时都会缩小缓冲区。 看到 -s
尺寸重新调整机制的详细信息选项。

-O 文件
将输出发送到文件，相当于 -dt 文件

-p 启用显示百分比进度和 ETA 信息的详细统计信息。 这仅有效
使用 -I 或 -m 选项并且 if 文件大小为非零。 请参阅 -v 选项
更多细节。

-P pid文件
将 sluice 的进程 ID 写入文件 pidfile 中。 sluice 时文件被删除
退出。

-r 率
以每秒字节数指定数据速率。 K、M、G 和 T 后缀可以指定
以千字节/秒、兆字节/秒、千兆字节/秒和太字节/秒为单位的速率
分别。 必须始终提供此选项，除非 -n 选项为
用过的。

-R 不要从 stdin 读取，而是从 /dev/urandom 读取随机数据。

-s 转移
修改利率调整班次。 这是用于的数据速率调整比例因子
-r、-c、-o 和 - 选项。

对于 -r 选项，每次写入之间的延迟是通过修改
前一个延迟通过添加或减去前一个延迟右移此
移位值。 移位值越大，向上/向下调整所需的时间越长
指定的费率。 偏移值越小，达到目标的速度越快
最佳延迟，然而，这可能导致在
开始是因为延迟变化很大导致大量超限和
欠载。 移位值 3 适用于大多数快速速率。

对于 -c、-o 和 -u 选项，通过添加或修改缓冲区的大小
减去由移位值移位的先前大小。 同样，移位值为 3
适用于大多数快速速率。

如果 shift 值设置为 0，则 shift rate 调整调谐机制为
明确关闭并根据数据总量调整数据速率
转移和写这个的时间。

1 和 2 的小 -s 偏移值会导致数据速率之前的快速振荡
阻尼充分发挥作用。 建议将 -s 0（默认值）的值用于
准确的低速数据传输。

-S 当文件结束时，将各种性能和缓冲统计信息打印到 stderr
到达。

-t 文件
tee 输出到指定文件。 输出同时写入标准输出和命名
文件。 默认情况下，如果文件不存在则创建，如果存在则重写
已经存在。 使用 -a 选项附加到现有文件。

-T t t 秒后停止切片测试。 还可以指定以秒为单位的时间单位，
带有后缀 s、m、h、d 或 y 的分钟、小时、天或年。

-u 检测欠载并重新调整读/写缓冲区大小以尝试停止欠载。 这个
每次检测到连续欠载时都会扩展缓冲区。 缓冲区
将不会扩展超过 4MB 的大小。 有关详细信息，请参阅 -s 选项
尺寸重新调整机制。

-v 将详细统计信息写入 stderr。 默认情况下，这将显示当前数据
rate，最后一次数据速率调整（'-' = underrun，'+' = overrun），总字节数
传输、持续时间和当前缓冲区大小。

使用 -p 选项，将显示进程统计信息。 这将显示
当前数据速率、传输的总字节数、持续时间、到目前为止完成的百分比
以及预计完成时间。 请注意，估计可使用
-I 和 -m 选项以及文件大小是否为非零。

-V 将版本信息打印到标准输出并成功退出。

-w 警告 如果发生长时间的连续数据速率欠载，则发出警告
就一次。 为了克服欠载增加 -i 读/写缓冲区大小或使用
-u 选项用于自动扩展读/写缓冲区。 太多欠载意味着
缓冲区太小或没有足够的 CPU 来跟上所需的
数据速率。

-z 不从 stdin 读取，而是生成零流（相当于读取
来自 /dev/zero）。

信号灯1 信息
发送 SIGUSR1（或 BSD 系统上的 SIGINFO）将切换详细数据速率模式
开关。

信号灯2
打开/关闭欠载/过载（-u，-o）选项。

附注

如果 -i 或 -c 选项均未使用，则 sluice 默认使用写入缓冲区大小
数据速率的 1/32，并且在 1 字节和 64MB 的限制之间。 水闸会尝试
通过调整写入之间的延迟来保持数据速率稳定。 要调整它，请参阅
-s 选项。

示例

读取 /dev/zero 并以 4MB/sec 的速率以 1K 大小写入文件“example.dat”
猫/开发/零| sluice -i 4K -r 1M > example.dat

从 /dev/zero 读取 32MB 并以 64K/sec 的速率写入标准输出并反馈
使用 4K 缓冲区写入和 4 的调整移位在 stderr 上的持续时间和 ETA。
猫/开发/零| 水闸 -r 64K -vp -m 32M -i 4K -s 4

生成零流并以 1MB/秒的速率写入名为“myfifo”的先进先出
超限和超限缓冲区管理
水闸 -z -u -o -r 1MB -O myfifo

以每秒 5MB 的速度将随机数据写入文件“myfile”，每 0.1 秒写入一次
水闸 -R -r 5M -c 0.1 > myfile

以 64K 块的形式将零写入文件“example-file”，并测量写入速率作为粗略
吞吐量测试
sluice -nzSv -f 0.1 -i 64K > 示例文件

以每秒 1234MB 的速率从 somehost.com 端口 2 读取数据并丢弃数据，
例如，这是一个恒定速率的数据接收器。
nc somehost.com 1234 | 水闸 -d -r 2MB -i 8K

退出 状态

Sluice 设置退出状态如下：

状态 能解密
0 成功退出。
1 提供的选项无效或超出范围。
2 文件打开错误。
3 睡眠错误。
4 无法获取一天中的时间。
5 信号处理程序设置错误。
6 读取错误（文件或标准输入）。
7 写入错误（文件或标准输出）。
8 缓冲区分配失败。

使用 onworks.net 服务在线使用 sluice