.TH CDPARANOIA 1 "11 Sep 2008" .SH "نام (NAME)" cdparanoia \- ابزار خواندن CD صوتی با قابلیت‌های اعتبارسنجی پیشرفته داده‌ها .SH "خلاصه دستور (SYNOPSIS)" .B cdparanoia .RB [ options ] .B span .RB [ outfile ] .SH "توضیحات (DESCRIPTION)" .B cdparanoia شیارهای صوتی را از درایوهای CDROM با قابلیت CDDA استخراج می‌کند. داده‌ها را می‌توان در یک فایل ذخیره کرد یا با قالب‌های WAV، AIFF، AIFF-C یا خام (raw) به خروجی استاندارد هدایت نمود. اکثر مدل‌های درایو CDROM از نوع ATAPI، SCSI و چندین مدل اختصاصی دیگر پشتیبانی می‌شوند؛ .B cdparanoia می‌تواند تشخیص دهد که آیا درایو هدف از قابلیت CDDA پشتیبانی می‌کند یا خیر. .P علاوه بر خواندن ساده، .B cdparanoia قابلیت‌های اعتبارسنجی بسیار قدرتمند داده‌ها، همگام‌سازی، مدیریت خطا و بازسازی خراشیدگی‌ها را به همراه دارد. .SH "گزینه‌ها (OPTIONS)" .TP .B \-A --analyze-drive اجرا و ثبت تحلیل کاملی از رفتار حافظه موقت (کَش) درایو، زمان‌بندی و رفتار خواندن آن؛ اعتبارسنجی می‌کند که cdparanoia رفتار کَش و خواندن درایو را به درستی مدل‌سازی می‌کند یا خیر. این گزینه مستلزم فعال بودن گزینه‌های -vQL است. .TP .B \-v --verbose نمایش باجزئیات فراوان درباره فرآیند تشخیص خودکار و خواندن. مناسب برای پیکربندی و اشکال‌زدایی. .TP .B \-q --quiet عدم چاپ هرگونه اطلاعات پیشرفت یا خطا در طول فرآیند خواندن. .TP .B \-e --stderr-progress اجبار به ارسال اطلاعات پیشرفت به خروجی خطای استاندارد (stderr) (برای اسکریپت‌های پوششی). .TP .B \-l --log-summary [file] ذخیره خلاصه نتایج در فایل؛ نام فایل پیش‌فرض cdparanoia.log است. .TP .B \-L --log-debug [file] ذخیره خروجی دقیق تشخیص خودکار و اشکال‌زدایی دستگاه در یک فایل؛ نام فایل پیش‌فرض cdparanoia.log است. .TP .B \-V --version چاپ نسخه برنامه و خروج. .TP .B \-Q --query اجرای تشخیص خودکار درایو CDROM، استعلام و چاپ جدول محتویات (TOC) دیسک، سپس خروج. .TP .B \-s --search-for-drive اجبار به جستجوی کامل برای درایو cdrom، حتی اگر پیوند dev/cdrom/ موجود باشد. .TP .B \-h --help چاپ خلاصه کوتاهی از نحوه استفاده و گزینه‌های .B cdparanoia . .TP .B \-p --output-raw خروجی دادن داده‌های بدون هدر به صورت داده‌های خام ۱۶ بیتی PCM با نمونه‌های درهم‌آمیخته (interleaved) بر اساس ترتیب بایت میزبان. برای اجبار ترتیب بایت‌های little-endian یا big-endian، از .B \-r یا .B \-R همان‌طور که در زیر شرح داده شده استفاده کنید. .TP .B \-r --output-raw-little-endian خروجی دادن داده‌های بدون هدر به صورت داده‌های خام ۱۶ بیتی PCM با نمونه‌های درهم‌آمیخته بر اساس ترتیب بایت LSB نخست (little-endian). .TP .B \-R --output-raw-big-endian خروجی دادن داده‌های بدون هدر به صورت داده‌های خام ۱۶ بیتی PCM با نمونه‌های درهم‌آمیخته بر اساس ترتیب بایت MSB نخست (big-endian). .TP .B \-w --output-wav خروجی دادن داده‌ها در قالب RIFF WAV مایکروسافت (توجه داشته باشید که داده‌های WAV همیشه ترتیب بایت LSB نخست دارند). .TP .B \-f --output-aiff خروجی دادن داده‌ها در قالب AIFF اپل (توجه داشته باشید که داده‌های AIFC همیشه ترتیب بایت MSB نخست دارند). .TP .B \-a --output-aifc خروجی دادن داده‌ها در قالب فشرده‌نشده AIFF-C اپل (توجه داشته باشید که داده‌های AIFF-C همیشه ترتیب بایت MSB نخست دارند). .TP .BI "\-B --batch " فلگ خروجی دسته‌ای به سبک cdda2wav؛ دستور cdparanoia خروجی را در مرزهای هر شیار به چند فایل مجزا تقسیم می‌کند. نام فایل‌های خروجی با '.track#' آغاز می‌شود. .TP .B \-c --force-cdrom-little-endian برخی از درایوهای CDROM ترتیب بایت‌های خود (endianness) را نادرست گزارش می‌کنند (یا اصلاً گزارش نمی‌کنند)؛ ممکن است cdparanoia حدس اشتباهی بزند. از .B \-c استفاده کنید تا cdparanoia را مجبور کند درایو را به عنوان یک دستگاه little endian در نظر بگیرد. .TP .B \-C --force-cdrom-big-endian مشابه مورد بالا، اما cdparanoia را مجبور می‌کند تا درایو را به عنوان یک دستگاه big endian در نظر بگیرد. .TP .BI "\-n --force-default-sectors " n اجبار رابط پشتیبان به خواندن اتمیک .B n سکتور در هر بار خواندن. این عدد می‌تواند گمراه‌کننده باشد؛ هسته معمولاً درخواست‌های خواندن را به چندین خواندن اتمیک تقسیم می‌کند (کد خودکار Paranoia از این امر آگاه است) یا تنها امکان خواندن در یک محدوده اندازه معین را می‌دهد. .B این گزینه معمولاً نباید استفاده شود. .TP .BI "\-d --force-cdrom-device " device اجبار رابط پشتیبان به خواندن از .B device به‌جای نخستین درایو CDROM قابل خواندنی که پیدا می‌کند. این می‌تواند برای تعیین دستگاه‌هایی از هر نوع رابط معتبر (ATAPI، SCSI یا اختصاصی) استفاده شود. .TP .BI "\-k --force-cooked-device " device این گزینه استفاده از رابط قدیمی هسته با نام 'cooked ioctl' را با دستگاه cdrom مشخص‌شده اجبار می‌کند. رابط cooked ioctl در لینوکس 2.6 منسوخ شده است، البته اگر اصلاً وجود داشته باشد. .B \-k نمی‌تواند همراه با .B \-d یا .BR \-g استفاده شود. .TP .BI "\-g --force-generic-device " device این گزینه استفاده از رابط قدیمی هسته با نام 'generic scsi' (sg) را با دستگاه generic scsi مشخص‌شده اجبار می‌کند. .B \-g نمی‌تواند همراه با .BR \-k استفاده شود. .B \-g می‌تواند همراه با .B \-d برای تعیین صریح هر دو دستگاه SCSI cdrom و generic (sg) به صورت جداگانه استفاده شود. این گزینه فقط در سیستم‌های منسوخ SCSI و هنگام استفاده از درایور generic scsi (sg) کاربرد دارد. .TP .BI "\-S --force-read-speed " number استفاده صریح از این گزینه برای تنظیم نرخ سرعت خواندن درایو CD (در صورت پشتیبانی). این کار می‌تواند افت سرعت را در سیستم‌های دارای دیسک‌های کند یا حافظه کم کاهش دهد. .TP .BI "\-t --toc-offset " number استفاده از این گزینه برای جابه‌جایی آدرس‌دهی LBA کل دیسک به میزان مشخص‌شده؛ این مقدار به آفست‌های شروع در TOC اضافه می‌شود. این گزینه می‌تواند برای جابه‌جایی دستی مرزهای شیار برای کل دیسک بر اساس دقت سکتور استفاده شود. گزینه بعدی نیز کار مشابهی را انجام می‌دهد... .TP .BI "\-T --toc-bias " برخی از درایوها (معمولاً درایوهای خاص توشیبا) مقادیر واقعی آفست شروع شیار را در TOC گزارش می‌دهند، اما سپس شروع شیار ۱ نمایه ۱ را به عنوان سکتور ۰ برای تمامی عملیات خواندن در نظر می‌گیرند. این امر باعث می‌شود به نظر برسد که هر شیار خیلی دیر شروع می‌شود (کمی از ابتدا را از دست می‌دهد و مقداری از شیار بعدی را می‌گیرد). گزینه .B \-T این رفتار را جبران می‌کند. توجه داشته باشید که این گزینه باعث می‌شود cdparanoia تلاش کند سکتورهای قبل یا بعد از ناحیه شناخته‌شده داده کاربر در دیسک را بخواند، که منجر به خطاهای خواندن در لبه‌های دیسک در بیشتر درایوها و احتمالاً حتی قفل شدن سخت‌افزارهای دارای باگ می‌شود. .TP .BI "\-O --sample-offset " number استفاده از این گزینه برای جابه‌جایی موقعیت نمونه خروجی برای کل دیسک به میزان مشخص‌شده؛ این گزینه می‌تواند برای جابه‌جایی دستی مرزهای شیار برای کل دیسک بر اساس دقت نمونه استفاده شود. توجه داشته باشید که این کار باعث می‌شود cdparanoia تلاش کند سکتورهای جزئی را قبل یا بعد از ناحیه داده کاربر بخواند، که احتمالاً در بیشتر درایوها باعث خطاهای خواندن و در سخت‌افزارهای دارای مشکل موجب قفل سخت‌افزاری می‌شود. .TP .B \-Z --disable-paranoia غیرفعال کردن .B تمامی قابلیت‌های اعتبارسنجی و تصحیح داده‌ها. هنگام استفاده از -Z، دستور cdparanoia داده‌ها را دقیقاً مانند cdda2wav با تنظیم همپوشانی صفر می‌خواند. این گزینه مستلزم فعال بودن گزینه .B \-Y است. .TP .B \-z --never-skip[=max_retries] عدم پذیرش هرگونه پرش؛ در صورت نیاز تلاش مجدد بی‌نهایت. می‌توان یک حداکثر تعداد دفعات تلاش اختیاری را مشخص کرد؛ جهت مقایسه، حالت پیش‌فرض بدون -z در حال حاضر ۲۰ است. .TP .B \-Y --disable-extra-paranoia غیرفعال کردن اعتبارسنجی داده‌های درون‌خواندن؛ تنها بررسی همپوشانی در مرزهای خواندن انجام می‌شود. در صورت بروز خطا در ناحیه مورد نظر همپوشانی ممکن است گیر کند. توصیه نمی‌شود. .TP .B \-X --abort-on-skip اگر فرآیند خواندن به دلیل داده‌های ناقص، خط‌وخش یا هر مورد دیگری دچار پرش شد، خواندن این شیار را متوقف کن. اگر خروجی در یک فایل نوشته می‌شود، فایل نیمه‌کاره حذف گردد. .SH "شکلک‌های وضعیت خروجی (OUTPUT SMILIES)" .TP .B :-) عملکرد عادی، بدون لرزش یا با لرزش کم .TP .B :-| عملکرد عادی، لرزش قابل توجه .TP .B :-/ انحراف در خواندن .TP .B :-P از دست رفتن گزارش‌نشده استریمینگ در عملیات خواندن اتمیک .TP .B 8-| مشاهده خطاهای خواندن در همان نقطه حین بازخوانی؛ تصحیح دشوار .TP .B :-0 خطای انتقال پروتکل SCSI/ATAPI .TP .B :-( خراشیدگی یا خط شناسایی شد .TP .B ;-( تلاش برای تصحیح متوقف شد .TP .B 8-X لغو خواندن به دلیل خطای شناخته‌شده و غیرقابل تصحیح .TP .B :^D استخراج به پایان رسید .SH "نمادهای نوار پیشرفت (PROGRESS BAR SYMBOLS)" .TP .B بدون نیاز به تصحیح .TP .B - تصحیح لرزش لازم است .TP .B + از دست رفتن گزارش‌نشده استریمینگ یا خطای دیگر در خواندن .TP .B ! خطاهای یافت‌شده پس از مرحله اول تصحیح؛ درایو همان خطا را در بازخوانی‌های متعدد تکرار می‌کند و cdparanoia در تشخیص آن‌ها دچار مشکل شده است. .TP .B e خطای انتقال SCSI/ATAPI (تصحیح‌شده) .TP .B V خطای تصحیح‌نشده/پرش .SH "آرگومان محدوده (SPAN ARGUMENT)" آرگومان span مشخص می‌کند کدام شیار، شیارها یا زیربخش‌هایی از شیارها باید خوانده شوند. این آرگومان الزامی است. .B توجه: مگر در مواردی که span یک عدد ساده باشد، معمولاً بهتر است آرگومان span را داخل نقل‌قول (کوتیشن) قرار دهید تا از تفسیر توسط پوسته (شل) محافظت شود. .P آرگومان span می‌تواند یک شماره شیار ساده یا مشخصات یک آفست/محدوده باشد. ساختار آفست/محدوده فرم کلی زیر را دارد: .P 1[ww:xx:yy.zz]-2[aa:bb:cc.dd] .P در اینجا ۱ و ۲ شماره شیارها هستند؛ اعداد درون کروشه‌ها یک آفست دقیق‌تر را در یک شیار خاص فراهم می‌کنند. [aa:bb:cc.dd] در قالب ساعت/دقیقه/ثانیه/سکتور است. فیلدهای صفر نیازی به ذکر ندارند: [::20]، [:20]، [20]، [20.] و غیره به عنوان بیست ثانیه تفسیر می‌شوند، [10:] ده دقیقه خواهد بود، [.30] سی سکتور خواهد بود (۷۵ سکتور در هر ثانیه). .P هنگامی که تنها یک آفست منفرد ارائه شود، به عنوان آفست شروع تفسیر شده و استخراج تا انتهای شیار ادامه می‌یابد. اگر یک آفست منفرد با یک خط تیره آغاز شود یا به خط تیره ختم گردد، آفست نامشخص به ترتیب ابتدای دیسک یا انتهای دیسک در نظر گرفته می‌شود. بدین ترتیب: .TP .B 1:[20.35] استخراج از شیار ۱، ثانیه ۲۰، سکتور ۳۵ تا انتهای شیار ۱ را مشخص می‌کند. .TP .B 1:[20.35]- استخراج از 1[20.35] تا انتهای دیسک را مشخص می‌کند. .TP .B \-2 استخراج از ابتدای دیسک تا شیار ۲ (شامل شیار ۲) را مشخص می‌کند. .TP .B \-2:[30.35] استخراج از ابتدای دیسک تا 2:[30.35] را مشخص می‌کند. .TP .B 2-4 استخراج از ابتدای شیار ۲ تا انتهای شیار ۴ را مشخص می‌کند. .P مجدداً، فراموش نکنید که از کروشه‌ها و خط‌تیره‌های ابتدایی در برابر شل محافظت کنید. .SH "مثال‌ها (EXAMPLES)" چند مثال، همراه با محافظت در برابر شل: .TP تنها پرس‌وجو با جستجوی کامل برای درایو و گزارش کامل تشخیص خودکار: .P cdparanoia -vsQ .TP استخراج کل دیسک، با ذخیره هر شیار در فایلی جداگانه: .P cdparanoia -B .TP استخراج از شیار ۱، زمان 0:30.12 تا 1:10.00: .P cdparanoia "1[:30.12]-1[1:10]" .TP استخراج از ابتدای دیسک تا شیار ۳: .P cdparanoia -- "-3" .TP علامت "--" در بالا برای متمایز کردن "-3" از یک فلگ گزینه است. .SH "خروجی (OUTPUT)" آرگومان فایل خروجی اختیاری است؛ اگر مشخص نشود، cdparanoia نمونه‌ها را بسته به این که کدام‌یک از گزینه‌های .BR \-w "، " \-a "، " \-r " یا " \-R استفاده شده باشد، در یکی از فایل‌های .BR cdda.wav "، " cdda.aifc "، یا " cdda.raw خروجی می‌دهد (گزینه .B \-w حالت پیش‌فرض ضمنی است). آرگومان فایل خروجی با مقدار .B \- خروجی استاندارد را مشخص می‌کند؛ تمامی قالب‌های داده را می‌توان از طریق لوله (pipe) هدایت کرد. .SH "قدردانی‌ها (ACKNOWLEDGEMENTS)" برنامه Cdparanoia برگرفته از رابط کاربری بسته 'cdda2wav' متعلق به Heiko Eissfeldt () بوده و به شدت از آن الهام گرفته است. Cdparanoia بدون آن محقق نمی‌شد. .P همچنین Joerg Schilling از طریق کتابخانه انتقال عمومی SCSI خود، در دانش فنی SCSI مشارکت داشته است. .P .SH "نویسنده (AUTHOR)" Monty .P صفحه اصلی Cdparanoia در نشانی زیر در دسترس است: http://www.xiph.org/paranoia