.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "NBDTAB" "5" "$Date: 2006-10-18 15:01:57 +0200 (wo, 18 okt 2006) $" "" ""

.SH "نام (NAME)"
/etc/nbdtab \- پرونده پیکربندی برای nbd-client
.SH "خلاصه دستور (SYNOPSIS)"

\fB/etc/nbdtab\fR

.SH "توضیحات (DESCRIPTION)"
.PP
این پرونده امکان پیکربندی اتصال‌های از پیش تعریف‌شده برای
.B nbd-client
را فراهم می‌کند. این پرونده می‌تواند شامل چندین تعریف باشد (هر خط یک تعریف)،
که هر کدام از چهار فیلدِ جداشده با فاصله تشکیل شده‌اند.
.PP
برای اتصال دستگاهی که در پرونده
.I nbdtab
مشخص شده است، دستور
.BR nbd-client (8)
را تنها با نام کوتاه آن دستگاه به عنوان تنها آرگومان اجرا کنید. سپس اطلاعات لازم را در
.I nbdtab
جستجو کرده و اتصال را برقرار می‌کند.
.PP
فیلدها با هر تعداد نویسه فاصله یا تب از یکدیگر جدا می‌شوند؛ رکوردها با نویسه خط جدید از هم تفکیک می‌گردند. این پرونده همچنین می‌تواند شامل هر تعداد یادداشت باشد که با نویسه «#» آغاز می‌شوند و تا انتهای خط یا انتهای پرونده (هر کدام که زودتر برسد) ادامه می‌یابند.
.SS "فیلدها (FIELDS)"
.PP
این پرونده شامل فیلدهای زیر است:
.TP 3
1.
نام کوتاه پرونده دستگاه. یعنی باید شامل نام دستگاه بدون بخش ابتدایی
.I /dev/
باشد؛ برای نمونه می‌تواند
.I nbd0
باشد.
.TP 3
2.
نام میزبان (در صورت استفاده از سوکت TCP) یا نام پرونده (در صورت استفاده از سوکت دامنه‌ای یونیکس) که سرور روی آن به گوش فرا می‌دهد.
.TP 3
3.
نام مورد اشتراک (export) به همان شکلی که توسط
.B nbd-server
به اشتراک گذاشته شده است.
.TP 3
4.
هرگونه گزینه اضافی. این فیلد اختیاری است و اگر هیچ گزینه‌ای لازم نباشد، نیازی به درج آن در پرونده نیست. گزینه‌های شناخته‌شده توسط
.BR nbd-client (8)
در زیر و در بخش «گزینه‌ها» مشخص شده‌اند. هر گزینه ناشناخته‌ای در این فیلد موجب هشدار توسط
.B nbd-client
می‌شود، مگر آنکه با نویسه زیرخط («_») آغاز شده باشد؛ نویسه زیرخط به طور خاص برای استفاده محلی یا سفارشی‌سازی توزیع رزرو شده است.
.SS "گزینه‌ها (OPTIONS)"
.PP
هر گزینه خط فرمان
.B nbd-client
که امکان پیکربندی گزینه‌های خاص را برای یک گره دستگاه مشخص فراهم می‌کند، دارای گزینه متناظری در پرونده
.I nbdtab
است و برعکس؛ اگر چنین نباشد، یک اشکال نرم‌افزاری (bug) به شمار می‌رود.
.PP
گزینه‌های جداگانه در این فیلد باید با نویسه ویرگول از یکدیگر جدا شوند.
.TP
\fBbs=\fIblock size\fR
اندازه بلوک برای این مورد اشتراک. اگر از این گزینه استفاده نشود، مقدار پیش‌فرض هسته استفاده خواهد شد.
.IP
متناظر با گزینه
.B \-b
در خط فرمان است.
.TP
\fBcacertfile=\fIcertificate file\fR
پرونده گواهی مرجع گواهی (CA) برای TLS. متناظر با گزینه
.B \-A
در خط فرمان است.
.TP
\fBcertfile=\fIcertificate file\fR
پرونده گواهی برای TLS. متناظر با گزینه
.B \-F
در خط فرمان است.
.TP
\fBconns=\fInumber\fR
تعداد اتصال‌هایی که برای این دستگاه استفاده می‌شود. متناظر با گزینه
.B \-C
در خط فرمان است؛ برای جزئیات بیشتر درباره این گزینه، به
.BR nbd-client (8)
مراجعه کنید.
.TP
\fBkeyfile=\fIkey file\fR
پرونده کلید خصوصی برای TLS. متناظر با گزینه
.B \-K
در خط فرمان است.
.TP
\fBno_optgo\fR
غیرفعال کردن استفاده از NBD_OPT_GO در گفتگو. متناظر با گزینه
.B \-g
در خط فرمان است.
.TP
\fBpersist\fR
پایدار نگه‌داشتن اتصال، با استفاده از معناشناسی گزینه خط فرمان
.BR \-p .
.TP
\fBport=\fIport number\fR
درگاهی که ارتباط با
.B nbd-server
روی آن انجام می‌شود. به‌طور پیش‌فرض درگاه اختصاص‌یافته توسط IANA برای NBD، یعنی ۱۰۸۰۹ است.
.TP
\fBpriority=\fIGnuTLS priority string\fR
رشته اولویت GnuTLS برای استفاده. متناظر با گزینه
.B \-y
در خط فرمان است.
.TP
\fBswap\fR
بهینه‌سازی برای فضای مبادله (swap)؛ متناظر با
.BR \-s .
.TP
\fBtimeout=\fItimeout\fR
مدت زمان انتظار (مهلت زمانی). اگر این گزینه مشخص نشود، هیچ مهلت زمانی پیکربندی نمی‌شود.
.IP
متناظر با گزینه
.B \-t
در خط فرمان است.
.TP
\fBtlshostname=\fITLS hostname\fR
نام میزبان برای اهداف TLS؛ متناظر با
.BR \-H .
.TP
\fBunix\fR
استفاده از سوکت دامنه‌ای یونیکس برای اتصال به سرور؛ متناظر با
.BR \-u .
.SH "همچنین ببینید (SEE ALSO)"
.PP
.BR nbd-server (1),
.BR nbd-client (8),
.BR nbd-trdump (8)
.SH "نویسندگان (AUTHORS)"
.PP
ماژول هسته NBD و ابزارهای NBD در ابتدا توسط Pavel Machek (pavel@ucw.cz) نوشته شدند.
.PP
ماژول هسته لینوکس اکنون توسط Paul Clements (Paul.Clements@steeleye.com) نگهداری می‌شود، در حالی که ابزارهای فضای کاربری توسط Wouter Verhelst (<wouter@debian.org>) نگهداری می‌شوند.
.PP
در سیستم‌عامل The Hurd یک مترجم (translator) معمولی برای اجرای سمت کلاینت پروتکل در دسترس است و استفاده از
.B nbd-client
ضروری نیست. لطفاً برای اطلاعات بیشتر به مستندات مربوطه مراجعه کنید.
.PP
این صفحه راهنما توسط Wouter Verhelst (<wouter@debian.org>) نوشته شده است.
اجازه کپی، توزیع یا تغییر این سند تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License)، نسخه ۲، منتشرشده توسط بنیاد نرم‌افزار آزاد داده می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.PP
یک پرونده
.I nbdtab
ساده می‌تواند به این شکل باشد:

.nf
# فضای مبادله (swap)، با نام "swapexport" روی سرور
# بهینه‌سازی برای swap و تلاش مجدد برای اتصال هنگام قطع ارتباط.
nbd0 nbdserver.example.com swapexport swap,persist
# مورد اشتراک دیگر، با نام "data" روی سرور. بدون گزینه برای این مورد.
nbd1 nbdserver.example.com data
.fi