'\" t
.TH mtools 5 "14Jun25" MTOOLS MTOOLS
.SH "نام (NAME)"
mtools.conf \- پرونده‌های پیکربندی mtools
'\" t
.de TQ
.br
.ns
.TP \\$1
..

.tr \(is'
.tr \(if`
.tr \(pd"

.ds St Mtools\ 4.0.49
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحهٔ راهنما پرونده‌های پیکربندی mtools را شرح می‌دهد. این پرونده‌ها
\fR\&\f(CW\(if/etc/mtools.conf\(is\fR و \fR\&\f(CW\(if~/.mtoolsrc\(is\fR نامیده
می‌شوند. اگر متغیر محیطی \fR\&\f(CWMTOOLSRC\fR تنظیم شده باشد، مقدار آن به‌عنوان
نام پرونده برای پروندهٔ پیکربندی سوم استفاده می‌شود. این پرونده‌های
پیکربندی موارد زیر را شرح می‌دهند:
.TP
* \ پرچم‌ها\ و\ متغیرهای\ پیکربندی\ سراسری\
.TP
* \ پرچم‌ها\ و\ متغیرهای\ مختص\ هر\ درایو\
.PP
.SS "محل پرونده‌های پیکربندی (Location of the configuration files)"
.PP
.PP
\&\fR\&\f(CW\(if/etc/mtools.conf\(is\fR پروندهٔ پیکربندی سراسری سیستم است،
و \fR\&\f(CW\(if~/.mtoolsrc\(is\fR پروندهٔ پیکربندی خصوصی کاربر است.
.PP
در برخی سیستم‌ها، پروندهٔ پیکربندی سراسری سیستم در عوض
\&\fR\&\f(CW\(if/etc/default/mtools.conf\(is\fR نامیده می‌شود.
.PP
.SS "دستور زبان کلی پرونده پیکربندی (General configuration file syntax)"
.PP
پرونده‌های پیکربندی از بخش‌ها تشکیل شده‌اند. هر بخش با یک کلیدواژه
که بخش را مشخص می‌کند آغاز شده و پس از آن یک دو‌نقطه قرار می‌گیرد.
سپس انتساب‌های متغیر و پرچم‌ها می‌آیند. انتساب‌های متغیر
شکل زیر را دارند:
.ft I
.nf
name=value
.fi
.ft R

پرچم‌ها کلیدواژه‌های منفرد بدون علامت مساوی و مقدار پس از آن هستند.
یک بخش یا در انتهای پرونده و یا در جایی که بخش بعدی آغاز می‌شود به پایان می‌رسد.
.PP
خطوطی که با علامت هش (\fR\&\f(CW#\fR) آغاز می‌شوند، توضیح هستند. نویسه‌های
خط جدید معادل فاصله سفید هستند (مگر در جایی که به یک توضیح پایان دهند). پروندهٔ
پیکربندی نسبت به بزرگی و کوچکی حروف حساس نیست، به‌جز مواردی که در
نقل‌قول قرار گرفته‌اند (مانند نام پرونده‌ها).
.PP
.SS "مقادیر پیش‌فرض (Default values)"
برای اکثر پلتفرم‌ها، mtools شامل مقادیر پیش‌فرض کامپایل‌شدهٔ معقولی برای
درایوهای فلاپی فیزیکی است. بنابراین، اگر تنها کاری که می‌خواهید با mtools انجام دهید
دسترسی به درایوهای فلاپی‌تان است، معمولاً نیازی به درگیر شدن با
پروندهٔ پیکربندی ندارید. از سوی دیگر، اگر می‌خواهید از mtools برای دسترسی
به پارتیشن‌های دیسک سخت و پرونده‌های ایمیج DOSEMU خود نیز استفاده کنید،
به پروندهٔ پیکربندی نیاز خواهد بود.
.PP
.SS "متغیرهای سراسری (Global variables)"
.PP
پرچم‌های سراسری را می‌توان روی 1 یا 0 تنظیم کرد.
.PP
پرچم‌های سراسری زیر شناخته شده‌اند:
.TP
\&\fR\&\f(CWMTOOLS_SKIP_CHECK\fR\
اگر روی 1 تنظیم شود، mtools بیشتر بررسی‌های سلامت خود را نادیده می‌گیرد. این گزینه
برای خواندن برخی از دیسک‌های آتاری که با رام‌های قدیمی‌تر ساخته شده‌اند و
در غیر این صورت شناسایی نمی‌شوند، لازم است.
.TP
\&\fR\&\f(CWMTOOLS_FAT_COMPATIBILITY\fR\
اگر روی 1 تنظیم شود، mtools بررسی‌های اندازهٔ FAT را نادیده می‌گیرد. برخی دیسک‌ها
جدول FAT بزرگ‌تری نسبت به نیاز واقعی خود دارند. اگر این گزینه
تنظیم نشده باشد، این دیسک‌ها رد می‌شوند.
.TP
\&\fR\&\f(CWMTOOLS_LOWER_CASE\fR\
اگر روی 1 تنظیم شود، mtools تمام نام‌های کوتاه پرونده که با حروف بزرگ هستند را
به صورت حروف کوچک نمایش می‌دهد. این کار برای رفتاری سازگار با
نسخه‌های قدیمی‌تر mtools انجام شده است که از بیت‌های وضعیت حروف اطلاعی نداشتند.
.TP
\&\fR\&\f(CWMTOOLS_NO_VFAT\fR\
اگر روی 1 تنظیم شود، mtools برای نام‌های پرونده‌ای که ترکیب حروف کوچک و بزرگ هستند،
اما در غیر این صورت نام‌های مجاز DOS محسوب می‌شوند، مدخل‌های VFAT تولید نمی‌کند. این ویژگی
هنگام کار با نسخه‌هایی از DOS که توانایی درک نام‌های بلند VFAT را ندارند، مانند
FreeDOS، مفید است.
.TP
\&\fR\&\f(CWMTOOLS_DOTTED_DIR\fR\
در نمایش عریض دایرکتوری، نام کوتاه را با یک نقطه به جای فاصله‌های
جداکنندهٔ نام پایه و پسوند چاپ می‌کند.
.TP
\&\fR\&\f(CWMTOOLS_NAME_NUMERIC_TAIL\fR\
اگر روی یک (پیش‌فرض) تنظیم شود، برای تمام نام‌های بلند دنبالهٔ عددی (~1)
تولید می‌کند. اگر روی صفر تنظیم شود، تنها در صورتی دنبالهٔ عددی تولید می‌کند
که در غیر این صورت تداخل نام رخ می‌داد.
.TP
\&\fR\&\f(CWMTOOLS_TWENTY_FOUR_HOUR_CLOCK\fR\
اگر 1 باشد، از شیوهٔ نمایش اروپایی زمان (ساعت ۲۴ ساعته) استفاده می‌کند؛
در غیر این صورت از شیوهٔ بریتانیایی/آمریکایی (am/pm) استفاده می‌نماید.
.TP
\&\fR\&\f(CWMTOOLS_LOCK_TIMEOUT\fR\
مدت‌زمان انتظار بر حسب ثانیه برای آزاد شدن یک دستگاه قفل‌شده.
پیش‌فرض 30 است.
.PP
مثال:
درج خط زیر در پروندهٔ پیکربندی به mtools دستور می‌دهد که بررسی‌های
سلامت را نادیده بگیرد:

.nf
.ft 3
.in +0.3i
  MTOOLS_SKIP_CHECK=1
.fi
.in -0.3i
.ft R
.PP

\&\fR
.PP
متغیرهای سراسری را می‌توان از طریق متغیرهای محیطی نیز تنظیم کرد:

.nf
.ft 3
.in +0.3i
  export MTOOLS_SKIP_CHECK=1
.fi
.in -0.3i
.ft R
.PP

\&\fR
.PP
متغیرهای رشته‌ای سراسری را می‌توان روی هر مقداری تنظیم کرد:
.TP
\&\fR\&\f(CWMTOOLS_DATE_STRING\fR\
قالب مورد استفاده برای چاپ تاریخ پرونده‌ها. به‌طور پیش‌فرض dd-mm-yyyy است.
.PP
.SS "پرچم‌ها و متغیرهای مختص هر درایو (Per drive flags and variables)"
.PP
.SS "اطلاعات کلی (General information)"
.PP
پرچم‌ها و مقادیر مختص هر درایو را می‌توان در یک بخش درایو شرح داد. یک
بخش درایو با این عبارت آغاز می‌شود:
\&\fR\&\f(CWdrive\fR "\fIdriveletter\fR" :
.PP
سپس جفت‌های متغیر\-مقدار و پرچم‌ها قرار می‌گیرند.
.PP
این یک توصیف نمونه برای درایو است:

.nf
.ft 3
.in +0.3i
  drive a:
    file="/dev/fd0" use_xdf=1
.fi
.in -0.3i
.ft R
.PP

\&\fR
.PP
.SS "اطلاعات موقعیت (Location information)"
.PP
برای هر درایو، باید مشخص کنید که داده‌های آن از نظر فیزیکی در کجا ذخیره
شده‌اند (پروندهٔ ایمیج، دستگاه فیزیکی، پارتیشن، آفست).
.TP
\&\fR\&\f(CWfile\fR\
نام پرونده یا دستگاهی که ایمیج دیسک را در بر دارد. این گزینه
اجباری است. نام پرونده باید در گیومه قرار گیرد.
.TP
\&\fR\&\f(CWpartition\fR\
به mtools دستور می‌دهد که با درایو مانند یک دستگاه پارتیشن‌بندی‌شده رفتار کند و از
پارتیشن داده‌شده استفاده نماید. تنها پارتیشن‌های اصلی (Primary) با این
روش قابل دسترسی هستند و از 1 تا 4 شماره‌گذاری می‌شوند. برای پارتیشن‌های منطقی (Logical)، از
متغیر عمومی‌تر \fR\&\f(CWoffset\fR استفاده کنید. متغیر \fR\&\f(CWpartition\fR
برای رسانه‌های جداشدنی مانند دیسک‌های Syquest، درایوهای ZIP و دیسک‌های
مغناطیسی-نوری در نظر گرفته شده است. اگرچه DOS سنتی دیسک‌های Syquest و
دیسک‌های مغناطیسی-نوری را به‌عنوان \fR\&\f(CW\(ifدیسک‌های فلاپی غول‌پیکر\(is\fR که
پارتیشن‌بندی نشده‌اند می‌بیند، OS/2 و Windows NT با آن‌ها مانند دیسک سخت رفتار می‌کنند،
یعنی دستگاه‌های پارتیشن‌بندی‌شده. پرچم \fR\&\f(CWpartition\fR برای ایمیج‌های
دیسک سخت DOSEMU نیز مفید است. استفاده از آن برای دیسک‌های سختی که دسترسی مستقیم به
پارتیشن‌های آن‌ها از طریق سوار کردن (Mount) فراهم است توصیه نمی‌شود.
.TP
\&\fR\&\f(CWoffset\fR\
توصیف می‌کند که سامانهٔ پروندهٔ MS-DOS در کجای پرونده آغاز می‌شود. این گزینه
برای پارتیشن‌های منطقی در ایمیج‌های دیسک سخت DOSEMU و دیسک‌های رم ATARI مفید است. به‌طور
پیش‌فرض، این مقدار صفر است؛ یعنی سامانهٔ پرونده دقیقاً در
ابتدای دستگاه یا پرونده آغاز می‌شود.
.PP
.SS "پیکربندی هندسه دیسک (Disk Geometry Configuration)"
.PP
اطلاعات هندسه ویژگی‌های فیزیکی دیسک را شرح می‌دهد. این اطلاعات
سه هدف دارد:
.TP
قالب‌بندی\ (formatting)\
اطلاعات هندسه در سکتور بوت دیسک تازه‌ساخته‌شده نوشته می‌شود. با این حال،
می‌توانید اطلاعات هندسه را در خط فرمان نیز شرح دهید. برای جزئیات به بخش
mformat مراجعه کنید.
.TP
فیلتر کردن\ (filtering)\
در برخی سیستم‌های یونیکس گره‌های دستگاهی وجود دارند که تنها از یک هندسهٔ
فیزیکی پشتیبانی می‌کنند. برای نمونه، ممکن است برای دسترسی به یک دیسک با
چگالی بالا یا چگالی پایین به گره متفاوتی نیاز داشته باشید. هندسه با
هندسهٔ واقعی ذخیره‌شده در سکتور بوت مقایسه می‌شود تا اطمینان حاصل گردد این گره
دستگاه قادر به خواندن درست دیسک است. اگر هندسه مطابقت نداشته باشد،
این مدخل درایو با شکست مواجه می‌شود و مدخل درایو بعدی با همان
حرف درایو امتحان می‌شود. برای جزئیات بیشتر درباره ارائه چندین توصیف برای یک حرف درایو،
به بخش توصیف‌های چندگانه مراجعه کنید.
.IP
اگر هیچ اطلاعات هندسه‌ای در پروندهٔ پیکربندی ارائه نشود، تمامی دیسک‌ها
پذیرفته می‌شوند. در لینوکس (و در SPARC) گره‌های دستگاه با هندسهٔ قابل‌پیکربندی وجود دارند
(\fR\&\f(CW\(if/dev/fd0\(is\fR، \fR\&\f(CW\(if/dev/fd1\(is\fR و غیره)،
و بنابراین فیلتر کردن برای درایوهای دیسک مورد نیاز نیست (و نادیده گرفته می‌شود). (mtools
همچنان فیلتر کردن را روی پرونده‌های معمولی (ایمیج‌های دیسک) در لینوکس انجام می‌دهد؛ این امر
عمدتاً برای اهداف آزمایشی است، زیرا من به سیستم یونیکسی که واقعاً به فیلتر کردن نیاز داشته باشد
دسترسی ندارم).
.IP
اگر به فیلتر کردن نیاز ندارید، اما همچنان یک هندسهٔ پیش‌فرض برای
قالب‌بندی با mformat می‌خواهید، می‌توانید فیلتر کردن را با استفاده از پرچم \fR\&\f(CWmformat_only\fR
غیرفعال کنید.
.IP
اگر فیلتر کردن می‌خواهید، باید پرچم \fR\&\f(CWfilter\fR را ارائه دهید. اگر
یک هندسه ارائه می‌دهید، باید یکی از این دو پرچم را مشخص کنید.
.TP
هندسهٔ\ اولیه\ (initial\ geometry)\
در دستگاه‌هایی که از آن پشتیبانی می‌کنند (معمولاً دستگاه‌های فلاپی)، از اطلاعات
هندسه برای تنظیم هندسهٔ اولیه نیز استفاده می‌شود. این هندسهٔ اولیه هنگام
خواندن سکتور بوت، که حاوی هندسهٔ واقعی است، اعمال می‌شود. اگر هیچ اطلاعات هندسه‌ای در
پروندهٔ پیکربندی ارائه نشود، یا اگر پرچم \fR\&\f(CWmformat_only\fR ارائه شده باشد، هیچ
پیکربندی اولیه‌ای انجام نمی‌شود.
.IP
در لینوکس، هندسهٔ اولیه واقعاً مورد نیاز نیست، زیرا دستگاه‌های قابل‌پیکربندی قادرند
نوع دیسک را با دقت کافی (برای اکثر قالب‌های متداول) جهت خواندن سکتور بوت به‌طور خودکار تشخیص دهند.
.PP
اطلاعات هندسهٔ نادرست ممکن است به خطاهای بسیار عجیبی منجر شود. به همین دلیل اکیداً
توصیه می‌کنم که پرچم \fR\&\f(CWmformat_only\fR را به توصیف درایو خود اضافه کنید،
مگر اینکه واقعاً به فیلتر کردن یا هندسهٔ اولیه نیاز داشته باشید.
.PP
متغیرهای مربوط به هندسه زیر در دسترس هستند:
.TP
\&\fR\&\f(CWcylinders\fR\
.TQ
\&\fR\&\f(CWtracks\fR
تعداد استوانه‌ها (سیلندرها). (\fR\&\f(CWcylinders\fR شکل ترجیحی است،
و \fR\&\f(CWtracks\fR منسوخ در نظر گرفته می‌شود)
.TP
\&\fR\&\f(CWheads\fR\
تعداد هدها (سمت‌ها).
.TP
\&\fR\&\f(CWsectors\fR\
تعداد سکتورها در هر شیار (تراک).
.PP
مثال: بخش درایو زیر یک درایو 1.44M را شرح می‌دهد:
.PP

.nf
.ft 3
.in +0.3i
  drive a:
      file="/dev/fd0H1440"
      fat_bits=12
      cylinders=80 heads=2 sectors=18
      mformat_only
.fi
.in -0.3i
.ft R
.PP

\&\fR
.PP
توصیف‌های کوتاه‌نویسی هندسه زیر در دسترس هستند:
.TP
\&\fR\&\f(CW1.44m\fR\
دیسک 3 1/2 با چگالی بالا. معادل با:
\&\fR\&\f(CWfat_bits=12 cylinders=80 heads=2 sectors=18\fR
.TP
\&\fR\&\f(CW1.2m\fR\
دیسک 5 1/4 با چگالی بالا. معادل با:
\&\fR\&\f(CWfat_bits=12 cylinders=80 heads=2 sectors=15\fR
.TP
\&\fR\&\f(CW720k\fR\
دیسک 3 1/2 با چگالی دوبرابر. معادل با:
\&\fR\&\f(CWfat_bits=12 cylinders=80 heads=2 sectors=9\fR
.TP
\&\fR\&\f(CW360k\fR\
دیسک 5 1/4 با چگالی دوبرابر. معادل با:
\&\fR\&\f(CWfat_bits=12 cylinders=40 heads=2 sectors=9\fR
.PP
توصیف‌های قالب کوتاه‌نویسی را می‌توان اصلاح کرد. به عنوان مثال،
\&\fR\&\f(CW360k sectors=8\fR
یک دیسک 320k را توصیف می‌کند و معادل است با:
\&\fR\&\f(CWfat_bits=12 cylinders=40 heads=2 sectors=8\fR
.PP
.SS "پرچم‌های باز کردن (Open Flags)"
.PP
علاوه بر این، پرچم‌های زیر در دسترس هستند:
.TP
\&\fR\&\f(CWsync\fR\
تمام عملیات ورودی/خروجی (I/O) به‌صورت همگام انجام می‌شوند.
.TP
\&\fR\&\f(CWnodelay\fR\
دستگاه یا پرونده با پرچم O_NDELAY باز می‌شود. این پرچم در برخی
از معماری‌های غیرلینوکسی لازم است.
.TP
\&\fR\&\f(CWexclusive\fR\
دستگاه یا پرونده با پرچم O_EXCL باز می‌شود. در لینوکس، این کار
دسترسی انحصاری به درایو فلاپی را تضمین می‌کند. در بیشتر معماری‌های دیگر
و برای پرونده‌های معمولی، این گزینه هیچ تاثیری ندارد.
.PP
.SS "متغیرهای عمومی درایو (General Purpose Drive Variables)"
.PP
متغیرهای عمومی درایو زیر در دسترس هستند.
بسته به نوع، این متغیرها را می‌توان روی یک رشته
(precmd، postcmd) یا یک عدد صحیح (تمام موارد دیگر) تنظیم کرد.
.TP
\&\fR\&\f(CWfat_bits\fR\
تعداد بیت‌های FAT. این مقدار ممکن است 12 یا 16 باشد. این متغیر بسیار به‌ندرت
مورد نیاز است، زیرا تقریباً همیشه می‌توان آن را از اطلاعات موجود در
سکتور بوت استخراج کرد. برعکس، مشخص کردن تعداد بیت‌های FAT در صورت
اشتباه بودن ممکن است آسیب‌رسان باشد. تنها در صورتی باید از آن استفاده کنید که
mtools تعداد بیت‌های FAT را در تشخیص خودکار اشتباه تعیین کند، یا بخواهید
دیسکی با تعداد نامتعارفی از بیت‌های FAT را قالب‌بندی (mformat) کنید.
.TP
\&\fR\&\f(CWcodepage\fR\
صفحهٔ کد DOS مورد استفاده برای نام‌های کوتاه پرونده را شرح می‌دهد. این یک عدد
بین 1 تا 999 است. به‌طور پیش‌فرض، صفحهٔ کد 850 استفاده می‌شود. دلیل این امر
این است که این صفحهٔ کد بیشتر نویسه‌های موجود در ISO-Latin-1 را شامل
می‌شود. همچنین می‌توانید با استفاده از پارامتر سراسری \fR\&\f(CWdefault_codepage\fR
(خارج از هرگونه توصیف درایو)، یک صفحهٔ کد سراسری برای تمامی درایوها تعیین کنید.
این پارامتر از نسخهٔ 4.0.0 به بعد وجود دارد.
.TP
\&\fR\&\f(CWdata_map\fR\
داده‌ها را از پروندهٔ ایمیج بازنگاشت می‌کند. این ویژگی برای پرونده‌های ایمیجی مفید است
که ممکن است نیاز به درج سکتورهای پرشده با صفر اضافی داشته باشند. برای نمونه، این مورد
در ایمیج‌های فلاپی IBM 3174 رخ می‌دهد. این ایمیج‌ها نشان‌دهندهٔ
دیسک‌های فلاپی با سکتورهای کمتری در اولین استوانهٔ خود هستند. این سکتورهای ناموجود
در ایمیج ذخیره نشده‌اند، اما همچنان در چیدمان سامانهٔ پرونده شمارش می‌شوند.
قابلیت data_map امکان شبیه‌سازی این سکتورهای ناموجود را برای لایه‌های بالایی mtools فراهم می‌کند.
یک data_map دنباله‌ای با جداکنندهٔ ویرگول از نوع منبع و اندازه است. نوع منبع ممکن است
\fR\&\f(CWzero\fR برای سکتورهای پرشده با صفر ایجادشده توسط نگاشت، \fR\&\f(CWskip\fR برای نادیده گرفتن
(رد کردن) داده‌ها در ایمیج خام، و هیچ‌چیز برای استفاده از داده‌ها به همان صورت موجود
(رونوشت‌شده) از ایمیج خام باشد. نگاشت داده‌ها به‌طور خودکار با یک عنصر پایانی ضمنی از داده‌ها
تکمیل می‌شود که به همان صورت از آفست فعلی تا انتهای پرونده استفاده خواهد شد. هر اندازه یک
عدد است که پس از آن یک واحد قرار دارد: \fR\&\f(CWs\fR برای
یک سکتور ۵۱۲ بایتی، \fR\&\f(CWK\fR برای کیلوبایت، \fR\&\f(CWM\fR برای مگابایت،
\&\fR\&\f(CWG\fR برای گیگابایت، و هیچ‌چیز برای تک‌بایت‌ها.
.IP
مثال:
.IP
\&\fR\&\f(CWdata_map=1s,zero31s,28s,skip1s\fR نگاشتی برای استفاده با ایمیج‌های
فلاپی IBM 3174 خواهد بود. اولین سکتور (\fR\&\f(CW1s\fR، سکتور بوت) به همان صورت
استفاده می‌شود. سپس ۳۱ سکتور ساختگی پرشده با صفر (\fR\&\f(CWzero31s\fR) قرار می‌گیرند،
سپس ۲۸ سکتور بعدی از ایمیج (\fR\&\f(CW28s\fR) به همان صورت استفاده می‌شوند (آن‌ها حاوی
FAT و دایرکتوری ریشه هستند)، سپس یک سکتور از ایمیج نادیده گرفته می‌شود
(\fR\&\f(CWskip1s\fR)، و در نهایت بقیهٔ ایمیج به همان صورت استفاده می‌شود
(به‌طور ضمنی).
.IP
.TP
\&\fR\&\f(CWprecmd\fR\
دستور داده‌شده را پیش از باز کردن دستگاه اجرا می‌کند.
در برخی از مشتقات Solaris، لازم است پیش از باز کردن دستگاه فلاپی، دستور 'volcheck -v'
فراخوانی شود تا سیستم متوجه شود که واقعاً یک دیسک در درایو قرار دارد. درج
\fR\&\f(CWprecmd="volcheck -v"\fR در بند درایو، رفتار مورد نظر را ایجاد می‌کند.
.TP
\&\fR\&\f(CWpostcmd\fR\
دستور داده‌شده را پس از بستن دستگاه اجرا می‌کند.
اگر mtools پروندهٔ ایمیج را با برنامهٔ دیگری به اشتراک بگذارد، ممکن است برای
آزاد کردن پروندهٔ ایمیج برای آن برنامه مفید باشد.
.TP
\&\fR\&\f(CWblocksize\fR\
این پارامتر اندازهٔ بلوک پیش‌فرضی را نشان می‌دهد که همیشه باید روی این دستگاه
استفاده شود. تمام ورودی/خروجی‌ها بدون وابستگی به اندازهٔ سکتور ثبت‌شده در سکتور
بوت سامانهٔ پرونده، با مضاربی از این اندازهٔ بلوک انجام می‌شوند. این گزینه برای دستگاه‌های
نویسه‌ای که اندازهٔ سکتور آن‌ها 512 نیست، مانند درایوهای CD-ROM در Solaris، مفید است.
.PP
تنها متغیر \fR\&\f(CWfile\fR اجباری است. سایر پارامترها را می‌توان حذف کرد.
در این صورت از یک مقدار پیش‌فرض یا مقداری که به‌طور خودکار تشخیص داده شده است استفاده می‌شود.
.PP
.SS "پرچم‌های عمومی درایو (General Purpose Drive Flags)"
.PP
یک پرچم را می‌توان روی 1 (فعال) یا 0 (غیرفعال) تنظیم کرد. اگر مقدار
حذف شود، فعال در نظر گرفته می‌شود. به عنوان مثال، \fR\&\f(CWscsi\fR معادل است با
\&\fR\&\f(CWscsi=1\fR
.TP
\&\fR\&\f(CWnolock\fR\
به mtools دستور می‌دهد که از قفل‌گذاری روی این درایو استفاده نکند. این ویژگی در
سیستم‌هایی با معناشناسی قفل‌گذاری معیوب لازم است. با این حال، فعال کردن آن
در مواردی که چند کاربر ممکن است هم‌زمان به یک درایو دسترسی داشته باشند، ایمنی عملیات را کاهش می‌دهد.
.TP
\&\fR\&\f(CWscsi\fR\
هنگامی که روی 1 تنظیم شود، این گزینه به mtools دستور می‌دهد که به جای فراخوانی‌های
استاندارد خواندن/نوشتن، از ورودی/خروجی مستقیم SCSI برای دسترسی به دستگاه استفاده کند. در حال حاضر، این قابلیت
در HP-UX، Solaris و SunOS پشتیبانی می‌شود. این ویژگی از آن جهت لازم است که در برخی
معماری‌ها، مانند SunOS یا Solaris، رسانه‌های رایانهٔ شخصی (PC) را نمی‌توان با استفاده از فراخوانی‌های سیستمی
\fR\&\f(CWread\fR و \fR\&\f(CWwrite\fR مورد دسترسی قرار داد، زیرا سیستم‌عامل انتظار دارد
آن‌ها حاوی یک «برچسب دیسک» مخصوص سان باشند.
.IP
از آنجا که دسترسی مستقیم SCSI همیشه از کل دستگاه استفاده می‌کند، باید علاوه بر آن
پرچم "partition" را نیز تعیین کنید.
.IP
در برخی معماری‌ها مانند Solaris، ابزار mtools برای استفاده از گزینهٔ \fR\&\f(CWscsi\fR به
مجوزهای ریشه (root) نیاز دارد. بنابراین اگر می‌خواهید به درایوهای Zip/Jaz دسترسی داشته باشید،
mtools باید در Solaris به صورت setuid root نصب شود. از این رو، اگر پرچم \fR\&\f(CWscsi\fR داده شود،
گزینهٔ \fR\&\f(CWprivileged\fR به‌طور خودکار لحاظ می‌شود، مگر اینکه صراحتاً با
\fR\&\f(CWprivileged=0\fR غیرفعال شده باشد.
.IP
ابزار mtools از دسترسی ریشهٔ خود برای باز کردن دستگاه و ارسال فراخوانی‌های واقعی ورودی/خروجی SCSI
استفاده می‌کند. علاوه بر این، دسترسی ریشه تنها برای درایوهایی استفاده می‌شود که در پروندهٔ
پیکربندی سراسری سیستم مانند \&\fR\&\f(CW\(if/etc/mtools.conf\(is\fR توصیف شده باشند، و نه
برای مواردی که در \&\fR\&\f(CW\(if~/.mtoolsrc\(is\fR یا \fR\&\f(CW\(if$MTOOLSRC\(is\fR شرح داده شده‌اند.
.TP
\&\fR\&\f(CWprivileged\fR\
هنگامی که روی 1 تنظیم شود، به mtools دستور می‌دهد که از مجوزهای setuid و setgid خود
برای باز کردن درایو داده‌شده استفاده کند. این گزینه تنها برای درایوهایی معتبر است که
در پرونده‌های پیکربندی سراسری سیستم (مانند \&\fR\&\f(CW\(if/etc/mtools.conf\(is\fR، نه
\&\fR\&\f(CW\(if~/.mtoolsrc\(is\fR یا \fR\&\f(CW\(if$MTOOLSRC\(is\fR) توصیف شده باشند. بدیهی است
که اگر mtools به‌صورت setuid یا setgid نصب نشده باشد، این گزینه هیچ اثری نخواهد داشت. این گزینه
توسط 'scsi=1' به‌طور ضمنی فعال می‌شود، اما مجدداً فقط برای درایوهای تعریف‌شده در پرونده‌های پیکربندی سراسری سیستم.
گزینهٔ Privileged را می‌توان صراحتاً روی 0 نیز تنظیم کرد تا به mtools اعلام شود که
حتی اگر \fR\&\f(CWscsi=1\fR تنظیم شده باشد، از مجوزهای خود برای درایو مشخص استفاده نکند.
.IP
تنها در صورتی نیاز است mtools به صورت setuid نصب شود که از متغیرهای
درایو \&\fR\&\f(CWprivileged\fR یا \fR\&\f(CWscsi\fR استفاده کنید. اگر از این
گزینه‌ها استفاده نمی‌کنید، mtools حتی بدون نصب به صورت setuid root نیز کاملاً خوب کار می‌کند.
.TP
\&\fR\&\f(CWvold\fR\
.IP
به mtools دستور می‌دهد که نام دستگاه را به جای نام پرونده، به عنوان شناسهٔ vold
تفسیر کند. شناسهٔ vold با استفاده از توابع \fR\&\f(CWmedia_findname()\fR و
\&\fR\&\f(CWmedia_oldaliases()\fR از کتابخانهٔ \fR\&\f(CWvolmgt\fR به یک نام پروندهٔ واقعی
ترجمه می‌شود. این پرچم تنها در صورتی در دسترس است که mtools را پیش از کامپایل
با گزینهٔ \&\fR\&\f(CW--enable-new-vold\fR پیکربندی کرده باشید.
.TP
\&\fR\&\f(CWswap\fR\
.IP
رسانه را به عنوان یک دیسک آتاری با کلمات جابجا شده (word-swapped) در نظر می‌گیرد.
.TP
\&\fR\&\f(CWuse_xdf\fR\
اگر روی مقداری غیر از صفر تنظیم شود، mtools تلاش می‌کند به این دیسک به عنوان
یک دیسک XDF دسترسی پیدا کند. فرمت XDF یک قالب با ظرفیت بالا است که توسط OS/2 استفاده می‌شد.
این گزینه به‌طور پیش‌فرض غیرفعال است. برای جزئیات بیشتر به بخش XDF مراجعه کنید.
.TP
\&\fR\&\f(CWmformat_only\fR\
به mtools دستور می‌دهد که از هندسه برای این درایو تنها جهت قالب‌بندی با mformat و
نه برای فیلتر کردن استفاده کند.
.TP
\&\fR\&\f(CWfilter\fR\
به mtools دستور می‌دهد که از هندسه برای این درایو هم برای قالب‌بندی با mformat و
هم فیلتر کردن استفاده کند.
.TP
\&\fR\&\f(CWremote\fR\
به mtools دستور می‌دهد که به floppyd متصل شود (بخش floppyd را ببینید).
.PP
.SS "ارائه چند توصیف برای یک درایو (Supplying multiple descriptions for a drive)"
.PP
امکان ارائه چندین توصیف برای یک درایو وجود دارد. در این حالت،
توصیف‌ها به ترتیب امتحان می‌شوند تا یکی پیدا شود که مناسب
باشد. توصیف‌ها ممکن است به چند دلیل با شکست مواجه شوند:
.TP
1.\
به دلیل مناسب نبودن هندسه،
.TP
2.\
به دلیل نبودن دیسک در درایو،
.TP
3.\
یا به دلیل مشکلات دیگر.
.PP
تعاریف چندگانه هنگام استفاده از دستگاه‌های فیزیکی که تنها قادر به پشتیبانی
از یک هندسهٔ دیسک واحد هستند مفید است.
مثال:

.nf
.ft 3
.in +0.3i
  drive a: file="/dev/fd0H1440" 1.44m
  drive a: file="/dev/fd0H720" 720k
.fi
.in -0.3i
.ft R
.PP

\&\fR
.PP
این دستور به mtools می‌گوید که از /dev/fd0H1440 برای دیسک‌های 1.44m (چگالی بالا)
و از /dev/fd0H720 برای دیسک‌های 720k (چگالی دوبرابر) استفاده کند. در لینوکس این
ویژگی واقعاً مورد نیاز نیست، زیرا دستگاه /dev/fd0 قادر به مدیریت
هر هندسه‌ای است.
.PP
همچنین می‌توانید از توصیف‌های چندگانهٔ درایو برای دسترسی به هر دو درایو
فیزیکی خود از طریق یک حرف درایو استفاده کنید:
.PP

.nf
.ft 3
.in +0.3i
  drive z: file="/dev/fd0"
  drive z: file="/dev/fd1"
.fi
.in -0.3i
.ft R
.PP

\&\fR
.PP
با این توصیف، دستور \fR\&\f(CWmdir z:\fR در صورتی که درایو فیزیکی اول حاوی دیسک
باشد به آن دسترسی پیدا می‌کند. اگر درایو اول حاوی دیسک نباشد،
mtools درایو دوم را بررسی می‌کند.
.PP
هنگام استفاده از چندین پروندهٔ پیکربندی، توصیف‌های درایو در پرونده‌هایی که
در آخر تجزیه می‌شوند، توصیف‌های مربوط به همان درایو در پرونده‌های قبلی را
رونویسی می‌کنند. برای جلوگیری از این موضوع، به جای کلیدواژهٔ \fR\&\f(CWdrive\fR
از کلیدواژه‌های \fR\&\f(CWdrive+\fR یا \fR\&\f(CW+drive\fR استفاده کنید. اولی
توصیفی را به انتهای فهرست اضافه می‌کند (یعنی در آخر امتحان خواهد شد)، و دومی آن را
به ابتدای فهرست می‌افزاید.
.PP
.SS "محل پرونده‌های پیکربندی و ترتیب تجزیه (Location of configuration files and parsing order)"
.PP
پرونده‌های پیکربندی به ترتیب زیر تجزیه می‌شوند:
.TP
1.\
پیش‌فرض‌های کامپایل‌شده
.TP
2.\
\&\fR\&\f(CW\(if/etc/mtools.conf\(is\fR
.TP
3.\
\&\fR\&\f(CW\(if~/.mtoolsrc\(is\fR.
.TP
4.\
\&\fR\&\f(CW\(if$MTOOLSRC\(is\fR (پرونده‌ای که متغیر محیطی \fR\&\f(CWMTOOLSRC\fR به آن اشاره می‌کند)
.PP
گزینه‌های شرح داده‌شده در پرونده‌های بعدی، گزینه‌های شرح داده‌شده در پرونده‌های
قبلی را رونویسی می‌کنند. درایوهای تعریف‌شده در پرونده‌های قبلی در صورتی که در
پرونده‌های بعدی رونویسی نشوند باقی می‌مانند. برای مثال، ممکن است درایوهای A و B
در \fR\&\f(CW\(if/etc/mtools.conf\(is\fR و درایوهای C و D در
\fR\&\f(CW\(if~/.mtoolsrc\(is\fR تعریف شوند. با این حال، اگر \fR\&\f(CW\(if~/.mtoolsrc\(is\fR نیز
درایو A را تعریف کند، این توصیف جدید به جای اضافه شدن به توصیف قبلی، توصیف
درایو A در \fR\&\f(CW\(if/etc/mtools.conf\(is\fR را رونویسی می‌کند. اگر
می‌خواهید توصیف جدیدی به درایوی که از قبل در پروندهٔ قبلی شرح داده شده است اضافه کنید،
باید از کلیدواژهٔ \fR\&\f(CW+drive\fR یا \fR\&\f(CWdrive+\fR استفاده نمایید.
.PP
.SS "سازگاری رو به عقب با دستور زبان قدیمی پرونده پیکربندی (Backwards compatibility with old configuration file syntax)"
.PP
دستور زبان شرح داده شده در این راهنما برای نسخهٔ \fR\&\f(CWmtools\-3.0\fR جدید است. از
دستور زبان خط‌محور قدیمی همچنان پشتیبانی می‌شود. هر خطی که با یک حرف
تنها آغاز شود، یک توصیف درایو با دستور زبان قدیمی در نظر گرفته می‌شود. بخش‌های درایو
سبک قدیم و سبک جدید را می‌توان در همان پروندهٔ پیکربندی با هم ترکیب کرد تا
ارتقا آسان‌تر شود. در نهایت پشتیبانی از دستور زبان قدیمی متوقف خواهد شد، و برای جلوگیری
از استفاده از آن، عمداً از شرح آن در اینجا خودداری می‌کنم.
.PP
.SH "همچنین ببینید (SEE ALSO)"
mtools