CDDA2WAV(1) General Commands Manual CDDA2WAV(1)

cdda2wav - استخراج داده‌های صوتی سی‌دی در پرونده‌های صوتی با اعتبارسنجی مضاعف داده‌ها

cdda2wav [ options ][ dev=device ] [file(s) or directories]

cdda2wav می‌تواند قطعات صوتی را از درایوهای CDROM که قادر به خواندن داده‌های صوتی به صورت دیجیتال از طریق SCSI هستند (CDDA) استخراج کند.

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

از آنجا که cdda2wav ممکن است برای نوشتن داده‌های صوتی در خروجی استاندارد هدایت شود، به طور پیش‌فرض تمام خروجی‌های اطلاعاتی خود را در خطای استاندارد (stderr) می‌نویسد. گزینه out-fd=descriptor در زیر را ببینید.

Cdda2wav به طور پیش‌فرض اولین قطعه صوتی را از دیسک می‌خواند و سطح پرگویی (verbose) پیش‌فرض روی -vtoc,summary,sectors,titles تنظیم شده است و cdda2wav به طور پیش‌فرض پرونده‌های *.inf را می‌نویسد. برای استخراج تمام قطعات صوتی همراه با اعتبارسنجی کیفیت، توصیه می‌شود دستور زیر اجرا شود:

cdda2wav -vall cddb=0 speed=4 -paranoia paraopts=proof -B

برای راهنمایی در مورد نحوه تعیین دستی پارامترهای بهتر، به توضیحات paraopts= در زیر مراجعه کنید.

بیشتر کاربران نیازی به نگرانی در مورد نام‌گذاری دستگاه ندارند. اگر گزینه dev= مشخص نشده باشد، cdda2wav از قابلیت هدف خودکار (auto target) پشتیبانی کرده و هنگامی که دقیقاً یک درایو از نوع CD-ROM در سیستم موجود باشد، به طور خودکار درایو را پیدا می‌کند. هنگامی که بیش از یک درایو از نوع CD-ROM وجود داشته باشد، فهرستی از پارامترهای نام دستگاه ممکن است با دستور cdda2wav -scanbus یا از مثال هدف در خروجی cdda2wav dev=help به دست آید، سپس پارامتر dev= می‌تواند بر اساس فهرست دستگاه‌ها تنظیم شود.

پارامتر device در گزینه dev= که در زیر توضیح داده شده است، به نماد استاندارد SCSI CAM برای scsibus/target/lun دستگاه CD/DVD/BluRay-Recorder اشاره دارد. اگر پرونده etc/default/cdrecord/ وجود داشته باشد، پارامتر گزینه dev= می‌تواند یک برچسب نام درایو در پرونده مذکور نیز باشد (بخش FILES را ببینید).

نمایش اطلاعات نسخه cdda2wav در خروجی استاندارد.
نمایش اطلاعات نسخه و حق نشر (Copyright).

نرخ نمونه‌برداری را روی 44100Hz / divider تنظیم می‌کند. مقادیر ممکن با گزینه -R فهرست شده‌اند.

مقدار پیش‌فرض مقسم ۱ است.

هر قطعه را در یک پرونده مجزا کپی می‌کند.

حالت پیش‌فرض، عدم استخراج همه قطعات است.

تعداد بیت‌ها به ازای هر نمونه در هر کانال را تعیین می‌کند: 8، 12 یا 16.

مقدار پیش‌فرض ۱۶ بیت به ازای هر نمونه است.

تنظیم کانال‌ها:
1
برای ضبط مونو (تک‌کاناله)
2
برای ضبط استریو (دوکاناله)
برای ضبط استریو با جابه‌جایی هر دو کانال

حالت پیش‌فرض ضبط استریو است.

ترتیب بایت (endianness) نمونه‌های ورودی را برای لغو پیش‌فرض‌ها روی 'little'، 'big'، 'machine' یا 'guess' تنظیم می‌کند. مقدار 'machine' یا 'host' به عنوان ترتیب بایت واقعی پردازنده میزبان در سیستم‌عامل جاری ارزیابی می‌شود.

حالت پیش‌فرض، تشخیص خودکار ترتیب بایت سی‌دی‌رام است.

یک پرونده CUE سازگار با CDRWIN ایجاد می‌کند. یک پرونده CUE که به طور کامل از مستندات CDRWIN پیروی می‌کند، تنها در صورتی می‌تواند برای ایجاد کپی‌های ۱:۱ استفاده شود که یک پرونده داده صوتی واحد برای کل دیسک وجود داشته باشد. قالب پرونده inf.* قابلیت‌های بیشتری از سی‌دی صوتی را نسبت به قالب CUE برنامه CDRWIN پیاده‌سازی می‌کند و امکان ایجاد کپی‌های ۱:۱ را در حالتی که برای هر قطعه یک پرونده داده صوتی وجود دارد، فراهم می‌سازد. تنها در صورتی از قالب پرونده CUE برای فراداده استفاده کنید که واقعاً به این قالب نیاز داشته باشید.

برای اینکه به cdda2wav اجازه ایجاد پرونده‌های CUE را بدهید، باید همچنین -t all را مشخص کنید تا cdda2wav به حالتی برود که یک پرونده داده صوتی واحد برای کل سی‌دی تولید کند.

اثر تأکید اولیه (pre-emphasis) را در نمونه‌های ورودی خنثی و لغو می‌کند.

حالت پیش‌فرض این است که داده‌های صوتی در همان وضعیت روی دیسک نگه‌داشته شوند و وضعیت تأکید اولیه در پرونده‌های *.inf مشخص گردد.

جستجوی عنوان آلبوم و قطعه را بر اساس شناسه cddb در پایگاه cddbp انجام می‌دهد. پارامتر cddb mode تعیین می‌کند که ورودی‌های چندگانه چگونه پردازش شوند.
پارامتر توضیحات
-1 غیرفعال کردن پرس‌وجوهای cddb. این حالت پیش‌فرض است.
0 حالت تعاملی. کاربر ورودی مورد استفاده را انتخاب می‌کند.
1 حالت اولین تطابق. اولین ورودی بدون قید و شرط انتخاب می‌شود.
کارگزاری را که باید برای جستجوی عنوان‌ها با آن ارتباط برقرار شود تعیین می‌کند.
شماره پورتی را که باید برای جستجوی عناوین استفاده شود تعیین می‌کند.
مدت‌زمان ضبط را بر حسب ثانیه یا فریم (سکتور) تنظیم می‌کند. فریم‌ها با پسوند 'f' مشخص می‌شوند (به عنوان مثال 75f برای ۷۵ سکتور). 0 زمان را برای کل قطعه تنظیم می‌کند.

حالت پیش‌فرض استخراج کل قطعه است.

ترتیب بایت (endianness) نمونه‌های خروجی را روی 'little'، 'big' یا 'machine' تنظیم می‌کند تا پیش‌فرض را که 'ترتیب بایت شبکه' (big endian) است لغو نماید. مقدار 'machine' یا 'host' به عنوان ترتیب بایت واقعی پردازنده میزبان در سیستم‌عامل جاری ارزیابی می‌شود.
دامنه‌های بیشینه و کمینه (حدی) را در نمونه‌ها پیدا می‌کند.
تشخیص می‌دهد که آیا نمونه‌های ورودی مونو هستند یا خیر.
قالب‌بندی خروجی را برای تجزیه توسط واسط‌های گرافیکی بازآرایی می‌کند.
پرونده‌های info، cddb یا cdtext را ایجاد نمی‌کند.
نمایه (اندیس) شروع را انتخاب می‌کند.
در پرونده‌ای نمی‌نویسد، فقط اطلاعاتی درباره دیسک ارائه می‌دهد.
محاسبه چکسام MD-5 را برای تمام بایت‌های صوتی از ابتدای یک قطعه فعال می‌کند. سرآیند صوتی هنگام محاسبه چکسام MD-5 نادیده گرفته می‌شود تا امکان مقایسه مقادیر MD-5 برای پرونده‌هایی با انواع سرآیند متفاوت فراهم باشد.
حالت ضبط را روی مونو تنظیم می‌کند.
قطعات پنهان روی سی‌دی را نادیده می‌گیرد. به طور پیش‌فرض، cdda2wav بررسی می‌کند که آیا ممکن است یک قطعه پنهان قبل از قطعه ۱ وجود داشته باشد یا خیر. این بررسی ممکن است چند ثانیه طول بکشد و بنابراین می‌توان با گزینه -no-hidden-track آن را غیرفعال کرد.
در پرونده نمی‌نویسد، فقط می‌خواند (مثلاً برای مقاصد اشکال‌زدایی). اگر این گزینه همراه با گزینه -e استفاده شود، سی‌دی خوانده شده و محتوای صوتی بدون ایجاد پرونده‌های خروجی حاوی داده‌های صوتی، در دستگاه صوتی پخش می‌شود.
به طور پیش‌فرض، cdda2wav فیلدهای خالی CD-Text قطعات را با فیلد CD-Text مربوطه (در صورت تعریف) برای کل سی‌دی جایگزین می‌کند. اگر از گزینه -no-textdefaults استفاده شود، cdda2wav در چنین مواردی فیلدهای CD-Text مربوط به قطعه را خالی می‌گذارد.
اگر cdda2wav با اطلاعات مفید CD-Text روی سی‌دی مواجه شود، یک پرونده cdtext. می‌نویسد. گزینه -no-textfile امکان جلوگیری از ایجاد پرونده cdtext. را فراهم می‌سازد.
خواندن را با آفست مشخص‌شده به میزان offset سکتور بعد از قطعه شروع آغاز می‌کند (هر سکتور معادل ۱/۷۵ ثانیه است).
می‌تواند شامل wav (برای پرونده‌های wav) یا aiff (برای پرونده‌های aiff اپل/اس‌جی‌آی) یا aifc (برای پرونده‌های aifc اپل/اس‌جی‌آی) یا au یا sun (برای پرونده‌های سان au PCM.) یا cdr یا raw (برای پرونده‌های بدون سرآیند جهت استفاده در رایترهای سی‌دی) باشد.

قالب خروجی پیش‌فرض اکنون برای تمام پلتفرم‌ها wav است، زیرا به رایج‌ترین قالب تبدیل شده است. توجه داشته باشید که نسخه‌های قبلی cdda2wav استثنا قائل می‌شدند و در سولاریس به طور پیش‌فرض پرونده‌هایی از نوع au ایجاد می‌کردند.

گام صدای داده‌های صوتی کپی‌شده به دستگاه صدا را تغییر می‌دهد.
تعداد اولیه سکتورهای همپوشانی sectors را برای تصحیح لرزش (jitter) در حالت غیر پارانویا تنظیم می‌کند. توجه داشته باشید که خواندن‌های همپوشان در حالت پارانویا به گونه‌ای متفاوت مدیریت می‌شوند.

میزان همپوشانی پیش‌فرض در حالت غیر پارانویا برابر با ۱ است.

از کتابخانه paranoia به عنوان فیلتری بر روی روتین‌های خواندن cdda2wav استفاده می‌کند. در حالت paranoia زمان تأخیر برای حالت -interactive و با اندازه بافر پیش‌خوانی ۱۵۰ تا ۳۰۰ سکتور، معمولاً به ۵ تا ۱۰ ثانیه افزایش می‌یابد. این امر به دلیل خواندن حداقل دو بار توسط کد paranoia و لزوم تخلیه حافظه نهان درایو CD-ROM رخ می‌دهد.

اندازه ناحیه پیش‌خوانی باید بزرگ‌تر از اندازه RAM درایو باشد تا به libparanoia اجازه دهد حافظه نهان درایو را تخلیه کند. از آنجا که اندازه ناحیه پیش‌خوانی در گذشته یک مقدار ثابت کامپایل‌شده درون کد libparanoia بود، کیفیت استخراج با استفاده از libparanoia در درایوهای ساخته شده پس از سال ۲۰۰۰ دیگر کافی نبود. به پارامتر readahead= در گزینه paraopts= در زیر مراجعه کنید.

اگر حالت paranoia استفاده شود، cdda2wav برخی از آمارهای کیفیت را برای هر قطعه استخراج‌شده نمایش می‌دهد. موارد زیر در فهرست ظاهر می‌شوند:

مقدار توضیحات
rderr تعداد خطاهای سخت‌افزاری خواندن
skip تعداد سکتورهای رد شده به دلیل اتمام دفعات تلاش مجدد
atom تعداد لرزش‌های درون‌سکتوری (لرزش فریم) شناسایی‌شده
edge تعداد لرزش‌های بین سکتورها شناسایی‌شده
drop تعداد بایت‌های افتاده تصحیح‌شده
dup تعداد بایت‌های تکراری تصحیح‌شده
drift تعداد انحراف‌های (drift) شناسایی‌شده
c2 تعداد سکتورهای دارای خطاهای C2
reads تعداد بلوک‌های پیش‌خوانی خوانده‌شده و درصد نسبت به اندازه قطعه
overlap تعداد دفعات افزایش اندازه پویای همپوشانی

شاخص‌های کیفیت با جزئیات:

تعداد درخواست‌های ناموفق سطح پایین برای خواندن. هر خواندن برای sectors-per-request سکتور انجام می‌شود. اندازه sectors-per-request معمولاً کمتر از اندازه بافر پیش‌خوانی است.
تعداد سکتورهایی که رد شده‌اند زیرا تعداد دفعات تلاش مجدد برای خواندن به پایان رسیده و هیچ خواندن موفقی امکان‌پذیر نبوده است.
تعداد لرزش‌هایی که در داخل سکتورها شناسایی شده‌اند. این حالت هرگز نباید رخ دهد، اما هر زمان که یک خطای غیرقابل تصحیح C2 رخ دهد، درایو ممکن است همگام‌سازی جریان داده را از دست بدهد. افزایش اندازه بافر پیش‌خوانی ممکن است نتایج خطاهای atom را کاهش دهد.
تعداد لرزش‌هایی که در لبه‌های سکتورها شناسایی شده‌اند. این مشکل می‌تواند ناشی از خطاهای موقعیت‌یابی سکتور باشد. افزایش اندازه بافر پیش‌خوانی ممکن است نتایج خطاهای edge را کاهش دهد.
تعداد نمونه‌های افتاده (از دست رفته). این مشکل می‌تواند ناشی از خطاهای موقعیت‌یابی سکتور باشد. افزایش اندازه بافر پیش‌خوانی ممکن است نتایج خطاهای edge را کاهش دهد.
نمونه‌های تکراری، که می‌توانند مانند نمونه‌های افتاده بر اثر خطاهای موقعیت‌یابی سکتور رخ دهند. افزایش اندازه بافر پیش‌خوانی ممکن است نتایج خطاهای edge را کاهش دهد.
این مقدار میزان انحراف‌های شناسایی‌شده هنگام بررسی ناحیه همپوشانی است.
تعداد سکتورهای دارای خطای C2 که هنگام خواندن آخرین قطعه مشاهده شده است. از آنجا که کد پارانویا تمایل دارد قسمت‌های خراب دیسک را چندین بار بخواند، این تعداد معمولاً بیشتر از مقداری است که در صورت خواندن دیسک به صورت خطی و یک‌باره نمایش داده می‌شد. از paraopts=disable,c2check برای مشاهده مقداری که نمایانگر وضعیت واقعی دیسک است استفاده کنید.
تعداد بلوک‌های پیش‌خوانی خوانده‌شده برای آخرین قطعه توسط لایه بالاتر و درصد مقدار داده خوانده‌شده در مقایسه با اندازه قطعه. این درصد معمولاً ۲۰۰٪ است زیرا کد پارانویا تمام داده‌ها را حداقل دو بار می‌خواند. اگر همپوشانی و مشکلات خواندن زیادی وجود داشته باشد، این درصد افزایش می‌یابد.
تعداد دفعاتی که اندازه همپوشانی افزایش یافته است. این اتفاق زمانی رخ می‌دهد که اندازه همپوشانی کمتر از حداکثر اندازه همپوشانی باشد و خطاهایی در ناحیه همپوشانی شناسایی شوند.
پارامتر List فهرستی از گزینه‌های فرعی جداشده با کاما است که به کتابخانه paranoia منتقل می‌شوند.
گزینه توضیحات
help فهرست کردن تمام گزینه‌های paranoia
disable غیرفعال کردن حالت paranoia؛ Libparanoia همچنان استفاده می‌شود
no-verify خاموش کردن اعتبارسنجی و روشن کردن همپوشانی ایستا
retries=amount تنظیم حداکثر تعداد تلاش مجدد به ازای هر سکتور
readahead=amount تنظیم تعداد سکتورها برای بافر پیش‌خوانی
overlap=amount تنظیم تعداد سکتورها برای همپوشانی ایستا
minoverlap=amt تنظیم حداقل تعداد سکتورها برای همپوشانی پویا
maxoverlap=amt تنظیم حداکثر تعداد سکتورها برای همپوشانی پویا
c2check بررسی اشاره‌گرهای C2 از درایو برای سنجش کیفیت
proof تنظیم minoverlap=20,retries=200,readahead=600,c2check

پارامترهای paraopts= با جزئیات:

تصحیحات paranoia غیرفعال می‌شوند، اما داده‌ها همچنان از میان کدهای libparanoia هدایت می‌گردند. این گزینه امکان فعال‌سازی تشخیص خطای C2 و بررسی آمار خطاهای C2 را برای یک سی‌دی فراهم می‌سازد.
این گزینه اعتبارسنجی یکپارچگی داده‌ها را در ناحیه همپوشانی خاموش می‌کند و کنترل پویای همپوشانی را به نفع یک مقدار همپوشانی ایستا غیرفعال می‌سازد.
حداکثر تعداد دفعات تلاش مجدد برای خواندن به ازای هر سکتور را در صورت بروز خطاهای سخت‌افزاری تعیین می‌کند. مقدار پیش‌فرض برای این پارامتر 20 است. این همان مقداری است که توسط دستور قدیمی cdparanoia(1) استفاده می‌شد.
تعداد سکتورهای مورد استفاده برای بافر پیش‌خوانی را تعیین می‌کند. به جز در انتهای دیسک، libparanoia هرگز کمتر از این مقدار داده را از کد I/O سطح پایین درخواست نمی‌کند. اندازه بافر پیش‌خوانی معمولاً بزرگ‌تر از حداکثر اندازه برای یک DMA منفرد در سیستم است. به همین دلیل، libparanoia چندین عملیات خواندن را برای پر کردن بافر پیش‌خوانی فراخوانی می‌کند. مقدار پیش‌فرض مورد استفاده توسط cdda2wav برابر با ۴۰۰ است که بیشتر از ۱۵۰ سکتور مورد استفاده cdparanoia(1) بوده اما همچنان یک مصالحه برای عدم نیاز به حافظه بیش از حد است.

توصیه می‌شود از اندازه بافر پیش‌خوانی استفاده کنید که کمتر از اندازه RAM در درایو CD-ROM نباشد. اگر درایو بیش از ۱ مگابایت RAM دارد، به ازای هر مگابایت RAM در درایو، از ۴۲۵ سکتور استفاده کنید.

توجه داشته باشید تا زمانی که مقدار readahead= خیلی کوچک باشد، کیفیت استخراج بسته به مقدار مورد استفاده بسیار متغیر خواهد بود. مقدار مورد استفاده توسط cdparanoia(1) ممکن است باعث شود کیفیت استخراج حتی کمتر از کیفیتی باشد که cdda2wav بدون libparanoia ارائه می‌دهد.

تعداد سکتورهای مورد استفاده برای همپوشانی ایستا را تعیین می‌کند. این گزینه همپوشانی پویا را خاموش می‌سازد. توصیه می‌شود از همپوشانی ایستا استفاده نکنید. برای به دست آوردن همپوشانی بزرگ‌تر، بهتر است از مقدار minoverlap= بزرگ‌تری استفاده فرمایید.
حداقل تعداد سکتورها برای همپوشانی پویا را تعیین می‌کند. مقدار پیش‌فرض مورد استفاده توسط cdda2wav برابر با 0.5 است که بیشتر از پیش‌فرض cdparanoia(1) (که برابر با 0.1 است) می‌باشد.

برای درایوهای قدیمی که از جریان‌سازی دقیق پشتیبانی نمی‌کنند، توصیه نمی‌شود مقدار minoverlap= بزرگ‌تر یا مساوی با حداکثر اندازه DMA تعیین شود.

برای دستیابی به بهترین نتایج در سایر درایوها، توصیه می‌شود از مقدار minoverlap= استفاده شود که کمتر از نصف اندازه پیش‌خوانی نباشد.

کیفیت استخراج به شدت با مقدار minoverlap= تغییر می‌کند، اما افزایش این مقدار زمان استخراج را نیز افزایش می‌دهد.

حداکثر تعداد سکتورها برای همپوشانی پویا را تعیین می‌کند. اگر maxoverlap= مشخص نشده باشد و مقدار minoverlap= بزرگی تعیین شده باشد، این حالت منجر به یک همپوشانی شبه‌ایستا می‌شود. مقدار پیش‌فرض مورد استفاده توسط cdda2wav برابر با 32 است.
بررسی خطای C2 را روشن می‌کند. در حال حاضر، این گزینه فقط به چاپ آمار خطاهای C2 منجر می‌شود.

هشدار: گزارش شده است که برخی درایوها هنگامی که حالت c2check فعال است، در خواندن قطعات پنهان با شکست مواجه می‌شوند. اگر با درایوی برخورد کردید که در آن cdda2wav قادر به تشخیص خودکار قابل استفاده بودن c2check نیست، لطفاً گزارش دهید.

هنگامی که قصد دارید از c2check در حین استخراج قطعات پنهان استفاده کنید، ابتدا مطمئن شوید که درایو شما قطعات پنهان را با و بدون گزینه c2check به طور یکسان گزارش می‌کند.

این گزینه یک ماکرو برای پارامترهای استخراج بهتر از مقادیر پیش‌فرض است. ماکروی proof به صورت زیر بسط می‌یابد:

paraopts=minoverlap=sectors-per-request-1,\
retries=200,readahead=600

اگر sectors-per-request-1 بیشتر از ۲۰ باشد، مقدار ۲۰ به عنوان حداقل مقدار همپوشانی استفاده می‌شود.

پارامترهای مورد استفاده توسط proof هنوز بهترین حالت مطلق نیستند و هیچ مجموعه پارامتر بهینه‌ای برای تمام سناریوها وجود ندارد. یک مقدار بزرگ‌تر برای اندازه بافر پیش‌خوانی ممکن است مثلاً برای RAM موجود در سیستم بیش از حد بزرگ باشد و بهترین مقدار برای حداقل همپوشانی بستگی به این دارد که درایو از جریان‌سازی دقیق پشتیبانی می‌کند یا خیر. توصیه می‌شود برای به دست آوردن بهترین نتایج در یک پلتفرم خاص، آزمایش‌هایی را با مقادیر بزرگ‌تر برای پارامترهای minoverlap= و readahead= انجام دهید.

توجه داشته باشید که نسخه‌های قبلی شامل c2check در ماکروی proof بودند، اما گزارش شده که این ویژگی در برخی درایوها با مشکل مواجه می‌شود و بنابراین c2check به طور پیش‌فرض غیرفعال شد. نسخه‌های فعلی cdda2wav به طور خودکار بررسی می‌کنند که آیا درایو فعلی از قابلیت c2check پشتیبانی می‌کند یا خیر و در صورت امکان از آن استفاده می‌نمایند.

عملیات بی‌صدا، بدون خروجی روی صفحه نمایش.
نرخ نمونه‌برداری rate را بر حسب نمونه در ثانیه تنظیم می‌کند. مقادیر ممکن با گزینه -R فهرست شده‌اند.
فهرستی از تمام نرخ‌های نمونه‌برداری و مقسم‌های آن‌ها را نمایش می‌دهد.
دستگاه سی‌دی‌رام را روی یکی از سرعت‌های قابل انتخاب برای خواندن تنظیم می‌کند. برای حداکثر کیفیت استخراج، توصیه می‌شود از مقادیر سرعت ۸ یا کمتر استفاده شود.

حالت پیش‌فرض، استخراج با حداکثر سرعت است.

حالت ضبط را روی استریو تنظیم می‌کند.
یک سکتور شروع مطلق را تنظیم می‌کند. این گزینه با گزینه‌های -track و -offset ناسازگار و مانعة‌الجمع است.
-track all
قطعه شروع و به صورت اختیاری قطعه پایان را انتخاب می‌کند. اگر از -t all استفاده شود، تمام قطعات صوتی انتخاب می‌شوند. اگر از -t 2+max استفاده شود، تمام قطعات صوتی که از قطعه ۲ شروع می‌شوند انتخاب خواهند شد.
اطلاعات مفصل و پرگویی را درباره سی‌دی واکشی و چاپ می‌کند. Level فهرستی از گزینه‌های فرعی جداشده با کاما است. هر گزینه فرعی نوع اطلاعاتی را که باید گزارش شود کنترل می‌کند.
گزینه فرعی توضیحات
! معکوس کردن معنای رشته پس از آن
not معکوس کردن معنای رشته پس از آن
disable هیچ اطلاعاتی داده نمی‌شود، اما هشدارها نمایش داده می‌شوند
all تمام اطلاعات ارائه می‌شود
toc نمایش جدول محتویات (TOC)
summary نمایش خلاصه‌ای از پارامترهای ضبط
indices تعیین و نمایش آفست‌های نمایه
catalog واکشی و نمایش شماره کاتالوگ رسانه MCN
mcn واکشی و نمایش شماره کاتالوگ رسانه MCN
trackid واکشی و نمایش تمام کدهای بین‌المللی استاندارد ضبط ISRC
isrc واکشی و نمایش تمام کدهای بین‌المللی استاندارد ضبط ISRC
sectors نمایش جدول محتویات با نمادگذاری سکتور شروع
titles نمایش جدول محتویات همراه با عناوین قطعات (در صورت موجود بودن)
audio-tracks فهرست کردن قطعات صوتی و سکتورهای شروع آن‌ها

سطح پرگویی پیش‌فرض toc,summary,sectors,titles .

منتظر سیگنال می‌ماند، سپس ضبط را آغاز می‌کند.
کیفیت حداکثر (کیفیت استاندارد CD) را تنظیم می‌کند.

از device به عنوان منبع برای خواندن CDDA استفاده می‌کند. به عنوان مثال dev/cdrom/ برای رابط cooked_ioctl و Bus,ID,Lun برای رابط generic_scsi. پارامتر device در صورت تعیین باید با تنظیم رابط مطابقت داشته باشد (گزینه -I و -interface در زیر را ببینید).

اگر هیچ گزینه -I یا -interface مشخص نشده باشد، تنظیم رابط از ساختار نحوی نام دستگاه استخراج می‌شود. نام دستگاهی که به صورت Bus,ID,Lun باشد یا شامل دونقطه (':') باشد، به طور پیش‌فرض روی رابط generic_scsi قرار می‌گیرد.

استفاده از cooked_ioctl توصیه نمی‌شود زیرا باعث می‌شود cdda2wav عمدتاً به کیفیت استخراج صوتی سیستم‌عامل وابسته باشد که معمولاً بسیار بد است. به همین دلیل، از استفاده از پارامترهایی مانند dev=/dev/cdrom برای دستگاه خودداری کنید.

تنظیم متغیر محیطی CDDA_DEVICE توسط این گزینه لغو می‌شود.

اگر هیچ گزینه dev= وجود نداشته باشد، یا اگر گزینه dev= فقط حاوی یک مشخص‌کننده انتقال باشد اما آدرسی نداشته باشد، cdda2wav تلاش می‌کند فضای آدرس SCSI را برای یافتن درایوهای CD-ROM پویش کند. اگر دقیقاً یک درایو پیدا شود، به طور پیش‌فرض از همان استفاده می‌شود.

برای اطلاعات بیشتر، توضیحات مربوط به گزینه dev= در cdrecord(1) را ببینید.

سطح اشکال‌زدایی را برای لایه انتزاعی سیستم‌عامل SCSI در libscg تنظیم می‌کند.
سطح اشکال‌زدایی هسته را برای درایور کرنل فراخوانی‌شده توسط لایه انتزاعی سیستم‌عامل SCSI در libscg تنظیم می‌کند. این گزینه در همه پلتفرم‌ها پشتیبانی نمی‌شود.
تمام دستگاه‌های SCSI را روی تمام گذرگاه‌های SCSI پویش کرده و رشته‌های inquiry را چاپ می‌کند. این گزینه ممکن است برای یافتن آدرس SCSI دستگاه CD/DVD-Recorder روی سیستم استفاده شود. عددهای چاپ‌شده به عنوان برچسب‌ها با فرمول زیر محاسبه می‌شوند: bus * 100 + target
فهرستی از گزینه‌های SCSI جداشده با کاما که توسط libscg مدیریت می‌شوند. گزینه‌های پیاده‌سازی‌شده ممکن است مستقل از برنامه‌ها به‌روزرسانی شوند. در حال حاضر یک گزینه: ignore-resid برای دور زدن یک باگ کرنل لینوکس پشتیبانی می‌شود.
حداکثر اندازه انتقال را برای یک دستور منفرد SCSI روی # تنظیم می‌کند. نحو گزینه ts= مشابه دستور cdrecord fs=# یا sdd bs=# است.

اگر هیچ گزینه ts= مشخص نشده باشد، cdda2wav به طور پیش‌فرض اندازه انتقال را روی 3 MB قرار می‌دهد. اگر libscg مقادیر کمتری از سیستم‌عامل دریافت کند، مقدار به حداکثر مقدار ممکن در سیستم‌عامل جاری کاهش می‌یابد. گاهی اوقات ممکن است کاهش بیشتر اندازه انتقال یا افزایش آن مفید باشد، اما توجه داشته باشید که یافتن مقدار بهتر با آزمایش روی گزینه ts= ممکن است زمان زیادی ببرد.

برخی سیستم‌عامل‌ها مقادیر نادرستی برای حداکثر اندازه انتقال برمی‌گردانند. اگر انتقال کاملاً متوقف شود یا ریست رخ دهد، ممکن است کاهش اندازه انتقال به کمتر از ۶۴ کیلوبایت یا حتی کمتر از ۳۲ کیلوبایت مناسب باشد.

ثبت وقایع دستورات SCSI در کنسول را فعال می‌کند. این گزینه عمدتاً برای اشکال‌زدایی استفاده می‌شود.
گزارش‌های خطای دستورات SCSI به کنسول را متوقف و بی‌صدا می‌کند. این گزینه عمدتاً برای واسط‌های گرافیکی (GUI) استفاده می‌شود.

از auxdevice به عنوان درایو CDROM استفاده می‌کند تا امکان ارسال ioctl مربوط به CDROMMULTISESSION در لینوکس وجود داشته باشد، حتی اگر رابط generic_scsi در حال استفاده باشد.
مشخص می‌کند کدام رابط برای دسترسی به CDROM استفاده شود:
برای ارسال مستقیم دستورات SCSI به درایو.
برای استفاده از رابط برنامه‌نویسی ارائه‌شده توسط کرنل سیستم‌عامل.
مورد دوم توصیه نمی‌شود زیرا کیفیت کمتری ارائه می‌دهد و فقط در تعداد محدودی از پلتفرم‌ها کار می‌کند.
به حالت تعاملی وارد می‌شود که دستورات را از stdin می‌خواند و پاسخ‌های متنی را در stderr، یا توصیف‌گر پرونده مشخص‌شده توسط گزینه out-fd می‌نویسد. این حالت عمدتاً برای این معرفی شده است که افزونه‌های gstreamer بتوانند cdrecord را فراخوانی کنند.

اگر cdda2wav با گزینه -interactive فراخوانی شود، جدول محتویات (TOC) را از رسانه خوانده و سپس منتظر ورودی دستور می‌ماند گویی دستور stop صادر شده است. اگر دستور بعدی cont باشد، سپس cdda2wav کل بخش صوتی رسانه را استخراج می‌کند. اگر دستور بعدی read باشد، سپس cdda2wav استخراج را از موقعیتی که با پارامتر دستور read مشخص شده است شروع می‌کند.

دستور پارامترها توضیحات
cont ادامه پردازش در موقعیت فعلی
exit خروج از پردازش
help چاپ راهنمای دستور و انتظار برای ورودی
quit خروج از پردازش
read sectors sector number خواندن سکتورها از sector number
read tracks track number خواندن سکتورها از track number
stop توقف پردازش و انتظار برای ورودی جدید
خروجی اطلاعاتی را به توصیف‌گر پرونده مشخص‌شده توسط descriptor تغییر مسیر می‌دهد. پارامتر descriptor یک شماره توصیف‌گر پرونده یونیکس را مشخص می‌کند. به طور پیش‌فرض، cdda2wav خروجی اطلاعاتی را به stderr می‌فرستد. تغییر مسیر خروجی اطلاعاتی به یک توصیف‌گر پرونده دیگر به واسط‌های گرافیکی و سایر برنامه‌هایی که cdda2wav را از طریق لوله‌ها (pipes) فراخوانی می‌کنند کمک می‌کند.
در صورتی که نام پرونده برای پرونده داده‌های صوتی "-" باشد، خروجی صوتی را به توصیف‌گر پرونده تعیین‌شده توسط descriptor هدایت می‌کند. پارامتر descriptor یک شماره توصیف‌گر پرونده یونیکس را مشخص می‌کند. به طور پیش‌فرض، cdda2wav اگر خروجی به درون یک پرونده هدایت نشود، داده‌های صوتی را به stdout می‌فرستد. هدایت خروجی صوتی به یک توصیف‌گر پرونده دیگر به واسط‌های گرافیکی و برنامه‌هایی که cdda2wav را از طریق لوله‌ها فراخوانی می‌کنند کمک می‌نماید.
برای بافرسازی گسترده فرآیند را چنگال (انشعاب / fork) نمی‌کند. اگر از -no-fork استفاده شود و از cdda2wav برای بازپخش سی‌دی‌های صوتی در حالت paranoia استفاده شود، ممکن است پخش به دلیل کمبود بافرسازی قطع گردد. از سوی دیگر، اجازه دادن به cdda2wav برای fork زمان تأخیر را برای حالت -interactive افزایش خواهد داد.
داده‌های صوتی را در دستگاه صوتی سیستم‌عامل مثلاً /dev/dsp کپی می‌کند.
یک دستگاه صوتی جایگزین را برای استفاده با -e تنظیم می‌کند.
-sectors-per-request sectors
تعداد sectors سکتور را در هر درخواست می‌خواند.
از یک بافر حلقوی با مجموع buffers بافر استفاده می‌کند.

برخی از مقادیر پیش‌فرض برای cdda2wav به صورت کامپایل‌شده درون برنامه قرار دارند و به Makefile بستگی دارند و برخی دیگر به تنظیمات متغیرهای محیطی وابسته‌اند.

برای تنظیم نام دستگاه استفاده می‌شود. نام‌گذاری دستگاه با cdrecord(1) سازگار است.
در صورت ارائه، برای جستجوی عناوین در cddbp استفاده می‌شود.
در صورت ارائه، برای جستجوی عناوین در cddbp استفاده می‌شود.
اگر متغیر محیطی RSH موجود باشد، اتصال راه دور از طریق rcmd(3) ایجاد نمی‌شود، بلکه با فراخوانی برنامه‌ای که RSH به آن اشاره دارد برقرار می‌گردد. مثلاً از RSH=/usr/bin/ssh برای ایجاد یک اتصال پوسته امن (SSH) استفاده کنید.

توجه داشته باشید که این کار cdda2wav را وادار می‌کند یک لوله به برنامه rsh(1) ایجاد کند و اجازه دسترسی مستقیم cdda2wav به سوکت شبکه سرور راه دور را نمی‌دهد. این امر تنظیم پارامترهای کارایی را غیرممکن ساخته و سرعت اتصال را در مقایسه با یک اتصال rcmd(3) آغازشده توسط root کاهش می‌دهد.

اگر متغیر محیطی RSCSI موجود باشد، سرور SCSI راه دور برنامه /opt/schily/sbin/rscsi نخواهد بود، بلکه برنامه‌ای خواهد بود که RSCSI به آن اشاره دارد. توجه داشته باشید که اگر با حسابی وارد سیستم شوید که با یک برنامه سرور SCSI راه دور به عنوان پوسته ورود (login shell) ایجاد شده باشد، نام برنامه سرور SCSI راه دور نادیده گرفته خواهد شد.

cdda2wav از کدهای خروج زیر برای نشان دادن درجات مختلف موفقیت یا شکست استفاده می‌کند:

کد خروج توضیحات
0 هیچ خطایی رخ نداد، عملیات موفقیت‌آمیز بود.
1 خطای استفاده یا نحو. cdda2wav آرگومان‌های متناقض دریافت کرد.
2 خطای تنظیم یا حذف مجوزها. تغییرات مجوز ناموفق بود.
3 خطای خواندن از دستگاه CD-ROM یا رایتر رخ داد.
4 خطای نوشتن هنگام ذخیره یکی از پرونده‌های خروجی رخ داد.
5 خطا در مدیریت کارت صدا (راه‌اندازی اولیه یا نوشتن).
6 خطا در فراخوانی سیستمی ()stat روی دستگاه خواندن (cooked ioctl).
7 خطای ارتباط از طریق لوله (pipe) در حالت انشعاب‌یافته (forked).
8 خطا در نصب گرداننده سیگنال (signal handler).
9 تخصیص حافظه اشتراکی ناموفق بود (در حالت forked).
10 تخصیص پویای حافظه هیپ (heap) ناموفق بود.
11 خطا در رسانه سی‌دی صوتی رخ داد.
12 خطای باز کردن دستگاه در مدیریت ioctl شناسایی شد.
13 شرایط رقابتی (race condition) در مدیریت رابط ioctl شناسایی شد.
14 خطا در عملیات ()ioctl رخ داد.
15 خطای داخلی رخ داد. لطفاً گزارش دهید!
16 خطا در عملیات سمافور (نصب یا درخواست).
17 بافر انتقال SCSI دریافت نشد.
18 لوله‌ها برای ارتباط بین‌فرآیندی ایجاد نشدند (در حالت forked).

cdda2wav قادر است بخش‌هایی از یک سی‌دی صوتی یا CDROM چندرسانه‌ای (شامل بخش‌های صوتی) را مستقیماً به صورت دیجیتال بخواند. این بخش‌ها را می‌توان در یک پرونده، یک لوله یا یک دستگاه صوتی نوشت.

نام cdda2wav مخفف CDDA به WAV است (که در آن CDDA نمایانگر Compact Disc Digital Audio و WAV یک قالب نمونه صوتی معرفی‌شده توسط MS Windows است). این ابزار امکان کپی داده‌های صوتی CDDA را از درایو CDROM به پرونده‌ای در قالب WAV یا سایر قالب‌ها فراهم می‌سازد.

برخی از نسخه‌های cdda2wav ممکن است تلاش کنند اولویت‌های زمان‌بندی بلادرنگ بالاتری را به دست آورند تا عملکرد روان (بدون وقفه) را تضمین کنند. این اولویت‌ها برای کاربران ارشد (مدیر سیستم) در دسترس بوده و بالاتر از اولویت‌های فرآیندهای «معمولی» هستند؛ بنابراین تاخیرها به حداقل می‌رسد.

اگر فقط یک CDROM دارید و یک سی‌دی صوتی در آن بارگذاری شده است، می‌توانید به سادگی cdda2wav را فراخوانی کنید و در صورت وجود فضای خالی کافی در سیستم پرونده، پرونده صوتی audio.wav را با ضبط کل قطعه از قطعه ۱ به صورت استریو با ۱۶ بیت در نرخ نمونه‌برداری ۴۴۱۰۰ هرتز ایجاد خواهد کرد. در غیر این صورت زمان ضبط محدود خواهد شد. برای جزئیات، پرونده‌های README و README.INSTALL را ببینید.

اگر بیش از یک درایو از نوع CD-ROM در سیستم دارید، باید گزینه dev= را مشخص کنید.

بیشتر گزینه‌ها برای کنترل قالب پرونده WAV استفاده می‌شوند. در متن زیر، بیشتر آن‌ها با جزئیات بیشتری مورد بحث قرار گرفته‌اند.

dev=device دستگاه درایو CDROM مورد استفاده را انتخاب می‌کند. مشخص‌کننده داده‌شده باید با رابط انتخاب‌شده مطابقت داشته باشد (زیر را ببینید). برای رابط cooked_ioctl این توصیف‌گر دستگاه cdrom است. دستگاه‌های SCSI که با رابط عمومی SCSI استفاده می‌شوند، بر خلاف توصیف‌گر عمومی دستگاه SCSI، با گذرگاه SCSI، شناسه SCSI و LUN مربوط به SCSI آدرس‌دهی می‌شوند. یک مثال برای یک درایو SCSI CDROM روی گذرگاه 0 با شناسه SCSI برابر با 3 و lun برابر با 0 عبارت است از: dev=0,3,0.

-A auxdevice ممکن است در برخی موارد نادر برای مدیریت CD-Extra مورد نیاز باشد. Cdda2wav معمولاً مشکلی در دریافت اطلاعات multi-session برای CD-Extra با استفاده از دستورات خام SCSI ندارد. برای درایوهای Non-SCSI-CDROM، این همان دستگاه داده‌شده توسط dev= است (بالا را ببینید). برای درایوهای SCSI-CDROM، این دستگاه درایو CDROM (دستگاه SCSI، یعنی /dev/sr0 ) متناظر با دستگاه SCSI (یعنی 0,3,0 ) است و باید با دستگاه مورد استفاده برای نمونه‌برداری مطابقت داشته باشد.

-I interface روش ارتباطی درایو CDROM را انتخاب می‌کند. این روش رابط معمولاً به طور خودکار از نام دستگاه تشخیص داده می‌شود. برای درایوهای SCSI، رابط generic_scsi استفاده می‌شود (cooked_ioctl ممکن است برای همه دستگاه‌ها در دسترس نباشد). نام‌های معتبر عبارتند از generic_scsi و cooked_ioctl. اولی از رابط عمومی SCSI استفاده می‌کند و دومی از ioctl درایور CDROM استفاده می‌نماید. حالت دوم فقط زمانی کار می‌کند که درایور کرنل از خواندن CDDA پشتیبانی کند. این ورودی باید با دستگاه CDROM انتخاب‌شده مطابقت داشته باشد (بالا را ببینید).

-e داده‌های صوتی را هنگام ضبط در کارت صدا کپی می‌کند، بنابراین می‌توانید صدا را تقریباً همزمان بشنوید. کارت صدا همان داده‌هایی را دریافت می‌کند که ضبط می‌شوند. این کار از نظر زمانی حساس است، بنابراین با گزینه -q بهترین عملکرد را دارد. برای استفاده از cdda2wav به عنوان یک پخش‌کننده شبه‌سی‌دی بدون ذخیره در یک پرونده، می‌توانید از دستور زیر:

cdda2wav -q -e -t2 -d0 -N

برای پخش کل قطعه دوم یا:

cdda2wav -q -e -B -N

برای پخش کل دیسک استفاده کنید. این ویژگی سرعت ضبط را حداکثر به سرعت ۱ برابر (یک‌برابر) کاهش می‌دهد.

-p percentage گام (زیر و بمی) تمام صداهای بازپخش‌شده روی کارت صدا را تغییر می‌دهد. فقط کپی ارسالی به کارت صدا تحت تأثیر قرار می‌گیرد و نمونه‌های صوتی ضبط‌شده در پرونده بدون تغییر باقی می‌مانند. گام معمولی که پیش‌فرض است، با مقدار 100 مشخص می‌شود. درصدهای پایین‌تر متناظر با گام‌های بم‌تر هستند؛ یعنی 50 p- خروجی صوتی را یک اکتاو بم‌تر می‌کند. همچنین اسکریپت pitchplay را به عنوان مثال ببینید. این گزینه توسط Raul Sobon ارائه شده است.

-m یا -c 1 ضبط مونو را انتخاب می‌کند (هر دو کانال استریو با هم میکس می‌شوند)، -s یا -c 2 یا -c s ضبط استریو را انتخاب می‌کند. پارامتر s جای هر دو کانال صوتی را عوض می‌کند.

-x حالت استریو، ۱۶ بیت به ازای هر نمونه در ۴۴.۱ کیلوهرتز (کیفیت کامل CD) را تنظیم می‌کند. توجه داشته باشید که سایر گزینه‌های قالب که بعداً مشخص شوند می‌توانند این تنظیم را تغییر دهند.

-b 8 مقدار ۸ بیت (۱ بایت) را برای هر نمونه در هر کانال مشخص می‌کند؛ -b 12 مقدار ۱۲ بیت (۲ بایت) را برای هر نمونه در هر کانال مشخص می‌کند؛ -b 16 مقدار ۱۶ بیت (۲ بایت) را برای هر نمونه در هر کانال مشخص می‌کند (اطمینان حاصل کنید که پخش‌کننده نمونه یا کارت صدای شما قادر به پخش نمونه‌های ۱۲ بیتی یا ۱۶ بیتی است). انتخاب ۱۲ یا ۱۶ بیت اندازه پرونده را دو برابر می‌کند. نمونه‌های ۱۲ بیتی با نمونه‌های ۱۶ بیتی هم‌تراز می‌شوند، بنابراین مقداری فضای دیسک را هدر می‌دهند.

-r samplerate یک نرخ نمونه‌برداری را انتخاب می‌کند. samplerate می‌تواند در محدوده بین ۹۰۰ تا ۴۴۱۰۰ باشد. گزینه -R تمام نرخ‌های موجود را فهرست می‌کند.

-a divider یک مقسم نرخ نمونه‌برداری را انتخاب می‌کند. divider می‌تواند از ۱ تا ۵۰.۵ با گام‌های ۰.۵ باشد. گزینه -R تمام نرخ‌های موجود را فهرست می‌کند.

برای روان‌تر کردن صدا در نرخ‌های نمونه‌برداری پایین‌تر، cdda2wav روی n نمونه مجموع می‌گیرد (که در آن n مقسم مربوطه است). بنابراین برای خروجی ۲۲۰۵۰ هرتز باید روی ۲ نمونه و برای ۹۰۰ هرتز روی ۴۹ نمونه جمع بزنیم. این کار فرکانس‌های بالاتر را حذف می‌کند. اندازه سکتور استاندارد یک سی‌دی صوتی (با صرف‌نظر از اطلاعات اضافی) ۲۳۵۲ بایت است. برای پایان دادن به عمل جمع برای یک نمونه خروجی در مرزهای سکتور، باید نرخ‌های فوق انتخاب شوند. نرخ‌های نمونه‌برداری دلخواه با کیفیت بالا نیازمند نوعی طرح درون‌یابی (اینترپولیشن) است که نیازمند برنامه‌نویسی بسیار پیچیده‌تری است.

-R فهرستی از تمام نرخ‌های نمونه‌برداری و مقسم‌های آن‌ها را نمایش می‌دهد. مقسم‌ها می‌توانند از ۱ تا ۵۰.۵ با گام‌های ۰.۵ باشند.

-t n+m مقدار n را به عنوان قطعه شروع و به صورت اختیاری m را به عنوان آخرین قطعه از محدوده مورد ضبط انتخاب می‌کند. این قطعات باید در جدول محتویات (TOC) موجود باشند. این تنظیم قطعه‌ای را که ضبط از آن آغاز می‌شود تعیین می‌کند. ضبط می‌تواند از طریق قطعات بعدی نیز پیش برود (که با قطعه پایانی اختیاری محدود می‌شود یا به مدت‌زمان ضبط بستگی دارد). اینکه آیا یک پرونده ایجاد شود یا پرونده‌های مختلف، به گزینه -B بستگی دارد (زیر را ببینید).

-i n نمایه‌ای (اندیسی) را که ضبط با آن آغاز می‌شود انتخاب می‌کند. نمایه‌هایی غیر از ۱ باعث فراخوانی اسکنر نمایه می‌شوند که یافتن موقعیت شروع صحیح توسط آن مدتی زمان می‌برد. همچنین ممکن است یک آفست اضافی نیز تعیین شود (زیر را ببینید).

-d n مدت زمان ضبط را روی n ثانیه تنظیم می‌کند یا در صورتی که n صفر باشد، مدت ضبط را برای کل قطعه تنظیم می‌نماید. برای مشخص کردن مدت‌زمان بر حسب فریم (سکتور)، آرگومان می‌تواند یک پسوند 'f' داشته باشد؛ در این حالت آرگومان عددی به عنوان فریم (سکتور) به جای ثانیه در نظر گرفته می‌شود. لطفاً توجه داشته باشید که اگر از محدوده‌های قطعه استفاده شود، آن‌ها نیز مدت‌زمان ضبط را تعیین می‌کنند و بنابراین زمان مشخص‌شده توسط هر گزینه -d را لغو می‌نمایند.

مدت‌زمان ضبط به عنوان زمانی تعریف می‌شود که نمونه تولیدشده پخش خواهد شد (در نرخ نمونه‌برداری تعیین‌شده). از آنجا که این زمان با مقدار نمونه‌های تولیدشده مرتبط است، زمان خود فرآیند نمونه‌برداری نیست (که می‌تواند کمتر یا بیشتر باشد). همچنین به طور دقیق با اطلاعات زمانی روی سی‌دی صوتی (که توسط دستگاه پخش خانگی نشان داده می‌شود) جفت نشده است. تفاوت‌ها می‌توانند ناشی از استفاده از گزینه -o باشند (زیر را ببینید). توجه داشته باشید که مدت‌زمان ضبط کوتاه‌تر خواهد شد، مگر اینکه فضای دیسک کافی وجود داشته باشد. ضبط را می‌توان در هر زمان با فشردن کلید توقف (سیگنال SIGQUIT) لغو کرد.

-B هر قطعه را در یک پرونده جداگانه کپی می‌کند. می‌توان یک نام پایه مشخص کرد. نام پرونده‌ها یک شماره قطعه پیوست‌شده و یک پسوند متناظر با قالب صوتی دارند. برای ضبط تمام قطعات صوتی یک سی‌دی، از مدت‌زمان به اندازه کافی بزرگ (مثلاً 99999 d-) استفاده کنید.

-o sectors سکتور شروع قطعه را به میزان sectors افزایش می‌دهد. با استفاده از این گزینه می‌توانید مقدار معینی را در ابتدای یک قطعه رد کنید تا دقیقاً بخشی را که می‌خواهید انتخاب نمایید. هر سکتور ۱/۷۵ ثانیه طول می‌کشد، بنابراین شما کنترل بسیار دقیقی دارید. اگر آفست شما آن‌قدر زیاد باشد که در قطعه جاری جا نشود، یک پیام هشدار صادر شده و آفست نادیده گرفته می‌شود و زمان ضبط کاهش نمی‌یابد. (برای رد کردن خودکار بخش‌های آرام ابتدایی، از گزینه -w استفاده کنید، زیر را ببینید.)

-w روشن کردن این گزینه تمام خروجی‌های بی‌صدا را در ابتدا متوقف و حذف می‌کند که احتمالاً اندازه پرونده را کاهش می‌دهد. cdda2wav سیگنال خروجی را بررسی می‌کند و با مشاهده هرگونه سیگنال، نوشتن در پرونده را آغاز می‌نماید.

-F روشن کردن این گزینه منفی‌ترین و مثبت‌ترین مقدار نمونه یافت‌شده در حین ضبط را برای هر دو کانال نمایش می‌دهد. این می‌تواند برای تنظیم مجدد حجم صدا مفید باشد. مقادیر نشان‌داده‌شده در مرزهای قطعه بازنشانی نمی‌شوند و کل فرآیند نمونه‌برداری را پوشش می‌دهند. آن‌ها از نمونه‌های اصلی گرفته شده و قالبی یکسان دارند (یعنی مستقل از قالب خروجی انتخاب‌شده هستند).

-G اگر این گزینه داده شود، نمونه‌های ورودی برای هر دو کانال مقایسه می‌شوند. در پایان برنامه نتیجه چاپ می‌شود. تفاوت در کانال‌ها نشان‌دهنده استریو است، در غیر این صورت هنگامی که هر دو کانال برابر باشند، مونو را نشان می‌دهد.

-T برخی از سی‌دی‌های صوتی قدیمی با یک پاسخ فرکانسی اصلاح‌شده به نام تأکید اولیه (pre-emphasis) ضبط شده‌اند. این مورد بیشتر در ضبط‌های موسیقی کلاسیک یافت می‌شود. این تصحیح اغلب در فلگ‌های جدول محتویات (TOC) قابل مشاهده است. اما ضبط‌هایی وجود دارند که این تنظیم را فقط در زیرکانال‌ها نشان می‌دهند. اگر این گزینه داده شود، اسکنر نمایه راه‌اندازی می‌شود که زیرکانال q هر قطعه را می‌خواند. اگر تأکید اولیه در زیرکانال q یک قطعه مشخص شده باشد اما در TOC نباشد، وجود تأکید اولیه فرض شده و متعاقباً فیلتر معکوس برای این قطعه قبل از اینکه نمونه‌ها در پرونده صوتی نوشته شوند انجام می‌شود.

-O audiotype می‌تواند شامل wav (برای پرونده‌های wav) یا au یا sun (برای پرونده‌های سان PCM) یا cdr یا raw (برای پرونده‌های بدون سرآیند جهت استفاده در رایترهای سی‌دی) باشد. تمام نمونه‌های پرونده با مدولاسیون کد پالس خطی (Linear PCM، همان‌طور که در قالب دیسک فشرده صوتی انجام می‌شود) کدگذاری می‌شوند. این موضوع برای همه قالب‌های صوتی صادق است. پرونده‌های Wav با پرونده‌های صوتی ویندوز سازگار هستند؛ آن‌ها ترتیب بایت lsb,msb دارند که برعکس ترتیب بایت استفاده‌شده در سی‌دی صوتی است. پسوند پیش‌فرض نام پرونده 'wav.' است. پرونده‌های نوع Sun مانند پرونده‌های au. قدیمی کدگذاری‌شده به صورت لگاریتمی نیستند، بلکه همان‌طور که در بالا ذکر شد از PCM خطی استفاده می‌شود. ترتیب بایت msb,lsb است تا سازگار باشد. پسوند پیش‌فرض نام پرونده 'au.' است. قالب‌های AIFF و گونه جدیدتر AIFC از دنیای Apple/SGI نمونه‌های خود را در قالب bigendian (یعنی msb,lsb) ذخیره می‌کنند. در AIFC هیچ فشرده‌سازی استفاده نمی‌شود. در نهایت ساده‌ترین «قالب»، قالب cdr با نام مستعار raw است. این قالب به طور پیش‌فرض با ترتیب بایت msb,lsb انجام می‌شود تا ترتیبی را که اکثر رایترهای سی‌دی می‌خواهند برآورده کند. از آنجا که هیچ اطلاعات سرآیندی در این قالب وجود ندارد، پارامترهای نمونه را فقط می‌توان با پخش نمونه‌ها روی کارت صدا یا موارد مشابه شناسایی کرد. پسوند پیش‌فرض نام پرونده 'cdr.' یا 'raw.' است.

-S speed امکان تغییر درایو سی‌دی‌رام به یک سرعت خاص را برای کاهش خطاهای خواندن فراهم می‌کند. آرگومان بدون تغییر به درایو منتقل می‌شود. جزئیات تا حد زیادی به درایوهای سی‌دی‌رام بستگی دارد. به عنوان مثال، آرگومان 0 اغلب سرعت پیش‌فرض درایو است و مقدار 1 اغلب سرعت تک‌برابر (1x) را انتخاب می‌کند.

-M count محاسبه چکسام MD-5 را برای 'count' بایت از ابتدای یک قطعه فعال می‌کند. این قابلیت برای مقایسه سریع قطعات معرفی شد.

-paranoia یک روش جایگزین برای استخراج سکتورهای صوتی را انتخاب می‌کند. کتابخانه Monty با گزینه‌های پیش‌فرض زیر استفاده می‌شود:

PARANOIA_MODE_FULL, but without PARANOIA_MODE_NEVERSKIP

برای جزئیات بیشتر مستندات libparanoia مونتی را ببینید. در این حالت گزینه -P هیچ تأثیری ندارد.

(این بخش اعمال می‌شود مگر اینکه از گزینه -paranoia استفاده شود.) -P sectors تعداد سکتورهای مشخص‌شده را برای نمونه‌برداری همپوشانی اولیه جهت تصحیح لرزش (jitter) تنظیم می‌کند. دو حالت باید تفکیک شود: برای مقادیر غیر صفر، برخی از سکتورها دو بار خوانده می‌شوند تا تصحیح لرزش cdda2wav فعال شود. اگر آرگومان صفر داده شود، هیچ نمونه‌برداری همپوشانی استفاده نخواهد شد. برای سکتورهای همپوشانی غیر صفر، cdda2wav تنظیم را به صورت پویا در حین نمونه‌برداری تنظیم می‌کند (همان‌طور که cdparanoia انجام می‌دهد). اگر هیچ تطابقی پیدا نشود، cdda2wav خواندن را با همپوشانی افزایش‌یافته مجدداً امتحان می‌کند. اگر مقدار لرزش کمتر از نمونه‌های همپوشان فعلی باشد، cdda2wav تنظیم همپوشانی را کاهش می‌دهد که منجر به سرعت خواندن بالاتر می‌شود. آرگومان داده‌شده باید کمتر از تعداد کل سکتورها در هر درخواست باشد (گزینه -n در زیر را ببینید). Cdda2wav این تنظیم را بررسی می‌کند و در غیر این صورت یک پیام خطا صادر می‌نماید. حالت صفر سکتور در شرایط بار کم یا درایوهای سی‌دی‌رام بدون خطا (عالی) و سی‌دی‌های صوتی عالی (بدون خش) مناسب است.

-n sectors اندازه انتقال را روی سکتورهای مشخص‌شده در هر درخواست تنظیم می‌کند.

-l buffers تعداد مشخص‌شده از عناصر بافر حلقوی را تخصیص می‌دهد.

-C endianess تنظیمات پیش‌فرض قالب ورودی را لغو می‌کند. ترتیب بایت را می‌توان به صورت صریح روی "little"، "big" یا "machine" یا روی تشخیص خودکار ترتیب بایت بر اساس رأی‌گیری با "guess" تنظیم کرد.

-E endianess (ترتیب بایت می‌تواند "little"، "big" یا "machine" باشد) تنظیمات پیش‌فرض قالب خروجی را لغو می‌کند.

-v itemlist اطلاعات بیشتری را چاپ می‌کند. یک فهرست امکان انتخاب موارد مختلف اطلاعات را فراهم می‌سازد.

چاپ خلاصه‌ای از اعضای ممکن فهرست diffopts.
!
معکوس کردن معنای رشته پس از آن. بعد از علامت تعجب نیازی به کاما نیست.
معکوس کردن معنای تمام اعضا در فهرست diffopts، یعنی حذف تمام گزینه‌های موجود از فهرست مقایسه مجموعه کامل اولیه. هنگام استفاده از csh(1) ممکن است با ! به دلیل تجزیه‌کننده عجیب آن مشکل داشته باشید؛ به همین دلیل نام مستعار not وجود دارد.
غیرفعال کردن پرگویی
ارائه تمام اطلاعات
نمایش جدول محتویات (TOC)
نمایش خلاصه‌ای از پارامترهای ضبط
فراخوانی اسکنر نمایه و نمایش موقعیت‌های شروع نمایه‌ها
واکشی و نمایش شماره کاتالوگ رسانه
واکشی و نمایش کدهای بین‌المللی استاندارد ضبط (ISRC)
نمایش موقعیت‌های شروع قطعه با نمادگذاری مطلق سکتور

برای ترکیب چند درخواست، کافی است گزینه‌های فرعی را با کاما جدا کنید.

این خروجی جدول محتویات را همراه با تعداد قطعات و زمان کل (نمایش‌داده‌شده در قالب mm:ss.hh که mm=دقیقه، ss=ثانیه، hh=صدم ثانیه گردشده) نشان می‌دهد. فهرست زیر شماره قطعه و زمان قطعه را برای هر ورودی نمایش می‌دهد. خلاصه یک خط به ازای هر قطعه ارائه می‌دهد که نوع قطعه را توصیف می‌کند:


track preemphasis copypermitted tracktype chans

ستون track شماره قطعه را نگه می‌دارد. preemphasis نشان می‌دهد که آیا به آن قطعه یک پاسخ فرکانسی غیرخطی داده شده است یا خیر. نکته: می‌توانید این اثر را با گزینه -T لغو و خنثی کنید. copy-permitted مشخص می‌کند که آیا این قطعه مجاز به کپی است یا خیر. tracktype می‌تواند data یا audio باشد. در سی‌دی‌های چندرسانه‌ای (به جز سی‌دی‌های دارای قطعه پنهان) هر دوی آن‌ها باید وجود داشته باشند. channels فقط برای قطعات صوتی تعریف می‌شود که می‌تواند دو یا چهار کانال باشد.

-N این گزینه اشکال‌زدایی نوشتن در پرونده را خاموش می‌کند.

-H این گزینه ایجاد پرونده اطلاعات (info) و پرونده cddb را خاموش می‌کند.

-g این گزینه قالب‌بندی ساده خطی را فعال می‌کند که برای پشتیبانی از واسط‌های گرافیکی (مانند xcd-roast) مورد نیاز است.

-V این گزینه ثبت وقایع دستورات SCSI را روشن می‌کند. این کار خروجی زیادی تولید خواهد کرد (هنگامی که دستگاه‌های SCSI استفاده می‌شوند). این گزینه برای مقاصد اشکال‌زدایی مورد نیاز است. قالب آن همان قالبی است که در برنامه cdrecord استفاده می‌شود؛ برای اطلاعات بیشتر cdrecord(1) را ببینید.

-q تمام خروجی‌های صفحه نمایش را به جز پیام‌های خطا سرکوب و پنهان می‌کند. این کار مصرف منابع زمان پردازنده (CPU) را کاهش می‌دهد.

-J در پرونده‌ای نمی‌نویسد، فقط اطلاعاتی را درباره دیسک چاپ می‌کند (بسته به گزینه -v). این گزینه فقط برای مقاصد اطلاعاتی است.

-L cddbp mode ابزار Cdda2wav تلاش می‌کند نام اجراکننده، عنوان آلبوم و عناوین قطعات را از یک کارگزار cddbp واکشی کند. کارگزار پیش‌فرض در حال حاضر 'freedb.freedb.org' است. برنامه‌ریزی شده است که بعداً کنترل بیشتری روی مدیریت کارگزار اعمال شود. این پارامتر نحوه مدیریت ورودی‌های چندگانه را تعیین می‌کند:

0
حالت تعاملی، کاربر یکی از ورودی‌ها را انتخاب می‌کند.
1
انتخاب اولین ورودی بدون درخواست تأیید از کاربر.

cddbp-server servername هنگام استفاده از -L یا -cddb، کارگزاری که با آن تماس برقرار می‌شود می‌تواند با این گزینه تعیین شود.

cddbp-port portnumber هنگام استفاده از -L یا -cddb، پورت کارگزاری که با آن ارتباط برقرار می‌شود می‌تواند با این گزینه مشخص شود.

نمونه‌هایی ایجاد نکنید که قادر به خواندن آن‌ها نیستید. ابتدا نرم‌افزار پخش نمونه و سخت‌افزار کارت صدای خود را بررسی کنید. من با نرخ‌های نمونه‌برداری بسیار پایین (استریو <= ۱۵۷۵ هرتز، مونو <= ۳۶۷۵ هرتز) هنگام پخش آن‌ها با پخش‌کننده‌های استاندارد WAV برای Sound Blaster با مشکلاتی مواجه شدم (شاید آن‌ها در قالب WAV معتبر نیستند). بیشتر رایترهای سی‌دی (CD-Writers) بر روی نمونه‌های صوتی در قالب bigendian تأکید دارند. اکنون cdda2wav از گزینه -E endianess برای کنترل ترتیب بایت نمونه‌های نوشته‌شده پشتیبانی می‌کند.

اگر سخت‌افزار شما به اندازه کافی سریع باشد که cdda2wav را بدون وقفه اجرا کند و درایو سی‌دی شما یکی از انواع «عالی» باشد، با خاموش کردن تمام نمونه‌برداری‌های همپوشان با گزینه -P 0 سرعت بیشتری به دست خواهید آورد. تنظیمات دقیق‌تر را می‌توان با گزینه -n sectors انجام داد. می‌توانید مشخص کنید چه تعداد سکتور باید در یک نوبت درخواست شود.

دستور Cdda2wav از لوله‌ها(pipes) پشتیبانی می‌کند. از نام پرونده - استفاده کنید تا cdda2wav نمونه‌های خود را به خروجی استاندارد بفرستد.

تبدیل به سایر قالب‌های صوتی با استفاده از بسته نرم‌افزاری sox امکان‌پذیر است (دیگر نباید نیازی به استفاده از sox -x برای تغییر ترتیب بایت نمونه‌ها باشد؛ گزینه -E را برای تغییر ترتیب بایت خروجی ببینید).

اگر می‌خواهید بیش از یک قطعه را در پرونده‌های مجزا در یک نوبت نمونه‌برداری کنید، این کار در حال حاضر با گزینه -B امکان‌پذیر است. هنگامی که زمان ضبط از حد مجاز قطعه فراتر رود، پرونده جدیدی برای قطعه بعدی باز خواهد شد.

دستور Cdda2wav می‌تواند پرونده‌های زیادی برای مقاصد مختلف تولید کند.

پرونده‌های صوتی حاوی نمونه‌هایی با پسوندهای پیش‌فرض wav.، au.، aifc.، aiff. و cdr. بر اساس قالب صوتی انتخاب‌شده هستند. این پرونده‌ها در صورت مشخص شدن گزینه (-N) تولید نمی‌شوند. هنگامی که از گزینه کپی گروهی (-B) استفاده شود، ممکن است چندین پرونده نوشته شوند. نام‌های اختصاصی پرونده را می‌توان به عنوان آرگومان ارائه کرد. اگر تعداد نام‌های ارائه‌شده برای پوشش تمام قطعات صوتی کافی باشد، نام پرونده‌ها عیناً استفاده خواهند شد. در غیر این صورت، اگر تعداد نام‌های داده‌شده کمتر از پرونده‌های مورد نیاز برای نوشتن قطعات موجود باشد، بخش قبل از پسوند نام پرونده با 'dd_' گسترش می‌یابد که در آن dd نمایانگر شماره قطعه جاری است.

اگر cdda2wav اطلاعات عنوان cd-extra یا cd-text (آلبوم/قطعه) را شناسایی کند، پرونده‌های cddb.، cdindex. و cdtext. تولید می‌شوند مگر اینکه توسط گزینه -H سرکوب شوند. آن‌ها حاوی ورودی‌های با قالب‌بندی مناسب برای ارسال به پایگاه‌های داده عناوین قطعات سی‌دی صوتی در اینترنت هستند. سیستم‌های CDINDEX و (CDDB(tm در حال حاضر پشتیبانی می‌شوند. برای اطلاعات بیشتر لطفاً از www.musicbrainz.org و www.freedb.com بازدید فرمایید.

پرونده‌های inf پرونده‌های نمونه و بخشی از سی‌دی صوتی را که از آن استخراج شده‌اند توصیف می‌کنند. آن‌ها ابزاری برای انتقال اطلاعات به یک برنامه رایت سی‌دی مانند cdrecord هستند. به عنوان مثال، اگر سی‌دی صوتی اصلی تأکید اولیه (pre-emphasis) فعال داشته باشد و cdda2wav با گزینه -T تأکید اولیه را حذف کرده باشد، پرونده inf گزینه تأکید اولیه را غیرفعال ثبت می‌کند (زیرا پرونده صوتی دیگر آن را ندارد)، در حالی که cddb. و cdindex. تأکید اولیه را مانند سی‌دی اصلی فعال ثبت می‌کنند.

مهم: فروش کپی‌های آثار دارای حق نشر توسط اشخاص فاقد حق نشر ممنوع است. این برنامه نباید برای دور زدن قوانین حق نشر استفاده شود. کاربر هنگام استفاده از این نرم‌افزار این محدودیت را می‌پذیرد.

اسکنر نمایه ممکن است دچار پایان مهلت زمانی (timeout) شود.

بازنمونه‌برداری (کد تبدیل نرخ) از درون‌یابی چندجمله‌ای استفاده می‌کند که بهینه نیست.

دستور Cdda2wav باید از ریسه‌ها (threads) استفاده کند.

با تشکر از Project MODE (http://www.mode.net) و Fraunhofer Institut fuer integrierte Schaltungen (FhG-IIS) (http://www.iis.fhg.de) برای حمایت مالی. شرکت‌های Plextor Europe و Ricoh Japan درایوهای سی‌دی‌رام و رایترهای سی‌دی را تأمین کردند که کمک فراوانی به توسعه این نرم‌افزار نمود. رامی (Rammi) در اشکال‌زدایی کمک شایانی کرد و هنگام شنیدن ۱۰۰ باره ۱۶ ثانیه اول قطعه اول سی‌دی Krupps شکیبایی فراوانی نشان داد. کتابخانه Libparanoia توسط مانتی (Christopher Montgomery) xiphmont@mit.edu اهدا شد.

Heiko Eissfeldt heiko@colossus.escape.de (1993-2004,2015)

از ۲۰۰۴ تا کنون:

Joerg Schilling
Seestr. 110
D-13353 Berlin
Germany

2017/03/29

رابط‌های ارائه‌شده توسط cdda2wav برای پایداری طولانی‌مدت طراحی شده‌اند. از آنجا که cdda2wav به رابط‌های ارائه‌شده توسط سیستم‌عامل زیربنایی وابسته است، پایداری رابط‌های ارائه‌شده توسط cdda2wav به پایداری رابط‌های سیستم‌عامل بستگی دارد. تغییر رابط‌ها در سیستم‌عامل ممکن است تغییراتی را در رابط‌های cdda2wav تحمیل کند.

Version 3.02 2017/03/29