'\" t
.\" @(#)cdda2wav.1	1.64 17/03/29 Copyright 1998,1999,2000 Heiko Eissfeldt, Copyright 2004-2017 J. Schilling
.if t .ds a \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'a
.if t .ds o \v'-0.55m'\h'0.00n'\z.\h'0.45n'\z.\v'0.55m'\h'-0.45n'o
.if t .ds u \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'u
.if t .ds A \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'A
.if t .ds O \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'O
.if t .ds U \v'-0.77m'\h'0.30n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.75n'U
.if t .ds s \\(*b
.if t .ds S SS
.if n .ds a ae
.if n .ds o oe
.if n .ds u ue
.if n .ds s sz
.if t .ds m \\(*m
.if n .ds m micro
.TH CDDA2WAV 1 "Version 3.02 2017/03/29"
.SH "نام (NAME)"
cdda2wav \- استخراج داده‌های صوتی سی‌دی در پرونده‌های صوتی با اعتبارسنجی مضاعف داده‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B cdda2wav
[ 
.I options
][
.BI dev= device
]
.RI [ file(s)
or
.IR directories ]
.SH "توضیحات (DESCRIPTION)"
.B cdda2wav
می‌تواند قطعات صوتی را از درایوهای CDROM که قادر به خواندن داده‌های صوتی به صورت دیجیتال از طریق SCSI هستند
.RB ( CDDA )
استخراج کند.
.LP
از آنجا که
.B cdda2wav
راهبردهایی را برای دور زدن نقایص رایج سی‌دی‌های صوتی پیاده‌سازی می‌کند، بسیاری از دیسک‌هایی را می‌خواند که
توسط سایر نرم‌افزارها قابل خواندن نیستند.
همچنین از آنجا که
.B cdda2wav
می‌تواند از
.B libparanoia
(گزینه
.B \-paranoia
در زیر را ببینید)
برای اعتبارسنجی داده‌های خوانده‌شده از دیسک استفاده کند، حتی اگر دیسک دارای گرد و غبار، خط و خش یا مشکلات دیگری باشد، کیفیتی عالی ارائه می‌دهد.
.LP
از آنجا که
.B cdda2wav
ممکن است برای نوشتن داده‌های صوتی در خروجی استاندارد هدایت شود، به طور پیش‌فرض تمام خروجی‌های اطلاعاتی خود را
در خطای استاندارد (stderr) می‌نویسد. گزینه
.BI out\-fd= descriptor
در زیر را ببینید.
.PP
.SS "تنظیمات پیش‌فرض (Default settings)"
.PP
.B Cdda2wav
به طور پیش‌فرض اولین قطعه صوتی را از دیسک می‌خواند و سطح پرگویی (verbose) پیش‌فرض روی
.BR "\-vtoc,summary,sectors,titles"
تنظیم شده است و
.B cdda2wav
به طور پیش‌فرض پرونده‌های
.B "*.inf
را می‌نویسد.
برای استخراج تمام قطعات صوتی همراه با اعتبارسنجی کیفیت، توصیه می‌شود دستور زیر اجرا شود:
.PP
.B "cdda2wav -vall cddb=0 speed=4 -paranoia paraopts=proof -B"
.PP
برای راهنمایی در مورد نحوه تعیین دستی پارامترهای بهتر، به توضیحات
.B paraopts=
در زیر مراجعه کنید.
.SS "نام‌گذاری دستگاه (Device naming)"
بیشتر کاربران نیازی به نگرانی در مورد نام‌گذاری دستگاه ندارند.
اگر گزینه
.B dev=
مشخص نشده باشد،
.B cdda2wav
از قابلیت
.B هدف خودکار (auto target)
پشتیبانی کرده و هنگامی که دقیقاً یک درایو از نوع CD-ROM در سیستم موجود باشد، به طور خودکار درایو را پیدا می‌کند.
هنگامی که بیش از یک درایو از نوع CD-ROM وجود داشته باشد،
فهرستی از پارامترهای نام دستگاه ممکن است با دستور
.B "cdda2wav \-scanbus
یا از مثال هدف در خروجی
.BR "cdda2wav dev=help"
به دست آید، سپس پارامتر
.B dev=
می‌تواند بر اساس فهرست دستگاه‌ها تنظیم شود.
.PP
پارامتر
.I device
در گزینه
.B dev=
که در زیر توضیح داده شده است، به نماد استاندارد
.B SCSI\ CAM
برای
.IR scsibus / target / lun
دستگاه CD/DVD/BluRay-Recorder اشاره دارد.
اگر پرونده etc/default/cdrecord/ وجود داشته باشد، پارامتر گزینه
.B dev=
می‌تواند یک برچسب نام درایو در پرونده مذکور نیز باشد (بخش FILES را ببینید).

.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های اطلاعاتی (Informative options)"
.TP
.B \-h
.TP
.B \-help
نمایش اطلاعات نسخه cdda2wav در خروجی استاندارد.
.TP
.B \-version
نمایش اطلاعات نسخه و حق نشر (Copyright).
.SS "گزینه‌های صوتی (Audio options)"
.TP
.BI \-a " divider
.TP
.BI \-divider " divider
نرخ نمونه‌برداری را روی 44100Hz / 
.IR divider
تنظیم می‌کند. مقادیر ممکن با گزینه
.B \-R
فهرست شده‌اند.
.sp
مقدار پیش‌فرض مقسم ۱ است.
.TP
.B \-B
.TP
.B \-bulk
.TP
.B \-alltracks
هر قطعه را در یک پرونده مجزا کپی می‌کند.
.sp
حالت پیش‌فرض، عدم استخراج همه قطعات است.
.TP
.BI \-b " bits
.TP
.BI \-bits\-per\-sample " bits
تعداد
.I بیت‌ها
به ازای هر نمونه در هر کانال را تعیین می‌کند:
.BR 8 ،
.B 12
یا
.BR 16 .
.sp
مقدار پیش‌فرض ۱۶ بیت به ازای هر نمونه است.
.TP
.BI \-c " channels
.TP
.BI \-channels " channels
تنظیم کانال‌ها:
.RS
.TP
.B 1
برای ضبط مونو (تک‌کاناله)
.TP
.B 2
برای ضبط استریو (دوکاناله)
.TP
.B s
برای ضبط استریو با جابه‌جایی هر دو کانال
.PP
حالت پیش‌فرض ضبط استریو است.
.RE
.TP
.BI \-C " endianess
.TP
.BI \-cdrom\-endianess " endianess
ترتیب بایت (endianness) نمونه‌های ورودی را برای لغو پیش‌فرض‌ها روی 'little'، 'big'، 'machine' یا 'guess' تنظیم می‌کند.
مقدار 'machine' یا 'host' به عنوان ترتیب بایت واقعی پردازنده میزبان در سیستم‌عامل جاری ارزیابی می‌شود.
.sp
حالت پیش‌فرض، تشخیص خودکار ترتیب بایت سی‌دی‌رام است.
.TP
.B \-cuefile
یک پرونده CUE سازگار با CDRWIN ایجاد می‌کند.
یک پرونده CUE که به طور کامل از مستندات CDRWIN پیروی می‌کند، تنها در صورتی می‌تواند برای ایجاد کپی‌های ۱:۱ استفاده شود که یک پرونده داده صوتی واحد برای کل دیسک وجود داشته باشد.
قالب پرونده inf.* قابلیت‌های بیشتری از سی‌دی صوتی را نسبت به قالب CUE برنامه CDRWIN پیاده‌سازی می‌کند و امکان ایجاد کپی‌های ۱:۱ را در حالتی که برای هر قطعه یک پرونده داده صوتی وجود دارد، فراهم می‌سازد.
تنها در صورتی از قالب پرونده CUE برای فراداده استفاده کنید که واقعاً به این قالب نیاز داشته باشید.
.sp
برای اینکه به
.B cdda2wav
اجازه ایجاد پرونده‌های CUE را بدهید، باید همچنین
.B \-t all
را مشخص کنید تا
.B cdda2wav
به حالتی برود که یک پرونده داده صوتی واحد برای کل سی‌دی تولید کند.
.TP
.B \-T
.TP
.B \-deemphasize
اثر تأکید اولیه (pre-emphasis) را در نمونه‌های ورودی خنثی و لغو می‌کند.
.sp
حالت پیش‌فرض این است که داده‌های صوتی در همان وضعیت روی دیسک نگه‌داشته شوند و وضعیت تأکید اولیه در پرونده‌های
.B "*.inf
مشخص گردد.
.TP
.BI \-L " cddb mode
.TP
.BI \-cddb " cddb mode
جستجوی عنوان آلبوم و قطعه را بر اساس شناسه cddb در پایگاه cddbp انجام می‌دهد.
پارامتر cddb mode تعیین می‌کند که ورودی‌های چندگانه چگونه پردازش شوند.
.TS H
center box;
r | l.
پارامتر	توضیحات
_
-1	غیرفعال کردن پرس‌وجوهای cddb. این حالت پیش‌فرض است.
0	حالت تعاملی. کاربر ورودی مورد استفاده را انتخاب می‌کند.
1	حالت اولین تطابق. اولین ورودی بدون قید و شرط انتخاب می‌شود.
.TE
.TP
.BI cddbp\-server= servername
کارگزاری را که باید برای جستجوی عنوان‌ها با آن ارتباط برقرار شود تعیین می‌کند.
.TP
.BI cddbp\-port= portnumber
شماره پورتی را که باید برای جستجوی عناوین استفاده شود تعیین می‌کند.
.TP
.BI \-d " duration
.TP
.BI \-duration " duration
مدت‌زمان ضبط را بر حسب ثانیه یا فریم (سکتور) تنظیم می‌کند.
فریم‌ها با پسوند 'f' مشخص می‌شوند (به عنوان مثال 75f برای ۷۵ سکتور).
.B 0
زمان را برای کل قطعه تنظیم می‌کند.
.sp
حالت پیش‌فرض استخراج کل قطعه است.
.TP
.BI \-E " endianess
.TP
.BI \-output\-endianess " endianess
ترتیب بایت (endianness) نمونه‌های خروجی را روی 'little'، 'big' یا 'machine' تنظیم می‌کند تا پیش‌فرض را که 'ترتیب بایت شبکه' (big endian) است لغو نماید.
مقدار 'machine' یا 'host' به عنوان ترتیب بایت واقعی پردازنده میزبان در سیستم‌عامل جاری ارزیابی می‌شود.
.TP
.B \-F
.TP
.B \-find\-extremes
دامنه‌های بیشینه و کمینه (حدی) را در نمونه‌ها پیدا می‌کند.
.TP
.B \-G
.TP
.B \-find\-mono
تشخیص می‌دهد که آیا نمونه‌های ورودی مونو هستند یا خیر.
.TP
.B \-g
.TP
.B \-gui
قالب‌بندی خروجی را برای تجزیه توسط واسط‌های گرافیکی بازآرایی می‌کند.
.br
.ne 5
.TP
.B \-H
.TP
.B \-no\-infofile
پرونده‌های info، cddb یا cdtext را ایجاد نمی‌کند.
.TP
.BI \-i " index
.TP
.BI \-index " index
نمایه (اندیس) شروع را انتخاب می‌کند.
.TP
.B \-J
.TP
.B \-info\-only
در پرونده‌ای نمی‌نویسد، فقط اطلاعاتی درباره دیسک ارائه می‌دهد.
.TP
.B \-M 
.TP
.B \-md5
محاسبه چکسام MD-5 را برای تمام بایت‌های صوتی از ابتدای یک قطعه فعال می‌کند. سرآیند صوتی هنگام محاسبه چکسام MD-5 نادیده گرفته می‌شود تا امکان مقایسه مقادیر MD-5 برای پرونده‌هایی با انواع سرآیند متفاوت فراهم باشد.
.br
.ne 5
.TP
.B \-m
.TP
.B \-mono
حالت ضبط را روی مونو تنظیم می‌کند.
.TP
.B \-no\-hidden\-track
قطعات پنهان روی سی‌دی را نادیده می‌گیرد.
به طور پیش‌فرض،
.B cdda2wav
بررسی می‌کند که آیا ممکن است یک قطعه پنهان قبل از قطعه ۱ وجود داشته باشد یا خیر.
این بررسی ممکن است چند ثانیه طول بکشد و بنابراین می‌توان با گزینه
.BR \-no\-hidden\-track
آن را غیرفعال کرد.
.TP
.B \-N
.TP
.B \-no\-write
در پرونده نمی‌نویسد، فقط می‌خواند (مثلاً برای مقاصد اشکال‌زدایی).
اگر این گزینه همراه با گزینه
.B \-e
استفاده شود، سی‌دی خوانده شده و محتوای صوتی بدون ایجاد پرونده‌های خروجی حاوی داده‌های صوتی، در دستگاه صوتی پخش می‌شود.
.TP
.B \-no\-textdefaults
به طور پیش‌فرض،
.B cdda2wav
فیلدهای خالی CD-Text قطعات را با فیلد CD-Text مربوطه (در صورت تعریف) برای کل سی‌دی جایگزین می‌کند. اگر از گزینه
.B \-no\-textdefaults
استفاده شود،
.B cdda2wav
در چنین مواردی فیلدهای CD-Text مربوط به قطعه را خالی می‌گذارد.
.TP
.B \-no\-textfile
اگر
.B cdda2wav
با اطلاعات مفید CD-Text روی سی‌دی مواجه شود، یک پرونده cdtext. می‌نویسد.
گزینه
.B \-no\-textfile
امکان جلوگیری از ایجاد پرونده cdtext. را فراهم می‌سازد.
.TP
.BI \-o " offset
.TP
.BI \-offset " offset
خواندن را با آفست مشخص‌شده به میزان
.I offset
سکتور بعد از قطعه شروع آغاز می‌کند (هر سکتور معادل ۱/۷۵ ثانیه است).
.TP
.BI \-O " audiotype
.TP
.BI \-output\-format " audiotype
می‌تواند شامل
.I wav
(برای پرونده‌های wav) یا
.I aiff
(برای پرونده‌های aiff اپل/اس‌جی‌آی) یا
.I aifc
(برای پرونده‌های aifc اپل/اس‌جی‌آی) یا
.I au
یا
.I sun
(برای پرونده‌های سان au PCM.) یا
.I cdr
یا
.I raw
(برای پرونده‌های بدون سرآیند جهت استفاده در رایترهای سی‌دی) باشد.
.sp
قالب خروجی پیش‌فرض اکنون برای تمام پلتفرم‌ها
.B wav
است، زیرا به رایج‌ترین قالب تبدیل شده است. توجه داشته باشید که نسخه‌های قبلی
.B cdda2wav 
استثنا قائل می‌شدند و در سولاریس به طور پیش‌فرض پرونده‌هایی از نوع
.B au
ایجاد می‌کردند.
.TP
.BI \-p " percentage
.TP
.BI \-playback\-realtime " percentage
گام صدای داده‌های صوتی کپی‌شده به دستگاه صدا را تغییر می‌دهد.
.TP
.BI \-P " sectors
.TP
.BI  \-set\-overlap " sectors
تعداد اولیه سکتورهای همپوشانی
.I sectors
را برای تصحیح لرزش (jitter) در حالت غیر پارانویا تنظیم می‌کند. توجه داشته باشید که خواندن‌های همپوشان در حالت پارانویا به گونه‌ای متفاوت مدیریت می‌شوند.
.sp
میزان همپوشانی پیش‌فرض در حالت غیر پارانویا برابر با ۱ است.
.TP
.B \-paranoia
از کتابخانه paranoia به عنوان فیلتری بر روی روتین‌های خواندن cdda2wav استفاده می‌کند.
در حالت
.B paranoia
زمان تأخیر برای حالت
.B \-interactive
و با اندازه بافر پیش‌خوانی ۱۵۰ تا ۳۰۰ سکتور، معمولاً به ۵ تا ۱۰ ثانیه افزایش می‌یابد. این امر به دلیل خواندن حداقل دو بار توسط کد
.B paranoia
و لزوم تخلیه حافظه نهان درایو CD-ROM رخ می‌دهد.
.sp
اندازه ناحیه پیش‌خوانی باید بزرگ‌تر از اندازه RAM درایو باشد تا به
.B libparanoia
اجازه دهد حافظه نهان درایو را تخلیه کند.
از آنجا که اندازه ناحیه پیش‌خوانی در گذشته یک مقدار ثابت کامپایل‌شده درون کد
.B libparanoia
بود، کیفیت استخراج با استفاده از libparanoia در درایوهای ساخته شده پس از سال ۲۰۰۰ دیگر کافی نبود. به پارامتر
.B readahead=
در گزینه
.B paraopts=
در زیر مراجعه کنید.
.sp
.ne 10
اگر حالت
.B paranoia
استفاده شود،
.B cdda2wav
برخی از آمارهای کیفیت را برای هر قطعه استخراج‌شده نمایش می‌دهد.
موارد زیر در فهرست ظاهر می‌شوند:
.TS H
center box;
r | l.
مقدار	توضیحات
_
rderr	تعداد خطاهای سخت‌افزاری خواندن
skip	تعداد سکتورهای رد شده به دلیل اتمام دفعات تلاش مجدد
atom	تعداد لرزش‌های درون‌سکتوری (لرزش فریم) شناسایی‌شده
edge	تعداد لرزش‌های بین سکتورها شناسایی‌شده
drop	تعداد بایت‌های افتاده تصحیح‌شده
dup	تعداد بایت‌های تکراری تصحیح‌شده
drift	تعداد انحراف‌های (drift) شناسایی‌شده
c2	تعداد سکتورهای دارای خطاهای C2
reads	تعداد بلوک‌های پیش‌خوانی خوانده‌شده و درصد نسبت به اندازه قطعه
overlap	تعداد دفعات افزایش اندازه پویای همپوشانی
.TE
.RS
.LP
شاخص‌های کیفیت با جزئیات:
.TP
.B rderr
تعداد درخواست‌های ناموفق سطح پایین برای خواندن.
هر خواندن برای
.B sectors\-per\-request
سکتور انجام می‌شود.
اندازه
.B sectors\-per\-request
معمولاً کمتر از اندازه بافر پیش‌خوانی است.
.TP
.B skip
تعداد سکتورهایی که رد شده‌اند زیرا تعداد دفعات تلاش مجدد برای خواندن به پایان رسیده و هیچ خواندن موفقی امکان‌پذیر نبوده است.
.TP
.B atom
تعداد لرزش‌هایی که در داخل سکتورها شناسایی شده‌اند.
این حالت هرگز نباید رخ دهد، اما هر زمان که یک خطای غیرقابل تصحیح C2 رخ دهد، درایو ممکن است همگام‌سازی جریان داده را از دست بدهد.
افزایش اندازه بافر پیش‌خوانی ممکن است نتایج خطاهای atom را کاهش دهد.
.TP
.B edge
تعداد لرزش‌هایی که در لبه‌های سکتورها شناسایی شده‌اند.
این مشکل می‌تواند ناشی از خطاهای موقعیت‌یابی سکتور باشد.
افزایش اندازه بافر پیش‌خوانی ممکن است نتایج خطاهای edge را کاهش دهد.
.TP
.B drop
تعداد نمونه‌های افتاده (از دست رفته).
این مشکل می‌تواند ناشی از خطاهای موقعیت‌یابی سکتور باشد.
افزایش اندازه بافر پیش‌خوانی ممکن است نتایج خطاهای edge را کاهش دهد.
.TP
.B dup
نمونه‌های تکراری، که می‌توانند مانند نمونه‌های افتاده بر اثر خطاهای موقعیت‌یابی سکتور رخ دهند.
افزایش اندازه بافر پیش‌خوانی ممکن است نتایج خطاهای edge را کاهش دهد.
.TP
.B drift
این مقدار میزان انحراف‌های شناسایی‌شده هنگام بررسی ناحیه همپوشانی است.
.TP
.B c2
تعداد سکتورهای دارای خطای C2 که هنگام خواندن آخرین قطعه مشاهده شده است.
از آنجا که کد پارانویا تمایل دارد قسمت‌های خراب دیسک را چندین بار بخواند، این تعداد معمولاً بیشتر از مقداری است که در صورت خواندن دیسک به صورت خطی و یک‌باره نمایش داده می‌شد.
از
.B paraopts=disable,c2check
برای مشاهده مقداری که نمایانگر وضعیت واقعی دیسک است استفاده کنید.
.TP
.B reads
تعداد بلوک‌های پیش‌خوانی خوانده‌شده برای آخرین قطعه توسط لایه بالاتر و درصد مقدار داده خوانده‌شده در مقایسه با اندازه قطعه.
این درصد معمولاً ۲۰۰٪ است زیرا کد پارانویا تمام داده‌ها را حداقل دو بار می‌خواند. اگر همپوشانی و مشکلات خواندن زیادی وجود داشته باشد، این درصد افزایش می‌یابد.
.TP
.B overlap
تعداد دفعاتی که اندازه همپوشانی افزایش یافته است. این اتفاق زمانی رخ می‌دهد که اندازه همپوشانی کمتر از حداکثر اندازه همپوشانی باشد و خطاهایی در ناحیه همپوشانی شناسایی شوند.
.RE
.br
.ne 15
.TP
.BI \-paraopts= list
پارامتر
.I List
فهرستی از گزینه‌های فرعی جداشده با کاما است که به کتابخانه paranoia منتقل می‌شوند.
.TS H
center box;
r | l.
گزینه	توضیحات
_
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
.TE
.RS
.LP
پارامترهای
.B paraopts=
با جزئیات:
.TP
.B disable
تصحیحات paranoia غیرفعال می‌شوند، اما داده‌ها همچنان از میان کدهای
.BR libparanoia
هدایت می‌گردند.
این گزینه امکان فعال‌سازی تشخیص خطای C2 و بررسی آمار خطاهای C2 را برای یک سی‌دی فراهم می‌سازد.
.TP
.B no\-verify
این گزینه اعتبارسنجی یکپارچگی داده‌ها را در ناحیه همپوشانی خاموش می‌کند و کنترل پویای همپوشانی را به نفع یک مقدار همپوشانی ایستا غیرفعال می‌سازد.
.TP
.BI retries= amount
حداکثر تعداد دفعات تلاش مجدد برای خواندن به ازای هر سکتور را در صورت بروز خطاهای سخت‌افزاری تعیین می‌کند. مقدار پیش‌فرض برای این پارامتر
.BR 20
است.
این همان مقداری است که توسط دستور قدیمی
.BR cdparanoia (1)
استفاده می‌شد.
.TP
.BI readahead= amount
تعداد سکتورهای مورد استفاده برای بافر پیش‌خوانی را تعیین می‌کند.
به جز در انتهای دیسک،
.B libparanoia
هرگز کمتر از این مقدار داده را از کد I/O سطح پایین درخواست نمی‌کند.
اندازه بافر پیش‌خوانی معمولاً بزرگ‌تر از حداکثر اندازه برای یک DMA منفرد در سیستم است. به همین دلیل،
.B libparanoia
چندین عملیات خواندن را برای پر کردن بافر پیش‌خوانی فراخوانی می‌کند.
مقدار پیش‌فرض مورد استفاده توسط
.B cdda2wav
برابر با ۴۰۰ است که بیشتر از ۱۵۰ سکتور مورد استفاده
.BR cdparanoia (1)
بوده اما همچنان یک مصالحه برای عدم نیاز به حافظه بیش از حد است.
.sp
توصیه می‌شود از اندازه بافر پیش‌خوانی استفاده کنید که کمتر از اندازه RAM در درایو CD-ROM نباشد. اگر درایو بیش از ۱ مگابایت RAM دارد، به ازای هر مگابایت RAM در درایو، از ۴۲۵ سکتور استفاده کنید.
.sp
توجه داشته باشید تا زمانی که مقدار
.B readahead=
خیلی کوچک باشد، کیفیت استخراج بسته به مقدار مورد استفاده بسیار متغیر خواهد بود.
مقدار مورد استفاده توسط
.BR cdparanoia (1)
ممکن است باعث شود کیفیت استخراج حتی کمتر از کیفیتی باشد که
.B cdda2wav
بدون
.BR libparanoia
ارائه می‌دهد.
.TP
.BI overlap= amount
تعداد سکتورهای مورد استفاده برای همپوشانی ایستا را تعیین می‌کند. این گزینه همپوشانی پویا را خاموش می‌سازد.
توصیه می‌شود از همپوشانی ایستا استفاده نکنید. برای به دست آوردن همپوشانی بزرگ‌تر، بهتر است از مقدار
.B minoverlap=
بزرگ‌تری استفاده فرمایید.
.TP
.BI minoverlap= amount
حداقل تعداد سکتورها برای همپوشانی پویا را تعیین می‌کند.
مقدار پیش‌فرض مورد استفاده توسط
.B cdda2wav
برابر با
.BR 0.5
است که بیشتر از پیش‌فرض
.BR cdparanoia (1)
(که برابر با 0.1 است) می‌باشد.
.sp
برای درایوهای قدیمی که از جریان‌سازی دقیق پشتیبانی نمی‌کنند، توصیه نمی‌شود مقدار
.B minoverlap=
بزرگ‌تر یا مساوی با حداکثر اندازه DMA تعیین شود.
.sp
برای دستیابی به بهترین نتایج در سایر درایوها، توصیه می‌شود از مقدار
.B minoverlap=
استفاده شود که کمتر از نصف اندازه پیش‌خوانی نباشد.
.sp
کیفیت استخراج به شدت با مقدار
.B minoverlap=
تغییر می‌کند، اما افزایش این مقدار زمان استخراج را نیز افزایش می‌دهد.
.TP
.BI maxoverlap= amount
حداکثر تعداد سکتورها برای همپوشانی پویا را تعیین می‌کند.
اگر
.B maxoverlap=
مشخص نشده باشد و مقدار
.B minoverlap=
بزرگی تعیین شده باشد، این حالت منجر به یک همپوشانی شبه‌ایستا می‌شود.
مقدار پیش‌فرض مورد استفاده توسط
.B cdda2wav
برابر با
.BR 32
است.
.TP
.B c2check
بررسی خطای C2 را روشن می‌کند.
در حال حاضر، این گزینه فقط به چاپ آمار خطاهای C2 منجر می‌شود.
.sp
هشدار: گزارش شده است که برخی درایوها هنگامی که حالت
.B c2check
فعال است، در خواندن قطعات پنهان با شکست مواجه می‌شوند.
اگر با درایوی برخورد کردید که در آن
.B cdda2wav
قادر به تشخیص خودکار قابل استفاده بودن
.B c2check
نیست، لطفاً گزارش دهید.
.sp
هنگامی که قصد دارید از
.B c2check
در حین استخراج قطعات پنهان استفاده کنید، ابتدا مطمئن شوید که درایو شما قطعات پنهان را با و بدون گزینه
.B c2check
به طور یکسان گزارش می‌کند.
.br
.ne 5
.TP
.B proof
این گزینه یک ماکرو برای پارامترهای استخراج بهتر از مقادیر پیش‌فرض است.
ماکروی
.B proof
به صورت زیر بسط می‌یابد:
.sp
.B "    paraopts=minoverlap=\fIsectors\-per\-request\fP-1,\e
.br
.B "        retries=200,readahead=600
.sp
اگر
.I sectors\-per\-request\f\-1
بیشتر از ۲۰ باشد، مقدار ۲۰ به عنوان حداقل مقدار همپوشانی استفاده می‌شود.
.sp
پارامترهای مورد استفاده توسط
.B proof
هنوز بهترین حالت مطلق نیستند و هیچ مجموعه پارامتر بهینه‌ای برای تمام سناریوها وجود ندارد.
یک مقدار بزرگ‌تر برای اندازه بافر پیش‌خوانی ممکن است مثلاً برای RAM موجود در سیستم بیش از حد بزرگ باشد و بهترین مقدار برای حداقل همپوشانی بستگی به این دارد که درایو از جریان‌سازی دقیق پشتیبانی می‌کند یا خیر.
توصیه می‌شود برای به دست آوردن بهترین نتایج در یک پلتفرم خاص، آزمایش‌هایی را با مقادیر بزرگ‌تر برای پارامترهای
.B minoverlap=
و
.B readahead=
انجام دهید.
.sp
توجه داشته باشید که نسخه‌های قبلی شامل
.B c2check
در ماکروی
.B proof
بودند، اما گزارش شده که این ویژگی در برخی درایوها با مشکل مواجه می‌شود و بنابراین
.B c2check
به طور پیش‌فرض غیرفعال شد.
نسخه‌های فعلی
.B cdda2wav
به طور خودکار بررسی می‌کنند که آیا درایو فعلی از قابلیت
.B c2check
پشتیبانی می‌کند یا خیر و در صورت امکان از آن استفاده می‌نمایند.
.RE
.br
.TP
.B \-q
.TP
.B \-quiet
عملیات بی‌صدا، بدون خروجی روی صفحه نمایش.
.TP
.BI \-r " rate
.TP
.BI  \-rate " rate
نرخ نمونه‌برداری
.I rate
را بر حسب نمونه در ثانیه تنظیم می‌کند. مقادیر ممکن با گزینه
.B \-R
فهرست شده‌اند.
.TP
.B \-R
.TP
.B \-dump\-rates
فهرستی از تمام نرخ‌های نمونه‌برداری و مقسم‌های آن‌ها را نمایش می‌دهد.
.TP
.BI \-S " speed
.TP
.BI \-speed " speed
دستگاه سی‌دی‌رام را روی یکی از سرعت‌های قابل انتخاب برای خواندن تنظیم می‌کند.
برای حداکثر کیفیت استخراج، توصیه می‌شود از مقادیر سرعت ۸ یا کمتر استفاده شود.
.sp
حالت پیش‌فرض، استخراج با حداکثر سرعت است.
.TP
.B \-s
.TP
.B \-stereo
حالت ضبط را روی استریو تنظیم می‌کند.
.TP
.BI \-start\-sector " sector
یک سکتور شروع مطلق را تنظیم می‌کند. این گزینه با گزینه‌های
.B \-track
و
.BR \-offset
ناسازگار و مانعة‌الجمع است.
.br
.ne 10
.br
.TP
.BI \-t " track[+endtrack]
.TP
.BI \-track " track[+endtrack]
.TP
.BI \-track " track" +max
.TP
.B "\-track\ all"
قطعه شروع و به صورت اختیاری قطعه پایان را انتخاب می‌کند.
اگر از
.B "\-t\ all"
استفاده شود، تمام قطعات صوتی انتخاب می‌شوند.
اگر از
.B "\-t\ 2+max"
استفاده شود، تمام قطعات صوتی که از قطعه ۲ شروع می‌شوند انتخاب خواهند شد.
.br
.ne 5
.TP
.BI \-v " itemlist
.TP
.BI \-verbose\-level " itemlist
اطلاعات مفصل و پرگویی را درباره سی‌دی واکشی و چاپ می‌کند.
.B Level
فهرستی از گزینه‌های فرعی جداشده با کاما است. هر گزینه فرعی نوع اطلاعاتی را که باید گزارش شود کنترل می‌کند.

.TS H
center box;
r | l.
گزینه فرعی	توضیحات
_
!	معکوس کردن معنای رشته پس از آن
not	معکوس کردن معنای رشته پس از آن
disable	هیچ اطلاعاتی داده نمی‌شود، اما هشدارها نمایش داده می‌شوند
all	تمام اطلاعات ارائه می‌شود
toc	نمایش جدول محتویات (TOC)
summary	نمایش خلاصه‌ای از پارامترهای ضبط
indices	تعیین و نمایش آفست‌های نمایه
catalog	واکشی و نمایش شماره کاتالوگ رسانه MCN
mcn	واکشی و نمایش شماره کاتالوگ رسانه MCN
trackid	واکشی و نمایش تمام کدهای بین‌المللی استاندارد ضبط ISRC
isrc	واکشی و نمایش تمام کدهای بین‌المللی استاندارد ضبط ISRC
sectors	نمایش جدول محتویات با نمادگذاری سکتور شروع
titles	نمایش جدول محتویات همراه با عناوین قطعات (در صورت موجود بودن)
audio-tracks	فهرست کردن قطعات صوتی و سکتورهای شروع آن‌ها
.TE
.sp
سطح پرگویی پیش‌فرض
.BR "toc,summary,sectors,titles" " ."
.TP
.B \-w
.TP
.B \-wait
منتظر سیگنال می‌ماند، سپس ضبط را آغاز می‌کند.
.TP
.B \-x
.TP
.B \-max
کیفیت حداکثر (کیفیت استاندارد CD) را تنظیم می‌کند.
.SS "گزینه‌های SCSI (SCSI options)"
.TP
.BI dev= device
.TP
.BI \-D " device
.TP
.BI \-device " device
از
.I device
به عنوان منبع برای خواندن CDDA استفاده می‌کند.
به عنوان مثال dev/cdrom/ برای رابط
.B cooked_ioctl
و Bus,ID,Lun برای رابط
.BR generic_scsi .
پارامتر
.I device
در صورت تعیین باید با تنظیم رابط مطابقت داشته باشد (گزینه
.BR \-I " و " \-interface
در زیر را ببینید).
.sp
اگر هیچ گزینه
.BR \-I " یا " \-interface
مشخص نشده باشد، تنظیم رابط از ساختار نحوی نام دستگاه استخراج می‌شود. نام دستگاهی که به صورت Bus,ID,Lun باشد یا شامل دونقطه (':') باشد، به طور پیش‌فرض روی رابط
.B generic_scsi
قرار می‌گیرد.
.sp
استفاده از
.B cooked_ioctl
توصیه نمی‌شود زیرا باعث می‌شود
.B cdda2wav
عمدتاً به کیفیت استخراج صوتی سیستم‌عامل وابسته باشد که معمولاً بسیار بد است. به همین دلیل، از استفاده از پارامترهایی مانند
.BR dev= /dev/cdrom
برای دستگاه خودداری کنید.
.sp
تنظیم متغیر محیطی
.B CDDA_DEVICE
توسط این گزینه لغو می‌شود.
.sp
اگر هیچ گزینه
.B dev=
وجود نداشته باشد، یا اگر گزینه
.B dev=
فقط حاوی یک مشخص‌کننده انتقال باشد اما آدرسی نداشته باشد،
.B cdda2wav 
تلاش می‌کند فضای آدرس SCSI را برای یافتن درایوهای CD-ROM پویش کند.
اگر دقیقاً یک درایو پیدا شود، به طور پیش‌فرض از همان استفاده می‌شود.
.sp
برای اطلاعات بیشتر، توضیحات مربوط به گزینه
.B dev=
در
.BR cdrecord (1)
را ببینید.
.TP
.BI debug= #
.TP
.BI debug-scsi= #
سطح اشکال‌زدایی را برای لایه انتزاعی سیستم‌عامل SCSI در
.B libscg
تنظیم می‌کند.
.TP
.BI kdebug= #
.TP
.BI kdebug-scsi= #
.TP
.BI kd= #
سطح اشکال‌زدایی هسته را برای درایور کرنل فراخوانی‌شده توسط لایه انتزاعی سیستم‌عامل SCSI در
.B libscg
تنظیم می‌کند. این گزینه در همه پلتفرم‌ها پشتیبانی نمی‌شود.
.TP
.B \-scanbus
تمام دستگاه‌های SCSI را روی تمام گذرگاه‌های SCSI پویش کرده و رشته‌های inquiry را چاپ می‌کند. این گزینه ممکن است برای یافتن آدرس SCSI دستگاه CD/DVD-Recorder روی سیستم استفاده شود.
عددهای چاپ‌شده به عنوان برچسب‌ها با فرمول زیر محاسبه می‌شوند:
.B "bus * 100 + target
.TP
.BI scgopts= list
فهرستی از گزینه‌های SCSI جداشده با کاما که توسط libscg مدیریت می‌شوند.
گزینه‌های پیاده‌سازی‌شده ممکن است مستقل از برنامه‌ها به‌روزرسانی شوند.
در حال حاضر یک گزینه:
.B ignore\-resid
برای دور زدن یک باگ کرنل لینوکس پشتیبانی می‌شود.
.TP
.BI ts= #
حداکثر اندازه انتقال را برای یک دستور منفرد SCSI روی # تنظیم می‌کند.
نحو گزینه
.B ts=
مشابه دستور cdrecord fs=# یا sdd bs=# است.
.sp
اگر هیچ گزینه
.B ts=
مشخص نشده باشد،
.B cdda2wav
به طور پیش‌فرض اندازه انتقال را روی 3\ MB قرار می‌دهد. اگر libscg مقادیر کمتری از سیستم‌عامل دریافت کند، مقدار به حداکثر مقدار ممکن در سیستم‌عامل جاری کاهش می‌یابد.
گاهی اوقات ممکن است کاهش بیشتر اندازه انتقال یا افزایش آن مفید باشد، اما توجه داشته باشید که یافتن مقدار بهتر با آزمایش روی گزینه
.B ts=
ممکن است زمان زیادی ببرد.
.sp
برخی سیستم‌عامل‌ها مقادیر نادرستی برای حداکثر اندازه انتقال برمی‌گردانند.
اگر انتقال کاملاً متوقف شود یا ریست رخ دهد، ممکن است کاهش اندازه انتقال به کمتر از ۶۴ کیلوبایت یا حتی کمتر از ۳۲ کیلوبایت مناسب باشد.
.TP
.B \-V
.TP
.B \-verbose\-scsi
ثبت وقایع دستورات SCSI در کنسول را فعال می‌کند. این گزینه عمدتاً برای اشکال‌زدایی استفاده می‌شود.
.TP
.B \-Q
.TP
.B \-silent\-scsi
گزارش‌های خطای دستورات SCSI به کنسول را متوقف و بی‌صدا می‌کند. این گزینه عمدتاً برای واسط‌های گرافیکی (GUI) استفاده می‌شود.

.SS "گزینه‌های رابط سیستم‌عامل (OS Interface options)"
.TP
.BI \-A " auxdevice
.TP
.BI \-auxdevice " auxdevice
از
.I auxdevice
به عنوان درایو CDROM استفاده می‌کند تا امکان ارسال ioctl مربوط به CDROMMULTISESSION در لینوکس وجود داشته باشد، حتی اگر رابط
.B generic_scsi
در حال استفاده باشد.
.TP
.BI \-I " interface
.TP
.BI \-interface " interface
مشخص می‌کند کدام
.I رابط
برای دسترسی به CDROM استفاده شود:
.sp
.RS
.TP
.B generic_scsi
برای ارسال مستقیم دستورات SCSI به درایو.
.TP
.B cooked_ioctl
برای استفاده از رابط برنامه‌نویسی ارائه‌شده توسط کرنل سیستم‌عامل.
.RE
.sp
.RS
مورد دوم توصیه نمی‌شود زیرا کیفیت کمتری ارائه می‌دهد و فقط در تعداد محدودی از پلتفرم‌ها کار می‌کند.
.RE
.br
.ne 20
.TP
.B \-interactive
به حالت تعاملی وارد می‌شود که دستورات را از
.B stdin 
می‌خواند و پاسخ‌های متنی را در
.BR stderr ،
یا توصیف‌گر پرونده مشخص‌شده توسط گزینه
.B out\-fd
می‌نویسد.
این حالت عمدتاً برای این معرفی شده است که افزونه‌های gstreamer بتوانند cdrecord را فراخوانی کنند.
.sp
.ne 20
اگر
.B cdda2wav
با گزینه
.BR \-interactive
فراخوانی شود، جدول محتویات (TOC) را از رسانه خوانده و سپس منتظر ورودی دستور می‌ماند گویی دستور
.B stop
صادر شده است. اگر دستور بعدی
.B cont
باشد، سپس
.B cdda2wav
کل بخش صوتی رسانه را استخراج می‌کند.
اگر دستور بعدی
.B read 
باشد، سپس
.B cdda2wav
استخراج را از موقعیتی که با پارامتر دستور
.B read
مشخص شده است شروع می‌کند.
.TS H
center box;
c | l | l
c | l | l.
دستور	پارامترها	توضیحات
_
cont		ادامه پردازش در موقعیت فعلی
exit		خروج از پردازش
help		چاپ راهنمای دستور و انتظار برای ورودی
quit		خروج از پردازش
read	sectors \fIsector number\fP	خواندن سکتورها از \fIsector number\fP
read	tracks \fItrack number\fP	خواندن سکتورها از \fItrack number\fP
stop		توقف پردازش و انتظار برای ورودی جدید
.TE
.TP
.BI out\-fd= descriptor
خروجی اطلاعاتی را به توصیف‌گر پرونده مشخص‌شده توسط
.BR descriptor
تغییر مسیر می‌دهد.
پارامتر
.B descriptor
یک شماره توصیف‌گر پرونده یونیکس را مشخص می‌کند.
به طور پیش‌فرض،
.B cdda2wav
خروجی اطلاعاتی را به
.BR stderr
می‌فرستد.
تغییر مسیر خروجی اطلاعاتی به یک توصیف‌گر پرونده دیگر به واسط‌های گرافیکی و سایر برنامه‌هایی که
.B cdda2wav
را از طریق لوله‌ها (pipes) فراخوانی می‌کنند کمک می‌کند.
.TP
.BI audio\-fd= descriptor
در صورتی که نام پرونده برای پرونده داده‌های صوتی "-" باشد، خروجی صوتی را به توصیف‌گر پرونده تعیین‌شده توسط
.BR descriptor
هدایت می‌کند.
پارامتر
.B descriptor
یک شماره توصیف‌گر پرونده یونیکس را مشخص می‌کند.
به طور پیش‌فرض،
.B cdda2wav
اگر خروجی به درون یک پرونده هدایت نشود، داده‌های صوتی را به
.B stdout
می‌فرستد.
هدایت خروجی صوتی به یک توصیف‌گر پرونده دیگر به واسط‌های گرافیکی و برنامه‌هایی که
.B cdda2wav
را از طریق لوله‌ها فراخوانی می‌کنند کمک می‌نماید.
.br
.ne 7
.TP
.B \-no-fork
برای بافرسازی گسترده فرآیند را چنگال (انشعاب / fork) نمی‌کند. اگر از
.B \-no-fork
استفاده شود و از
.B cdda2wav
برای بازپخش سی‌دی‌های صوتی در حالت
.B paranoia
استفاده شود، ممکن است پخش به دلیل کمبود بافرسازی قطع گردد.
از سوی دیگر، اجازه دادن به
.B cdda2wav
برای fork زمان تأخیر را برای حالت
.B \-interactive
افزایش خواهد داد.
.TP
.B \-e
.TP
.B \-echo
داده‌های صوتی را در دستگاه صوتی سیستم‌عامل مثلاً
.BR /dev/dsp
کپی می‌کند.
.TP
.BI "sound\-device=" sounddevice
یک دستگاه صوتی جایگزین را برای استفاده با
.BR \-e
تنظیم می‌کند.
.ne 5
.TP
.BI \-n " sectors
.TP
.BI \-sectors\-per\-request " sectors
تعداد
.I sectors
سکتور را در هر درخواست می‌خواند.
.TP
.BI \-l " buffers
.TP
.BI \-buffers\-in\-ring " buffers
از یک بافر حلقوی با مجموع
.I buffers
بافر استفاده می‌کند.

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
برخی از مقادیر پیش‌فرض برای
.B cdda2wav
به صورت کامپایل‌شده درون برنامه قرار دارند و به
.B Makefile
بستگی دارند و برخی دیگر به تنظیمات
.B متغیرهای محیطی
وابسته‌اند.
.br
.ne 5
.TP
.B CDDA_DEVICE
برای تنظیم نام دستگاه استفاده می‌شود. نام‌گذاری دستگاه با
.BR cdrecord (1)
سازگار است.
.TP
.B CDDBP_SERVER
در صورت ارائه، برای جستجوی عناوین در cddbp استفاده می‌شود.
.TP
.B CDDBP_PORT
در صورت ارائه، برای جستجوی عناوین در cddbp استفاده می‌شود.
.TP
.B RSH
اگر متغیر محیطی
.B RSH
موجود باشد، اتصال راه دور از طریق
.BR rcmd (3)
ایجاد نمی‌شود، بلکه با فراخوانی برنامه‌ای که
.B RSH
به آن اشاره دارد برقرار می‌گردد. مثلاً از
.BR RSH= /usr/bin/ssh
برای ایجاد یک اتصال پوسته امن (SSH) استفاده کنید.
.sp
توجه داشته باشید که این کار
.B cdda2wav
را وادار می‌کند یک لوله به برنامه
.BR rsh (1)
ایجاد کند و اجازه دسترسی مستقیم
.B cdda2wav
به سوکت شبکه سرور راه دور را نمی‌دهد.
این امر تنظیم پارامترهای کارایی را غیرممکن ساخته و سرعت اتصال را در مقایسه با یک اتصال
.BR rcmd (3)
آغازشده توسط
.B root
کاهش می‌دهد.
.TP
.B RSCSI
اگر متغیر محیطی
.B RSCSI
موجود باشد، سرور SCSI راه دور برنامه
.B /opt/schily/sbin/rscsi
نخواهد بود، بلکه برنامه‌ای خواهد بود که
.B RSCSI
به آن اشاره دارد.
توجه داشته باشید که اگر با حسابی وارد سیستم شوید که با یک برنامه سرور SCSI راه دور به عنوان پوسته ورود (login shell) ایجاد شده باشد، نام برنامه سرور SCSI راه دور نادیده گرفته خواهد شد.
.SH "وضعیت خروج (EXIT STATUS)"
.B cdda2wav
از کدهای خروج زیر برای نشان دادن درجات مختلف موفقیت یا شکست استفاده می‌کند:
.TS H
center box;
r | l.
کد خروج	توضیحات
_
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).
.TE
.SH "بحث و بررسی (DISCUSSION)"
.B cdda2wav
قادر است بخش‌هایی از یک سی‌دی
.B صوتی
یا CDROM
.B چندرسانه‌ای
(شامل بخش‌های صوتی) را مستقیماً به صورت دیجیتال بخواند. این بخش‌ها را می‌توان در یک پرونده، یک لوله یا یک دستگاه صوتی نوشت.
.PP
نام
.B cdda2wav
مخفف
.B CDDA
به
.B WAV
است (که در آن
.B CDDA
نمایانگر Compact Disc Digital Audio و
.B WAV
یک قالب نمونه صوتی معرفی‌شده توسط MS Windows است). این ابزار امکان کپی داده‌های صوتی
.B CDDA
را از درایو CDROM به پرونده‌ای در قالب
.B WAV
یا سایر قالب‌ها فراهم می‌سازد.
.PP
برخی از نسخه‌های
.B cdda2wav
ممکن است تلاش کنند اولویت‌های زمان‌بندی بلادرنگ بالاتری را به دست آورند تا عملکرد روان (بدون وقفه) را تضمین کنند. این اولویت‌ها برای کاربران ارشد (مدیر سیستم) در دسترس بوده و بالاتر از اولویت‌های فرآیندهای «معمولی» هستند؛ بنابراین تاخیرها به حداقل می‌رسد.
.PP
اگر فقط یک CDROM دارید و یک سی‌دی صوتی در آن بارگذاری شده است، می‌توانید به سادگی
.B cdda2wav
را فراخوانی کنید و در صورت وجود فضای خالی کافی در سیستم پرونده، پرونده صوتی
.B audio.wav
را با ضبط کل قطعه از قطعه ۱ به صورت استریو با ۱۶ بیت در نرخ نمونه‌برداری ۴۴۱۰۰ هرتز ایجاد خواهد کرد. در غیر این صورت زمان ضبط محدود خواهد شد. برای جزئیات، پرونده‌های
.B README
و
.BR README.INSTALL
را ببینید.
.PP
اگر بیش از یک درایو از نوع CD-ROM در سیستم دارید، باید گزینه
.B dev=
را مشخص کنید.
.SH "نکاتی درباره گزینه‌ها (HINTS ON OPTIONS)"
.PP
بیشتر گزینه‌ها برای کنترل قالب پرونده WAV استفاده می‌شوند. در متن زیر، بیشتر آن‌ها با جزئیات بیشتری مورد بحث قرار گرفته‌اند.
.SS "انتخاب دستگاه (Select Device)"
.BI dev= "device"
دستگاه درایو CDROM مورد استفاده را انتخاب می‌کند.
مشخص‌کننده داده‌شده باید با رابط انتخاب‌شده مطابقت داشته باشد (زیر را ببینید).
برای رابط
.B cooked_ioctl
این توصیف‌گر دستگاه cdrom است.
.B "دستگاه‌های SCSI که با رابط عمومی SCSI استفاده می‌شوند، بر خلاف توصیف‌گر عمومی دستگاه SCSI،
.B "با گذرگاه SCSI، شناسه SCSI و LUN مربوط به SCSI آدرس‌دهی می‌شوند.
یک مثال برای یک درایو SCSI CDROM روی گذرگاه 0 با شناسه SCSI برابر با 3 و lun برابر با 0 عبارت است از:
.BR dev=0,3,0 .
.SS "انتخاب دستگاه کمکی (Select Auxiliary device)"
.BI \-A " auxdevice"
ممکن است در برخی موارد نادر برای مدیریت CD-Extra مورد نیاز باشد.
.B Cdda2wav
معمولاً مشکلی در دریافت اطلاعات multi-session برای CD-Extra با استفاده از دستورات خام SCSI ندارد.
برای درایوهای Non-SCSI-CDROM، این همان دستگاه داده‌شده توسط
.B dev=
است (بالا را ببینید). برای درایوهای SCSI-CDROM، این دستگاه درایو CDROM (دستگاه SCSI، یعنی
.B /dev/sr0
) متناظر با دستگاه SCSI (یعنی
.B 0,3,0
) است و باید با دستگاه مورد استفاده برای نمونه‌برداری مطابقت داشته باشد.
.SS "انتخاب رابط (Select Interface)"
.BI \-I " interface"
روش ارتباطی درایو CDROM را انتخاب می‌کند.
این روش رابط معمولاً به طور خودکار از نام دستگاه تشخیص داده می‌شود.
برای درایوهای SCSI، رابط
.B generic_scsi
استفاده می‌شود (cooked_ioctl ممکن است برای همه دستگاه‌ها در دسترس نباشد).
نام‌های معتبر عبارتند از
.B generic_scsi
و
.BR cooked_ioctl .
اولی از رابط عمومی SCSI استفاده می‌کند و دومی از ioctl درایور CDROM استفاده می‌نماید. حالت دوم فقط زمانی کار می‌کند که درایور کرنل از خواندن
.B CDDA
پشتیبانی کند. این ورودی باید با دستگاه CDROM انتخاب‌شده مطابقت داشته باشد (بالا را ببینید).
.SS "فعال‌سازی بازپخش روی کارت صدا (Enable echo to soundcard)"
.B \-e
داده‌های صوتی را هنگام ضبط در کارت صدا کپی می‌کند، بنابراین می‌توانید صدا را تقریباً همزمان بشنوید. کارت صدا همان داده‌هایی را دریافت می‌کند که ضبط می‌شوند. این کار از نظر زمانی حساس است، بنابراین با گزینه
.B \-q
بهترین عملکرد را دارد. برای استفاده از
.B cdda2wav
به عنوان یک پخش‌کننده شبه‌سی‌دی بدون ذخیره در یک پرونده، می‌توانید از دستور زیر:
.PP
.B "cdda2wav \-q \-e \-t2 \-d0 \-N"
.PP
برای پخش کل قطعه دوم یا:
.PP
.B "cdda2wav \-q \-e \-B \-N"
.PP
برای پخش کل دیسک استفاده کنید.
این ویژگی سرعت ضبط را حداکثر به سرعت ۱ برابر (یک‌برابر) کاهش می‌دهد.
.SS "تغییر گام صدای بازپخش‌شده (Change pitch of echoed audio)"
.B "\-p percentage"
گام (زیر و بمی) تمام صداهای بازپخش‌شده روی کارت صدا را تغییر می‌دهد. فقط کپی ارسالی به کارت صدا تحت تأثیر قرار می‌گیرد و نمونه‌های صوتی ضبط‌شده در پرونده بدون تغییر باقی می‌مانند.
گام معمولی که پیش‌فرض است، با مقدار 100 مشخص می‌شود.
درصدهای پایین‌تر متناظر با گام‌های بم‌تر هستند؛ یعنی
50 p\- خروجی صوتی را یک اکتاو بم‌تر می‌کند.
همچنین اسکریپت
.B pitchplay
را به عنوان مثال ببینید. این گزینه توسط Raul Sobon ارائه شده است.
.SS "انتخاب ضبط مونو یا استریو (Select mono or stereo recording)"
.B \-m
یا
.B "\-c 1"
ضبط مونو را انتخاب می‌کند (هر دو کانال استریو با هم میکس می‌شوند)،
.B \-s
یا
.B "\-c 2"
یا
.B "\-c s"
ضبط استریو را انتخاب می‌کند. پارامتر s جای هر دو کانال صوتی را عوض می‌کند.
.SS "انتخاب بیشترین کیفیت (Select maximum quality)"
.B \-x
حالت استریو، ۱۶ بیت به ازای هر نمونه در ۴۴.۱ کیلوهرتز (کیفیت کامل CD) را تنظیم می‌کند. توجه داشته باشید که سایر گزینه‌های قالب که بعداً مشخص شوند می‌توانند این تنظیم را تغییر دهند.
.SS "انتخاب کیفیت نمونه‌برداری (Select sample quality)"
.B "\-b 8"
مقدار ۸ بیت (۱ بایت) را برای هر نمونه در هر کانال مشخص می‌کند؛
.B "\-b 12"
مقدار ۱۲ بیت (۲ بایت) را برای هر نمونه در هر کانال مشخص می‌کند؛
.B "\-b 16"
مقدار ۱۶ بیت (۲ بایت) را برای هر نمونه در هر کانال مشخص می‌کند (اطمینان حاصل کنید که پخش‌کننده نمونه یا کارت صدای شما قادر به پخش نمونه‌های ۱۲ بیتی یا ۱۶ بیتی است). انتخاب ۱۲ یا ۱۶ بیت اندازه پرونده را دو برابر می‌کند. نمونه‌های ۱۲ بیتی با نمونه‌های ۱۶ بیتی هم‌تراز می‌شوند، بنابراین مقداری فضای دیسک را هدر می‌دهند.
.SS "انتخاب نرخ نمونه‌برداری (Select sample rate)"
.BI \-r " samplerate"
یک نرخ نمونه‌برداری را انتخاب می‌کند.
.I samplerate
می‌تواند در محدوده بین ۹۰۰ تا ۴۴۱۰۰ باشد. گزینه
.B \-R
تمام نرخ‌های موجود را فهرست می‌کند.
.SS "انتخاب مقسم نرخ نمونه‌برداری (Select sample rate divider)"
.BI \-a " divider"
یک مقسم نرخ نمونه‌برداری را انتخاب می‌کند.
.I divider
می‌تواند از ۱ تا ۵۰.۵ با گام‌های ۰.۵ باشد. گزینه
.B \-R
تمام نرخ‌های موجود را فهرست می‌کند.
.sp
برای روان‌تر کردن صدا در نرخ‌های نمونه‌برداری پایین‌تر،
.B cdda2wav
روی
.I n
نمونه مجموع می‌گیرد (که در آن
.I n
مقسم مربوطه است). بنابراین برای خروجی ۲۲۰۵۰ هرتز باید روی ۲ نمونه و برای ۹۰۰ هرتز روی ۴۹ نمونه جمع بزنیم. این کار فرکانس‌های بالاتر را حذف می‌کند. اندازه سکتور استاندارد یک سی‌دی صوتی (با صرف‌نظر از اطلاعات اضافی) ۲۳۵۲ بایت است. برای پایان دادن به عمل جمع برای یک نمونه خروجی در مرزهای سکتور، باید نرخ‌های فوق انتخاب شوند. نرخ‌های نمونه‌برداری دلخواه با کیفیت بالا نیازمند نوعی طرح درون‌یابی (اینترپولیشن) است که نیازمند برنامه‌نویسی بسیار پیچیده‌تری است.
.SS "فهرست جدول تمامی نرخ‌های نمونه‌برداری (List a table of all sampling rates)"
.BI \-R
فهرستی از تمام نرخ‌های نمونه‌برداری و مقسم‌های آن‌ها را نمایش می‌دهد. مقسم‌ها می‌توانند از ۱ تا ۵۰.۵ با گام‌های ۰.۵ باشند.
.SS "انتخاب قطعه شروع و به صورت اختیاری قطعه پایان (Select start track and optionally end track)"
.BI \-t " n+m"
مقدار
.B n
را به عنوان قطعه شروع و به صورت اختیاری
.B m
را به عنوان آخرین قطعه از محدوده مورد ضبط انتخاب می‌کند.
این قطعات باید در جدول محتویات (TOC) موجود باشند. این تنظیم قطعه‌ای را که ضبط از آن آغاز می‌شود تعیین می‌کند. ضبط می‌تواند از طریق قطعات بعدی نیز پیش برود (که با قطعه پایانی اختیاری محدود می‌شود یا به مدت‌زمان ضبط بستگی دارد). اینکه آیا یک پرونده ایجاد شود یا پرونده‌های مختلف، به گزینه
.B \-B
بستگی دارد (زیر را ببینید).
.SS "انتخاب نمایه شروع (Select start index)"
.BI \-i " n"
نمایه‌ای (اندیسی) را که ضبط با آن آغاز می‌شود انتخاب می‌کند. نمایه‌هایی غیر از ۱ باعث فراخوانی اسکنر نمایه می‌شوند که یافتن موقعیت شروع صحیح توسط آن مدتی زمان می‌برد. همچنین ممکن است یک آفست اضافی نیز تعیین شود (زیر را ببینید).
.SS "تنظیم مدت‌زمان ضبط (Set recording duration)"
.B \-d " n"
مدت زمان ضبط را روی
.I n
ثانیه تنظیم می‌کند یا در صورتی که
.I n
صفر باشد، مدت ضبط را برای کل قطعه تنظیم می‌نماید. برای مشخص کردن مدت‌زمان بر حسب فریم (سکتور)، آرگومان می‌تواند یک پسوند 'f' داشته باشد؛ در این حالت آرگومان عددی به عنوان فریم (سکتور) به جای ثانیه در نظر گرفته می‌شود.
لطفاً توجه داشته باشید که اگر از محدوده‌های قطعه استفاده شود، آن‌ها نیز مدت‌زمان ضبط را تعیین می‌کنند و بنابراین زمان مشخص‌شده توسط هر گزینه
.BR \-d
را لغو می‌نمایند.
.sp
مدت‌زمان ضبط به عنوان زمانی تعریف می‌شود که نمونه تولیدشده پخش خواهد شد (در نرخ نمونه‌برداری تعیین‌شده). از آنجا که این زمان با مقدار نمونه‌های تولیدشده مرتبط است، زمان خود فرآیند نمونه‌برداری نیست (که می‌تواند کمتر یا بیشتر باشد). همچنین به طور دقیق با اطلاعات زمانی روی سی‌دی صوتی (که توسط دستگاه پخش خانگی نشان داده می‌شود) جفت نشده است.
تفاوت‌ها می‌توانند ناشی از استفاده از گزینه
.B \-o
باشند (زیر را ببینید). توجه داشته باشید که مدت‌زمان ضبط کوتاه‌تر خواهد شد، مگر اینکه فضای دیسک کافی وجود داشته باشد. ضبط را می‌توان در هر زمان با فشردن کلید توقف (سیگنال SIGQUIT) لغو کرد.
.SS "ضبط تمام قطعات یک سی‌دی صوتی در پرونده‌های مجزا (Record all tracks of a complete audio CD in separate files)"
.B \-B
هر قطعه را در یک پرونده جداگانه کپی می‌کند. می‌توان یک نام پایه مشخص کرد. نام پرونده‌ها یک شماره قطعه پیوست‌شده و یک پسوند متناظر با قالب صوتی دارند. برای ضبط تمام قطعات صوتی یک سی‌دی، از مدت‌زمان به اندازه کافی بزرگ (مثلاً 99999 d\-) استفاده کنید.
.SS "تنظیم آفست سکتور شروع (Set start sector offset)"
.BI \-o " sectors"
سکتور شروع قطعه را به میزان
.IR sectors
افزایش می‌دهد.
با استفاده از این گزینه می‌توانید مقدار معینی را در ابتدای یک قطعه رد کنید تا دقیقاً بخشی را که می‌خواهید انتخاب نمایید. هر سکتور ۱/۷۵ ثانیه طول می‌کشد، بنابراین شما کنترل بسیار دقیقی دارید. اگر آفست شما آن‌قدر زیاد باشد که در قطعه جاری جا نشود، یک پیام هشدار صادر شده و آفست نادیده گرفته می‌شود و زمان ضبط کاهش نمی‌یابد. (برای رد کردن خودکار بخش‌های آرام ابتدایی، از گزینه
.B \-w
استفاده کنید، زیر را ببینید.)
.SS "گزینه انتظار برای سیگنال (Wait for signal option)"
.B \-w
روشن کردن این گزینه تمام خروجی‌های بی‌صدا را در ابتدا متوقف و حذف می‌کند که احتمالاً اندازه پرونده را کاهش می‌دهد.
.B cdda2wav
سیگنال خروجی را بررسی می‌کند و با مشاهده هرگونه سیگنال، نوشتن در پرونده را آغاز می‌نماید.
.SS "یافتن مقادیر حدی نمونه‌ها (Find extreme samples)"
.B \-F
روشن کردن این گزینه منفی‌ترین و مثبت‌ترین مقدار نمونه یافت‌شده در حین ضبط را برای هر دو کانال نمایش می‌دهد. این می‌تواند برای تنظیم مجدد حجم صدا مفید باشد. مقادیر نشان‌داده‌شده در مرزهای قطعه بازنشانی نمی‌شوند و کل فرآیند نمونه‌برداری را پوشش می‌دهند. آن‌ها از نمونه‌های اصلی گرفته شده و قالبی یکسان دارند (یعنی مستقل از قالب خروجی انتخاب‌شده هستند).
.SS "تشخیص مونو بودن نمونه‌های ورودی (Find if input samples are in mono)"
.B \-G
اگر این گزینه داده شود، نمونه‌های ورودی برای هر دو کانال مقایسه می‌شوند. در پایان برنامه نتیجه چاپ می‌شود. تفاوت در کانال‌ها نشان‌دهنده استریو است، در غیر این صورت هنگامی که هر دو کانال برابر باشند، مونو را نشان می‌دهد.
.SS "لغو تأکید اولیه در نمونه‌های ورودی (Undo the pre-emphasis in the input samples)"
.B \-T
برخی از سی‌دی‌های صوتی قدیمی با یک پاسخ فرکانسی اصلاح‌شده به نام تأکید اولیه (pre-emphasis) ضبط شده‌اند. این مورد بیشتر در ضبط‌های موسیقی کلاسیک یافت می‌شود. این تصحیح اغلب در فلگ‌های جدول محتویات (TOC) قابل مشاهده است. اما ضبط‌هایی وجود دارند که این تنظیم را فقط در زیرکانال‌ها نشان می‌دهند. اگر این گزینه داده شود، اسکنر نمایه راه‌اندازی می‌شود که زیرکانال q هر قطعه را می‌خواند. اگر تأکید اولیه در زیرکانال q یک قطعه مشخص شده باشد اما در TOC نباشد، وجود تأکید اولیه فرض شده و متعاقباً فیلتر معکوس برای این قطعه قبل از اینکه نمونه‌ها در پرونده صوتی نوشته شوند انجام می‌شود.
.SS "تنظیم قالب صوتی (Set audio format)"
.B \-O " audiotype"
می‌تواند شامل
.I wav
(برای پرونده‌های wav) یا
.I au
یا
.I sun
(برای پرونده‌های سان PCM) یا
.I cdr
یا
.I 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.' است.
.SS "انتخاب سرعت خواندن درایو سی‌دی‌رام (Select cdrom drive reading speed)"
.B \-S " speed"
امکان تغییر درایو سی‌دی‌رام به یک سرعت خاص را برای کاهش خطاهای خواندن فراهم می‌کند. آرگومان بدون تغییر به درایو منتقل می‌شود.
جزئیات تا حد زیادی به درایوهای سی‌دی‌رام بستگی دارد.
به عنوان مثال، آرگومان 0 اغلب سرعت پیش‌فرض درایو است و مقدار 1 اغلب سرعت تک‌برابر (1x) را انتخاب می‌کند.
.SS "فعال‌سازی چکسام‌های MD5 (Enable MD5 checksums)"
.B \-M " count"
محاسبه چکسام MD-5 را برای 'count' بایت از ابتدای یک قطعه فعال می‌کند. این قابلیت برای مقایسه سریع قطعات معرفی شد.
.SS "استفاده از libparanoia مونتی برای خواندن سکتورها (Use Monty's libparanoia for reading of sectors)"
.B \-paranoia
یک روش جایگزین برای استخراج سکتورهای صوتی را انتخاب می‌کند. کتابخانه Monty با گزینه‌های پیش‌فرض زیر استفاده می‌شود:
.sp
PARANOIA_MODE_FULL, but without PARANOIA_MODE_NEVERSKIP
.sp
برای جزئیات بیشتر مستندات libparanoia مونتی را ببینید.
در این حالت گزینه
.B \-P
هیچ تأثیری ندارد.
.SS "خواندن خطی یا همپوشان سکتورها (Do linear or overlapping reading of sectors)"
(این بخش اعمال می‌شود مگر اینکه از گزینه
.B \-paranoia
استفاده شود.)
.B \-P " sectors"
تعداد سکتورهای مشخص‌شده را برای نمونه‌برداری همپوشانی اولیه جهت تصحیح لرزش (jitter) تنظیم می‌کند. دو حالت باید تفکیک شود: برای مقادیر غیر صفر، برخی از سکتورها دو بار خوانده می‌شوند تا تصحیح لرزش cdda2wav فعال شود.
اگر آرگومان صفر داده شود، هیچ نمونه‌برداری همپوشانی استفاده نخواهد شد.
برای سکتورهای همپوشانی غیر صفر، cdda2wav تنظیم را به صورت پویا در حین نمونه‌برداری تنظیم می‌کند (همان‌طور که cdparanoia انجام می‌دهد).
اگر هیچ تطابقی پیدا نشود، cdda2wav خواندن را با همپوشانی افزایش‌یافته مجدداً امتحان می‌کند.
اگر مقدار لرزش کمتر از نمونه‌های همپوشان فعلی باشد، cdda2wav تنظیم همپوشانی را کاهش می‌دهد که منجر به سرعت خواندن بالاتر می‌شود.
آرگومان داده‌شده باید کمتر از تعداد کل سکتورها در هر درخواست باشد (گزینه
.I -n
در زیر را ببینید).
Cdda2wav این تنظیم را بررسی می‌کند و در غیر این صورت یک پیام خطا صادر می‌نماید.
حالت صفر سکتور در شرایط بار کم یا درایوهای سی‌دی‌رام بدون خطا (عالی) و سی‌دی‌های صوتی عالی (بدون خش) مناسب است.
.SS "تنظیم اندازه انتقال (Set the transfer size)"
.B \-n " sectors"
اندازه انتقال را روی سکتورهای مشخص‌شده در هر درخواست تنظیم می‌کند.
.SS "تنظیم تعداد عناصر بافر حلقوی (Set number of ring buffer elements)"
.B \-l " buffers"
تعداد مشخص‌شده از عناصر بافر حلقوی را تخصیص می‌دهد.
.SS "تنظیم ترتیب بایت (Endianness) نمونه‌های ورودی (Set endianess of input samples)"
.B \-C " endianess"
تنظیمات پیش‌فرض قالب ورودی را لغو می‌کند.
ترتیب بایت را می‌توان به صورت صریح روی "little"، "big" یا "machine" یا روی تشخیص خودکار ترتیب بایت بر اساس رأی‌گیری با "guess" تنظیم کرد.
.SS "تنظیم ترتیب بایت (Endianness) نمونه‌های خروجی (Set endianess of output samples)"
.B \-E " endianess"
(ترتیب بایت می‌تواند "little"، "big" یا "machine" باشد) تنظیمات پیش‌فرض قالب خروجی را لغو می‌کند.
.SS "گزینه گزارش پرگویی (Verbose option)"
.B \-v " itemlist"
اطلاعات بیشتری را چاپ می‌کند. یک فهرست امکان انتخاب موارد مختلف اطلاعات را فراهم می‌سازد.
.sp
.TP 10
.B help
چاپ خلاصه‌ای از اعضای ممکن فهرست diffopts.
.TP
.B !
معکوس کردن معنای رشته پس از آن. بعد از علامت تعجب نیازی به کاما نیست.
.TP 10
.B not
معکوس کردن معنای تمام اعضا در فهرست diffopts، یعنی حذف تمام گزینه‌های موجود از فهرست مقایسه مجموعه کامل اولیه.
هنگام استفاده از
.BR csh (1)
ممکن است با
.B "!"
به دلیل تجزیه‌کننده عجیب آن مشکل داشته باشید؛ به همین دلیل نام مستعار
.B "not"
وجود دارد.
.TP
.B "disable"
غیرفعال کردن پرگویی
.TP
.B "all"
ارائه تمام اطلاعات
.TP
.B "toc"
نمایش جدول محتویات (TOC)
.TP
.B "summary"
نمایش خلاصه‌ای از پارامترهای ضبط
.TP
.B "indices"
فراخوانی اسکنر نمایه و نمایش موقعیت‌های شروع نمایه‌ها
.TP
.B "catalog"
واکشی و نمایش شماره کاتالوگ رسانه
.TP
.B "trackid"
واکشی و نمایش کدهای بین‌المللی استاندارد ضبط (ISRC)
.TP
.B "sectors"
نمایش موقعیت‌های شروع قطعه با نمادگذاری مطلق سکتور
.PP
برای ترکیب چند درخواست، کافی است گزینه‌های فرعی را با کاما جدا کنید.
.SS "جدول محتویات (The table of contents)"
این خروجی جدول محتویات را همراه با تعداد قطعات و زمان کل (نمایش‌داده‌شده در قالب
.IR mm : ss . hh
که
.IR mm =دقیقه،
.IR ss =ثانیه،
.IR hh "=صدم ثانیه گردشده)"
نشان می‌دهد.
فهرست زیر شماره قطعه و زمان قطعه را برای هر ورودی نمایش می‌دهد.
خلاصه یک خط به ازای هر قطعه ارائه می‌دهد که نوع قطعه را توصیف می‌کند:
.sp
.ce 1
.B "track preemphasis copypermitted tracktype chans"
.sp
ستون
.B track
شماره قطعه را نگه می‌دارد.
.B preemphasis
نشان می‌دهد که آیا به آن قطعه یک پاسخ فرکانسی غیرخطی داده شده است یا خیر.
نکته: می‌توانید این اثر را با گزینه
.B \-T
لغو و خنثی کنید.
.B "copy\-permitted"
مشخص می‌کند که آیا این قطعه مجاز به کپی است یا خیر.
.B "tracktype"
می‌تواند data یا audio باشد. در سی‌دی‌های چندرسانه‌ای (به جز سی‌دی‌های دارای قطعه پنهان) هر دوی آن‌ها باید وجود داشته باشند.
.B "channels"
فقط برای قطعات صوتی تعریف می‌شود که می‌تواند دو یا چهار کانال باشد.
.SS "عدم تولید پرونده خروجی (No file output)"
.B \-N
این گزینه اشکال‌زدایی نوشتن در پرونده را خاموش می‌کند.
.SS "عدم تولید پرونده اطلاعات (No infofile generation)"
.B \-H
این گزینه ایجاد پرونده اطلاعات (info) و پرونده cddb را خاموش می‌کند.
.SS "تولید خروجی ساده برای رابط‌های گرافیکی (Generation of simple output for gui frontends)"
.B \-g
این گزینه قالب‌بندی ساده خطی را فعال می‌کند که برای پشتیبانی از واسط‌های گرافیکی (مانند xcd-roast) مورد نیاز است.
.SS "ثبت وقایع پرجزئیات SCSI (Verbose SCSI logging)"
.B \-V
این گزینه ثبت وقایع دستورات SCSI را روشن می‌کند. این کار خروجی زیادی تولید خواهد کرد (هنگامی که دستگاه‌های SCSI استفاده می‌شوند).
این گزینه برای مقاصد اشکال‌زدایی مورد نیاز است. قالب آن همان قالبی است که در برنامه cdrecord استفاده می‌شود؛ برای اطلاعات بیشتر
.BR cdrecord (1)
را ببینید.
.SS "گزینه بی‌صدا (Quiet option)"
.B \-q
تمام خروجی‌های صفحه نمایش را به جز پیام‌های خطا سرکوب و پنهان می‌کند.
این کار مصرف منابع زمان پردازنده (CPU) را کاهش می‌دهد.
.SS "گزینه نمایش صرف اطلاعات (Just show information option)"
.B \-J
در پرونده‌ای نمی‌نویسد، فقط اطلاعاتی را درباره دیسک چاپ می‌کند (بسته به گزینه
.BR \-v ).
این گزینه فقط برای مقاصد اطلاعاتی است.
.SH "پشتیبانی از CDDBP (CDDBP support)"
.SS "گزینه جستجوی عنوان آلبوم و قطعه (Lookup album and track titles option)"
.B \-L " cddbp mode"
ابزار Cdda2wav تلاش می‌کند نام اجراکننده، عنوان آلبوم و عناوین قطعات را از یک کارگزار cddbp واکشی کند. کارگزار پیش‌فرض در حال حاضر 'freedb.freedb.org' است.
برنامه‌ریزی شده است که بعداً کنترل بیشتری روی مدیریت کارگزار اعمال شود.
این پارامتر نحوه مدیریت ورودی‌های چندگانه را تعیین می‌کند:
.IP \fB0\fP
حالت تعاملی، کاربر یکی از ورودی‌ها را انتخاب می‌کند.
.IP \fB1\fP
انتخاب اولین ورودی بدون درخواست تأیید از کاربر.
.SS "تنظیم کارگزار برای جستجوی عناوین (Set server for title lookups)"
.B cddbp\-server " servername"
هنگام استفاده از \-L یا \-cddb، کارگزاری که با آن تماس برقرار می‌شود می‌تواند با این گزینه تعیین شود.
.SS "تنظیم شماره پورت برای جستجوی عناوین (Set portnumber for title lookups)"
.B cddbp\-port " portnumber"
هنگام استفاده از \-L یا \-cddb، پورت کارگزاری که با آن ارتباط برقرار می‌شود می‌تواند با این گزینه مشخص شود.
.SH "نکاتی درباره نحوه استفاده (HINTS ON USAGE)"
نمونه‌هایی ایجاد نکنید که قادر به خواندن آن‌ها نیستید. ابتدا نرم‌افزار پخش نمونه و سخت‌افزار کارت صدای خود را بررسی کنید. من با نرخ‌های نمونه‌برداری بسیار پایین (استریو <= ۱۵۷۵ هرتز، مونو <= ۳۶۷۵ هرتز) هنگام پخش آن‌ها با پخش‌کننده‌های استاندارد WAV برای Sound Blaster با مشکلاتی مواجه شدم (شاید آن‌ها در قالب
.B WAV
معتبر نیستند). بیشتر رایترهای سی‌دی (CD-Writers) بر روی نمونه‌های صوتی در قالب bigendian تأکید دارند.
اکنون cdda2wav از گزینه
.B \-E " endianess"
برای کنترل ترتیب بایت نمونه‌های نوشته‌شده پشتیبانی می‌کند.
.PP
اگر سخت‌افزار شما به اندازه کافی سریع باشد که cdda2wav را بدون وقفه اجرا کند و درایو سی‌دی شما یکی از انواع «عالی» باشد، با خاموش کردن تمام نمونه‌برداری‌های همپوشان با گزینه
.B \-P " 0"
سرعت بیشتری به دست خواهید آورد. تنظیمات دقیق‌تر را می‌توان با گزینه
.B \-n " sectors"
انجام داد. می‌توانید مشخص کنید چه تعداد سکتور باید در یک نوبت درخواست شود.
.PP
دستور Cdda2wav از
.BR لوله‌ها (pipes)
پشتیبانی می‌کند. از نام پرونده
.B \-
استفاده کنید تا cdda2wav نمونه‌های خود را به خروجی استاندارد بفرستد.
.PP
تبدیل به سایر قالب‌های صوتی با استفاده از بسته نرم‌افزاری
.B sox
امکان‌پذیر است (دیگر نباید نیازی به استفاده از
.B sox \-x
برای تغییر ترتیب بایت نمونه‌ها باشد؛ گزینه
.B \-E
را برای تغییر ترتیب بایت خروجی ببینید).
.PP
اگر می‌خواهید بیش از یک قطعه را در پرونده‌های مجزا در یک نوبت نمونه‌برداری کنید، این کار در حال حاضر با گزینه
.B \-B
امکان‌پذیر است. هنگامی که زمان ضبط از حد مجاز قطعه فراتر رود، پرونده جدیدی برای قطعه بعدی باز خواهد شد.
.SH "فایل‌ها (FILES)"
دستور Cdda2wav می‌تواند پرونده‌های زیادی برای مقاصد مختلف تولید کند.
.SS "پرونده‌های صوتی (Audio files):"
.PP
پرونده‌های صوتی حاوی نمونه‌هایی با پسوندهای پیش‌فرض wav.، au.، aifc.، aiff. و cdr. بر اساس قالب صوتی انتخاب‌شده هستند. این پرونده‌ها در صورت مشخص شدن گزینه
.RB ( \-N )
تولید نمی‌شوند. هنگامی که از گزینه کپی گروهی
.RB ( \-B )
استفاده شود، ممکن است چندین پرونده نوشته شوند. نام‌های اختصاصی پرونده را می‌توان به عنوان آرگومان ارائه کرد. اگر تعداد نام‌های ارائه‌شده برای پوشش تمام قطعات صوتی کافی باشد، نام پرونده‌ها عیناً استفاده خواهند شد. در غیر این صورت، اگر تعداد نام‌های داده‌شده کمتر از پرونده‌های مورد نیاز برای نوشتن قطعات موجود باشد، بخش قبل از پسوند نام پرونده با 'dd_' گسترش می‌یابد که در آن dd نمایانگر شماره قطعه جاری است.
.SS "پرونده‌های Cddb و Cdindex (Cddb and Cdindex files):"
.PP
اگر cdda2wav اطلاعات عنوان cd-extra یا cd-text (آلبوم/قطعه) را شناسایی کند، پرونده‌های cddb.، cdindex. و cdtext. تولید می‌شوند مگر اینکه توسط گزینه
.BR \-H
سرکوب شوند. آن‌ها حاوی ورودی‌های با قالب‌بندی مناسب برای ارسال به پایگاه‌های داده عناوین قطعات سی‌دی صوتی در اینترنت هستند. سیستم‌های CDINDEX و (CDDB(tm در حال حاضر پشتیبانی می‌شوند. برای اطلاعات بیشتر لطفاً از www.musicbrainz.org و www.freedb.com بازدید فرمایید.
.SS "پرونده‌های Inf (Inf files):"
.PP
پرونده‌های inf پرونده‌های نمونه و بخشی از سی‌دی صوتی را که از آن استخراج شده‌اند توصیف می‌کنند. آن‌ها ابزاری برای انتقال اطلاعات به یک برنامه رایت سی‌دی مانند cdrecord هستند. به عنوان مثال، اگر سی‌دی صوتی اصلی تأکید اولیه (pre-emphasis) فعال داشته باشد و cdda2wav با گزینه
.B \-T
تأکید اولیه را حذف کرده باشد، پرونده inf گزینه تأکید اولیه را غیرفعال ثبت می‌کند (زیرا پرونده صوتی دیگر آن را ندارد)، در حالی که cddb. و cdindex. تأکید اولیه را مانند سی‌دی اصلی فعال ثبت می‌کنند.
.SH "هشدار (WARNING)"
.B مهم:
فروش کپی‌های آثار دارای حق نشر توسط اشخاص فاقد حق نشر ممنوع است. این برنامه نباید برای دور زدن قوانین حق نشر استفاده شود. کاربر هنگام استفاده از این نرم‌افزار این محدودیت را می‌پذیرد.
.SH "اشکالات (BUGS)"
اسکنر نمایه ممکن است دچار پایان مهلت زمانی (timeout) شود.
.sp
بازنمونه‌برداری (کد تبدیل نرخ) از درون‌یابی چندجمله‌ای استفاده می‌کند که بهینه نیست.
.sp
دستور Cdda2wav باید از ریسه‌ها (threads) استفاده کند.
.SH "قدردانی‌ها (ACKNOWLEDGEMENTS)"
با تشکر از Project MODE (http://www.mode.net) و Fraunhofer Institut f\*ur integrierte Schaltungen (FhG-IIS) (http://www.iis.fhg.de) برای حمایت مالی.
شرکت‌های Plextor Europe و Ricoh Japan درایوهای سی‌دی‌رام و رایترهای سی‌دی را تأمین کردند که کمک فراوانی به توسعه این نرم‌افزار نمود.
رامی (Rammi) در اشکال‌زدایی کمک شایانی کرد و هنگام شنیدن ۱۰۰ باره ۱۶ ثانیه اول قطعه اول سی‌دی Krupps شکیبایی فراوانی نشان داد.
کتابخانه Libparanoia توسط مانتی (Christopher Montgomery) xiphmont@mit.edu اهدا شد.
.SH "نویسنده (AUTHOR)"
Heiko Eissfeldt heiko@colossus.escape.de (1993-2004,2015)
.PP
از ۲۰۰۴ تا کنون:

.nf
J\*org Schilling
Seestr. 110
D-13353 Berlin
Germany
.fi
.SH "تاریخ (DATE)"
2017/03/29
.br
.ne 7
.SH "پایداری رابط کاربری (INTERFACE STABILITY)"
رابط‌های ارائه‌شده توسط
.B cdda2wav
برای پایداری طولانی‌مدت طراحی شده‌اند.
از آنجا که
.B cdda2wav
به رابط‌های ارائه‌شده توسط سیستم‌عامل زیربنایی وابسته است، پایداری رابط‌های ارائه‌شده توسط
.B cdda2wav
به پایداری رابط‌های سیستم‌عامل بستگی دارد.
تغییر رابط‌ها در سیستم‌عامل ممکن است تغییراتی را در رابط‌های
.BR cdda2wav
تحمیل کند.