.\" Copyright 2002 Paul Thompson <set@pobox.com>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.\" References consulted:
.\"   udf-0.9.5 source
.\"
.\"
.TH CDRWTOOL 1 "udftools" "دستورات کاربر"

.SH "نام (NAME)"
cdrwtool \- قالب‌بندی و مدیریت دیسک‌های CD-RW و DVD-RAM برای استفاده با سیستم فایل UDF

.SH "خلاصه دستور (SYNOPSIS)"
.BI "cdrwtool \-d " device " \-i | \-g"
.PP
.BI "cdrwtool \-d " device " \-s [ " write-parameters " ]"
.PP
.BI "cdrwtool \-d " device " \-q [ " write-parameters " ]"
.PP
.BI "cdrwtool \-d " device " \-m " offset " [ " write-parameters " ]"
.PP
.BI "cdwrtool \-d " device " \-u " blocks " [ " write-parameters " ]"
.PP
.BI "cdrwtool \-d " device " \-b " b_mode " [ " write-parameters " ]"
.PP
.BI "cdrwtool \-d " device " \-c " blocks " [ " write-parameters " ]"
.PP
.BI "cdwrtool \-d " device " \-f " filename " [ " write-parameters " ]"
.PP
.BI "cdwrtool \-d " device " \-r " track " [ " write-parameters " ]"
.PP
.BI "cdrwtool \-h"

.SH "توضیحات (DESCRIPTION)"
دستور
.B cdwrtool
می‌تواند عملیات خاصی را روی دستگاه‌های CD-R، CD-RW یا DVD-R انجام دهد. عمده این عملیات شامل پاک کردن دیسک، قالب‌بندی آن برای استفاده با دستگاه packet-cd و اعمال سیستم فایل UDF است.
.PP
متداول‌ترین کاربرد احتمالاً گزینه «راه‌اندازی سریع» (quick setup) است:
.IP
.BI "cdrwtool \-d " device " \-q"
.PP
که دیسک را پاک کرده، آن را به عنوان یک شیار (track) بزرگ قالب‌بندی می‌کند و ساختارهای سیستم فایل UDF را روی آن می‌نویسد.
.PP
سایر گزینه‌ها پارامترهای مختلف نحوه راه‌اندازی دستگاه را دریافت و تنظیم می‌کنند و امکان تعیین آفست‌ها، حالت‌ها و تنظیمات متفاوتی نسبت به مقادیر پیش‌فرض را فراهم می‌سازند.
.PP
کاربرد بیشتر این گزینه‌ها نیازی به توضیح ندارد.

.SH "گزینه‌ها (OPTIONS)"
دستورالعمل‌های اصلی:
.IP "\fB\-d \fIdevice\fP"
مشخص کردن دستگاه مورد استفاده؛ به عنوان مثال: \fI/dev/sr0\fP

.IP \fB\-i\fP
چاپ اطلاعات شیارهای (track) دیسک.

.IP \fB\-g\fP
چاپ پارامترهای نوشتن.

.IP "\fB\-u \fIlength\fP"
ایجاد سیستم فایل UDF با استفاده از تعداد بلوک‌های مشخص‌شده در \fIlength\fP.

.IP "\fB\-q\fP"
«راه‌اندازی سریع»: پاک کردن دیسک، قالب‌بندی آن به صورت یک شیار بزرگ و نوشتن سیستم فایل UDF.

.IP "\fB\-m \fIoffset\fP"
قالب‌بندی دیسک در آفست مشخص‌شده بر حسب تعداد بلوک‌ها (\fIoffset\fP).

.IP "\fB\-b \fImode\fP"
پاک کردن دیسک با استفاده از حالت (\fImode\fP) `full` یا `fast`.

.IP "\fB\-f \fIfilename\fP"
نوشتن فایل روی دیسک.

.IP "\fB\-c \fItrack\fP"
بستن شیار (track).
.IP "\fB\-r \fItrack\fP"
رزرو کردن شیار (track).

.IP "\fB\-z \fIlength\fP"
طول بسته ثابت (fixed packet length).

.IP \fB\-s\fP
تنظیم پارامترهای نوشتن تعیین‌شده توسط گزینه‌های
.BR "\-l" ،
.B "\-w"
و
.B "\-p"
برای دیسک.

.IP "\fB\-v \fIversion\fP"
مشخص کردن نگارش UDF مورد استفاده. نگارش‌های معتبر عبارتند از 0x0201، 0x0200 و 0x0150.
در صورت عدم ذکر، نگارش udf در
.B mkudffs
برابر با 0x0150 خواهد بود.

.IP \fB\-h\fP
نمایش یک پیام راهنمای مختصر.
.PP

پارامترهای نوشتن:
.IP "\fB\-t \fIspeed\fP"
تنظیم سرعت نوشتن (پیش‌فرض احتمالاً 12x است).
.IP "\fB\-l \fItype\fP"
تنظیم فیلد چندنشستی (multi-session). مقادیر معتبر شامل `0` (پیش‌فرض)، `1` یا `3` هستند که به ترتیب متناظر با
«بدون اشاره‌گر B0؛ نشست بعدی مجاز نیست»،
«اشاره‌گر B0 برابر با FF:FF:FF؛ نشست بعدی مجاز نیست» و
«نشست بعدی مجاز است؛ اشاره‌گر B0 برابر با ناحیه برنامه احتمالی بعدی» می‌باشند.
.IP "\fB\-w \fImode\fP"
تنظیم حالت نوشتن؛ یا `mode1` یا `mode2` (پیش‌فرض).
.IP "\fB\-p \fItype\fP"
تنظیم نوع بسته (packet type)؛ یا `0` یا `1` (پیش‌فرض) که به ترتیب متناظر با اندازه‌های بسته متغیر و ثابت هستند.
.IP "\fB\-o \fIoffset\fP"
تنظیم آفست نوشتن.

.SH "اشکالات (BUGS)"
بسیاری از درایوهای مدرن در مرحله آماده‌سازی برای قالب‌بندی رسانه‌های جدید، پاک‌شده یا قابل‌افزودن CD-RW خطای رد درخواست می‌دهند. این امر پیامی مانند زیر تولید می‌کند:
.IP
.B Command failed: 55 ... - sense ...
.PP
راهکار این است که از یک برنامه رایت CD برای نوشتن یک نشست و بستن رسانه استفاده شود. برای مثال با استفاده از هر یک از برنامه‌های "cdrecord"، "wodim"، "cdrskin" یا "xorriso -as cdrecord" به عنوان مقدار متغیر \fBprog\fP در دستور زیر:
.PP
.in +4n
.EX
prog="xorriso -as cdrecord"
drive="/dev/sr0"
dd if=/dev/zero bs=1M count=10 | $prog -v -eject dev="$drive" -
.EE
.in

.SH "نویسندگان (AUTHORS)"
.nf
Jens Axboe <axboe@suse.de>
Ben Fennema
Some additions by Richard Atterer <atterer@debian.org>
BUGS note about closing medium by Thomas Schmitt <scdbackup@gmx.net>
.fi

.SH "در دسترس بودن (AVAILABILITY)"
دستور
.B cdrwtool
بخشی از بسته udftools است و از نشانی
https://github.com/pali/udftools
قابل دریافت می‌باشد.

.SH "همچنین ببینید (SEE ALSO)"
\fBpktsetup\fP(8), \fBcdrecord\fP(1), \fBwodim\fP(1), \fBcdrskin\fP(1),
\fBxorriso\fP(1)