نام (NAME)

xorrecord - شبیه‌سازی برنامه cdrecord برای CD/DVD/BD توسط برنامه xorriso

خلاصه دستور (SYNOPSIS)

xorrecord [ options ] dev=device [track_source]

توضیحات (DESCRIPTION)

xorrecord داده‌های پیش‌قالب‌بندی‌شده را روی رسانه‌های CD، DVD و BD می‌نویسد.

این برنامه برخی از گزینه‌های برنامه cdrecord از مجموعه cdrtools اثر Joerg Schilling را می‌شناسد. پیاده‌سازی آن بخشی از برنامه xorriso است که هیچ کد منبع مشترکی با cdrtools ندارد، بلکه برای ارتباط با درایو از libburn استفاده می‌کند.
شبیه‌ساز دیگر و کامل‌تر cdrecord، برنامه cdrskin است که از توابع رایت یکسانی با xorrecord استفاده می‌کند، اما قادر به رایت CDهای صوتی و مدیریت CD-TEXT نیز هست.

گزینه‌ها (OPTIONS)

آدرس‌دهی درایو:

--devices

فهرست درایوهای CD، DVD یا BD در دسترس را در خروجی استاندارد چاپ می‌کند. در صورتی که کاربر مجوزهای لازم برای استفاده از آن‌ها را نداشته باشد یا درایو توسط برنامهٔ دیگری در حال استفاده باشد، ممکن است درایوها غیرقابل دسترس باشند.
هر درایو در دسترس با خطی شبیه به این نمایش داده می‌شود:
0 -dev '/dev/sr0' rwrw-- : 'TSSTcorp' 'CDDVDW SH-S203B'
نشانی libburn این درایو «/dev/sr0» است. «TSSTcorp» نام سازنده (در این مورد: Toshiba Samsung Storage Technologies Corporation) و «CDDVDW SH-S203B» نام مدل است (در این مورد: یک نویسندهٔ DVD).
سپس شبیه‌سازی را بدون انجام هیچ عملیات دیگری روی درایو به پایان می‌رساند.

dev=drive_address

نشانی libburn درایو مورد استفاده را تنظیم می‌کند.
برای مثال در GNU/Linux: dev=/dev/sr0
برای مثال در FreeBSD: dev=/dev/cd0
برای مثال در NetBSD: dev=/dev/rcd0d
برای مثال در Solaris: dev=/dev/rdsk/c2t2d0s2
همچنین بخش «آماده‌سازی و آدرس‌دهی درایو» در بالا را ببینید.
رسانهٔ موجود در درایو نباید سوار (mount) شده باشد یا به هر شکل دیگری در حال استفاده باشد.
این گزینه تنها زمانی اعمال می‌شود که یک منبع قطعه (track source)، گزینهٔ blank=، یا یک گزینهٔ استعلام درایو مشخص شده باشد. در غیر این صورت منجر به یک رخداد SORRY شده و معمولاً باعث خروج با مقداری غیر از صفر خواهد شد.

استعلام درایو و رسانه:

-inq

اطلاعات سازنده، نام مدل، و نسخهٔ سفت‌افزار (firmware) درایو را در خروجی استاندارد چاپ می‌کند.

-checkdrive

بدون قید و شرط چاپ می‌کند که درایو از burnfree، SAO و TAO پشتیبانی می‌کند. همچنین خروجی گزینهٔ -inq را چاپ می‌کند.

-atip

خروجی -checkdrive، توانمندترین نمایهٔ (profile) رسانهٔ موجود در درایو، فهرست نمایه‌های پشتیبانی‌شده توسط درایو، قابل پاک‌شدن بودن آن (یعنی امکان خالی‌کردن)، سازندهٔ رسانه، و نام محصول رسانه را چاپ می‌کند.
نمایه‌ها الگوهای استفاده‌ای هستند که اغلب به نوع خاصی از رسانه (مانند CD-RW) گره خورده‌اند، اما ممکن است برای خانواده‌ای از رسانه‌ها نیز اعمال شوند؛ به عنوان مثال، نمایهٔ CD-ROM برای تمام رسانه‌های CD حاوی داده اعمال می‌شود.

-toc

جدول محتوای (TOC) رسانهٔ موجود در درایو را چاپ می‌کند. خروجی با گزینهٔ -toc در cdrecord سازگار نیست، بلکه مشابه دستور -toc در xorriso است. این گزینه نشانی، سازنده، نام مدل و نسخهٔ سفت‌افزار درایو را فهرست می‌کند.
دربارهٔ رسانه، نام محصول و سازنده، وجود داده‌های نوشته‌شده از قبل، و در این صورت بسته بودن یا الحاق‌پذیر بودن رسانه را مشخص می‌کند. رسانه‌های الحاق‌پذیر (appendable) می‌توانند یک نشست (session) دیگر دریافت کنند. میزان داده‌های قابل خواندن و نوشتن نیز بیان می‌شود. اگر نشست‌هایی وجود داشته باشد، نشانی بلوک آغازین و اندازهٔ آن‌ها گزارش می‌شود. اگر نشستی حاوی سیستم‌فایل ISO 9660 باشد، شناسهٔ حجم (Volume Id) آن گزارش می‌شود. در صورتی که رسانه قابل نوشتن باشد، نشانی بلوک بعدی قابل نوشتن گزارش خواهد شد.
اگر گزینهٔ --grow_overwriteable_iso داده نشده باشد یا هیچ سیستم‌فایل ISO 9660 روی رسانه موجود نباشد، رسانه‌های با قابلیت بازنویسی (overwritable) به صورت خالی گزارش می‌شوند. این به این دلیل است که می‌توان روی آن‌ها بدون آماده‌سازی بیشتر از ابتدا نوشت، و این که MMC تفاوتی بین داده‌های نوشته‌شده در آخرین فرایند رایت و داده‌های قدیمی‌تری که توسط آن فرایند رایت رونویسی نشده‌اند قائل نمی‌شود. در نتیجه، این رسانه‌ها با ۰ بلوک خواندنی گزارش می‌شوند، هرچند تمام بلوک‌های قابل نوشتن آن‌ها معمولاً قابل خواندن نیز هستند.

-msinfo

متن آرگومان را برای گزینهٔ -C در برنامه‌های mkisofs، genisoimage یا xorrisofs چاپ می‌کند. این مقدار از دو عدد تشکیل شده که با کاما از هم جدا شده‌اند.
عدد اول نخستین بلوک از نخستین قطعهٔ آخرین نشست ثبت‌شده را مشخص می‌کند. این همچنین همان نشانی‌ای است که به طور پیش‌فرض هنگام سوار کردن یک رسانه با مثلاً سیستم‌فایل ISO 9660 توسط سیستم‌عامل‌ها استفاده می‌شود.
عدد دوم نشانی بعدی قابل نوشتن را مشخص می‌کند، جایی که xorrecord شروع به نوشتن نشست بعدی خواهد کرد.
این گزینه فقط برای رسانه‌های نوشته‌شده و الحاق‌پذیر معتبر است. در تمام موارد دیگر هیچ متنی خروجی نمی‌دهد، اما برنامه را با مقدار خروج غیرصفر لغو می‌کند.

تنظیمات برای فرایند رایت:

یک فرایند رایت دقیقاً به یک آرگومان نشانی منبع قطعه (track source) نیاز دارد که مشخص می‌کند داده‌هایی که باید در نشست آینده قرار گیرند از کجا خوانده شوند. وضعیت رسانه باید خالی (blank) یا الحاق‌پذیر (appendable) باشد.
منبع قطعه می‌تواند «-» برای ورودی استاندارد، یا نشانی یک فایل خواندنی از هر نوعی به جز دایرکتوری‌ها باشد. تقریباً همهٔ انواع رسانه‌ها منبع قطعه‌ای با تعداد بایت‌های غیرقابل پیش‌بینی، مانند ورودی استاندارد یا لوله‌های نام‌گذاری‌شده (named pipes) را می‌پذیرند. با این وجود، DVD-R DL و DVD-RW که با حالت deformat_quickest خالی شده‌اند، نیازمند رزرو دقیق اندازهٔ قطعه از قبل هستند؛ بنابراین یا باید از منبعی با طول قابل پیش‌بینی خوانده شوند، یا باید با گزینهٔ tsize= یا با گزینهٔ -isosize همراه باشند.
چندین گزینه انتظار یک مقدار اندازه را به عنوان آرگومان دارند. یک عدد با حرف پایانی «b» یا بدون حرف پایانی، شمارش سادهٔ بایت‌هاست. سایر حروف پایانی باعث ضرب عدد داده‌شده در یک ضریب مقیاس می‌شوند:
"k" یا "K" = 1024 ، "m" یا "M" = 1024k ، "g" یا "G" = 1024m ، "s" یا "S" = 2048
برای مثال tsize=234567s به معنای اندازهٔ 234567 * 2048 = 480393216 بایت است.

blank=mode

یک CD-RW یا DVD-RW را خالی می‌کند تا دوباره از ابتدا قابل استفاده شود. اگر DVD-RW، DVD+RW، DVD-RAM، BD-R یا BD-RE هنوز قالب‌بندی (format) نشده باشند، آن‌ها را قالب‌بندی می‌کند.
این عملیات معمولاً هرگونه دادهٔ ضبط‌شده روی رسانه را غیرقابل خواندن می‌کند. این کار با رایت کردن در همان اجرای xorrecord قابل ترکیب است، یا می‌تواند بدون منبع قطعه انجام شود و رسانه را خالی رها کند.
حالت (mode) مشخص‌شده همراه با blank= رفتار خاص را تعیین می‌کند:

-multi

این گزینه CD، DVD-R[W] قالب‌بندی‌نشده، DVD+R یا BD-R را پس از نوشته شدن نشست (session) فعلی، در وضعیت قابل الصاق (appendable) نگه می‌دارد. بدون آن، دیسک بسته می‌شود و دیگر نمی‌توان روی آن نوشت - مگر اینکه از نوع -RW بوده و پاک شود، که این کار موجب از دست رفتن محتوای آن می‌گردد.
این گزینه را نمی‌توان برای DVD-R DL یا DVD-RWهایی که با حالت "deformat_quickest" پاک شده‌اند اعمال کرد. گزینه --multi_if_possible ممکن است بتواند این وضعیت را به صورت خودکار تشخیص داده و مدیریت کند.
به منظور در دسترس بودن تمام محتوای سیستم‌فایل، سیستم‌فایل احتمالی ISO-9660 در نشست بعدی باید به روشی ویژه توسط برنامه آماده‌ساز سیستم‌فایل آماده شود. برنامه‌های mkisofs، genisoimage و xorrisofs انتظار اطلاعات خاصی درباره این وضعیت دارند که می‌توان آن را توسط گزینه -msinfo در xorrecord دریافت کرد.
در رسانه‌های بازنویسی‌پذیر DVD یا BD، گزینه -multi نمی‌تواند پایان نشست را مشخص کند. بنابراین هنگام افزودن یک نشست جدید، این پایان باید از داده‌های بار مفید (payload) تعیین شود. در حال حاضر تنها سیستم‌فایل‌های ISO-9660 را می‌توان به این صورت استفاده کرد. گزینه --grow_overwriteable_iso را ببینید.

-dummy

تلاش برای انجام عملیات‌های درایو بدون تأثیر واقعی بر روی رسانه واردشده. هیچ ضمانتی وجود ندارد که این قابلیت با ترکیب خاصی از درایو و رسانه کار کند. با این حال، از عملیات پاک‌سازی به‌طور مطمئن جلوگیری می‌شود. برای جلوگیری از رایت واقعی ناخواسته، -dummy از اجرای رایت بر روی هر چیزی جز CD-R[W]، DVD-R[W] یا درایوهای شبیه‌سازی‌شده stdio خودداری می‌کند.

-waiti

صبر کردن تا زمانی که داده‌های ورودی در stdin در دسترس قرار گیرند یا EOF در stdin رخ دهد. تنها پس از آن دسترسی به درایوها آغاز می‌شود.
در صورتی که xorrisofs در انتهای یک لوله (pipe) کار می‌کند که در آن فرآیند تغذیه‌کننده قبل از شروع به نوشتن خروجی خود در xorrisofs، از درایو می‌خواند، باید از این گزینه استفاده شود. مثال:
xorrisofs ... -C 0,12800 -M /dev/sr0 ... | \
xorrecord dev=/dev/sr0 ... -waiti -
این گزینه حتی اگر ورودی استاندارد منبع ترک نباشد نیز کار می‌کند. اگر هیچ فرآیندی ورودی را لوله‌کشی نکند، کلید Enter پایانه شما به عنوان محرک برای xorrecord عمل خواهد کرد. توجه داشته باشید اگر ورودی استاندارد منبع ترک نباشد، این سطر ورودی توسط cdrskin مصرف نخواهد شد و معمولاً به عنوان یک دستور پوسته اجرا خواهد شد.

tsize=size

اعلام اندازه دقیق منبع ترک (track). این کار برای رسانه‌های DVD-R DL و DVD-RWهای پاک‌شده با حالت quickest ضروری است، اگر نتوان اندازه را از قبل از منبع ترک تعیین کرد؛ مانند زمانی که ورودی استاندارد یا یک لوله نام‌گذاری‌شده (named pipe) باشد.
اگر منبع ترک مقدار بایت‌های پیش‌بینی‌شده را تحویل ندهد، باقیمانده ترک با صفر پر می‌شود. این حالت یک خطا در نظر گرفته نمی‌شود. اما اگر از سوی دیگر، منبع ترک بایت‌هایی بیشتر از مقدار اعلام‌شده تحویل دهد، ترک روی رسانه به اندازه پیش‌بینی‌شده بریده می‌شود و xorrecord با یک مقدار غیرصفر خارج می‌شود.

-isosize

تلاش برای به دست آوردن اندازه ترک از محتوای منبع ترک. این گزینه تنها زمانی کار می‌کند که منبع ترک حاوی یک سیستم‌فایل ISO 9660 باشد. هر محتوای دیگری در منبع ترک باعث لغو اجرای رایت خواهد شد.
اگر منبع ترک یک فایل معمولی یا دستگاه بلوکی نباشد، این گزینه تنها در صورتی کار خواهد کرد که اندازه بافر fifo برنامه حداقل 64k باشد. گزینه fs= را ببینید.

padsize=size

افزودن مقدار مشخص‌شده‌ای از صفرهای انتهایی به ترک پیش‌رو. این ویژگی را می‌توان با اندازه 0 غیرفعال کرد. مقدار پیش‌فرض 300 kB است تا مشکلی در GNU/Linux دور زده شود که اغلب در خواندن چند بلوک آخر یک ترک CD که در حالت نوشتن TAO نوشته شده، ناموفق است. در صورتی که نتوان اندازه ترک را پیش‌بینی کرد یا رسانه CD خام نبوده اما قابل الصاق باشد، TAO توسط xorrecord استفاده می‌شود.

-nopad

مشابه padsize=0.

-pad

مشابه padsize=15s. این مقدار زمانی در هسته‌های قدیمی‌تر GNU/Linux کافی بود. اکنون باید دست‌کم از padsize=128k، و در صورت امکان از padsize=300k استفاده کرد.

-data

اعلام صریح اینکه منبع ترک باید به عنوان ترک داده ضبط شود، نه به عنوان ترک صوتی. این گزینه هیچ تأثیری در xorrecord ندارد، زیرا در هر صورت هیچ پشتیبانی از دیگر قالب‌های ترک وجود ندارد.

-tao

درخواست صریح برای اینکه از نوع نوشتن TAO برای CD، یا نوع Incremental برای DVD-R استفاده شود. معمولاً برنامه نوع نوشتن را با توجه به وضعیت رسانه داده‌شده، گزینه -multi و منبع ترک انتخاب می‌کند. درخواست صریح آن، در صورتی که مناسب وضعیت نباشد، از شروع عملیات نوشتن جلوگیری می‌کند.

-sao

درخواست صریح برای اینکه از نوع نوشتن SAO برای CD، یا DAO برای DVD-R استفاده شود. این کار در صورتی که مناسب وضعیت نباشد ممکن است از اجرای عملیات نوشتن جلوگیری کند.

-dao

نام مستعار -sao.

fs=size

تنظیم اندازه بافر fifo برنامه به مقدار مشخص‌شده به جای مقدار پیش‌فرض 4m.
بافر fifo مازاد موقت داده‌های منبع ترک را ذخیره می‌کند تا در زمان‌های کمبود موقت داده از منبع، جریانی پیوسته برای درایو فراهم آورد.
برخلاف cdrecord، برنامه xorrecord قابلیت محافظت از تخلیه بافر درایو (buffer underrun protection) را به طور پیش‌فرض فعال می‌کند و برای شروع نوشتن، منتظر پر شدن بافر fifo برای بار اول نمی‌ماند. در درایوهای بسیار قدیمی CD و رایانه‌های کند، این امر ممکن است باعث لغو شدن عملیات رایت شود. در این صورت، استفاده از برنامه cdrskin را برای رایت CD مد نظر قرار دهید. درایوهای DVD و BD بدون مشکل تخلیه بافر را تحمل می‌کنند.
هر چه بافر fifo بزرگ‌تر باشد، دوره‌های طولانی‌تری از ضعف منبع داده را می‌توان جبران کرد. اما یک fifo بزرگ می‌تواند سیستم‌عامل را از حافظه پنهان خواندن (read cache) جهت کارایی بهتر سیستم‌فایل محروم کند.

speed=value

تنظیم سرعت نوشتن. مقدار پیش‌فرض 0 = حداکثر سرعت است. سرعت می‌تواند بر حسب ضرایب سرعتی x وابسته به نوع رسانه یا به عنوان توان عملیاتی مطلوب در ثانیه بر حسب kB سازگار با MMC (= 1000) یا MB (= 1000 kB) مشخص شود. ضریب سرعتی x رسانه را می‌توان با افزودن "c" برای CD، "d" برای DVD و "b" برای BD به‌طور صریح تعیین کرد. استفاده از "x" اختیاری است.
نمونه‌های سرعت:
706k = 706kB/s = 4c = 4xCD
5540k = 5540kB/s = 4d = 4xDVD
اگر هیچ نشانه‌ای از واحد سرعت ضمیمه نشده باشد، رسانه درون درایو تعیین‌کننده خواهد بود. واحد پیش‌فرض CD است، 1x = 176,400 بایت خام در ثانیه. برای DVD‏، 1x = 1,385,000 بایت در ثانیه. برای BD‏، 1x = 4,495,625 بایت در ثانیه.
درایوهای MMC معمولاً برآورد سرعت خودشان را اعمال می‌کنند و مقدار سرعت ارائه‌شده توسط برنامه رایت را صرفاً به عنوان یک پیشنهاد برای تصمیم‌گیری خود در نظر می‌گیرند..TP minbuf=percentage معادل با:
modesty_on_drive=<percentage>

-immed

معادل با:
modesty_on_drive=75
در cdrecord، این گزینه استفاده از بیت Immed را نیز کنترل می‌کند. اما xorriso تا جایی که ممکن و مناسب باشد از Immed استفاده می‌کند، مگر اینکه با گزینه use_immed_bit=off غیرفعال شده باشد.

-eject

بیرون دادن سینی درایو پس از انجام تمام کارهای دیگر.

نسخه و میزان پرگویی برنامه:

-version

چاپ خطی در خروجی استاندارد که با
"Cdrecord 2.01-Emulation Copyright"
آغاز می‌شود و خطوط بعدی که نسخه xorriso و کتابخانه‌های پشتیبان آن را گزارش می‌دهند. آن‌ها همچنین مجوزی که برنامه تحت آن عرضه شده را بیان کرده و تا جایی که قانون اجازه می‌دهد، هرگونه ضمانت را سلب می‌کنند.
سپس شبیه‌سازی بدون انجام هیچ‌گونه عملیاتی روی درایو به پایان می‌رسد.

-v

افزایش میزان پرگویی برنامه به اندازه یک سطح. چهار سطح پرگویی از تقریباً بی‌صدا تا پرگویی اشکال‌زدایی وجود دارد. هر دو سطح بالاتر را می‌توان با تکرار -v یا با -vv یا با -vvv فعال کرد.

-V

ثبت دستورات SCSI و پاسخ‌های درایو در خطای استاندارد. این امر ممکن است زمانی مفید باشد که xorrecord و یک درایو یا رسانه خاص آن‌طور که انتظار می‌رود همکاری نمی‌کنند، یا اگر فقط می‌خواهید بدانید libburn چگونه با درایو تعامل می‌کند. برای درک این گزارش بسیار پرگو، لازم است مشخصات SCSI شامل SPC، SBC و MMC مطالعه شود.
لطفاً در وهله اول چنین گزارشی را به یک گزارش باگ اضافه نکنید، مگر اینکه بخواهید به انحراف خاصی از مشخصات مذکور اشاره کنید، یا اینکه نگه‌دارنده‌ای از xorrecord که مسئولیت رسیدگی به گزارش باگ شما را بر عهده دارد، درخواست این گزارش را کرده باشد.

-help

چاپ فهرستی مختصر از گزینه‌های برنامه در خطای استاندارد و اعلام این‌که cdrecord نیست.
سپس شبیه‌سازی بدون انجام هیچ‌گونه عملیاتی روی درایو پایان می‌یابد.

گزینه‌های ناسازگار با cdrecord:

--no_rc

تنها در صورتی که به عنوان نخستین آرگومان خط فرمان استفاده شود، این گزینه از خواندن و تفسیر فایل‌های راه‌اندازی جلوگیری می‌کند. بخش «فایل‌ها (FILES)» را در ادامه ببینید.

--drive_not_exclusive

این گزینه استفاده از سازوکارهای قفل کردن فایل دستگاه را هنگام در اختیار گرفتن درایو غیرفعال می‌کند. در GNU/Linux قفل کردن با open(O_EXCL) و در FreeBSD با flock(LOCK_EX) انجام می‌شود.
توجه داشته باشید که اگر از درایوی استفاده کنید که سوار (mount) شده باشد، توسط فرایند دیگری باز شده باشد، یا توسط /dev/pktcdvd* محافظت شود، می‌تواند مشکلاتی ایجاد کند. اطمینان حاصل کنید که سایر کاربران درایو در حین اجرای عملیات رایت xorrecord، باعث ایجاد فعالیت در درایو نمی‌شوند.

drive_scsi_dev_family=sr|scd|sg|default

مخصوص GNU/Linux:
به‌طور پیش‌فرض، xorrecord تلاش می‌کند تا نشانی‌های درایو در لینوکس را پیش از باز شدن برای کار با درایو، به /dev/sr* نگاشت کند. این کار با سایر موارد استفاده از درایوهای نوری، مانند mount(8)، به‌خوبی هماهنگ است. اما بین سال‌های ۲۰۱۰ تا ۲۰۲۰، تمام /dev/sr* یک قفل سراسری را به اشتراک می‌گذاشتند که تنها به یک درایو اجازه می‌داد یک دستور SCSI را پردازش کند در حالی که سایرین باید منتظر تکمیل آن می‌ماندند. این امر در صورتی که بیش از یک درایو به‌طور هم‌زمان مشغول نوشتن یا خواندن بود، بازدهی بسیار پایینی ایجاد می‌کرد.
قفل سراسری هرگز روی فایل‌های دستگاه /dev/sg* و همچنین برای فراخوان‌های سیستمی read(2) و write(2) اعمال نشد. اما ioctl(SG_IO) که برای اجرای دستورات SCSI برای رایت نوری لازم است، تحت تأثیر قرار گرفت.
بنابراین برای اجراهای هم‌زمان رایت روی GNU/Linux نسخه ۲.۶ تا ۵.۵، توصیه می‌شود از drive_scsi_dev_family="sg" استفاده کنید. نشانی‌های درایو ممکن است به خوبی به صورت /dev/sr* داده شوند، اما با این وجود به عنوان /dev/sg* استفاده خواهند شد.

--grow_overwriteable_iso

فعال‌سازی شبیه‌سازی نوشتن چند‌نشستی (multi-session) روی رسانه‌های بازنویسی‌پذیر که حاوی سیستم‌فایل ISO 9660 هستند. این شبیه‌سازی از growisofs -M الگوبرداری شده، اما با مدل استفادهٔ
xorrecord -msinfo
xorrisofs -C -M | xorrecord -waiti -multi -
برای رسانه‌های ترتیبی تطبیق یافته است.
گزینه --grow_overwriteable_iso مانع از استفاده از رسانه‌های چندنشستی واقعی نمی‌شود؛ به این معنی که در صورت نوشتن ایمیج‌های سیستم‌فایل ISO 9660، می‌توان از همان گزینه‌های xorrecord برای هر دو نوع رسانه استفاده کرد و به نتایج مشابهی رسید. این گزینه مستلزم گزینه -isosize است و بنابراین ایجاب می‌کند که منبع قطعه (track) یک ایمیج سیستم‌فایل ISO 9660 باشد.
در رسانه‌های بازنویسی‌پذیر و در صورتی که گزینه blank=fast|all وجود نداشته باشد، سیستم‌فایل احتمالی ISO 9660 موجود روی رسانه را گسترش می‌دهد. فرض بر این است که شرح اندازه داخلی این ایمیج به انتهای داده‌های ارزشمند اشاره دارد. رسانه‌های بازنویسی‌پذیر با اندازه قابل تشخیص ISO 9660 به عنوان رسانه‌های الحاق‌پذیر در نظر گرفته می‌شوند تا رسانه‌های خام. به این معنی که گزینه‌های -msinfo و -toc کار خواهند کرد. گزینه -toc همیشه یک نشست واحد را نشان می‌دهد که اندازه آن با هر ایمیج ISO 9660 اضافه‌شده افزایش می‌یابد.

--multi_if_possible

در صورت مناسب بودن رسانه، گزینه -multi را اعمال می‌کند. رسانه‌های DVD-R DL و DVD-RW که با حالت "deformat_quickest" خام شده‌اند، مناسب نیستند.
همه درایوها چنین DVD-RWهای سریع خام‌شده‌ای را که نیاز به "on" دارند، به‌درستی تشخیص نمی‌دهند. اگر این سوءظن منطقی وجود داشته باشد که اجرای رایت به دلیل -multi با شکست مواجه شده است، این گزینه باعث تلاش مجدد بدون -multi می‌شود.

stream_recording="on"|"off"|number

حالت "on" درخواست می‌کند که انطباق با تنظیم سرعت مورد نظر بر مدیریت خطاهای نوشتن ارجحیت داده شود. در DVD-RAM و BD، این می‌تواند سرعت نوشتن مؤثر را به سرعت نوشتن اسمی رسانه نزدیک کند. اما همچنین استفاده خودکار از بلوک‌های جایگزین را در صورت وقوع خطاهای نوشتن غیرفعال می‌کند. این حالت همچنین ممکن است توسط درایو نادیده گرفته شده یا مورد پذیرش قرار نگیرد.
اگر یک عدد داده شود، مدیریت خطا برای تمام نشانی‌های بایتی زیر آن عدد فعال باقی می‌ماند. هر عدد کمتر از 16s معادل "off" است.

dvd_obs="default"|"32k"|"64k"

تنظیم تعداد بایت‌هایی که باید با هر عملیات نوشتن به رسانه DVD یا BD منتقل شوند. در بیشتر انواع نوشتن، قطعه‌ها تا مضرب بعدی از این اندازه نوشتن پد می‌شوند (گزینه --obs_pad را ببینید). مقدار 64 KB ممکن است بازده را در سیستم‌های گذرگاهی که مشکلات تأخیر دارند بهبود بخشد. مقدار پیش‌فرض به نوع رسانه، گزینه stream_recording= و گزینه‌های زمان کامپایل بستگی دارد.

--obs_pad

پد کردن داده‌های آخرین عملیات نوشتن در یک نشست DVD-R[W] DAO، یا نشست BD-R، یا نشست شبه‌درایو stdio: تا اندازه کامل یک تکه خروجی. این پدینگ باید به‌طور خودکار روی سایر انواع رسانه‌های DVD و BD اعمال شود، که در آن‌ها برای نمونه باعث می‌شود ایمیج‌های ISO دارای بلوک‌های بدون استفاده در انتها باشند. این‌که آیا به‌طور خودکار روی BD-R اعمال شود یا خیر، به گزینه --bdr_obs_exempt بستگی دارد.
اگر این احتمال وجود دارد که نشست‌های DVD-R[W] DAO یا BD-R در صورت مضرب ۱۶ بلوک نبودن اندازه‌شان، با هسته و/یا درایو DVD شما لغو شوند، از این گزینه استفاده کنید.
این گزینه همچنین ممکن است در زمان کامپایل libburn فعال شود.

--bdr_obs_exempt

مستثنی کردن رسانه‌های BD-R از پدینگ خودکار و بدون قید و شرط پایان تراکنش، مشروط بر این‌که این پدینگ توسط --obs_pad درخواست نشده باشد و هیچ stream_recording درخواست نشده باشد.
این یک ویژگی جدید است که با نسخه 1.5.6 معرفی شده است. ممکن است در نسخه‌های بعدی به حالت پیش‌فرض تبدیل شود.

--perform_opc

دستور دادن به درایو برای انجام کالیبراسیون بهینه توان (OPC) پیش از شروع نوشتن. بسیاری از درایوها حتی بدون دستور صریح، کالیبراسیون توان خود را انجام می‌دهند.
این گزینه ممکن است مفید باشد یا نباشد. تنها زمانی از آن استفاده کنید که گمان می‌برید خرابی‌های رایت به دلیل سازگاری ضعیف بین درایو و رسانه رخ داده است.

--perform_opc_growisofs

دستور دادن به درایو برای انجام کالیبراسیون بهینه توان پیش از شروع نوشتن، اما فقط برای DVD-R و DVD-RW قالب‌بندی‌نشده، و تنها در صورتی که درایو ورودی‌های جدول OPC را ارائه ندهد. این همان کاری است که growisofs به‌طور پیش‌فرض انجام می‌دهد.
این گزینه ممکن است مفید باشد یا نباشد. تنها زمانی از آن استفاده کنید که گمان می‌برید خرابی‌های رایت به دلیل سازگاری ضعیف بین درایو و رسانه رخ داده است.

modesty_on_drive=parameter[:parameters]

کنترل این‌که آیا باید از پر شدن کامل بافر درایو جلوگیری شود یا خیر. پارامتر "on" (یا "1") مانع از آن می‌شود که برنامه در حالی که بافر درایو رایتر در خطر پر شدن بیش از یک حد معین است اقدام به نوشتن کند. اگر این پرشدگی بیش از حد مجاز شود، برنامه منتظر می‌ماند تا میزان پر بودن به یک مقدار درصد پایینی مشخص برسد.
این کار می‌تواند بار روی سیستم‌عامل و کنترل‌کننده درایو را کاهش دهد و بنابراین در صورتی که دیسک و رایتر روی کنترل‌کننده‌های مستقل قرار نداشته باشند (مانند hda و hdb)، به دستیابی به پهنای باند ورودی بهتر کمک کند. همچنین ممکن است در رایت‌های هم‌زمان روی رایترهای مختلف با هسته‌های لینوکس بین ۲.۶ تا ۵.۵ کمک کند، در صورتی که دلیلی برای رفع نکردن مشکل از طریق drive_scsi_dev_family="sg" وجود داشته باشد. از سوی دیگر، خطر سرریز منفی بافر (buffer underflow) و در نتیجه کاهش سرعت نوشتن را افزایش می‌دهد.
برخی از رایترها مناسب نیستند زیرا پر بودن بافر را با دانه‌بندی بسیار درشت در اندازه یا زمان گزارش می‌دهند، یا انتظار دارند بافر آن‌ها پیش از رفتن به سرعت کامل، تا انتها پر شود.
پارامترهای "off" یا "0" این ویژگی را غیرفعال می‌کنند.
آستانه شروع انتظار با پارامتر "max_percent=" تعیین می‌شود. پارامتر "min_percent=" آستانه ازسرگیری انتقال را مشخص می‌کند. درصدهای مجاز در محدوده ۲۵ تا ۱۰۰ هستند. اعداد در این محدوده بدون نام پیشوند به عنوان "on:min_percent=" تفسیر می‌شوند.
برای مثال: modesty_on_drive=75
مقادیر بهینه به رفتار بافر درایو بستگی دارد.
پارامتر "timeout_sec=" تعیین می‌کند که پس از چه مدتی از انتظار ناموفق، حالت modesty باید غیرفعال شود زیرا کارایی ندارد.
پارامتر "min_usec=" دوره توقف اولیه را بر حسب میکروثانیه مشخص می‌کند. اگر به نظر برسد که بافر درایو برای ارسال داده‌های بیشتر بیش از حد پر است، برنامه به میزان زمان مشخص‌شده منتظر می‌ماند و وضعیت پر بودن بافر را دوباره جویا می‌شود. اگر پرس‌وجوی مکرر فضای خالی کافی را نشان ندهد، زمان توقف به‌آرامی تا میزانی که پارامتر "max_usec=" تعیین کرده افزایش می‌یابد.
پارامترهایی که با یک گزینه modesty_on_drive= ذکر نشده‌اند، بدون تغییر باقی می‌مانند. پیش‌فرض عبارت است از:
modesty_on_drive=off:min_percent=90:max_percent=95:
timeout_sec=120:min_usec=5000:max_usec=25000.TP use_immed_bit="on"|"off"|"default" کنترل می‌کند که آیا چندین دستور زمان‌بر SCSI با بیت Immed اجرا شوند یا خیر؛ این بیت باعث می‌شود که دستورها در حالی که عملیات درایو هنوز در حال انجام است، زودتر به پایان برسند. سپس xorriso وضعیت پیشرفت را مرتباً استعلام می‌کند تا زمانی که درایو دوباره آماده بودن خود را گزارش دهد. اگر این ویژگی غیرفعال باشد، پاک‌سازی و قالب‌بندی هیچ نشانگری از پیشرفت را نمایش نخواهند داد.
اینکه آیا -use_immed_bit به‌طور پیش‌فرض روی "off" تنظیم باشد یا خیر، ممکن است به سیستم‌عامل بستگی داشته باشد.

write_start_address=byte_offset

نشانی بایتی را روی رسانه‌های بازنویسی‌پذیر تعیین می‌کند که نوشتن شیار (track) از آنجا آغاز شود. در DVD+RW، DVD-RAM یا BD-RE، مقدار byte_offset باید با بلوک‌های ۲ کیبی‌بایتی هم‌تراز باشد، اما در DVD مقدار ۳۲ کیبی‌بایت و در BD مقدار ۶۴ کیبی‌بایت بهتر است. در DVD-RW قالب‌بندی‌شده، هم‌ترازی ۳۲ کیبی‌بایتی الزامی است.
سایر رسانه‌ها برای این گزینه مناسب نیستند.

stdio_sync="on"|"off"|number

تعداد بایت‌هایی را تعیین می‌کند که پس از آن، ارسال خروجی به درایوهای شبیه‌سازی‌شدهٔ :stdio تحمیل شود. این تحمیل از انباشته شدن حافظه با حجم زیادی از داده‌های معلق برای دستگاه‌های کُند جلوگیری می‌کند. مقدار پیش‌فرض "on" مشابه "16m" است. خروجی تحمیلی را می‌توان با "off" غیرفعال کرد.

مثال‌ها (EXAMPLES)

فایل‌ها (FILES)

همچنین ببینید (SEE ALSO)

برای حالت دستوری عمومی xorriso:

xorriso(1)

قالب‌بندی منابع قطعه (track) برای xorrecord:

xorrisofs(1), mkisofs(8), genisoimage(8), afio(1), star(1)

سایر برنامه‌هایی که نشست‌ها را روی رسانه‌های نوری رایت می‌کنند:

growisofs(1), cdrecord(1), wodim(1), cdrskin(1).SHگزارش باگ‌ها (BUGS) برای گزارش باگ‌ها، درخواست کمک یا پیشنهاد بهبودها برای xorriso، لطفاً یک رایانامه به فهرست عمومی <bug-xorriso@gnu.org> بفرستید. اگر به حریم خصوصی بیشتری نیاز است، به <scdbackup@gmx.net> پیام بفرستید.
لطفاً توضیح دهید که انتظار داشتید xorriso چه کاری انجام دهد، آرگومان‌های برنامه یا دستورهای تعاملی که با آن‌ها برای رسیدن به آن تلاش کردید، پیام‌های xorriso، و نتیجه نامطلوب حاصل از اجرای برنامه.
انتظار داشته باشید پیش از آن‌که راه‌حلی پیشنهاد شود، پرسش‌های بیشتری مطرح گردد.

نویسندگان (AUTHORS)

Thomas Schmitt <scdbackup@gmx.net>
برای libburnia-project.org

کپی‌رایت و تکثیر (COPYRIGHT)

کپی‌رایت (c) 2011 - 2026 Thomas Schmitt
اجازه توزیع آزادانه این متن داده شده است. این متن تنها باید همگام با مشخصات فنی xorriso تغییر یابد. اگر از این مجوز برای توسعه نسخه‌های تغییریافته xorriso بهره می‌گیرید، مجاز به اصلاح این متن تحت همان مجوز خواهید بود.

قدردانی (CREDITS)

xorriso تا حدی بر اساس کارهای Vreixo Formoso است که libisofs را همراه با Mario Danic (که سرپرستی تیم libburnia را نیز بر عهده دارد) ارائه می‌دهد. با تشکر از Andy Polyakov که emulated growing را ابداع کرد، و از Derek Foreman و Ben Jansens که روزگاری libburn را پایه‌گذاری کردند.
با قدردانی از Joerg Schilling که ابزار cdrtools او به مدت ده سال به من خدمت کرد.