ประตูน้ำ - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

sluice - เครื่องมือควบคุมการไหลของข้อมูลในอัตราที่กำหนด

เรื่องย่อ

ประตูน้ำ [ตัวเลือก]

DESCRIPTION

sluice อ่านอินพุตและเอาต์พุตตามอัตราข้อมูลที่ระบุ มีการควบคุมอัตราข้อมูลต่างๆ
กลไกที่ปรับแต่งได้สำหรับกรณีการใช้งานเฉพาะในกรณีที่จำเป็น

OPTIONS

ตัวเลือกบานเกล็ดมีดังนี้:

-a ต่อท้ายเอาต์พุตไปยังไฟล์ (ใช้ร่วมกับตัวเลือก -t 'tee' หรือ -O)
แทนที่จะสร้างไฟล์ใหม่หรือตัดทอนไฟล์ที่มีอยู่ ตัวเลือกนี้จะผนวก
ข้อมูลไปยังไฟล์.

-c ความล่าช้า
เปิดใช้งานเวลาหน่วงคงที่ (เป็นวินาที) ระหว่างการเขียน ตัวเลือกนี้จะปรับค่า
ขนาดบัฟเฟอร์เอาต์พุตเพื่อพยายามรักษาอัตราข้อมูลให้คงที่ ขนาดบัฟเฟอร์เอาต์พุต
ในโหมดนี้จะถูกตั้งค่าเริ่มต้นเป็นอัตราข้อมูล × ความล่าช้า

ตัวเลือกนี้ไม่มีร่วมกันกับตัวเลือก -i และเปิดใช้งาน -o . โดยปริยาย
overrun และ -u underrun ตัวเลือกการจัดการบัฟเฟอร์เพื่อปรับขนาดใหม่แบบไดนามิก
อ่าน/เขียนบัฟเฟอร์เพื่อให้อัตราข้อมูลคงที่ โดยค่าเริ่มต้น ค่านี้จะปรับค่า
บัฟเฟอร์ขึ้นอยู่กับจำนวนข้อมูลทั้งหมดที่ถ่ายโอนและเวลาในการเขียนสิ่งนี้
(เทียบเท่ากับโหมดการหมุน -s 0) อย่างไรก็ตาม หากค่าการเลื่อน -s มากกว่า
มากกว่า 0 แล้วขนาดใหม่จะถูกปรับโดยขนาดก่อนหน้าที่เลื่อนไปทางขวาโดย
ค่ากะ

-d ทิ้งข้อมูลอย่าคัดลอกไปที่ stdout ทำให้ประตูน้ำทำหน้าที่เป็นที่เก็บข้อมูล

-D โหมด
เลือกโหมดหน่วงเวลา มีหลายวิธีในการดำเนินการอัตราข้อมูล
ความล่าช้า ค่าเริ่มต้นคือดำเนินการอ่านแล้วเขียนและสุดท้ายล่าช้าสำหรับ
การวนซ้ำแต่ละครั้ง อย่างไรก็ตาม ตัวเลือก -D ช่วยให้สามารถเลือกโหมดหน่วงเวลาเป็น
ดังต่อไปนี้:

โหมด ความล่าช้า กลยุทธ์ ความล่าช้า ระยะเวลา
0 อ่าน เขียน หน่วงเวลา (ค่าเริ่มต้น) 1 × หน่วงเวลา
1 หน่วงเวลา อ่าน เขียน 1 × หน่วงเวลา
2 อ่าน หน่วงเวลา เขียน 1 × หน่วงเวลา
3 หน่วงเวลา อ่าน หน่วงเวลา เขียน 2 × 1/2 เวลาหน่วง
4 อ่าน, หน่วง, เขียน, หน่วงเวลา 2 × 1/2 หน่วงเวลา
5 หน่วงเวลา อ่าน หน่วงเวลา เขียน หน่วงเวลา 3 × 1/3 หน่วงเวลา

โปรดทราบว่าโหมด 3 และ 4 จะทำการหน่วงเวลาสองครั้ง โดยแต่ละครั้งประกอบด้วย 1/2 ของเวลาหน่วง
และโหมด 5 ทำการหน่วงเวลา 3 ครั้ง โดยแต่ละครั้งประกอบด้วย 1/3 ของเวลาหน่วง

โหมด 1, 3, 5 อาจถือว่าไม่แม่นยำในแง่ของการวิ่งทั้งหมด
ระยะเวลา. ในโหมดเหล่านี้ ความล่าช้าภายนอกจะเกิดขึ้นก่อนการสิ้นสุดไฟล์ขั้นสุดท้าย
ดำเนินการอ่านที่ว่างเปล่า

-e ละเว้นข้อผิดพลาดในการอ่าน การอ่านที่ล้มเหลวจะถูกแทนที่ด้วยศูนย์

-f ความถี่
ระบุความถี่ของการอัพเดตสถิติแบบละเอียด -v ค่าเริ่มต้นคือ 1/4 ของa
ที่สอง. โปรดทราบว่า sluice จะพยายามส่งการอัปเดตให้ใกล้เคียงกับความถี่ที่ร้องขอ
อย่างไรก็ตาม หากอัตราการอ่าน/เขียนน้อยกว่าความถี่ การอัปเดตจะเกิดขึ้น
ที่อัตราการอ่าน/เขียนเท่านั้น

-h แสดงความช่วยเหลือ

-i ขนาด
ระบุขนาดการอ่าน/เขียนเป็นไบต์ คำต่อท้าย K, M, G, T และ P อนุญาตให้หนึ่ง to
ระบุขนาดเป็นกิโลไบต์ เมกะไบต์ กิกะไบต์ เทราไบต์ และเพตะไบต์
ตามลำดับ อ็อพชันนี้ไม่เกิดร่วมกันกับอ็อพชัน -c

ในโหมดนี้ ความล่าช้าระหว่างการเขียนจะใช้เพื่อควบคุมอัตราข้อมูล โดย
ค่าเริ่มต้น การหน่วงเวลาจะขึ้นอยู่กับจำนวนข้อมูลที่ถ่ายโอนและเวลาทั้งหมด
นำมาเขียนเรื่องนี้ ซึ่งเทียบเท่ากับโหมดการปรับจูน -s 0 อย่างไรก็ตาม หาก
-s ค่า shift มากกว่า 0 ดังนั้นการหน่วงเวลาใหม่จะถูกปรับโดยค่าก่อนหน้า
เลื่อนไปทางขวาโดยเลื่อนตามค่ากะ

สามารถเรียกใช้โหมดการควบคุมอัตราไฮบริดพิเศษได้โดยใช้ -o ล้นและ
-u ตัวเลือกอันเดอร์โฟลว์เพื่อเปิดใช้งานการปรับขนาดใหม่แบบไดนามิกของบัฟเฟอร์การอ่าน/เขียน โดย
ค่าเริ่มต้นนี้จะปรับบัฟเฟอร์ตามจำนวนข้อมูลทั้งหมดที่ถ่ายโอนและ
เวลาเขียนสิ่งนี้ (เทียบเท่ากับโหมดการหมุน -s 0) อย่างไรก็ตาม ถ้า -s
ค่า shift มากกว่า 0 จากนั้นขนาดใหม่จะถูกปรับตามขนาดก่อนหน้า
เลื่อนไปทางขวาตามค่ากะ

-I ไฟล์
อ่านอินพุตจากไฟล์มากกว่าจาก stdin

-m ขนาด
ระบุจำนวนข้อมูลที่จะประมวลผล ขนาดเริ่มต้นเป็นไบต์ แต่ K, M, G, T
และส่วนต่อท้าย P สามารถระบุขนาดเป็นกิโลไบต์ เมกะไบต์ กิกะไบต์ เทราไบต์ และ
เพตาไบต์ตามลำดับ ถ้าขนาดนี้น้อยกว่าขนาดเขียน แสดงว่าเขียน
ขนาดถูกตัดให้เหลือขนาด -m

-n ไม่มีการควบคุมอัตรา นี่เป็นเพียงสำเนาข้อมูลตรง ๆ เหมือนกับ cat และ data rate ทั้งหมด
ใช้การควบคุมไม่ได้ เมื่อรวมกับตัวเลือก -v และ -S เราสามารถสังเกต
อัตราข้อมูลของสำเนา

-o ตรวจจับการโอเวอร์รันและปรับขนาดบัฟเฟอร์การอ่าน/เขียนใหม่เพื่อลองและหยุดการโอเวอร์รัน นี้
จะลดขนาดบัฟเฟอร์ทุกครั้งที่ตรวจพบการบุกรุกที่ต่อเนื่องกัน ดู -s
ตัวเลือกสำหรับรายละเอียดของกลไกการปรับขนาดใหม่

-O ไฟล์
ส่งเอาต์พุตไปยังไฟล์ เทียบเท่ากับ -dt file

-p เปิดใช้งานสถิติโดยละเอียดที่แสดง% ความคืบหน้าและข้อมูล ETA นี้เท่านั้นที่ถูกต้อง
โดยใช้ตัวเลือก -I หรือ -m และถ้าขนาดไฟล์ไม่ใช่ศูนย์ ดูตัวเลือก -v สำหรับ
รายละเอียดเพิ่มเติม.

-P ไฟล์ pid
เขียน ID กระบวนการของประตูน้ำในไฟล์ pidfile ไฟล์จะถูกลบออกเมื่อประตูน้ำ
ทางออก

-r อัตรา
ระบุอัตราข้อมูลเป็นไบต์ต่อวินาที ส่วนต่อท้าย K, M, G และ T สามารถระบุได้
อัตราในหน่วยกิโลไบต์/วินาที เมกะไบต์/วินาที กิกะไบต์/วินาที และเทราไบต์/วินาที
ตามลำดับ ต้องระบุตัวเลือกนี้เสมอ ยกเว้นเมื่อตัวเลือก -n เป็น
มือสอง

-R อย่าอ่านจาก stdin ให้อ่านข้อมูลแบบสุ่มจาก /dev/urandom แทน

-s เปลี่ยน
แก้ไขการเปลี่ยนแปลงการปรับอัตรา นี่คือปัจจัยการปรับอัตราข้อมูลที่ใช้โดย
ตัวเลือก -r, -c, -o และ -

สำหรับตัวเลือก -r การหน่วงเวลาระหว่างการเขียนแต่ละครั้งจะถูกควบคุมโดยการแก้ไข
การหน่วงเวลาก่อนหน้าโดยการเพิ่มหรือลบการหน่วงเวลาก่อนหน้านี้ ถูกเลื่อนโดยสิ่งนี้
ค่ากะ ยิ่งค่า shift มากเท่าไหร่ ก็ยิ่งใช้เวลาในการปรับขึ้น/ลงเป็น . นานขึ้น
อัตราที่ระบุ ยิ่งค่า shift น้อยเท่าไหร่ก็จะยิ่งไปถึง .เร็วขึ้นเท่านั้น
อย่างไรก็ตาม ความล่าช้าที่เหมาะสมที่สุดอาจส่งผลให้อัตราผันผวนสูงที่
เริ่มต้นเพราะความล่าช้าแปรผันตามปริมาณมากทำให้เกิดการล้นเกินและ
อันเดอร์รัน ค่ากะ 3 ทำงานได้ดีสำหรับอัตราที่รวดเร็วที่สุด

สำหรับตัวเลือก -c, -o และ -u ขนาดของบัฟเฟอร์จะถูกแก้ไขโดยการเพิ่มหรือ
การลบขนาดก่อนหน้าที่เลื่อนออกไปโดยค่ากะ อีกครั้ง ค่ากะ 3
ทำงานได้ดีสำหรับอัตราที่รวดเร็วที่สุด

หากค่ากะถูกตั้งค่าเป็น 0 แสดงว่ากลไกการปรับแต่งการปรับอัตรากะคือ
ปิดไว้อย่างชัดเจนและปรับอัตราข้อมูลตามจำนวนข้อมูลทั้งหมด
โอนและเวลาในการเขียนนี้.

ค่าการเลื่อนขนาดเล็กของ 1 และ 2 อาจทำให้เกิดการสั่นอย่างรวดเร็วก่อนอัตราข้อมูล
การทำให้หมาด ๆ เริ่มทำงานอย่างเต็มที่ แนะนำให้ใช้ค่า -s 0 (ค่าเริ่มต้น) สำหรับ
การถ่ายโอนข้อมูลความเร็วต่ำที่แม่นยำ

-S พิมพ์สถิติประสิทธิภาพและบัฟเฟอร์ต่างๆ ไปยัง stderr เมื่อสิ้นสุดไฟล์
ถึงแล้ว

-t ไฟล์
ทีเอาต์พุตไปยังไฟล์ที่ระบุ เอาต์พุตถูกเขียนทั้ง stdout และชื่อ
ไฟล์. โดยค่าเริ่มต้น ไฟล์จะถูกสร้างขึ้นหากไม่มีอยู่หรือเขียนใหม่หากไฟล์นั้น
มีอยู่แล้ว. ใช้ตัวเลือก -a เพื่อต่อท้ายไฟล์ที่มีอยู่

-T t หยุดการทดสอบสไลซ์หลังจาก t วินาที หนึ่งยังสามารถระบุหน่วยของเวลาเป็นวินาที
นาที ชั่วโมง วัน หรือปี ต่อท้าย s, m, h, d หรือ y

-u ตรวจจับอันเดอร์รันและปรับขนาดบัฟเฟอร์การอ่าน/เขียนใหม่เพื่อลองและหยุดอันเดอร์รัน นี้
จะขยายบัฟเฟอร์ทุกครั้งที่ตรวจพบอันเดอร์รันต่อเนื่องกัน บัฟเฟอร์
จะไม่ขยายขนาดเกิน 4MB ดูตัวเลือก -s สำหรับรายละเอียดของ
กลไกการปรับขนาดใหม่

-v เขียนสถิติอย่างละเอียดเพื่อ stderr โดยค่าเริ่มต้น สิ่งนี้จะแสดงข้อมูลปัจจุบัน
อัตรา, การปรับอัตราข้อมูลล่าสุด ('-' = อันเดอร์รัน, '+' = โอเวอร์รัน), ไบต์ทั้งหมด
โอน ระยะเวลา และขนาดบัฟเฟอร์ปัจจุบัน

ด้วยตัวเลือก -p สถิติความคืบหน้าจะแสดงขึ้น นี้จะแสดง
อัตราข้อมูลปัจจุบัน จำนวนไบต์ทั้งหมดที่ถ่ายโอน ระยะเวลา เปอร์เซ็นต์ที่เสร็จสมบูรณ์จนถึงตอนนี้
และระยะเวลาที่คาดว่าจะแล้วเสร็จ โปรดทราบว่าการประมาณค่าสามารถใช้ได้โดยใช้
ตัวเลือก -I และ -m และหากขนาดไฟล์ไม่เป็นศูนย์

-V พิมพ์ข้อมูลเวอร์ชันไปยังมาตรฐานออกและออกได้สำเร็จ

-w เตือนหากมีการแตกอัตราข้อมูลต่อเนื่องเป็นเวลานานจะมีการออกคำเตือน
เพียงครั้งเดียว. หากต้องการเอาชนะอันเดอร์รัน ให้เพิ่มขนาดบัฟเฟอร์การอ่าน/เขียน -i หรือใช้
ตัวเลือก -u เพื่อขยายบัฟเฟอร์การอ่าน/เขียนโดยอัตโนมัติ มีอันเดอร์รันมากเกินไปหมายความว่า
มีบัฟเฟอร์น้อยเกินไปหรือ CPU ไม่เพียงพอเพื่อให้ทันกับความต้องการ
อัตราข้อมูล

-z อย่าอ่านจาก stdin แต่สร้างกระแสของศูนย์แทน (เทียบเท่ากับการอ่าน
จาก /dev/zero)

ซิกุสร์1 ซิกอินโฟ
การส่ง SIGUSR1 (หรือ SIGINFO บนระบบ BSD) จะสลับโหมดอัตราข้อมูลแบบละเอียด
เปิดปิด.

ซิกุสร์2
สลับเปิด/ปิดตัวเลือก underrun/overrun (-u, -o)

หมายเหตุ

หากไม่มีการใช้ตัวเลือก -i หรือ -c ดังนั้น sluice จะใช้ค่าเริ่มต้นเป็นขนาดบัฟเฟอร์การเขียนของ
1/32 ของอัตราข้อมูลและอยู่ระหว่างขีดจำกัด 1 ไบต์และ 64MB น้ำจิ้มจะพยายาม
เพื่อให้อัตราข้อมูลคงที่โดยการปรับการหน่วงเวลาระหว่างการเขียน หากต้องการปรับแต่ง โปรดดูที่
-s ตัวเลือก

ตัวอย่าง

อ่าน /dev/zero และเขียนขนาด 4K ที่อัตรา 1MB/วินาทีไปยังไฟล์ 'example.dat'
cat /dev/zero | ประตูน้ำ -i 4K -r 1M > example.dat

อ่าน 32MB จาก /dev/zero และเขียนที่อัตรา 64K/วินาทีไปยัง stdout พร้อมคำติชมเกี่ยวกับ
ระยะเวลาและ ETA บน stderr โดยใช้การเขียนบัฟเฟอร์ 4K และการปรับกะ 4
cat /dev/zero | ประตูน้ำ -r 64K -vp -m 32M -i 4K -s 4

สร้างกระแสของศูนย์และเขียนในอัตรา 1MB/วินาทีไปยัง fifo ชื่อ 'myfifo' ด้วย
underrun และ overrun การจัดการบัฟเฟอร์
ประตูน้ำ -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 > ตัวอย่างไฟล์

อ่านข้อมูลจาก somehost.com บนพอร์ต 1234 ในอัตรา 2MB ต่อวินาที แล้วทิ้งข้อมูล
เช่นนี่คือซิงก์ข้อมูลอัตราคงที่
nc somehost.com 1234 | ประตูน้ำ -d -r 2MB -i 8K

EXIT สถานภาพ

Sluice กำหนดสถานะการออกดังนี้:

Status decription
0 ออกได้สำเร็จ
1 ระบุตัวเลือกที่ไม่ถูกต้องหรืออยู่นอกช่วง
2 ข้อผิดพลาดในการเปิดไฟล์
3 ข้อผิดพลาดในการนอนหลับ
4 ไม่สามารถรับเวลาของวัน
5 ข้อผิดพลาดในการตั้งค่าตัวจัดการสัญญาณ
6 ข้อผิดพลาดในการอ่าน (ไฟล์หรือ stdin)
7 เขียนผิดพลาด (ไฟล์หรือ stdout)
8 การจัดสรรบัฟเฟอร์ล้มเหลว

ใช้ประตูน้ำออนไลน์โดยใช้บริการ onworks.net