水門 - クラウド上のオンライン

プログラム：

NAME

sluice - 指定されたレートでデータ フローを制御するツール

SYNOPSIS

水門 [オプション]

DESCRIPTION

sluice は入力を読み取り、指定されたデータ レートで出力します。 さまざまなデータレート制御機能を備えています
必要に応じて特定のユースケースに合わせて調整できるメカニズム。

OPTIONS

スルースのオプションは次のとおりです。

-a 出力をファイルに追加します (-t 'tee' または -O オプションと組み合わせて使用​​します)。
このオプションでは、新しいファイルを作成したり、既存のファイルを切り詰めたりする代わりに、
データをファイルにコピーします。

-c 遅らせる
書き込み間の一定の遅延時間 (秒単位) を有効にします。 このオプションは、
データレートを一定に保つための出力バッファサイズ。 出力バッファサイズ
このモードでは、最初はデータ レート × 遅延に設定されます。

このオプションは -i オプションと相互に排他的であり、-o オプションを暗黙的に有効にします。
動的にサイズを変更するオーバーランおよび -u アンダーランのバッファ管理オプション
データレートを一定に保つための読み取り/書き込みバッファ。 デフォルトでは、これにより調整されます
転送されるデータの総量とこれを書き込む時間に基づいてバッファーを決定します。
(-s 0 回転モードと同等)。 ただし、-s シフト値が大きい場合は、
0 より大きい場合、新しいサイズは前のサイズによって調整され、右にシフトされます。
シフト値。

-d データを破棄し、標準出力にコピーしないでください。 これにより、スルースがデータ シンクとして機能します。

-D モード
ディレイモードを選択します。 データレートをいつ実行するかについてはさまざまなアプローチがあります
遅れます。 デフォルトでは、読み取り、書き込み、最後に遅延が実行されます。
各反復。 ただし、-D オプションを使用すると、遅延モードを次のように選択できます。
以下：

モード ディレイ 戦略 ディレイ 演奏時間
0 読み取り、書き込み、遅延 (デフォルト) 1 × 遅延時間
1 遅延、読み取り、書き込み 1 × 遅延時間
2 読み取り、遅延、書き込み 1 × 遅延時間
3 遅延、読み取り、遅延、書き込み 2 × 1/2 遅延時間
4 読み出し、遅延、書き込み、遅延 2 × 1/2 遅延時間
5 遅延、読み取り、遅延、書き込み、遅延 3 × 1/3 遅延時間

モード 3 と 4 は、それぞれ遅延時間の 1/2 で構成される XNUMX つの遅延を実行することに注意してください。
モード 5 は、それぞれ 3/1 の遅延時間で構成される 3 つの遅延を実行します。

モード 1、3、5 は、合計実行の観点からは完全に正確ではないとみなされる可能性があります
間隔。 これらのモードでは、最終的なファイルの終わりの前に無関係な遅延が発生します。
空読み出しが行われます。

-e 読み取りエラーを無視します。 失敗した読み取りはゼロに置き換えられます。

-f 周波数
-v 詳細統計更新の頻度を指定します。 デフォルトは 1/4 です。
XNUMX番。 sluice は要求された頻度に近い更新を発行しようとすることに注意してください。
ただし、読み取り/書き込み速度が頻度よりも低い場合、更新が発生します。
読み取り/書き込み速度のみ。

-h ヘルプを表示

-i サイズ
読み取り/書き込みサイズをバイト単位で指定します。 K、M、G、T、P の接尾辞を使用すると、
サイズをキロバイト、メガバイト、ギガバイト、テラバイト、ペタバイトで指定します
それぞれ。 このオプションは、-c オプションとは相互に排他的です。

このモードでは、書き込み間の遅延を使用してデータ レートを制御します。 に
デフォルトでは、遅延は転送されるデータの総量と時間に基づいて決まります。
これを書くために取られました。 これは、-s 0 チューニング モードと同等です。 ただし、
-s シフト値が 0 より大きい場合、新しい遅延は前の遅延によって調整されます。
シフト値によって右にシフトされた遅延。

特殊なハイブリッド レート制御モードは、-o オーバーフローおよび -o オーバーフローを使用することによっても呼び出すことができます。
-u アンダーフロー オプションを使用すると、読み取り/書き込みバッファーの動的なサイズ変更も有効になります。 に
デフォルトでは、転送されるデータの総量に基づいてバッファが調整されます。
これを書き込む時間 (-s 0 回転モードと同等)。 ただし、-s の場合、
シフト値が 0 より大きい場合、新しいサイズは以前のサイズによって調整されます
シフト値だけ右にシフトされます。

-I file
標準入力ではなくファイルから入力を読み取ります。

-m サイズ
処理するデータの量を指定します。デフォルトのサイズはバイト単位ですが、K、M、G、T
および P 接尾辞は、キロバイト、メガバイト、ギガバイト、テラバイト、および
それぞれペタバイト。 このサイズが書き込みサイズより小さい場合、書き込み
サイズは -m サイズになるように切り捨てられます。

-n レート制御はありません。 これは、cat とすべてのデータ レートによく似た、単なるデータ コピーです。
コントロールは使用できません。 -v および -S オプションと組み合わせると、
コピーのデータ レート。

-o オーバーランを検出し、読み取り/書き込みバッファ サイズを変更して、オーバーランの停止を試みます。 これ
連続したオーバーランが検出されるたびにバッファが縮小されます。 「-s」を参照してください。
サイズ再調整機構の詳細についてはオプションをご覧ください。

-O file
出力をファイルに送信 (-dt file と同等)

-p 進捗状況 (%) と到着予定時刻 (ETA) 情報を示す詳細な統計を有効にします。 これだけが有効です
-I または -m オプションを使用し、ファイル サイズがゼロ以外の場合。 -v オプションを参照してください。
詳細はこちら

-P pidファイル
ファイル pidfile に sluice のプロセス ID を書き込みます。 ファイルは水門時に削除されます
終了します。

-r 率
データレートをバイト/秒で指定します。 K、M、G、および T の接尾辞で指定できるのは、
キロバイト/秒、メガバイト/秒、ギガバイト/秒、およびテラバイト/秒の速度
それぞれ。 このオプションは、-n オプションが指定されている場合を除き、常に指定する必要があります。
中古。

-R stdin から読み取るのではなく、/dev/urandom からランダム データを読み取ります。

-s シフト
レート調整シフトを修正します。 これは、によって使用されるデータ レート調整倍率です。
-r、-c、-o、および - オプション。

-r オプションの場合、各書き込み間の遅延は、
これによって右にシフトされた前の遅延を加算または減算して、前の遅延を計算します。
シフト値。 シフト値が大きいほど、上下に調整するのに時間がかかります。
指定されたレート。 シフト値が小さいほど、その値に到達するまでの時間が短くなります。
ただし、これにより、遅延が大幅に変動する可能性があります。
遅延が大幅に変化して大きなオーバーランが発生するため、
アンダーランします。 シフト値 3 は、ほとんどの高速レートで適切に機能します。

-c、-o、および -u オプションの場合、バッファのサイズは、または
シフト値によってシフトされた前のサイズを減算します。 再度、シフト値 3
ほとんどの高速レートでうまく機能します。

シフト値が 0 に設定されている場合、シフト率調整チューニング機構は
明示的にオフになり、データ レートはデータの合計量に基づいて調整されます。
転送され、これを書く時間になりました。

-s シフト値 1 および 2 が小さいと、データ レートの前に急速な発振が発生する可能性があります。
ダンピングが完全に作動します。 -s 0 (デフォルト) の値が推奨されるのは、
正確な低速データ転送。

-S ファイルの終わりに、さまざまなパフォーマンスとバッファリングの統計を標準エラー出力に出力します。
に達した。

-t file
指定されたファイルに出力します。 出力は標準出力と名前付きファイルの両方に書き込まれます。
ファイル。 デフォルトでは、ファイルが存在しない場合は作成され、存在する場合は再書き込みされます。
もう存在している。 既存のファイルに追加するには、-a オプションを使用します。

-T t t 秒後にスライス テストを停止します。 時間の単位を秒で指定することもできます。
分、時間、日、または年に接尾辞 s、m、h、d、または y を付けます。

-u アンダーランを検出し、読み取り/書き込みバッファ サイズを変更して、アンダーランの停止を試みます。 これ
連続したアンダーランが検出されるたびにバッファが拡張されます。 バッファー
サイズは 4MB を超えて拡張されません。 詳細については、-s オプションを参照してください。
サイズ再調整機構。

-v 詳細な統計を標準エラー出力に書き込みます。 デフォルトでは、現在のデータが表示されます。
レート、最後のデータ レート調整 (「-」 = アンダーラン、「+」 = オーバーラン)、合計バイト数
転送、期間、および現在のバッファ サイズ。

-p オプションを使用すると、進行状況の統計が表示されます。 これにより、
現在のデータ レート、転送された総バイト数、期間、これまでの完了率
完了までの推定時間も表示されます。 推定は以下を使用して利用できることに注意してください。
-I および -m オプション、およびファイル サイズがゼロ以外の場合。

-V バージョン情報を標準出力に出力し、正常に終了します。

-w 警告 連続したデータレートのアンダーランが長時間発生すると、警告が発行されます。
一度だけ。 アンダーランを克服するには、-i 読み取り/書き込みバッファー サイズを増やすか、次を使用します。
-u オプションを使用すると、読み取り/書き込みバッファーを自動拡張できます。 アンダーランが多すぎることを意味します
バッファが小さすぎるか、必要な処理を維持するのに十分な CPU が利用できない
データレート。

-z 標準入力から読み取るのではなく、代わりにゼロのストリームを生成します (読み取りと同等)
/dev/zero から)。

シグSR1 署名情報
SIGUSR1 (BSD システムでは SIGINFO) を送信すると、冗長データ レート モードが切り替わります。
オンオフ。

シグSR2
アンダーラン/オーバーラン (-u、-o) オプションのオン/オフを切り替えます。

注意事項

-i オプションも -c オプションも使用されない場合、sluice はデフォルトで書き込みバッファ サイズを使用します。
データ レートの 1/32 で、1 バイトと 64MB の制限の間にあります。 水門は試してみます
書き込み間の遅延を調整してデータレートを安定に保ちます。 これを調整するには、を参照してください。
-s オプション。

例

/dev/zero を読み取り、4MB/秒の速度で 1K サイズでファイル「example.dat」に書き込みます。
猫/dev/ゼロ | 水門 -i 4K -r 1M > example.dat

/dev/zero から 32MB を読み取り、フィードバックを使用して 64K/秒の速度で標準出力に書き込みます。
4K バッファ書き込みと 4 のチューニング シフトを使用した標準エラー出力の期間と ETA。
猫/dev/ゼロ | 水門 -r 64K -vp -m 32M -i 4K -s 4

ゼロのストリームを生成し、「myfifo」という名前の FIFO に 1MB/秒の速度で書き込みます。
アンダーランおよびオーバーランのバッファ管理
水門 -z -u -o -r 1MB -O myfifo

ランダム データを 5MB/秒でファイル「myfile」に書き込み、0.1 秒ごとに書き込みを行います
水門 -R -r 5M -c 0.1 > myfile

ファイル「example-file」に 64K チャンクでゼロを書き込み、書き込み速度を粗値として測定します。
スループットテスト
sluice -nzSv -f 0.1 -i 64K > サンプルファイル

ポート 1234 で somehost.com から 2MB/秒の速度でデータを読み取り、データを破棄します。
たとえば、これは固定レートのデータ シンクです。
nc somehost.com 1234 | 水門 -d -r 2MB -i 8K

EXIT ステータス

Sluice は終了ステータスを次のように設定します。

状況 解読
0 正常に終了しました。
1 無効なオプションまたは範囲外のオプションが指定されました。
2 ファイルオープンエラー。
3 スリープエラー。
4 時刻の取得に失敗しました。
5 シグナルハンドラーのセットアップエラー。
6 読み取りエラー (ファイルまたは標準入力)。
7 書き込みエラー (ファイルまたは標準出力)。
8 バッファ割り当てに失敗しました。

onworks.net サービスを使用してオンラインで sluice を使用する