.\" Hey, EMACS: -*- nroff -*- .\" .\" IMPORTANT NOTE: .\" .\" The original of this file is kept in xorriso/xorrecord.texi .\" This here was generated by program xorriso/make_xorriso_1 .\" .\" .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) .TH XORRECORD 1 "Version 1.5.8, Apr 01, 2026" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: .\" .nh disable hyphenation .\" .hy enable hyphenation .\" .ad l left justify .\" .ad b justify to both left and right margins .\" .nf disable filling .\" .fi enable filling .\" .br insert line break .\" .sp insert n+1 empty lines .\" for manpage-specific macros, see man(7) .nh .SH "نام (NAME)" xorrecord \- شبیه‌سازی برنامه cdrecord برای CD/DVD/BD توسط برنامه xorriso .SH "خلاصه دستور (SYNOPSIS)" .B xorrecord [ options ] dev=device [track_source] .br .SH "توضیحات (DESCRIPTION)" .PP \fBxorrecord\fR داده‌های پیش‌قالب‌بندی‌شده را روی رسانه‌های CD، DVD و BD می‌نویسد. .br .PP این برنامه برخی از گزینه‌های برنامه cdrecord از مجموعه cdrtools اثر Joerg Schilling را می‌شناسد. پیاده‌سازی آن بخشی از برنامه xorriso است که هیچ کد منبع مشترکی با cdrtools ندارد، بلکه برای ارتباط با درایو از libburn استفاده می‌کند. .br شبیه‌ساز دیگر و کامل‌تر cdrecord، برنامه \fBcdrskin\fR است که از توابع رایت یکسانی با \fBxorrecord\fR استفاده می‌کند، اما قادر به رایت CDهای صوتی و مدیریت CD\-TEXT نیز هست. .SS \fBMMC، نشست (Session)، ترک (Track)، انواع رسانه‌ها:\fR .br \fBMMC\fR استانداردی از خانواده SCSI است که تعامل بین رایانه‌ها و درایوهای نوری را تعریف می‌کند. بیش از یک دهه است که تمام ریکوردرهای CD، DVD یا BD فارغ از نوع کابل‌کشی گذرگاهی که با آن به رایانه متصل شده‌اند، از این استاندارد پیروی می‌کنند. libburn به این انطباق با استاندارد و به قابلیت سیستم‌عامل در انجام تراکنش‌های SCSI از طریق کابل‌کشی گذرگاه مربوطه وابسته است. .br یک \fBنشست (Session)\fR ناحیه‌ای از داده روی یک دیسک نوری است که معمولاً در یک مرحله پیوسته نوشته می‌شود. این ناحیه حداقل شامل یک \fBترک (Track)\fR است که رشته‌ای پیوسته از بلوک‌های قابل خواندن است. \fBxorrecord\fR یک نشست منفرد با یک ترک داده واحد تولید می‌کند که از بلوک‌های ۲۰۴۸ بایتی تشکیل شده است. این برنامه حالت نوشتن را به‌طور خودکار و بر اساس نوع رسانه، وضعیت دیسک و گزینه \-multi انتخاب می‌کند. .br روی رسانه‌های CD انواع ترک دیگری مانند صوتی (audio) و حالت‌های نوشتن خاصی مانند TAO و SAO وجود دارند. رسانه‌های CD و DVD\- می‌توانند بیش از یک ترک را در یک نشست جای دهند. برخی از این قابلیت‌ها توسط برنامه \fBcdrskin\fR قابل استفاده هستند. .br استاندارد MMC چندین \fBنوع رسانه\fR قابل ضبط را توصیف می‌کند که تقریباً دو خانواده را تشکیل می‌دهند. .br \fBرسانه‌های با قابلیت ضبط ترتیبی (Sequentially recordable media)\fR عبارتند از CD\-R، CD\-RW، DVD\-R، DVD\-R DL، DVD\-RW، DVD+R، DVD+R DL و BD\-R. به‌جز DVD\-R DL، اگر هنوز فضای نوشته‌نشده‌ای باقی مانده باشد و اگر نشست قبلی با گزینه \fB\-multi\fR نوشته شده باشد، می‌توانند بیش از یک نشست را ذخیره کنند. CD\-RW و DVD\-RW را می‌توان پاکسازی (blank) کرد تا مجدداً از ابتدا قابل استفاده باشند. .br \fBرسانه‌های بازنویسی‌پذیر (Overwritable media)\fR عبارتند از DVD\-RAM، DVD+RW، DVD\-RW قالب‌بندی‌شده و BD\-RE. آن‌ها یک نشست واحد با یک ترک تکی برای نوشتن با دسترسی تصادفی ارائه می‌دهند. نیازی به پاکسازی رسانه‌های بازنویسی‌پذیر پیش از استفاده مجدد نیست. .br رسانه‌های DVD\-RW در وضعیت قابل ضبط ترتیبی فروخته می‌شوند اما می‌توانند یک بار قالب‌بندی شوند تا بازنویسی‌پذیر گردند. گزینه‌های \fBblank=format_overwrite\fR و \fBblank=deformat\fR را ببینید. .br اگر قرار باشد سیستم‌فایل‌های ISO 9660 روی رسانه‌های بازنویسی‌پذیر ذخیره شوند، می‌توان با استفاده از گزینه \fB\-\-grow_overwriteable_iso\fR چندین نشست را شبیه‌سازی کرد. در این حالت، نیاز به پاکسازی پیش از استفاده مجدد نیز شبیه‌سازی می‌شود..SS .B آماده‌سازی و آدرس‌دهی درایو: .PP درایوها (نویسنده‌های CD، DVD یا BD) از طریق نشانی‌های فایلی که مخصوص libburn و سیستم‌عامل هستند در دسترس قرار می‌گیرند. این نشانی‌ها با اجرای \fBxorrecord \-\-devices\fR یا \fBxorriso \-device_links\fR فهرست می‌شوند. .br در GNU/Linux، FreeBSD و NetBSD، کاربر به مجوز خواندن و نوشتن (rw) برای فایل دستگاه نیاز دارد. در Solaris، کاربر به مجوز خواندن (r) و امتیاز «sys_devices» نیاز دارد که معمولاً با اجرای \fBxorrecord\fR از طریق دستور pfexec به دست می‌آید. .br این مجوزها یا امتیازها حتی برای فهرست‌کردن درایو نیز لازم هستند. بنابراین ممکن است لازم باشد فهرست کلی را به عنوان مدیر سیستم (superuser) یا از طریق pfexec دریافت کنید. .br دستور \fBxorrecord\fR گزینهٔ \-scanbus مربوط به cdrecord را اجرا نمی‌کند و نشانی‌های به قالب Bus,Target,Lun را که توسط \-scanbus اعلام می‌شوند نمی‌پذیرد. اگر پشتیبانی از این نشانی‌ها لازم است، استفاده از برنامهٔ cdrskin را در نظر بگیرید. .br امکان استفاده از \fBxorrecord\fR روی درایوهای شبیه‌سازی‌شده (emulated) وجود دارد. نشانی‌های آن‌ها با پیشوند «stdio:» و به دنبال آن یک نشانی فایل آغاز می‌شود. رفتار رسانهٔ شبیه‌سازی‌شده به نوع فایل بستگی دارد. برای جزئیات به man xorriso مراجعه کنید. .br اگر خروجی استاندارد به عنوان درایو شبیه‌سازی‌شده انتخاب شود، تمام متن‌های نتیجهٔ برنامه که معمولاً در خروجی استاندارد ظاهر می‌شوند، به خطای استاندارد هدایت خواهند شد. .SS \fBارتباط با برنامهٔ xorriso:\fR .br دستور \fBxorrecord\fR در واقع یک حالت دستوری از برنامهٔ \fBxorriso\fR است که با دستور «\-as cdrecord» در xorriso یا با راه‌اندازی برنامه با یکی از نام‌های «xorrecord»، «cdrecord»، «wodim» یا «cdrskin» وارد آن می‌شود. .br از این حالت دستوری می‌توان با آرگومان «\-\-» خارج شد که به حالت دستوری عمومی xorriso هدایت می‌کند. برای توضیحات آن به \fBman xorriso\fR مراجعه کنید. بر خلاف حالت دستوری xorriso، ترتیب گزینه‌های شبیه‌سازی cdrecord اهمیتی ندارد. تمام عملیات معوق قبل از پایان اجرای برنامه یا قبل از پایان شبیه‌سازی cdrecord، با ترتیبی ثابت انجام می‌شوند. .SS .br .SH "گزینه‌ها (OPTIONS)" .br .PP .TP .B آدرس‌دهی درایو: .TP \fB--devices\fR فهرست درایوهای CD، DVD یا BD در دسترس را در خروجی استاندارد چاپ می‌کند. در صورتی که کاربر مجوزهای لازم برای استفاده از آن‌ها را نداشته باشد یا درایو توسط برنامهٔ دیگری در حال استفاده باشد، ممکن است درایوها غیرقابل دسترس باشند. .br هر درایو در دسترس با خطی شبیه به این نمایش داده می‌شود: .br 0 \-dev '/dev/sr0' rwrw\-\- : 'TSSTcorp' 'CDDVDW SH\-S203B' .br نشانی libburn این درایو «/dev/sr0» است. «TSSTcorp» نام سازنده (در این مورد: Toshiba Samsung Storage Technologies Corporation) و «CDDVDW SH\-S203B» نام مدل است (در این مورد: یک نویسندهٔ DVD). .br سپس شبیه‌سازی را بدون انجام هیچ عملیات دیگری روی درایو به پایان می‌رساند. .TP \fBdev=drive_address\fR نشانی libburn درایو مورد استفاده را تنظیم می‌کند. .br برای مثال در GNU/Linux: dev=/dev/sr0 .br برای مثال در FreeBSD: dev=/dev/cd0 .br برای مثال در NetBSD: dev=/dev/rcd0d .br برای مثال در Solaris: dev=/dev/rdsk/c2t2d0s2 .br همچنین بخش «آماده‌سازی و آدرس‌دهی درایو» در بالا را ببینید. .br رسانهٔ موجود در درایو نباید سوار (mount) شده باشد یا به هر شکل دیگری در حال استفاده باشد. .br این گزینه تنها زمانی اعمال می‌شود که یک منبع قطعه (track source)، گزینهٔ blank=، یا یک گزینهٔ استعلام درایو مشخص شده باشد. در غیر این صورت منجر به یک رخداد SORRY شده و معمولاً باعث خروج با مقداری غیر از صفر خواهد شد. .TP .B استعلام درایو و رسانه: .TP \fB\-inq\fR اطلاعات سازنده، نام مدل، و نسخهٔ سفت‌افزار (firmware) درایو را در خروجی استاندارد چاپ می‌کند. .TP \fB\-checkdrive\fR بدون قید و شرط چاپ می‌کند که درایو از burnfree، SAO و TAO پشتیبانی می‌کند. همچنین خروجی گزینهٔ \-inq را چاپ می‌کند. .TP \fB\-atip\fR خروجی \-checkdrive، توانمندترین نمایهٔ (profile) رسانهٔ موجود در درایو، فهرست نمایه‌های پشتیبانی‌شده توسط درایو، قابل پاک‌شدن بودن آن (یعنی امکان خالی‌کردن)، سازندهٔ رسانه، و نام محصول رسانه را چاپ می‌کند. .br نمایه‌ها الگوهای استفاده‌ای هستند که اغلب به نوع خاصی از رسانه (مانند CD\-RW) گره خورده‌اند، اما ممکن است برای خانواده‌ای از رسانه‌ها نیز اعمال شوند؛ به عنوان مثال، نمایهٔ CD\-ROM برای تمام رسانه‌های CD حاوی داده اعمال می‌شود. .TP \fB\-toc\fR جدول محتوای (TOC) رسانهٔ موجود در درایو را چاپ می‌کند. خروجی با گزینهٔ \-toc در cdrecord سازگار نیست، بلکه مشابه دستور \-toc در \fBxorriso\fR است. این گزینه نشانی، سازنده، نام مدل و نسخهٔ سفت‌افزار درایو را فهرست می‌کند. .br دربارهٔ رسانه، نام محصول و سازنده، وجود داده‌های نوشته‌شده از قبل، و در این صورت بسته بودن یا الحاق‌پذیر بودن رسانه را مشخص می‌کند. رسانه‌های الحاق‌پذیر (appendable) می‌توانند یک نشست (session) دیگر دریافت کنند. میزان داده‌های قابل خواندن و نوشتن نیز بیان می‌شود. اگر نشست‌هایی وجود داشته باشد، نشانی بلوک آغازین و اندازهٔ آن‌ها گزارش می‌شود. اگر نشستی حاوی سیستم‌فایل ISO 9660 باشد، شناسهٔ حجم (Volume Id) آن گزارش می‌شود. در صورتی که رسانه قابل نوشتن باشد، نشانی بلوک بعدی قابل نوشتن گزارش خواهد شد. .br اگر گزینهٔ \fB\-\-grow_overwriteable_iso\fR داده نشده باشد یا هیچ سیستم‌فایل ISO 9660 روی رسانه موجود نباشد، رسانه‌های با قابلیت بازنویسی (overwritable) به صورت خالی گزارش می‌شوند. این به این دلیل است که می‌توان روی آن‌ها بدون آماده‌سازی بیشتر از ابتدا نوشت، و این که MMC تفاوتی بین داده‌های نوشته‌شده در آخرین فرایند رایت و داده‌های قدیمی‌تری که توسط آن فرایند رایت رونویسی نشده‌اند قائل نمی‌شود. در نتیجه، این رسانه‌ها با ۰ بلوک خواندنی گزارش می‌شوند، هرچند تمام بلوک‌های قابل نوشتن آن‌ها معمولاً قابل خواندن نیز هستند. .TP \fB\-msinfo\fR متن آرگومان را برای گزینهٔ \-C در برنامه‌های mkisofs، genisoimage یا xorrisofs چاپ می‌کند. این مقدار از دو عدد تشکیل شده که با کاما از هم جدا شده‌اند. .br عدد اول نخستین بلوک از نخستین قطعهٔ آخرین نشست ثبت‌شده را مشخص می‌کند. این همچنین همان نشانی‌ای است که به طور پیش‌فرض هنگام سوار کردن یک رسانه با مثلاً سیستم‌فایل ISO 9660 توسط سیستم‌عامل‌ها استفاده می‌شود. .br عدد دوم نشانی بعدی قابل نوشتن را مشخص می‌کند، جایی که \fBxorrecord\fR شروع به نوشتن نشست بعدی خواهد کرد. .br این گزینه فقط برای رسانه‌های نوشته‌شده و الحاق‌پذیر معتبر است. در تمام موارد دیگر هیچ متنی خروجی نمی‌دهد، اما برنامه را با مقدار خروج غیرصفر لغو می‌کند. .TP .B تنظیمات برای فرایند رایت: .PP یک فرایند رایت دقیقاً به یک آرگومان نشانی منبع قطعه (track source) نیاز دارد که مشخص می‌کند داده‌هایی که باید در نشست آینده قرار گیرند از کجا خوانده شوند. وضعیت رسانه باید خالی (blank) یا الحاق‌پذیر (appendable) باشد. .br منبع قطعه می‌تواند «\-» برای ورودی استاندارد، یا نشانی یک فایل خواندنی از هر نوعی به جز دایرکتوری‌ها باشد. تقریباً همهٔ انواع رسانه‌ها منبع قطعه‌ای با تعداد بایت‌های غیرقابل پیش‌بینی، مانند ورودی استاندارد یا لوله‌های نام‌گذاری‌شده (named pipes) را می‌پذیرند. با این وجود، DVD\-R DL و DVD\-RW که با حالت deformat_quickest خالی شده‌اند، نیازمند رزرو دقیق اندازهٔ قطعه از قبل هستند؛ بنابراین یا باید از منبعی با طول قابل پیش‌بینی خوانده شوند، یا باید با گزینهٔ \fBtsize=\fR یا با گزینهٔ \fB\-isosize\fR همراه باشند. .br چندین گزینه انتظار یک مقدار اندازه را به عنوان آرگومان دارند. یک عدد با حرف پایانی «b» یا بدون حرف پایانی، شمارش سادهٔ بایت‌هاست. سایر حروف پایانی باعث ضرب عدد داده‌شده در یک ضریب مقیاس می‌شوند: .br "k" یا "K" = 1024 ، "m" یا "M" = 1024k ، "g" یا "G" = 1024m ، "s" یا "S" = 2048 .br برای مثال tsize=234567s به معنای اندازهٔ 234567 * 2048 = 480393216 بایت است. .TP \fBblank=mode\fR یک CD\-RW یا DVD\-RW را خالی می‌کند تا دوباره از ابتدا قابل استفاده شود. اگر DVD\-RW، DVD+RW، DVD\-RAM، BD\-R یا BD\-RE هنوز قالب‌بندی (format) نشده باشند، آن‌ها را قالب‌بندی می‌کند. .br این عملیات معمولاً هرگونه دادهٔ ضبط‌شده روی رسانه را غیرقابل خواندن می‌کند. این کار با رایت کردن در همان اجرای \fBxorrecord\fR قابل ترکیب است، یا می‌تواند بدون منبع قطعه انجام شود و رسانه را خالی رها کند. .br حالت (mode) مشخص‌شده همراه با blank= رفتار خاص را تعیین می‌کند: .RS .TP .br as_needed .br تلاش می‌کند تا رسانه را برای نوشتن از ابتدا آماده سازد. اگر نیاز به قالب‌بندی داشته باشد، آن را قالب‌بندی می‌کند. اگر خالی نباشد، برای اعمال blank=fast تلاش می‌کند. در صورتی که رسانه نتواند وضعیت کاملاً قابل نوشتن به خود بگیرد (مثلاً اگر یک رسانهٔ یک‌بار-نوشتنی غیرخالی باشد)، دلیلی برای لغو برنامه خواهد بود. .br این کار DVD\-RW قالب‌بندی‌نشده را در وضعیت خالی قالب‌بندی‌نشده باقی می‌گذارد. برای قالب‌بندی DVD\-RW از blank=format_overwrite استفاده کنید. BD\-R خالی و قالب‌بندی‌نشده نیز قالب‌بندی‌نشده باقی می‌ماند. .br (نکته: blank=as_needed یک گزینهٔ اصلی cdrecord نیست.).TP .br all .br پاک کردن کامل یک CD\-RW یا یک DVD\-RW قالب‌بندی‌نشده. .TP .br fast .br پاک کردن حداقلی یک CD\-RW کامل یا پاک کردن یک DVD\-RW قالب‌بندی‌نشده. .TP .br deformat .br مانند blank=all اما با قابلیت افزوده برای پاک کردن DVD\-RWهای بازنویسی‌پذیر (overwritable). این کار قالب‌بندی آن‌ها را از بین برده و آن‌ها را برای ضبط ترتیبی آماده می‌کند. .br (توجه: blank=deformat از گزینه‌های اصلی cdrecord نیست) .TP .br deformat_quickest .br مانند blank=deformat اما پاک کردن DVD\-RW را تنها به صورت حداقلی انجام می‌دهد. این روش سریع‌تر از پاک کردن کامل است اما رسانه‌ای تولید می‌کند که قادر به نوشتن ترک‌هایی با اندازه غیرقابل پیش‌بینی نیست. حالت چندنشستی (Multi\-session) نیز امکان‌پذیر نخواهد بود. .br (توجه: blank=deformat_quickest از گزینه‌های اصلی cdrecord نیست.) .TP .br format_overwrite .br قالب‌بندی یک DVD\-RW به حالت "Restricted Overwrite". کاربر باید مقداری صبوری به خرج دهد. .br قالب‌بندی DVD+RW یا BD\-RE قالب‌بندی‌نشده یا BD\-R خام به اندازه پیش‌فرض آن‌ها. انجام این کار برای دیسک‌های DVD+RW و BD\-RE الزامی نیست، چرا که در اولین تلاش برای نوشتن به طور خودکار قالب‌بندی خواهند شد. .br رسانه‌های BD\-R ممکن است در حالت قالب‌بندی‌نشده نوشته شوند. این کار جایگزینی بلوک‌های خراب (bad blocks) را غیرفعال نگه داشته و سرعت اسمی کامل نوشتن را ممکن می‌سازد. به محض این که رسانه‌های BD\-R نوشته شوند، دیگر قابل قالب‌بندی نخواهند بود. .br برای قالب‌بندی مجدد رسانه‌هایی که قبلاً قالب‌بندی شده‌اند یا برای قالب‌بندی با اندازه‌ای غیر از پیش‌فرض، از برنامه \fBxorriso\fR با دستور \fB\-format\fR استفاده کنید. .br (توجه: blank=format_overwrite از گزینه‌های اصلی cdrecord نیست) .TP .br help .br چاپ یک خلاصه کوتاه از حالت‌های پاک‌سازی در خروجی خطای استاندارد. .br سپس پایان شبیه‌سازی بدون انجام هیچ عملیاتی روی درایو. .RE .TP \fB\-multi\fR این گزینه CD، DVD\-R[W] قالب‌بندی‌نشده، DVD+R یا BD\-R را پس از نوشته شدن نشست (session) فعلی، در وضعیت قابل الصاق (appendable) نگه می‌دارد. بدون آن، دیسک بسته می‌شود و دیگر نمی‌توان روی آن نوشت \- مگر اینکه از نوع \-RW بوده و پاک شود، که این کار موجب از دست رفتن محتوای آن می‌گردد. .br این گزینه را نمی‌توان برای DVD\-R DL یا DVD\-RWهایی که با حالت "deformat_quickest" پاک شده‌اند اعمال کرد. گزینه \-\-multi_if_possible ممکن است بتواند این وضعیت را به صورت خودکار تشخیص داده و مدیریت کند. .br به منظور در دسترس بودن تمام محتوای سیستم‌فایل، سیستم‌فایل احتمالی ISO\-9660 در نشست بعدی باید به روشی ویژه توسط برنامه آماده‌ساز سیستم‌فایل آماده شود. برنامه‌های mkisofs، genisoimage و xorrisofs انتظار اطلاعات خاصی درباره این وضعیت دارند که می‌توان آن را توسط گزینه \-msinfo در \fBxorrecord\fR دریافت کرد. .br در رسانه‌های بازنویسی‌پذیر DVD یا BD، گزینه \-multi نمی‌تواند پایان نشست را مشخص کند. بنابراین هنگام افزودن یک نشست جدید، این پایان باید از داده‌های بار مفید (payload) تعیین شود. در حال حاضر تنها سیستم‌فایل‌های ISO\-9660 را می‌توان به این صورت استفاده کرد. گزینه \fB\-\-grow_overwriteable_iso\fR را ببینید. .TP \fB\-dummy\fR تلاش برای انجام عملیات‌های درایو بدون تأثیر واقعی بر روی رسانه واردشده. هیچ ضمانتی وجود ندارد که این قابلیت با ترکیب خاصی از درایو و رسانه کار کند. با این حال، از عملیات پاک‌سازی به‌طور مطمئن جلوگیری می‌شود. برای جلوگیری از رایت واقعی ناخواسته، \-dummy از اجرای رایت بر روی هر چیزی جز CD\-R[W]، DVD\-R[W] یا درایوهای شبیه‌سازی‌شده stdio خودداری می‌کند. .TP \fB\-waiti\fR صبر کردن تا زمانی که داده‌های ورودی در stdin در دسترس قرار گیرند یا EOF در stdin رخ دهد. تنها پس از آن دسترسی به درایوها آغاز می‌شود. .br در صورتی که xorrisofs در انتهای یک لوله (pipe) کار می‌کند که در آن فرآیند تغذیه‌کننده قبل از شروع به نوشتن خروجی خود در xorrisofs، از درایو می‌خواند، باید از این گزینه استفاده شود. مثال: .br xorrisofs ... \-C 0,12800 \-M /dev/sr0 ... | \\ .br xorrecord dev=/dev/sr0 ... \-waiti \- .br این گزینه حتی اگر ورودی استاندارد منبع ترک نباشد نیز کار می‌کند. اگر هیچ فرآیندی ورودی را لوله‌کشی نکند، کلید Enter پایانه شما به عنوان محرک برای \fBxorrecord\fR عمل خواهد کرد. توجه داشته باشید اگر ورودی استاندارد منبع ترک نباشد، این سطر ورودی توسط cdrskin مصرف نخواهد شد و معمولاً به عنوان یک دستور پوسته اجرا خواهد شد. .TP \fBtsize=size\fR اعلام اندازه دقیق منبع ترک (track). این کار برای رسانه‌های DVD\-R DL و DVD\-RWهای پاک‌شده با حالت quickest ضروری است، اگر نتوان اندازه را از قبل از منبع ترک تعیین کرد؛ مانند زمانی که ورودی استاندارد یا یک لوله نام‌گذاری‌شده (named pipe) باشد. .br اگر منبع ترک مقدار بایت‌های پیش‌بینی‌شده را تحویل ندهد، باقیمانده ترک با صفر پر می‌شود. این حالت یک خطا در نظر گرفته نمی‌شود. اما اگر از سوی دیگر، منبع ترک بایت‌هایی بیشتر از مقدار اعلام‌شده تحویل دهد، ترک روی رسانه به اندازه پیش‌بینی‌شده بریده می‌شود و xorrecord با یک مقدار غیرصفر خارج می‌شود. .TP \fB\-isosize\fR تلاش برای به دست آوردن اندازه ترک از محتوای منبع ترک. این گزینه تنها زمانی کار می‌کند که منبع ترک حاوی یک سیستم‌فایل ISO 9660 باشد. هر محتوای دیگری در منبع ترک باعث لغو اجرای رایت خواهد شد. .br اگر منبع ترک یک فایل معمولی یا دستگاه بلوکی نباشد، این گزینه تنها در صورتی کار خواهد کرد که اندازه بافر fifo برنامه حداقل 64k باشد. گزینه fs= را ببینید. .TP \fBpadsize=size\fR افزودن مقدار مشخص‌شده‌ای از صفرهای انتهایی به ترک پیش‌رو. این ویژگی را می‌توان با اندازه 0 غیرفعال کرد. مقدار پیش‌فرض 300 kB است تا مشکلی در GNU/Linux دور زده شود که اغلب در خواندن چند بلوک آخر یک ترک CD که در حالت نوشتن TAO نوشته شده، ناموفق است. در صورتی که نتوان اندازه ترک را پیش‌بینی کرد یا رسانه CD خام نبوده اما قابل الصاق باشد، TAO توسط \fBxorrecord\fR استفاده می‌شود. .TP \fB\-nopad\fR مشابه padsize=0. .TP \fB\-pad\fR مشابه padsize=15s. این مقدار زمانی در هسته‌های قدیمی‌تر GNU/Linux کافی بود. اکنون باید دست‌کم از padsize=128k، و در صورت امکان از padsize=300k استفاده کرد. .TP \fB\-data\fR اعلام صریح اینکه منبع ترک باید به عنوان ترک داده ضبط شود، نه به عنوان ترک صوتی. این گزینه هیچ تأثیری در \fBxorrecord\fR ندارد، زیرا در هر صورت هیچ پشتیبانی از دیگر قالب‌های ترک وجود ندارد. .TP \fB\-tao\fR درخواست صریح برای اینکه از نوع نوشتن TAO برای CD، یا نوع Incremental برای DVD\-R استفاده شود. معمولاً برنامه نوع نوشتن را با توجه به وضعیت رسانه داده‌شده، گزینه \-multi و منبع ترک انتخاب می‌کند. درخواست صریح آن، در صورتی که مناسب وضعیت نباشد، از شروع عملیات نوشتن جلوگیری می‌کند. .TP \fB\-sao\fR درخواست صریح برای اینکه از نوع نوشتن SAO برای CD، یا DAO برای DVD\-R استفاده شود. این کار در صورتی که مناسب وضعیت نباشد ممکن است از اجرای عملیات نوشتن جلوگیری کند. .TP \fB\-dao\fR نام مستعار \-sao. .TP \fBfs=size\fR تنظیم اندازه بافر fifo برنامه به مقدار مشخص‌شده به جای مقدار پیش‌فرض 4m. .br بافر fifo مازاد موقت داده‌های منبع ترک را ذخیره می‌کند تا در زمان‌های کمبود موقت داده از منبع، جریانی پیوسته برای درایو فراهم آورد. .br برخلاف cdrecord، برنامه xorrecord قابلیت محافظت از تخلیه بافر درایو (buffer underrun protection) را به طور پیش‌فرض فعال می‌کند و برای شروع نوشتن، منتظر پر شدن بافر fifo برای بار اول نمی‌ماند. در درایوهای بسیار قدیمی CD و رایانه‌های کند، این امر ممکن است باعث لغو شدن عملیات رایت شود. در این صورت، استفاده از برنامه \fBcdrskin\fR را برای رایت CD مد نظر قرار دهید. درایوهای DVD و BD بدون مشکل تخلیه بافر را تحمل می‌کنند. .br هر چه بافر fifo بزرگ‌تر باشد، دوره‌های طولانی‌تری از ضعف منبع داده را می‌توان جبران کرد. اما یک fifo بزرگ می‌تواند سیستم‌عامل را از حافظه پنهان خواندن (read cache) جهت کارایی بهتر سیستم‌فایل محروم کند. .TP \fBspeed=value\fR تنظیم سرعت نوشتن. مقدار پیش‌فرض 0 = حداکثر سرعت است. سرعت می‌تواند بر حسب ضرایب سرعتی x وابسته به نوع رسانه یا به عنوان توان عملیاتی مطلوب در ثانیه بر حسب kB سازگار با MMC (= 1000) یا MB (= 1000 kB) مشخص شود. ضریب سرعتی x رسانه را می‌توان با افزودن "c" برای CD، "d" برای DVD و "b" برای BD به‌طور صریح تعیین کرد. استفاده از "x" اختیاری است. .br نمونه‌های سرعت: .br 706k = 706kB/s = 4c = 4xCD .br 5540k = 5540kB/s = 4d = 4xDVD .br اگر هیچ نشانه‌ای از واحد سرعت ضمیمه نشده باشد، رسانه درون درایو تعیین‌کننده خواهد بود. واحد پیش‌فرض CD است، 1x = 176,400 بایت خام در ثانیه. برای DVD‏، 1x = 1,385,000 بایت در ثانیه. برای BD‏، 1x = 4,495,625 بایت در ثانیه. .br درایوهای MMC معمولاً برآورد سرعت خودشان را اعمال می‌کنند و مقدار سرعت ارائه‌شده توسط برنامه رایت را صرفاً به عنوان یک پیشنهاد برای تصمیم‌گیری خود در نظر می‌گیرند..TP \fBminbuf=percentage\fR معادل با: .br modesty_on_drive= .TP \fB\-immed\fR معادل با: .br modesty_on_drive=75 .br در cdrecord، این گزینه استفاده از بیت Immed را نیز کنترل می‌کند. اما xorriso تا جایی که ممکن و مناسب باشد از Immed استفاده می‌کند، مگر اینکه با گزینه use_immed_bit=off غیرفعال شده باشد. .TP \fB\-eject\fR بیرون دادن سینی درایو پس از انجام تمام کارهای دیگر. .TP .B نسخه و میزان پرگویی برنامه: .TP \fB\-version\fR چاپ خطی در خروجی استاندارد که با .br "Cdrecord 2.01\-Emulation Copyright" .br آغاز می‌شود و خطوط بعدی که نسخه xorriso و کتابخانه‌های پشتیبان آن را گزارش می‌دهند. آن‌ها همچنین مجوزی که برنامه تحت آن عرضه شده را بیان کرده و تا جایی که قانون اجازه می‌دهد، هرگونه ضمانت را سلب می‌کنند. .br سپس شبیه‌سازی بدون انجام هیچ‌گونه عملیاتی روی درایو به پایان می‌رسد. .TP \fB\-v\fR افزایش میزان پرگویی برنامه به اندازه یک سطح. چهار سطح پرگویی از تقریباً بی‌صدا تا پرگویی اشکال‌زدایی وجود دارد. هر دو سطح بالاتر را می‌توان با تکرار \-v یا با \-vv یا با \-vvv فعال کرد. .TP \fB\-V\fR ثبت دستورات SCSI و پاسخ‌های درایو در خطای استاندارد. این امر ممکن است زمانی مفید باشد که \fBxorrecord\fR و یک درایو یا رسانه خاص آن‌طور که انتظار می‌رود همکاری نمی‌کنند، یا اگر فقط می‌خواهید بدانید libburn چگونه با درایو تعامل می‌کند. برای درک این گزارش بسیار پرگو، لازم است مشخصات SCSI شامل SPC، SBC و MMC مطالعه شود. .br لطفاً در وهله اول چنین گزارشی را به یک گزارش باگ اضافه نکنید، مگر اینکه بخواهید به انحراف خاصی از مشخصات مذکور اشاره کنید، یا اینکه نگه‌دارنده‌ای از \fBxorrecord\fR که مسئولیت رسیدگی به گزارش باگ شما را بر عهده دارد، درخواست این گزارش را کرده باشد. .TP \fB\-help\fR چاپ فهرستی مختصر از گزینه‌های برنامه در خطای استاندارد و اعلام این‌که cdrecord نیست. .br سپس شبیه‌سازی بدون انجام هیچ‌گونه عملیاتی روی درایو پایان می‌یابد. .TP .B گزینه‌های ناسازگار با cdrecord: .TP \fB--no_rc\fR تنها در صورتی که به عنوان نخستین آرگومان خط فرمان استفاده شود، این گزینه از خواندن و تفسیر فایل‌های راه‌اندازی جلوگیری می‌کند. بخش «فایل‌ها (FILES)» را در ادامه ببینید. .TP \fB--drive_not_exclusive\fR این گزینه استفاده از سازوکارهای قفل کردن فایل دستگاه را هنگام در اختیار گرفتن درایو غیرفعال می‌کند. در GNU/Linux قفل کردن با open(O_EXCL) و در FreeBSD با flock(LOCK_EX) انجام می‌شود. .br توجه داشته باشید که اگر از درایوی استفاده کنید که سوار (mount) شده باشد، توسط فرایند دیگری باز شده باشد، یا توسط /dev/pktcdvd* محافظت شود، می‌تواند مشکلاتی ایجاد کند. اطمینان حاصل کنید که سایر کاربران درایو در حین اجرای عملیات رایت xorrecord، باعث ایجاد فعالیت در درایو نمی‌شوند. .TP \fBdrive_scsi_dev_family=sr|scd|sg|default\fR مخصوص GNU/Linux: .br به‌طور پیش‌فرض، xorrecord تلاش می‌کند تا نشانی‌های درایو در لینوکس را پیش از باز شدن برای کار با درایو، به /dev/sr* نگاشت کند. این کار با سایر موارد استفاده از درایوهای نوری، مانند mount(8)، به‌خوبی هماهنگ است. اما بین سال‌های ۲۰۱۰ تا ۲۰۲۰، تمام /dev/sr* یک قفل سراسری را به اشتراک می‌گذاشتند که تنها به یک درایو اجازه می‌داد یک دستور SCSI را پردازش کند در حالی که سایرین باید منتظر تکمیل آن می‌ماندند. این امر در صورتی که بیش از یک درایو به‌طور هم‌زمان مشغول نوشتن یا خواندن بود، بازدهی بسیار پایینی ایجاد می‌کرد. .br قفل سراسری هرگز روی فایل‌های دستگاه /dev/sg* و همچنین برای فراخوان‌های سیستمی read(2) و write(2) اعمال نشد. اما ioctl(SG_IO) که برای اجرای دستورات SCSI برای رایت نوری لازم است، تحت تأثیر قرار گرفت. .br بنابراین برای اجراهای هم‌زمان رایت روی GNU/Linux نسخه ۲.۶ تا ۵.۵، توصیه می‌شود از drive_scsi_dev_family="sg" استفاده کنید. نشانی‌های درایو ممکن است به خوبی به صورت /dev/sr* داده شوند، اما با این وجود به عنوان /dev/sg* استفاده خواهند شد. .TP \fB--grow_overwriteable_iso\fR فعال‌سازی شبیه‌سازی نوشتن چند‌نشستی (multi\-session) روی رسانه‌های بازنویسی‌پذیر که حاوی سیستم‌فایل ISO 9660 هستند. این شبیه‌سازی از growisofs \-M الگوبرداری شده، اما با مدل استفادهٔ .br xorrecord \-msinfo .br xorrisofs \-C \-M | xorrecord \-waiti \-multi \- .br برای رسانه‌های ترتیبی تطبیق یافته است. .br گزینه \-\-grow_overwriteable_iso مانع از استفاده از رسانه‌های چندنشستی واقعی نمی‌شود؛ به این معنی که در صورت نوشتن ایمیج‌های سیستم‌فایل ISO 9660، می‌توان از همان گزینه‌های \fBxorrecord\fR برای هر دو نوع رسانه استفاده کرد و به نتایج مشابهی رسید. این گزینه مستلزم گزینه \-isosize است و بنابراین ایجاب می‌کند که منبع قطعه (track) یک ایمیج سیستم‌فایل ISO 9660 باشد. .br در رسانه‌های بازنویسی‌پذیر و در صورتی که گزینه blank=fast|all وجود نداشته باشد، سیستم‌فایل احتمالی ISO 9660 موجود روی رسانه را گسترش می‌دهد. فرض بر این است که شرح اندازه داخلی این ایمیج به انتهای داده‌های ارزشمند اشاره دارد. رسانه‌های بازنویسی‌پذیر با اندازه قابل تشخیص ISO 9660 به عنوان رسانه‌های الحاق‌پذیر در نظر گرفته می‌شوند تا رسانه‌های خام. به این معنی که گزینه‌های \-msinfo و \-toc کار خواهند کرد. گزینه \-toc همیشه یک نشست واحد را نشان می‌دهد که اندازه آن با هر ایمیج ISO 9660 اضافه‌شده افزایش می‌یابد. .TP \fB--multi_if_possible\fR در صورت مناسب بودن رسانه، گزینه \-multi را اعمال می‌کند. رسانه‌های DVD\-R DL و DVD\-RW که با حالت "deformat_quickest" خام شده‌اند، مناسب نیستند. .br همه درایوها چنین DVD\-RWهای سریع خام‌شده‌ای را که نیاز به "on" دارند، به‌درستی تشخیص نمی‌دهند. اگر این سوءظن منطقی وجود داشته باشد که اجرای رایت به دلیل \-multi با شکست مواجه شده است، این گزینه باعث تلاش مجدد بدون \-multi می‌شود. .TP \fBstream_recording="on"|"off"|number\fR حالت "on" درخواست می‌کند که انطباق با تنظیم سرعت مورد نظر بر مدیریت خطاهای نوشتن ارجحیت داده شود. در DVD\-RAM و BD، این می‌تواند سرعت نوشتن مؤثر را به سرعت نوشتن اسمی رسانه نزدیک کند. اما همچنین استفاده خودکار از بلوک‌های جایگزین را در صورت وقوع خطاهای نوشتن غیرفعال می‌کند. این حالت همچنین ممکن است توسط درایو نادیده گرفته شده یا مورد پذیرش قرار نگیرد. .br اگر یک عدد داده شود، مدیریت خطا برای تمام نشانی‌های بایتی زیر آن عدد فعال باقی می‌ماند. هر عدد کمتر از 16s معادل "off" است. .TP \fBdvd_obs="default"|"32k"|"64k"\fR تنظیم تعداد بایت‌هایی که باید با هر عملیات نوشتن به رسانه DVD یا BD منتقل شوند. در بیشتر انواع نوشتن، قطعه‌ها تا مضرب بعدی از این اندازه نوشتن پد می‌شوند (گزینه \-\-obs_pad را ببینید). مقدار 64 KB ممکن است بازده را در سیستم‌های گذرگاهی که مشکلات تأخیر دارند بهبود بخشد. مقدار پیش‌فرض به نوع رسانه، گزینه stream_recording= و گزینه‌های زمان کامپایل بستگی دارد. .TP \fB\--obs_pad\fR پد کردن داده‌های آخرین عملیات نوشتن در یک نشست DVD\-R[W] DAO، یا نشست BD\-R، یا نشست شبه‌درایو stdio: تا اندازه کامل یک تکه خروجی. این پدینگ باید به‌طور خودکار روی سایر انواع رسانه‌های DVD و BD اعمال شود، که در آن‌ها برای نمونه باعث می‌شود ایمیج‌های ISO دارای بلوک‌های بدون استفاده در انتها باشند. این‌که آیا به‌طور خودکار روی BD\-R اعمال شود یا خیر، به گزینه \-\-bdr_obs_exempt بستگی دارد. .br اگر این احتمال وجود دارد که نشست‌های DVD\-R[W] DAO یا BD\-R در صورت مضرب ۱۶ بلوک نبودن اندازه‌شان، با هسته و/یا درایو DVD شما لغو شوند، از این گزینه استفاده کنید. .br این گزینه همچنین ممکن است در زمان کامپایل libburn فعال شود. .TP \fB\--bdr_obs_exempt\fR مستثنی کردن رسانه‌های BD\-R از پدینگ خودکار و بدون قید و شرط پایان تراکنش، مشروط بر این‌که این پدینگ توسط \-\-obs_pad درخواست نشده باشد و هیچ stream_recording درخواست نشده باشد. .br این یک ویژگی جدید است که با نسخه 1.5.6 معرفی شده است. ممکن است در نسخه‌های بعدی به حالت پیش‌فرض تبدیل شود. .TP \fB\--perform_opc\fR دستور دادن به درایو برای انجام کالیبراسیون بهینه توان (OPC) پیش از شروع نوشتن. بسیاری از درایوها حتی بدون دستور صریح، کالیبراسیون توان خود را انجام می‌دهند. .br این گزینه ممکن است مفید باشد یا نباشد. تنها زمانی از آن استفاده کنید که گمان می‌برید خرابی‌های رایت به دلیل سازگاری ضعیف بین درایو و رسانه رخ داده است. .TP \fB\--perform_opc_growisofs\fR دستور دادن به درایو برای انجام کالیبراسیون بهینه توان پیش از شروع نوشتن، اما فقط برای DVD\-R و DVD\-RW قالب‌بندی‌نشده، و تنها در صورتی که درایو ورودی‌های جدول OPC را ارائه ندهد. این همان کاری است که growisofs به‌طور پیش‌فرض انجام می‌دهد. .br این گزینه ممکن است مفید باشد یا نباشد. تنها زمانی از آن استفاده کنید که گمان می‌برید خرابی‌های رایت به دلیل سازگاری ضعیف بین درایو و رسانه رخ داده است. .TP \fBmodesty_on_drive=parameter[:parameters]\fR کنترل این‌که آیا باید از پر شدن کامل بافر درایو جلوگیری شود یا خیر. پارامتر "on" (یا "1") مانع از آن می‌شود که برنامه در حالی که بافر درایو رایتر در خطر پر شدن بیش از یک حد معین است اقدام به نوشتن کند. اگر این پرشدگی بیش از حد مجاز شود، برنامه منتظر می‌ماند تا میزان پر بودن به یک مقدار درصد پایینی مشخص برسد. .br این کار می‌تواند بار روی سیستم‌عامل و کنترل‌کننده درایو را کاهش دهد و بنابراین در صورتی که دیسک و رایتر روی کنترل‌کننده‌های مستقل قرار نداشته باشند (مانند hda و hdb)، به دستیابی به پهنای باند ورودی بهتر کمک کند. همچنین ممکن است در رایت‌های هم‌زمان روی رایترهای مختلف با هسته‌های لینوکس بین ۲.۶ تا ۵.۵ کمک کند، در صورتی که دلیلی برای رفع نکردن مشکل از طریق drive_scsi_dev_family="sg" وجود داشته باشد. از سوی دیگر، خطر سرریز منفی بافر (buffer underflow) و در نتیجه کاهش سرعت نوشتن را افزایش می‌دهد. .br برخی از رایترها مناسب نیستند زیرا پر بودن بافر را با دانه‌بندی بسیار درشت در اندازه یا زمان گزارش می‌دهند، یا انتظار دارند بافر آن‌ها پیش از رفتن به سرعت کامل، تا انتها پر شود. .br پارامترهای "off" یا "0" این ویژگی را غیرفعال می‌کنند. .br آستانه شروع انتظار با پارامتر "max_percent=" تعیین می‌شود. پارامتر "min_percent=" آستانه ازسرگیری انتقال را مشخص می‌کند. درصدهای مجاز در محدوده ۲۵ تا ۱۰۰ هستند. اعداد در این محدوده بدون نام پیشوند به عنوان "on:min_percent=" تفسیر می‌شوند. .br برای مثال: modesty_on_drive=75 .br مقادیر بهینه به رفتار بافر درایو بستگی دارد. .br پارامتر "timeout_sec=" تعیین می‌کند که پس از چه مدتی از انتظار ناموفق، حالت modesty باید غیرفعال شود زیرا کارایی ندارد. .br پارامتر "min_usec=" دوره توقف اولیه را بر حسب میکروثانیه مشخص می‌کند. اگر به نظر برسد که بافر درایو برای ارسال داده‌های بیشتر بیش از حد پر است، برنامه به میزان زمان مشخص‌شده منتظر می‌ماند و وضعیت پر بودن بافر را دوباره جویا می‌شود. اگر پرس‌وجوی مکرر فضای خالی کافی را نشان ندهد، زمان توقف به‌آرامی تا میزانی که پارامتر "max_usec=" تعیین کرده افزایش می‌یابد. .br پارامترهایی که با یک گزینه modesty_on_drive= ذکر نشده‌اند، بدون تغییر باقی می‌مانند. پیش‌فرض عبارت است از: .br modesty_on_drive=off:min_percent=90:max_percent=95: timeout_sec=120:min_usec=5000:max_usec=25000.TP \fBuse_immed_bit="on"|"off"|"default"\fR کنترل می‌کند که آیا چندین دستور زمان‌بر SCSI با بیت Immed اجرا شوند یا خیر؛ این بیت باعث می‌شود که دستورها در حالی که عملیات درایو هنوز در حال انجام است، زودتر به پایان برسند. سپس xorriso وضعیت پیشرفت را مرتباً استعلام می‌کند تا زمانی که درایو دوباره آماده بودن خود را گزارش دهد. اگر این ویژگی غیرفعال باشد، پاک‌سازی و قالب‌بندی هیچ نشانگری از پیشرفت را نمایش نخواهند داد. .br اینکه آیا \-use_immed_bit به‌طور پیش‌فرض روی "off" تنظیم باشد یا خیر، ممکن است به سیستم‌عامل بستگی داشته باشد. .TP \fBwrite_start_address=byte_offset\fR نشانی بایتی را روی رسانه‌های بازنویسی‌پذیر تعیین می‌کند که نوشتن شیار (track) از آنجا آغاز شود. در DVD+RW، DVD\-RAM یا BD\-RE، مقدار byte_offset باید با بلوک‌های ۲ کیبی‌بایتی هم‌تراز باشد، اما در DVD مقدار ۳۲ کیبی‌بایت و در BD مقدار ۶۴ کیبی‌بایت بهتر است. در DVD\-RW قالب‌بندی‌شده، هم‌ترازی ۳۲ کیبی‌بایتی الزامی است. .br سایر رسانه‌ها برای این گزینه مناسب نیستند. .TP \fBstdio_sync="on"|"off"|number\fR تعداد بایت‌هایی را تعیین می‌کند که پس از آن، ارسال خروجی به درایوهای شبیه‌سازی‌شدهٔ :stdio تحمیل شود. این تحمیل از انباشته شدن حافظه با حجم زیادی از داده‌های معلق برای دستگاه‌های کُند جلوگیری می‌کند. مقدار پیش‌فرض "on" مشابه "16m" است. خروجی تحمیلی را می‌توان با "off" غیرفعال کرد. .SH "مثال‌ها (EXAMPLES)" .SS .B مرور کلی مثال‌ها: دریافت یک نمای کلی از درایوها و نشانی‌های آن‌ها .br دریافت اطلاعات دربارهٔ یک درایو خاص یا رسانهٔ بارگذاری‌شده .br آماده‌سازی CD-RW یا DVD-RW برای استفادهٔ مجدد، BD-R برای مدیریت بلوک‌های خراب .br قالب‌بندی DVD-RW جهت بی‌نیازی از پاک‌سازی پیش از استفادهٔ مجدد .br حذف قالب‌بندی DVD-RW برای فعال‌سازی مجدد قابلیت چندنشستی (multi-session) .br نوشتن یک ایمیج فایل‌سیستم ISO 9660 تکی .br نوشتن چندین نشست ISO 9660 .br نوشتن نشست ISO 9660 به‌صورت بی‌درنگ (on-the-fly) .br نوشتن بایگانی فشردهٔ afio به‌صورت بی‌درنگ (on-the-fly) .br .SS .B دریافت یک نمای کلی از درایوها و نشانی‌های آن‌ها: $ xorrecord \-\-devices .SS .B دریافت اطلاعات دربارهٔ یک درایو خاص و رسانهٔ بارگذاری‌شده: $ xorrecord dev=/dev/sr0 \-atip \-toc \-\-grow_overwriteable_iso .SS .B آماده‌سازی CD-RW یا DVD-RW برای استفادهٔ مجدد: $ xorrecord \-v dev=/dev/sr0 blank=as_needed \-eject .SS .B قالب‌بندی DVD-RW جهت بی‌نیازی از پاک‌سازی پیش از استفادهٔ مجدد: $ xorrecord \-v dev=/dev/sr0 blank=format_overwrite \-eject .br این دستور همچنین می‌تواند برای قالب‌بندی رسانهٔ BD\-R پیش از اولین استفاده، جهت فعال‌سازی مدیریت خطاهای نوشتن به کار رود. چند صد مگابایت از بلوک‌های یدکی رزرو خواهند شد و عملیات نوشتن روی چنین رسانه‌ای با سرعتی کمتر از نصف سرعت نامی انجام خواهد گرفت. .SS .B حذف قالب‌بندی DVD-RW برای فعال‌سازی مجدد قابلیت چندنشستی: $ xorrecord \-v dev=/dev/sr0 blank=deformat .SS .B نوشتن یک ایمیج فایل‌سیستم ISO 9660 تکی: $ xorrecord \-v dev=/dev/sr0 speed=12 fs=8m \\ blank=as_needed \-eject padsize=300k my_image.iso .SS .B نوشتن چندین نشست ISO 9660: این کار با تمام رسانه‌ها ممکن است به‌جز DVD\-RW با پاک‌سازی حداقلی و DVD\-R DL، که قادر به انجام چندنشستی (multi\-session) نیستند. .br نشست اول مانند مثال قبل نوشته می‌شود، با این تفاوت که از گزینهٔ \-multi استفاده می‌شود. این نشست شامل فایل‌های دایرکتوری ./tree1 دیسک سخت تحت دایرکتوری /dir1 در فایل‌سیستم ISO 9660 خواهد بود: .br $ xorrisofs \-o image_1.iso \-J \-graft\-points /dir1=./tree1 .br $ xorrecord \-v dev=/dev/sr0 speed=12 fs=8m \\ .br \-multi \-\-grow_overwriteable_iso \\ .br blank=as_needed \-eject padsize=300k image_1.iso .br برای نشست دوم، xorrisofs باید شماره‌های \-msinfo رسانه را بداند. علاوه بر این، داده‌ها را با استفاده از درایور فقط‌خواندنی CD\-ROM سیستم از روی رسانه خواهد خواند. .br بسیاری از سیستم‌ها متوجه فعالیت‌های نوشتن xorrecord نمی‌شوند. لازم است توجه آن‌ها را با بیرون دادن و بارگذاری مجدد سینی درایو جلب کرد. به همین دلیل، اجرای فوق از گزینهٔ \-eject استفاده می‌کند. .br شماره‌های \-msinfo را دریافت کنید (و در صورت موتوردار بودن، سینی را به‌درستی دوباره بارگذاری کنید) با: .br $ m=$(xorrecord dev=/dev/sr0 \-msinfo) .br یک دستور آزمایشی برای دفع هرگونه اختلال ناشی از دیمن‌های مزاحم پس از بارگذاری سینی اجرا کنید: .br $ dd if=/dev/sr0 count=1 >/dev/null 2>&1 .br از شماره‌ها همراه با xorrisofs استفاده کنید تا ./tree2 به عنوان /dir2 به ایمیج افزوده شود: .br $ xorrisofs \-M /dev/sr0 \-C $m \-o image_2.iso \\ .br \-J \-graft\-points /dir2=./tree2 .br اکنون نشست جدید را روی همان رسانه رایت کنید. این بار بدون پاک‌سازی (blanking): .br $ xorrecord \-v dev=/dev/sr0 speed=12 fs=8m \\ .br \-multi \-\-grow_overwriteable_iso \\ .br \-eject padsize=300k image_2.iso .br سیستم‌عامل‌هایی که این رسانه را سوار (mount) می‌کنند، اَبَربلوک (superblock) نشست دوم را می‌خوانند و هر دو دایرکتوری /dir1 و /dir2 را نمایش می‌دهند..SS .B نوشتن بی‌درنگ نشست ISO 9660: امکان ترکیب اجرای \fBxorrisofs\fR و \fBxorrecord\fR در یک خط‌لوله (pipeline) بدون ذخیره ایمیج ISO 9660 به‌صورت فایل روی دیسک سخت وجود دارد. .br اجرا از طریق خط‌لوله در برابر این مشکل آسیب‌پذیرتر است که برخی سیستم‌ها در بارگذاری خودکار سینی دیسک (tray) صبوری کافی به خرج نمی‌دهند و ممکن است دیمن‌ها در نخستین تلاش درایور CD\-ROM برای خواندن از رسانه تازه بارگذاری‌شده اختلال ایجاد کنند. توصیه می‌شود سینی را به‌صورت دستی یا از طریق یک اجرای جداگانه xorriso به همراه اجرای متعاقب dd بارگذاری کنید. .br باز هم، xorriso صبوری لازم را دارد و dd قربانی قابل‌چشم‌پوشی برای دیمن‌ها است. .br $ m=$(xorrecord dev=/dev/sr0 \-msinfo) .br $ dd if=/dev/sr0 count=1 >/dev/null 2>&1 .br $ xorrisofs \-M /dev/sr0 \-C $m \\ .br \-J \-graft\-points /dir2=./tree2 \\ .br | xorrecord \-v dev=/dev/sr0 speed=12 fs=8m \\ .br \-waiti \-multi \-\-grow_overwriteable_iso \\ .br \-eject padsize=300k \- .br این همچنین مورد استفاده اصلی خود برنامه \fBxorriso\fR است، که در آن به هیچ راه‌حل موقت سیستمی نیازی نیست و اجرا به‌سادگی به این شکل خواهد بود: .br $ xorriso \-dev /dev/sr0 \-joliet on \-speed 12 \-fs 8m \\ .br \-map ./tree2 /dir2 \-commit_eject all .SS .B نوشتن بی‌درنگ بایگانی فشرده afio: این کار روی تمام رسانه‌ها به‌جز DVD\-RW و DVD\-R DL با پاک‌سازی حداقلی (minimally blanked) امکان‌پذیر است. از آن‌جا که جریان خروجی فشرده‌شده دارای سرعت بسیار متغیری است، استفاده از یک fifo بزرگ‌تر توصیه می‌شود. با این وجود، این مثال برای درایوهای بسیار قدیمی CD که فاقد محافظت در برابر تهی‌شدن بافر (underrun protection) هستند و در نتیجه با کمبود موقت داده فرآیند رایت را لغو می‌کنند، مناسب نیست. .br $ find . | afio \-oZ \- | \\ .br xorrecord \-v dev=/dev/sr0 speed=12 fs=64m \\ .br \-multi padsize=300k \- .br بایگانی‌های afio شامل ارجاعاتی به نشانی‌های مطلق بلوک داده نیستند. بنابراین برای چندنشستی (multi\-session) به تمهیدات ویژه‌ای نیاز ندارند. می‌توان نشانی‌های آغازین نشست را با گزینه \-toc به دست آورد و سپس از گزینه skip= در dd برای شروع خواندن از یکی از آن نشانی‌ها استفاده کرد. به‌عنوان مثال برای فهرست کردن محتوای آن: .br $ dd if=/dev/sr0 bs=2048 skip=64046 | afio \-tvZ \- .br ‏afio پایان بایگانی را تشخیص خواهد داد. .SH "فایل‌ها (FILES)" .SS .B فایل‌های راه‌اندازی: .br اگر \-\-no_rc به‌عنوان نخستین آرگومان داده نشود، \fBxorrecord\fR هنگام راه‌اندازی تلاش می‌کند خطوط فایل‌های زیر را خوانده و اجرا کند: .br /etc/default/xorriso .br /etc/opt/xorriso/rc .br /etc/xorriso/xorriso.conf .br $HOME/.xorrisorc .br فایل‌ها با ترتیبی که در اینجا آمده خوانده می‌شوند، اما وجود هیچ‌یک از آن‌ها الزامی نیست. خطوط به‌صورت گزینه‌های \fBxorrecord\fR تفسیر نمی‌شوند، بلکه به‌صورت دستورات عمومی \fBxorriso\fR در نظر گرفته می‌شوند. به man xorriso مراجعه کنید. .SH "همچنین ببینید (SEE ALSO)" .TP برای حالت دستوری عمومی xorriso: .BR xorriso(1) .TP قالب‌بندی منابع قطعه (track) برای xorrecord: .BR xorrisofs(1), .BR mkisofs(8), .BR genisoimage(8), .BR afio(1), .BR star(1) .TP سایر برنامه‌هایی که نشست‌ها را روی رسانه‌های نوری رایت می‌کنند: .BR growisofs(1), .BR cdrecord(1), .BR wodim(1), .BR cdrskin(1).SH "گزارش باگ‌ها (BUGS)" برای گزارش باگ‌ها، درخواست کمک یا پیشنهاد بهبودها برای \fBxorriso\fR، لطفاً یک رایانامه به فهرست عمومی بفرستید. اگر به حریم خصوصی بیشتری نیاز است، به پیام بفرستید. .br لطفاً توضیح دهید که انتظار داشتید \fBxorriso\fR چه کاری انجام دهد، آرگومان‌های برنامه یا دستورهای تعاملی که با آن‌ها برای رسیدن به آن تلاش کردید، پیام‌های \fBxorriso\fR، و نتیجه نامطلوب حاصل از اجرای برنامه. .br انتظار داشته باشید پیش از آن‌که راه‌حلی پیشنهاد شود، پرسش‌های بیشتری مطرح گردد. .SH "نویسندگان (AUTHORS)" Thomas Schmitt .br برای libburnia\-project.org .SH "کپی‌رایت و تکثیر (COPYRIGHT)" کپی‌رایت (c) 2011 \- 2026 Thomas Schmitt .br اجازه توزیع آزادانه این متن داده شده است. این متن تنها باید همگام با مشخصات فنی xorriso تغییر یابد. اگر از این مجوز برای توسعه نسخه‌های تغییریافته xorriso بهره می‌گیرید، مجاز به اصلاح این متن تحت همان مجوز خواهید بود. .SH "قدردانی (CREDITS)" \fBxorriso\fR تا حدی بر اساس کارهای Vreixo Formoso است که libisofs را همراه با Mario Danic (که سرپرستی تیم libburnia را نیز بر عهده دارد) ارائه می‌دهد. با تشکر از Andy Polyakov که emulated growing را ابداع کرد، و از Derek Foreman و Ben Jansens که روزگاری libburn را پایه‌گذاری کردند. .br با قدردانی از Joerg Schilling که ابزار cdrtools او به مدت ده سال به من خدمت کرد.