-h, --help

نمایش راهنما و خروج

-V, --version

نمایش نسخه و خروج

-v, --verbose

افزایش سطح جزئیات گزارش (می‌تواند چندین بار استفاده شود)

-L, --list-supported

فهرست کردن طرح‌واره‌ها (schemes) و قالب‌های پشتیبانی‌شده

-i,--input=IO_URI

نشانی URI فایل یا دستگاه ورودی

--input-format=FILE_FORMAT

اجبار قالب فایل ورودی

-s,--source=ENDPOINT_URI

نقطه پایانی (endpoint) منبع دوردست

-r,--repair=ENDPOINT_URI

نقطه پایانی ترمیم دوردست

-c,--control=ENDPOINT_URI

نقطه پایانی کنترل دوردست

--reuseaddr

فعال‌سازی SO_REUSEADDR هنگام اتصال (bind) سوکت‌ها

--target-latency=STRING

تأخیر هدف، در واحدهای زمانی TIME

--io-latency=STRING

تأخیر هدف ضبط، در واحدهای زمانی TIME

--latency-tolerance=STRING

حداکثر انحراف مجاز از تأخیر هدف، در واحدهای زمانی TIME

--nbsrc=INT

تعداد بسته‌های منبع در بلوک FEC

--nbrpr=INT

تعداد بسته‌های ترمیم در بلوک FEC

--packet-len=STRING

طول بستهٔ خروجی، در واحدهای زمانی TIME

--frame-len=TIME

مدت زمان فریم‌های داخلی، در واحدهای زمانی TIME

--max-packet-size=SIZE

حداکثر اندازهٔ بسته، در واحدهای SIZE

--max-frame-size=SIZE

حداکثر اندازهٔ فریم داخلی، در واحدهای SIZE

--rate=INT

بازنویسی نرخ نمونه‌برداری ورودی، به هرتز (Hz)

--latency-backend=ENUM

تعیین اینکه کدام تأخیر در تنظیم‌کنندهٔ تأخیر استفاده شود (مقادیر ممکن="niq"، پیش‌فرض=`niq')

--latency-profile=ENUM

نمایهٔ تنظیم تأخیر (مقادیر ممکن="responsive"، "gradual"، "intact"، پیش‌فرض=`intact')

--resampler-backend=ENUM

پشتانهٔ بازنمونه‌بردار (مقادیر ممکن="default"، "builtin"، "speex"، "speexdec"، پیش‌فرض=`default')

--resampler-profile=ENUM

نمایهٔ بازنمونه‌بردار (مقادیر ممکن="low"، "medium"، "high"، پیش‌فرض=`medium')

--interleaving

فعال‌سازی درهم‌بافی (interleaving) بسته‌ها (پیش‌فرض=خاموش)

--profiling

فعال‌سازی پروفایل‌بندی درونی (پیش‌فرض=خاموش)

--color=ENUM

تنظیم حالت گزارش رنگی برای خروجی stderr (مقادیر ممکن="auto"، "always"، "never"، پیش‌فرض=`auto')

گزینه‌های --source، --repair و --control نقاط پایانی شبکه‌ای را تعیین می‌کنند که ترافیک باید به آن‌ها ارسال شود.

مقدار ENDPOINT_URI باید ساختاری به شکل زیر داشته باشد:

protocol://host[:port][/path][?query]

مثال‌ها:

فهرست پروتکل‌های پشتیبانی‌شده را می‌توان با استفاده از گزینهٔ --list-supported دریافت کرد.

فیلد host باید یک FQDN (نام دامنه کامل)، نشانی IPv4، یا نشانی IPv6 درون قلاب‌ها (کروشه‌ها) باشد.

اگر پروتکل درگاه پیش‌فرضی را تعریف کرده باشد، فیلد port می‌تواند حذف شود؛ در غیر این صورت، الزامی است.

فیلدهای path و query تنها برای پروتکل‌هایی مجاز هستند که از آن‌ها پشتیبانی می‌کنند؛ برای نمونه RTSP.

اگر FEC فعال باشد، باید یک جفت نقطه پایانی مبدا (source) و تصحیح (repair) مشخص شود. این دو نقطه پایانی باید از پروتکل‌های سازگار استفاده کنند؛ برای مثال rtp+rs8m:// برای نقطه پایانی مبدا، و rs8m:// برای نقطه پایانی تصحیح. اگر FEC غیرفعال باشد، باید تنها یک نقطه پایانی مبدا ارائه شود.

پروتکل‌های مبدا و تصحیح پشتیبانی‌شده:

علاوه بر این، پیشنهاد می‌شود که یک نقطه پایانی کنترلی مشخص شود. این نقطه برای تبادل داده‌های غیررسانه‌ای جهت شناسایی نشست، انتقال بازخورد و غیره به کار می‌رود. اگر هیچ نقطه پایانی کنترلی ارائه نشود، نشست در حالت تقلیل‌یافتهٔ جایگزین (fallback) کار می‌کند که ممکن است پایداری کمتری داشته باشد و از همهٔ قابلیت‌ها پشتیبانی نکند.

پروتکل‌های کنترلی پشتیبانی‌شده:

• DEVICE_TYPE://DEVICE_NAME -- دستگاه صوتی
• DEVICE_TYPE://default -- دستگاه صوتی پیش‌فرض برای نوع دستگاه مشخص‌شده
• file:///ABS/PATH -- مسیر مطلق فایل
• file://localhost/ABS/PATH -- مسیر مطلق فایل (حالت جایگزین؛ تنها میزبان "localhost" پشتیبانی می‌شود)
• file:/ABS/PATH -- مسیر مطلق فایل (حالت جایگزین)
• file:REL/PATH -- مسیر نسبی فایل
• file://- -- ورودی استاندارد (stdin)
• file:- -- ورودی استاندارد (stdin) (حالت جایگزین)

• pulse://default
• pulse://alsa_input.pci-0000_00_1f.3.analog-stereo
• alsa://hw:1,0
• file:///home/user/test.wav
• file://localhost/home/user/test.wav
• file:/home/user/test.wav
• file:./test.wav
• file:-

TIME باید یکی از قالب‌های زیر را داشته باشد:

123ns; 1.23us; 1.23ms; 1.23s; 1.23m; 1.23h;

SIZE باید یکی از قالب‌های زیر را داشته باشد:

123; 1.23K; 1.23M; 1.23G;

$ roc-send -vv \
    -i file:./input.wav \
    -s rtp+rs8m://192.168.0.3:10001 -r rs8m://192.168.0.3:10002 \
        -c rtcp://192.168.0.3:10003 \
    -s rtp+rs8m://198.214.0.7:10001 -r rs8m://198.214.0.7:10002 \
        -c rtcp://198.214.0.7:10003

ضبط صدا از دستگاه پیش‌فرض (حذف -i):

$ roc-send -vv -s rtp://192.168.0.3:10001

ضبط صدا از دستگاه پیش‌فرض ALSA:

$ roc-send -vv -s rtp://192.168.0.3:10001 -i alsa://default

ضبط صدا از یک دستگاه مشخص PulseAudio:

$ roc-send -vv -s rtp://192.168.0.3:10001 -i pulse://alsa_input.pci-0000_00_1f.3.analog-stereo

ارسال فایل WAV (تشخیص قالب بر اساس پسوند):

$ roc-send -vv -s rtp://192.168.0.3:10001 -i file:./input.wav

ارسال فایل WAV (تعیین دستی قالب):

$ roc-send -vv -s rtp://192.168.0.3:10001 -i file:./input.file --input-format wav

ارسال WAV از stdin:

$ roc-send -vv -s rtp://192.168.0.3:10001 -i file:- --input-format wav <./input.wav

ارسال فایل WAV (تعیین مسیر مطلق):

$ roc-send -vv -s rtp://192.168.0.3:10001 -i file:///home/user/input.wav

$ roc-send -vv -s rtp://192.168.0.3:10001 --rate=44100

$ roc-send -vv -i file:./input.wav -s rtp+ldpc://192.168.0.3:10001 \
    -r ldpc://192.168.0.3:10002 -c ldpc://192.168.0.3:10003 \
    --nbsrc=1000 --nbrpr=500

$ roc-send -vv -i file:./input.wav -s rtp+ldpc://192.168.0.3:10001 \
    --packet-len 2500us

$ roc-send -vv -s rtp://192.168.0.3:10001 \
    --io-latency=20ms --frame-len 4ms

$ roc-send -vv -s rtp://192.168.0.3:10001 \
    --resampler-backend=speex --resampler-profile=high

$ roc-recv -vv -o pulse://default -s rtp+rs8m://0.0.0.0:10001 \
    -r rs8m://0.0.0.0:10002 -c rtcp://0.0.0.0:10003 \
    --latency-profile=intact --target-latency=200ms
$ roc-send -vv -i file:./input.wav -s rtp+rs8m://192.168.0.3:10001 \
    -r rs8m://192.168.0.3:10002 -c rtcp://192.168.0.3:10003 \
    --latency-profile=gradual --target-latency=200ms