.TH CDRDAO 1 "Jan 18, 2006" .SH "نام (NAME)" cdrdao \- خواندن و نوشتن دیسک‌های CD در حالت disc-at-once .SH "خلاصه دستور (SYNOPSIS)" .B cdrdao .RB { show-toc|toc-info|toc-size|read-toc|read-cd|read-cddb|show-data|read-test|disk-info|discid|msinfo|drive-info|unlock|scanbus|simulate|write|copy|blank } .RB [ --device .IR device ] .RB [ --source-device .IR device ] .RB [ --driver .IR driver-id ] .RB [ --source-driver .IR driver-id ] .RB [ --simulate ] .RB [ --speed .IR writing-speed ] .RB [ --blank-mode .IR mode] .RB [ --datafile .IR file ] .RB [ --read-raw ] .RB [ --read-subchan .RB [ --no-mode2-mixed ] .IR mode ] .RB [ --tao-source ] .RB [ --tao-source-adjust .IR link-blocks ] .RB [ --fast-toc ] .RB [ --buffers .IR buffer-count ] .RB [ --multi ] .RB [ --overburn ] .RB [ --eject ] .RB [ --swap ] .RB [ --session ] .RB [ --force ] .RB [ --reload ] .RB [ --keepimage ] .RB [ --on-the-fly ] .RB [ --paranoia-mode .IR mode ] .RB [ --with-cddb ] .RB [ --cddb-servers .IR server-list ] .RB [ --cddb-timeout .IR timeout ] .RB [ --cddb-directory .IR directory ] .RB [ --tmpdir .IR directory ] .RB [ --keep ] .RB [ --save ] .RB [ -n ] .RB [ -v .IR verbose-level ] .RI toc-file .SH "توضیحات (DESCRIPTION)" ابزار .I cdrdao دیسک‌های صوتی و داده CD-R را در حالت disk-at-once (DAO) بر اساس یک فایل توصیف موسوم به .I toc-file ایجاد می‌کند. در حالت DAO امکان ایجاد فاصله‌های پیش از شیار (pre-gap) غیراستاندارد وجود دارد که طول آن‌ها غیر از ۲ ثانیه بوده و حاوی داده‌های صوتی غیرصفر باشند. این قابلیت برای نمونه جهت تقسیم‌بندی ضبط‌های زنده به شیارها کاربرد دارد، در جایی که وقفه‌های ۲ ثانیه‌ای آزاردهنده خواهند بود. به جای یک .I toc-file می‌توان از یک فایل cue (مورد استفاده در یک ابزار معروف مسترینگ DOS/Windows) استفاده کرد. برای جزئیات بیشتر به بخش فایل‌های CUE مراجعه کنید. .SH "دستورات (COMMANDS)" .TP اولین آرگومان باید یکی از دستورات زیر باشد: .TP .BI show-toc چاپ خلاصه‌ای از آنچه روی CD-R نوشته خواهد شد. .TP .BI toc-info چاپ خلاصه کوتاهی از toc-file. .TP .BI toc-size چاپ تعداد کل بلوک‌ها برای toc. .TP .BI read-toc تحلیل هر شیار از CD درج‌شده و ایجاد یک .I toc-file که می‌تواند برای ساخت یک کپی کم‌وبیش دقیق از دیسک استفاده شود. این دستور شیارهای صوتی یا داده را نمی‌خواند؛ برای این منظور از .BI read-cd استفاده کنید. می‌توانید با استفاده از گزینه .BI \--datafile یک نام فایل برای فایل داده مشخص کنید. .TP .BI read-cd کپی کردن تمام شیارهای CD درج‌شده در یک فایل ایمیج و ایجاد یک .I toc-file متناظر. در صورتی که گزینه .BI --datafile داده نشود، نام فایل ایمیج به‌طور پیش‌فرض "data.bin" خواهد بود. .TP .BI read-cddb تلاش برای بازیابی داده‌های عنوان و هنرمند از یک سرور CDDB برای CD ارائه‌شده توسط toc-file مشخص. داده‌های بازیابی‌شده به‌عنوان داده‌های CD-TEXT برای زبان 0 به toc-file اضافه می‌شوند. داده‌های CD-TEXT موجود برای زبان 0 بازنویسی خواهند شد. .TP .BI show-data چاپ تمام نمونه‌هایی که روی CD-R نوشته می‌شوند. هر خط شامل شماره نمونه (شروع از 0) و مقدار ده‌دهی نمونه برای کانال چپ و راست است. برای بررسی درست بودن ترتیب بایت (byte order) فایل‌های صوتی مفید است. .TP .BI read-test بررسی امکان خواندن تمام داده‌ها از فایل‌های صوتی تعریف‌شده در .IR toc-file . این کار همچنین ارتباط با فرایند پیرو (slave) که مسئول نوشتن داده‌های صوتی در دستگاه ضبط CD است را بررسی می‌کند. عمدتاً برای آزمایش استفاده می‌شود. .TP .BI disk-info نمایش اطلاعات درباره CD-R درج‌شده. اگر CD-R دارای نشست باز باشد، زمان شروع آخرین نشست و نشست جاری را نیز چاپ می‌کند که توسط mkisofs برای ایجاد ایمیج برای نشست دوم یا بالاتر استفاده می‌شود. .TP .BI discid چاپ اطلاعات CDDB. .TP .BI msinfo نمایش اطلاعات مورد نیاز برای ایجاد دیسک‌های چندنشستی با mkisofs. خروجی برای پردازش توسط اسکریپت‌ها در نظر گرفته شده است. .TP .BI drive-info نمایش اطلاعات درایو. .TP .BI unlock تلاش برای باز کردن قفل دستگاه ضبط پس از یک فرایند ناموفق نوشتن یا شبیه‌سازی. اگر پس از اجرای cdrdao نمی‌توانید CD را خارج کنید، این دستور را امتحان کنید. .TP .BI blank پاک کردن یک دیسک CD-RW. دیسک به‌طور پیش‌فرض به‌صورت حداقلی (minimal) پاک می‌شود. برای انتخاب حالت دیگر پاک‌سازی از گزینه .BI --blank-mode استفاده کنید. گاهی برای عملیات موفقیت‌آمیز پاک‌سازی باید سرعت پاک‌کردن به‌صورت دستی کاهش یابد. از گزینه .BI --speed برای انتخاب سرعت دیگر استفاده نمایید. .TP .BI scanbus پویش برای یافتن دستگاه‌ها. .TP .BI simulate مشابه .BI write است اما لیزر خاموش می‌ماند. میانبری برای .BI "write --simulate" است. .TP .BI write نوشتن CD-R مطابق با مشخصات موجود در .IR toc-file . .TP .BI copy انجام تمام مراحل کپی کردن CD. دستگاه حاوی دیسک مبدأ باید با گزینه .BI --source-device و دستگاه ضبط با گزینه .BI --device مشخص شود. اگر تنها یک دستگاه در دسترس باشد، گزینه .BI --source-device باید حذف شود و cdrdao پس از ایجاد ایمیج از دیسک مبدأ، درخواست درج CD-R را اعلام خواهد کرد. فایل ایمیج با نام "cddata.bin" در صورتی که گزینه .BI --datafile داده نشود در پوشه کاری جاری ایجاد خواهد شد. ایمیج ایجادشده پس از اتمام نوشتن حذف می‌شود. اگر گزینه .BI --on-the-fly داده شود، هیچ فایل ایمیجی ایجاد نمی‌شود و داده‌ها مستقیماً از دستگاه خواننده به دستگاه ضبط CD پایپ می‌شوند. .SH "گزینه‌ها (OPTIONS)" .TP .BI \--device " [prot:]bus,id,lun" تنظیم آدرس SCSI دستگاه ضبط CD به‌صورت سه‌تایی bus/id/lun، برای نمونه '0,2,0' برای واحد منطقی 0 دستگاه SCSI با شناسه 2 روی گذرگاه 0. دستگاه‌های ATAPI را می‌توان با پیشوند 'ATAPI:' مشخص کرد، مانند 'ATAPI:0,0,0'. در برخی سیستم‌ها گره دستگاه را می‌توان مستقیماً تعیین کرد، مانند '/dev/sg0' در سیستم‌های لینوکس. کاربران لینوکس 2.6 می‌توانند رابط جدیدتر ATAPI را با پیشوند 'ATA:' امتحان کنند. .TP .BI \--source-device " [prot:]bus,id,lun" مشابه بالا، اما در دستور .BI copy برای تعیین دستگاه مبدأ استفاده می‌شود. .TP .BI \--driver " driver-id:option-flags" اجبار به استفاده از درایور مشخص‌شده به‌جای درایور شناسایی‌شده خودکار. شناسه‌های درایور موجود: .br cdd2600, plextor, plextor-scan, generic-mmc, generic-mmc-raw, ricoh-mp6200, yamaha-cdr10x, teac-cdr55, sony-cdu920, sony-cdu948, taiyo-yuden, toshiba. .br تعیین یک شناسه نامعتبر فهرستی از درایورهای در دسترس را ارائه می‌دهد. فلگ‌های گزینه می‌توانند برای تغییر رفتار برخی درایورها استفاده شوند. برای جزئیات به .BI README مراجعه کنید. .TP .BI \--source-driver " driver-id:option-flags" مشابه بالا، اما برای دستگاه مشخص‌شده با گزینه .BI --source-device استفاده می‌شود. .TP .BI \--speed " value" تنظیم سرعت نوشتن روی .IR value . پیش‌فرض بالاترین سرعت ممکن است. .TP .BI \--blank-mode " mode" تنظیم حالت پاک‌سازی. حالت‌های موجود عبارتند از .BI full و .BR minimal . لطفاً توجه داشته باشید که داده‌های دیسک‌های پاک‌شده با حالت minimal ممکن است به‌راحتی بازیابی شوند. از حالت .BI full برای پاک کردن کامل تمامی داده‌ها استفاده کنید. حالت پیش‌فرض پاک‌سازی .BI minimal است. .TP .BI \--datafile " file" مورد استفاده در دستورات .BI "read-toc, read-cd" و .BR copy . تنظیم فایل داده پیش‌فرض که توسط .BI read-toc در toc-file قرار می‌گیرد. از "-" برای اشاره به ورودی استاندارد (STDIN) استفاده کنید. برای دستورات .BI read-cd و .BI copy این گزینه نام فایل ایمیج ساخته‌شده را تعیین می‌کند. .TP .BI \--read-raw فقط برای دستورات .BI read-cd و .BI read-toc استفاده می‌شود. تمام بخش‌های داده به‌عنوان بلوک‌های ۲۳۵۲ بایتی شامل هدر بخش و داده‌های L-EC در فایل ایمیج نوشته خواهند شد. حالت شیار در .I toc-file ایجادشده روی MODE1_RAW یا MODE2_RAW تنظیم می‌شود. .TP .BI \--read-subchan " mode" مورد استفاده توسط دستورات .BI read-cd , .BI read-toc و .BR copy . نوع داده‌های کانال فرعی (sub-channel) استخراج‌شده از CD مبدأ و نوشته‌شده در ایمیج شیار یا کپی‌شده در CD مقصد را مشخص می‌کند. حالت می‌تواند .BI rw برای خواندن داده‌های فشرده کانال فرعی R-W (رفع درهم‌تنیدگی شده و تصحیح‌خطاشده) و .BI rw_raw برای خواندن داده‌های خام کانال فرعی R-W (بدون رفع درهم‌تنیدگی، بدون تصحیح خطا، داده‌های L-EC گنجانده‌شده در ایمیج شیار) باشد. اگر این گزینه مشخص نشود، هیچ داده کانال فرعی استخراج نخواهد شد. .TP .BI \--no-mode2-mixed فقط برای دستورات .BI read-cd و .BI read-toc استفاده می‌شود. اگر با MODE2_FORM1 یا MODE2_FORM2 روبرو شدیم، آن را به‌عنوان MODE2_FORM_MIX در .I toc-file استخراج نکن. .TP .BI \--tao-source این گزینه به دستورات .I read-toc و .I read-cd نشان می‌دهد که CD مبدأ در حالت TAO نوشته شده است. فرض بر این خواهد بود که طول فاصله پیش از شیار بین همه شیارها (به‌جز بین دو شیار صوتی) مقدار استاندارد ۱۵۰ بلوک به‌علاوه تعداد بلوک‌های پیوند (معمولاً ۲) است. تعداد بلوک‌های پیوند می‌تواند با گزینه .I --tao-source-adjust کنترل شود. از این گزینه تنها زمانی استفاده کنید که .I read-toc یا .I read-cd در نواحی گذار بین دو شیار پیام خطا می‌دهند. اگر از این گزینه با دیسک‌های فشرده کارخانه‌ای (pressed) یا CDهای نوشته‌شده در حالت DAO استفاده کنید، نتایج نادرستی دریافت خواهید کرد. .TP .BI \--tao-source-adjust " link-blocks" تعداد بلوک‌های پیوند را برای شیارهای نوشته‌شده در حالت TAO مشخص می‌کند. این گزینه تنها در صورت تعیین گزینه .I --tao-source مؤثر است. .TP .BI \--fast-toc فقط برای دستور .BI read-toc استفاده می‌شود. این گزینه استخراج طول فاصله پیش از شیار و علامت‌های نمایه را متوقف می‌کند که باعث تسریع فرایند read-toc می‌شود. فاصله‌های پیش از شیار استاندارد ۲ ثانیه‌ای (اما نه سکوت!) در toc-file قرار می‌گیرند. CD حاصل صدایی مانند دیسک مبدأ خواهد داشت، تنها نمایشگر پخش‌کننده CD در ناحیه گذار بین دو شیار رفتار کمی متفاوتی خواهد داشت. این گزینه همچنین می‌تواند در صورتی که read-toc با درایو شما با شکست مواجه می‌شود، کمک‌کننده باشد. .TP .BI \--buffers " buffer-count" تعداد بافرهایی را مشخص می‌کند که برای جلوگیری از خطای خالی شدن بافر (buffer underrun) تخصیص می‌یابند. حداقل تعداد بافر ۱۰ است و پیش‌فرض ۳۲ است به‌جز در سیستم‌های FreeBSD که پیش‌فرض ۲۰ است. هر بافر ۱ ثانیه داده صوتی را نگه می‌دارد، به‌طوری که تقسیم .I buffer-count بر سرعت نوشتن، حداکثر زمانی را که خواندن داده‌های صوتی می‌تواند متوقف شود نشان می‌دهد. .TP .BI \--multi اگر این گزینه داده شود، نشست پس از نوشتن موفقیت‌آمیز داده‌های صوتی بسته نخواهد شد. امکان الحاق یک نشست دیگر روی چنین دیسک‌هایی وجود دارد، مثلاً برای ساخت یک CD-EXTRA. .TP .BI \--overburn به‌طور پیش‌فرض cdrdao اجازه نوشتن داده‌ای بیشتر از ظرفیت مشخص‌شده دیسک فعلی را نمی‌دهد. این گزینه اجازه می‌دهد این شرط نادیده گرفته شود. .TP .BI \--eject خارج کردن دیسک CD-R پس از نوشتن یا شبیه‌سازی نوشتن. .TP .BI \--swap معکوس کردن ترتیب بایت (byte order) تمام نمونه‌هایی که به دستگاه ضبط CD ارسال می‌شوند. .TP .BI \--session " session-nr" مورد استفاده برای .BI read-toc و .BI read-cd جهت تعیین نشستی که باید روی دیسک‌های چندنشستی پردازش شود. .TP .BI \--reload نشان می‌دهد که سینی دیسک می‌تواند قبل از نوشتن بدون پرامپت به کاربر جهت بازنشانی وضعیت دیسک پس از اجرای شبیه‌سازی، باز شود. .TP .BI \--force اجبار به اجرای عملیاتی که در غیر این صورت انجام نمی‌شد. .TP .BI \--paranoia-mode " mode" تنظیم حالت تصحیح برای استخراج صوت دیجیتال. 0: بدون بررسی، داده‌ها مستقیماً از درایو کپی می‌شوند. 1: اجرای خواندن همپوشان برای جلوگیری از لرزش (jitter). 2: مانند 1 همراه با بررسی‌های اضافی داده‌های صوتی خوانده‌شده. 3: مانند 2 به همراه تشخیص و ترمیم خط‌وخش. سرعت استخراج از 0 تا 3 کاهش می‌یابد. پیش‌فرض حالت کامل پارانویا (3) است. .TP .BI \--keepimage اگر یک دیسک با دستور .I copy کپی شود، این گزینه باعث می‌شود ایمیج ایجادشده پس از پایان فرایند کپی حذف نشود. .TP .BI \--on-the-fly اجرای کپی CD درجا بدون ساخت فایل ایمیج. .TP .BI \--with-cddb فعال‌سازی دریافت خودکار داده‌های CDDB برای استفاده به‌عنوان داده‌های CD-TEXT در دستورات .IR copy ، .I read-toc و .IR read-cd . .TP .BI \--cddb-servers " server-list" تنظیم فهرستی جداشده با فاصله یا کاما از سرورهای CDDB مورد استفاده برای دستور .I read-cddb یا برای دستوراتی که گزینه .I --with-cddb در آن‌ها فعال است. یک ورودی سرور می‌تواند دارای قالب‌های زیر باشد: .IP اتصال به ، پورت پیش‌فرض cddbp (888)، استفاده از پروتکل cddbp. .IP : اتصال به ، پورت ، استفاده از پروتکل cddbp. .IP : اتصال به ، پورت پیش‌فرض http (80)، استفاده از پروتکل http، نشانی: . .IP :: اتصال به ، پورت ، استفاده از پروتکل http، نشانی: . .IP ::: اتصال به ، پورت پیش‌فرض http (80)، استفاده از پروتکل http، نشانی: http://:/. .IP :::: اتصال به ، پورت ، استفاده از پروتکل http، نشانی: http://:/. مسیر معمولاً "/~cddb/cddb.cgi" است. تمام سرورهای فهرست سرورها به ترتیب مشخص‌شده بررسی می‌شوند تا زمانی که اتصال موفقی برقرار شود. برای سرورهای پروکسی http، اولین پروکسی http متصل‌شده با موفقیت صرف‌نظر از توانایی اتصال به سرور http مقصد استفاده خواهد شد. مثال: freedb.freedb.org:/~cddb/cddb.cgi .TP .BI \--cddb-timeout " timeout" تنظیم مهلت زمانی اتصال به سرورهای CDDB بر حسب ثانیه. .TP .BI \--cddb-directory " directory" مشخص کردن پوشه محلی پایگاه داده CDDB که رکوردهای دریافت‌شده CDDB در آن ذخیره می‌شوند. در صورت مشخص نشدن این گزینه، رکوردهای دریافت‌شده در سیستم محلی ذخیره نخواهند شد. .TP .BI \--tmpdir " directory" مشخص کردن پوشه‌ای برای ذخیره فایل‌های موقت داده ایجادشده از رمزگشایی فایل‌های MP3 و Ogg Vorbis. به‌طور پیش‌فرض "/tmp" استفاده می‌شود. .TP .BI \--keep عدم حذف فایل‌های موقت WAV ایجادشده از فایل‌های MP3 و Ogg Vorbis پس از خروج از cdrdao. .TP .BI \--save ذخیره برخی از گزینه‌های جاری در فایل تنظیمات "$HOME/.cdrdao" و خروج. برای جزئیات بیشتر به بخش \'تنظیمات\' مراجعه کنید. .TP .BI \-n متوقف کردن توقف ۱۰ ثانیه‌ای پیش از نوشتن یا شبیه‌سازی. .TP .BI \-v " verbose-level" تنظیم سطح پرگویی. سطوح بالاتر از ۲ سطوح اشکال‌زدایی هستند که خروجی بسیار زیادی تولید می‌کنند. .SH "فایل‌های TOC (TOC FILES)" فایل .I toc-file داده‌هایی را که روی CD-R نوشته می‌شوند توصیف کرده و امکان کنترل موقعیت شیارها/نمایه‌ها، فاصله‌های پیش از شیار و اطلاعات کانال‌های فرعی را فراهم می‌سازد. این یک فایل متنی ساده است، برای ساخت آن از ویرایشگر متنی دلخواه خود استفاده کنید. یک .I toc-file شامل یک سربرگ اختیاری و دنباله‌ای از مشخصات شیارها است. توضیحات که با '//' شروع می‌شوند و تا انتهای خط ادامه دارند را می‌توان در هر جایی قرار داد. .SS "سربرگ (Header)" .IP CATALOG\ "ddddddddddddd" تعیین شماره کاتالوگ اختیاری CD. رشته باید دقیقاً شامل ۱۳ رقم باشد. .LP فلگ‌های زیر نوع نشستی را که ایجاد خواهد شد مشخص می‌کنند. این مورد برای ایجاد قالب صحیح CD-TOC و بررسی سازگاری حالت‌های شیار برای نوع نشست مورد نظر استفاده می‌شود. اگر چندین فلگ مشخص شود، آخرین مورد اعمال خواهد شد. .IP CD_DA دیسک تنها شامل شیارهای صوتی است. .IP CD_ROM دیسک تنها شامل شیارهای حالت 1 یا شیارهای حالت 1 و صوتی است (CD با حالت مختلط). .IP CD_ROM_XA دیسک شامل شیارهای حالت 2 فرم 1 یا حالت 2 فرم 2 است. شیارهای صوتی نیز مجاز هستند. این نوع باید در صورت ایجاد دیسک‌های چندنشستی استفاده شود (گزینه --multi). .IP CD_TEXT\ {\ ...\ } تعریف داده‌های سراسری CD-TEXT مانند عنوان آلبوم و زبان‌های استفاده‌شده. برای نحو محتویات بلوک CD-TEXT به بخش CD-TEXT در زیر مراجعه کنید. .SS "مشخصات شیار (Track Specification)" .IP TRACK\ \ [] یک شیار جدید را آغاز می‌کند، شماره شیار یکی افزایش می‌یابد. طول یک شیار باید حداقل ۴ ثانیه باشد. طول بلوک داده‌های ورودی به بستگی دارد: AUDIO: ۲۳۵۲ بایت (۵۸۸ نمونه)، MODE1: ۲۰۴۸ بایت، MODE1_RAW: ۲۳۵۲ بایت، MODE2: ۲۳۳۶ بایت، MODE2_FORM1: ۲۰۴۸ بایت، MODE2_FORM2: ۲۳۲۴ بایت، MODE2_FORM_MIX: ۲۳۳۶ بایت شامل زیرسربرگ، MODE2_RAW: ۲۳۵۲ بایت. گزینه اختیاری است. در صورت ارائه، نوع داده‌های کانال فرعی را برای هر بخش تعیین می‌کند. RW: داده‌های فشرده کانال فرعی R-W (۹۶ بایت، داده‌های L-EC در صورت نیاز تولید می‌شوند)، RW_RAW: داده‌های خام کانال فرعی R-W (درهم‌تنیده و داده‌های L-EC از پیش محاسبه‌شده، ۹۶ بایت). اگر مشخص شود، طول بلوک به اندازه طول داده‌های کانال فرعی افزایش می‌یابد. اگر طول داده‌های ورودی مضربی از طول بلوک نباشد، با صفر پر می‌شود (padding). .LP فلگ‌های زیر ممکن است پس از بیانیه شروع شیار بیایند. آن‌ها برای تنظیم اطلاعات کانال فرعی برای شیار جاری استفاده می‌شوند. هر فلگ اختیاری است. در صورت عدم ارائه، پیش‌فرض‌های زیر استفاده می‌شوند: کپی مجاز نیست، بدون pre emphasis، صدای دوکاناله، بدون کد ISRC. .IP "[ NO ] COPY" تنظیم یا پاک کردن فلگ مجاز بودن کپی. .IP "[ NO ] PRE_EMPHASIS" تنظیم یا پاک کردن فلگ pre emphasis (تنها برای شیارهای صوتی). .IP TWO_CHANNEL_AUDIO نشان می‌دهد که شیار حاوی داده‌های صوتی دوکاناله است (تنها برای شیارهای صوتی). .IP FOUR_CHANNEL_AUDIO نشان می‌دهد که شیار حاوی داده‌های صوتی چهارکاناله است (تنها برای شیارهای صوتی). .IP ISRC\ "CCOOOYYSSSSS" تنظیم کد ISRC شیار (تنها برای شیارهای صوتی). .br C: کد کشور (حروف بزرگ یا ارقام) .br O: کد مالک (حروف بزرگ یا ارقام) .br Y: سال (ارقام) .br S: شماره سریال (ارقام) .LP یک بلوک اختیاری CD-TEXT که داده‌های CD-TEXT را برای این شیار تعریف می‌کند می‌تواند در ادامه بیاید. برای نحو محتویات بلوک CD-TEXT به بخش CD-TEXT در زیر مراجعه کنید. .IP "CD_TEXT { ... }" .LP حداقل یکی از بیانیه‌های زیر باید برای تعیین داده‌های شیار جاری ظاهر شود. طول‌ها و موقعیت‌های شروع می‌توانند در نمونه‌ها (۱/۴۴۱۰۰ ثانیه) برای شیارهای صوتی یا بر حسب بایت برای شیارهای داده بیان شوند. همچنین امکان ارائه طول در بلوک‌ها با فرمت MSF به‌صورت 'MM:SS:FF' که دقیقه، ثانیه و فریم (0 <= 'FF' < 75) را مشخص می‌کند وجود دارد. یک فریم معادل یک بلوک است. اگر بیش از یک بیانیه استفاده شود، شیار با به هم پیوستن داده‌ها به ترتیب مشخص‌شده تشکیل خواهد شد. .IP "SILENCE " افزودن داده‌های صوتی صفر با طول مشخص‌شده به شیار صوتی جاری. برای ایجاد فاصله‌های پیش از شیار خاموش مفید است. .IP "ZERO " افزودن داده‌های صفر به شیارهای داده. باید برای تعریف فاصله‌های قبل یا بعد از شیار بین شیارهای با حالت متفاوت استفاده شود. .IP [\ FILE\ |\ AUDIOFILE\ ]\ ""\ \ [\ \ ] افزودن داده‌های صوتی فایل مشخص‌شده به شیار صوتی جاری. امکان انتخاب بخشی از یک فایل صوتی با و وجود دارد که امکان برش بدون تخریب را فراهم می‌کند. اولین نمونه از یک فایل صوتی با = 0 آدرس‌دهی می‌شود. اگر حذف شود یا روی 0 تنظیم گردد، تمام داده‌های صوتی از تا انتهای فایل استفاده می‌شود. فایل‌های صوتی می‌توانند دارای قالب خام (raw) یا WAVE با ۱۶ بیت در هر نمونه، نرخ نمونه‌برداری ۴۴.۱ کیلوهرتز و استریو باشند. فایل‌های خام باید دارای چیدمان 'MSBLeft LSBLeft MSBRight LSBRight ...' (ترتیب بایت big endian) باشند. انتظار می‌رود فایل‌های WAVE دارای ترتیب بایت little endian باشند. گزینه --swap ترتیب بایت مورد انتظار را برای تمام فایل‌های خام و WAVE معکوس می‌کند. تنها نام فایل‌هایی با پسوند ".wav" به‌عنوان فایل‌های WAVE در نظر گرفته می‌شوند، همه نام‌های دیگر فایل‌های صوتی خام فرض می‌شوند. برای تبدیل سایر قالب‌های فایل به قالب‌های پشتیبانی‌شده از ابزارهایی مانند sox(1) استفاده کنید. مشخص کردن "-" به‌عنوان نام فایل باعث می‌شود داده‌ها از ورودی استاندارد خوانده شوند. در حال حاضر فقط فایل‌های خام از STDIN پشتیبانی می‌شوند. اگر درباره ترتیب بایت فایل‌های صوتی خود نامطمئن هستید، دستور 'show-data' را امتحان کنید. اگر ترتیب بایت درست باشد، دنباله‌ای از اعداد صعودی یا نزولی را برای هر دو کانال مشاهده خواهید کرد. در غیر این صورت اعداد بین مقادیر بسیار بالا و پایین جهش می‌کنند - نویز با صدای بلند. .IP DATAFILE\ ""\ [\ \ ] افزودن داده‌ها از فایل داده‌شده به شیار داده جاری. اگر حذف شود، طول واقعی فایل استفاده خواهد شد. .IP FIFO\ ""\ افزودن داده‌ها از مسیر FIFO مشخص‌شده به شیار صوتی یا داده جاری. مقدار باید مقدار داده‌ای را که از FIFO خوانده می‌شود مشخص کند. این مقدار همیشه بر حسب بایت (مقدار اسکالر) یا بر حسب طول بلوک (مقدار MSF) است. .IP "START [ MM:SS:FF ]" طول فاصله پیش از شیار را تعریف می‌کند (موقعیتی که نمایه از 0 به 1 تغییر می‌کند). اگر مقدار MSF حذف شود، طول شیار جاری استفاده خواهد شد. اگر طول شیار جاری مضربی از طول بلوک نباشد، طول فاصله پیش از شیار به مرز بلوک بعدی گرد می‌شود. اگر هیچ بیانیه START داده نشود، شیار فاصله پیش از شیار نخواهد داشت. .IP "PREGAP MM:SS:FF" این یک روش جایگزین برای تعیین فاصله پیش از شیار با داده‌های صوتی صفر است. می‌تواند قبل از اولین بیانیه SILENCE، ZERO یا FILE ظاهر شود. هر یک از PREGAP یا START می‌توانند در مشخصات یک شیار استفاده شوند. این معادل با توالی .br SILENCE MM:SS:FF .br START .br برای شیارهای صوتی یا .br ZERO MM:SS:FF .br START .br برای شیارهای داده است. .LP هیچ چیز مانع از ترکیب بیانیه‌های 'DATAFILE'/'ZERO' و 'AUDIOFILE'/'SILENCE' در یک شیار واحد نمی‌شود. با این حال نتایج تعریف‌نشده هستند. انتهای مشخصات یک شیار می‌تواند شامل صفر یا چند بیانیه افزایش نمایه باشد: .IP "INDEX MM:SS:FF" افزایش شماره نمایه در موقعیت داده‌شده درون شیار. اولین بیانیه مقدار را از 1 به 2 افزایش می‌دهد. این موقعیت نسبت به شروع واقعی شیار است و فاصله پیش از شیار موجود را به حساب نمی‌آورد. .SS "بلوک‌های CD-TEXT (CD-TEXT Blocks)" یک بلوک CD-TEXT می‌تواند در بخش سراسری قرار گیرد تا داده‌های معتبر برای کل CD را تعریف کند، و همچنین در مشخصات هر شیار از یک .IR toc-file . بخش سراسری باید یک نگاشت زبان تعریف کند که برای نگاشت .I language-number به کدهای کشور استفاده می‌شود. حداکثر تا ۸ زبان مختلف می‌توانند تعریف شوند: .IP "LANGUAGE_MAP { 0 : c1 1 : c2 ... 7 : c7 }" کد کشور می‌تواند یک مقدار صحیح در بازه 0..255 یا یکی از کشورهای زیر باشد (مقدار صحیح مربوطه در پرانتز پشت توکن قرار دارد): EN(9, انگلیسی) .br تنها تعریف نگاشت برای زبان‌های استفاده‌شده ضروری است. .LP اگر نگاشتی برای یک .I language-number وجود نداشته باشد، داده‌های مربوط به این زبان نادیده گرفته خواهند شد. برای هر زبان باید یک بلوک زبان وجود داشته باشد که داده‌های واقعی را برای یک زبان خاص تعریف کند. .IP "LANGUAGE language-number { cd-text-item cd-text-data cd-text-item cd-text-data ... }" اقلام CD-TEXT را برای .I language-number مشخص‌شده که باید در نگاشت زبان تعریف شده باشد، تعیین می‌کند. .LP مقدار .I cd-text-data می‌تواند یک رشته محصور در " یا داده‌های باینری مانند .nf .in +.5i { 0, 10, 255, ... } .in -.5i .fi باشد که در آن هر عدد صحیح باید در بازه 0..255 قرار گیرد. .br مقدار .I cd-text-item می‌تواند یکی از موارد زیر باشد: .IP TITLE داده‌های رشته‌ای: عنوان CD یا شیار. .IP PERFORMER داده‌های رشته‌ای. .IP SONGWRITER داده‌های رشته‌ای. .IP COMPOSER داده‌های رشته‌ای. .IP ARRANGER داده‌های رشته‌ای. .IP MESSAGE داده‌های رشته‌ای. پیام به کاربر. .IP DISC_ID داده‌های رشته‌ای: فقط باید در بلوک سراسری CD-TEXT ظاهر شود. فرمت معمولاً این‌گونه است: XY12345 .IP GENRE ترکیبی از داده‌های باینری (کد ژانر) و داده‌های رشته‌ای. فقط باید در بلوک سراسری CD-TEXT ظاهر شود. ورودی‌های مفید توسط .I gcdmaster ایجاد خواهند شد. .IP TOC_INFO1 داده‌های باینری: جدول اختیاری محتویات 1. فقط باید در بلوک سراسری CD-TEXT ظاهر شود. .IP TOC_INFO2 داده‌های باینری: جدول اختیاری محتویات 2. فقط باید در بلوک سراسری CD-TEXT ظاهر شود. .IP UPC_EAN داده‌های رشته‌ای: این مورد فقط باید در بلوک سراسری CD-TEXT ظاهر شود. روی دیسک‌های حاوی CD-TEXT که من به آن‌ها دسترسی داشتم همواره یک رشته خالی بود. .IP ISRC داده‌های رشته‌ای: کد ISRC شیار. فرمت معمولاً به‌صورت CC-OOO-YY-SSSSS است. .IP SIZE_INFO داده‌های باینری: حاوی خلاصه‌ای از تمام داده‌های CD-TEXT بوده و فقط باید در بلوک سراسری CD-TEXT ظاهر شود. این داده‌ها هنگام نوشتن داده‌های CD-TEXT به‌طور خودکار (مجدداً) ایجاد خواهند شد. اگر یکی از اقلام CD-TEXT شامل TITLE، PERFORMER، SONGWRITER، COMPOSER، ARRANGER، ISRC برای حداقل یک شیار یا در بخش سراسری تعریف شود، باید برای تمام شیارها و در بخش سراسری تعریف گردد. اگر یک قلم DISC_ID در بخش سراسری تعریف شده باشد، یک ورودی ISRC باید برای هر شیار تعریف شود. .SS "مثال‌ها (Examples)" شیار ساده بدون فاصله پیش از شیار با تمام داده‌های صوتی از فایل WAVE به نام "data.wav": .nf .in +.5i CD_DA TRACK AUDIO FILE "data.wav" 0 .in -.5i .fi شیار استاندارد با فاصله پیش از شیار دو ثانیه‌ای، کد ISRC و CD-TEXT: .nf .in +.5i CD_DA CD_TEXT { LANGUAGE_MAP { 0 : EN } LANGUAGE 0 { TITLE "CD Title" PERFORMER "Performer" DISC_ID "XY12345" UPC_EAN "" } } TRACK AUDIO ISRC "DEXXX9800001" CD_TEXT { LANGUAGE 0 { TITLE "Track Title" PERFORMER "Performer" ISRC "DE-XXX-98-00001" } } PREGAP 0:2:0 FILE "data.wav" 0 .in -.5i .fi شیار با فاصله پیش از شیار ۱۰ ثانیه‌ای حاوی داده‌های صوتی از فایل خام "data.cdr": .nf .in +.5i CD_DA TRACK AUDIO FILE "data.cdr" 0 START 0:10:0 .in -.5i .fi شیار ترکیبی با داده‌هایی از فایل‌های مختلف. داده‌ها و طول فاصله پیش از شیار از "pregapdata.wav" گرفته می‌شود. دقیقه اول "track.cdr" نادیده گرفته شده و دو ثانیه سکوت در '2:0:0' درج می‌شود. ایندکس پس از ۲ و ۴ دقیقه پس از شروع شیار افزایش می‌یابد: .nf .in +.5i CD_DA TRACK AUDIO FILE "pregapdata.wav" 0 START FILE "track.cdr" 1:0:0 1:0:0 SILENCE 0:2:0 FILE "track.cdr" 2:0:0 INDEX 2:0:0 INDEX 4:0:0 .in -.5i .fi دیسک با حالت مختلط شامل یک شیار داده به‌عنوان اولین شیار و در پی آن دو شیار صوتی: .nf .in +.5i CD_ROM TRACK MODE1 DATAFILE "data_1" ZERO 00:02:00 // post-gap TRACK AUDIO SILENCE 00:02:00 // pre-gap START FILE "data_2.wav" 0 TRACK AUDIO FILE "data_3.wav" 0 .in -.5i .fi .SH "فایل‌های CUE (CUE FILES)" فایل‌های cue را می‌توان در هر جایی که یک .I toc-file مورد انتظار است استفاده کرد. فایل bin متناظر از بیانیه FILE در فایل cue گرفته نمی‌شود، بلکه با جایگزینی ".cue" با ".bin" در نام فایل cue ساخته می‌شود. فایل cue باید دقیقاً شامل یک بیانیه FILE باشد. در حال حاضر حالت‌های شیار زیر پشتیبانی می‌شوند: MODE1/2048، MODE1/2352، MODE2/2336، MODE2/2352. بیانیه‌های CATALOG، ISRC و POSTGAP تجزیه می‌شوند اما هنوز ارزیابی نمی‌گردند. .SH "تنظیمات (SETTINGS)" برخی از گزینه‌های خط فرمان می‌توانند به‌عنوان تنظیمات در مکان‌های زیر ذخیره شوند. فایل‌ها هنگام شروع .I cdrdao به ترتیب زیر خوانده می‌شوند: 1. /etc/cdrdao.conf 2. /etc/defaults/cdrdao 3. /etc/default/cdrdao 4. $HOME/.cdrdao گزینه‌های خط فرمان تنظیمات بارگذاری‌شده را بازنویسی می‌کنند. فایل تنظیمات شامل جفت‌های نام - مقدار جداشده با دو نقطه است. مقادیر رشته‌ای باید در " محصور شوند. اگر از گزینه خط فرمان .I \--save استفاده شود این فایل به‌طور خودکار نوشته می‌شود اما امکان ویرایش دستی آن نیز وجود دارد. مقادیر زیر تعریف شده‌اند: .IP write_device دستگاه مورد استفاده برای عملیات‌های .IR simulate ، .IR write ، .IR copy ، .IR blank ، .I disk-info و .IR unlock . گزینه متناظر: .I --device .IP write_driver درایور (شامل گزینه‌های درایور) مورد استفاده برای عملیات‌های .IR simulate ، .IR write ، .IR copy ، .IR blank ، .I disk-info و .IR unlock . گزینه متناظر: .I --driver .IP write_speed سرعت نوشتن را مشخص می‌کند. گزینه متناظر: --speed .IP write_buffers بافرهای fifo مورد استفاده برای ضبط را مشخص می‌کند. گزینه متناظر: --buffers .IP read_device دستگاه مورد استفاده برای عملیات‌های .IR read-toc ، .I read-cd و .IR copy . گزینه متناظر: .I --device یا .I --source-device .IP read_driver درایور (شامل گزینه‌های درایور) مورد استفاده برای عملیات‌های .IR read-toc ، .I read-cd و .IR copy . گزینه متناظر: .I --driver یا .I --source-driver .IP read_paranoia_mode حالت پارانویا مورد استفاده برای عملیات‌های .I read-cd و .IR copy . گزینه متناظر: .I --paranoia-mode .IP cddb_server_list فهرست سرورهای CDDB برای .IR read-cddb . گزینه متناظر: .I --cddb-servers .IP cddb_timeout مهلت زمانی اتصال CDDB به ثانیه مورد استفاده توسط .IR read-cddb . گزینه متناظر: .I --cddb-timeout .IP cddb_directory پوشه محلی برای ذخیره رکوردهای دریافت‌شده CDDB مورد استفاده توسط .IR read-cddb . گزینه متناظر: .I --cddb-directory .IP tmp_file_dir پوشه‌ای که در آن فایل‌های موقت WAV ناشی از رمزگشایی فایل‌های MP3 و Ogg Vorbis ایجاد می‌شوند. گزینه متناظر: .I --tmpdir .LP .SH "باگ‌ها (BUGS)" اگر برنامه در طول فرایند نوشتن/شبیه‌سازی متوقف شود، ممکن است منابع IPC استفاده‌شده آزاد نشوند. برای حذف آن‌ها از ipcs(8) و ipcrm(8) استفاده کنید. .SH "نویسنده (AUTHOR)" .ft CW .nf \&Andreas Mueller mueller@daneb.ping.de [DEFUNCT] \&Denis Leroy \&Manuel Clos .ft R .fi .SH "همچنین ببینید (SEE ALSO)" .BR gcdmaster "(1), "cdrecord "(1), "cdda2wav "(1), "cdparanoia "(1), " sox "(1), "ipcs "(8), " ipcrm (8)