NBDTAB(5) NBDTAB(5)

/etc/nbdtab - پرونده پیکربندی برای nbd-client

/etc/nbdtab

این پرونده امکان پیکربندی اتصال‌های از پیش تعریف‌شده برای nbd-client را فراهم می‌کند. این پرونده می‌تواند شامل چندین تعریف باشد (هر خط یک تعریف)، که هر کدام از چهار فیلدِ جداشده با فاصله تشکیل شده‌اند.

برای اتصال دستگاهی که در پرونده nbdtab مشخص شده است، دستور nbd-client(8) را تنها با نام کوتاه آن دستگاه به عنوان تنها آرگومان اجرا کنید. سپس اطلاعات لازم را در nbdtab جستجو کرده و اتصال را برقرار می‌کند.

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

این پرونده شامل فیلدهای زیر است:

1.
نام کوتاه پرونده دستگاه. یعنی باید شامل نام دستگاه بدون بخش ابتدایی /dev/ باشد؛ برای نمونه می‌تواند nbd0 باشد.
2.
نام میزبان (در صورت استفاده از سوکت TCP) یا نام پرونده (در صورت استفاده از سوکت دامنه‌ای یونیکس) که سرور روی آن به گوش فرا می‌دهد.
3.
نام مورد اشتراک (export) به همان شکلی که توسط nbd-server به اشتراک گذاشته شده است.
4.
هرگونه گزینه اضافی. این فیلد اختیاری است و اگر هیچ گزینه‌ای لازم نباشد، نیازی به درج آن در پرونده نیست. گزینه‌های شناخته‌شده توسط nbd-client(8) در زیر و در بخش «گزینه‌ها» مشخص شده‌اند. هر گزینه ناشناخته‌ای در این فیلد موجب هشدار توسط nbd-client می‌شود، مگر آنکه با نویسه زیرخط («_») آغاز شده باشد؛ نویسه زیرخط به طور خاص برای استفاده محلی یا سفارشی‌سازی توزیع رزرو شده است.

هر گزینه خط فرمان nbd-client که امکان پیکربندی گزینه‌های خاص را برای یک گره دستگاه مشخص فراهم می‌کند، دارای گزینه متناظری در پرونده nbdtab است و برعکس؛ اگر چنین نباشد، یک اشکال نرم‌افزاری (bug) به شمار می‌رود.

گزینه‌های جداگانه در این فیلد باید با نویسه ویرگول از یکدیگر جدا شوند.

اندازه بلوک برای این مورد اشتراک. اگر از این گزینه استفاده نشود، مقدار پیش‌فرض هسته استفاده خواهد شد.
متناظر با گزینه -b در خط فرمان است.
پرونده گواهی مرجع گواهی (CA) برای TLS. متناظر با گزینه -A در خط فرمان است.
پرونده گواهی برای TLS. متناظر با گزینه -F در خط فرمان است.
تعداد اتصال‌هایی که برای این دستگاه استفاده می‌شود. متناظر با گزینه -C در خط فرمان است؛ برای جزئیات بیشتر درباره این گزینه، به nbd-client(8) مراجعه کنید.
پرونده کلید خصوصی برای TLS. متناظر با گزینه -K در خط فرمان است.
غیرفعال کردن استفاده از NBD_OPT_GO در گفتگو. متناظر با گزینه -g در خط فرمان است.
پایدار نگه‌داشتن اتصال، با استفاده از معناشناسی گزینه خط فرمان -p.
درگاهی که ارتباط با nbd-server روی آن انجام می‌شود. به‌طور پیش‌فرض درگاه اختصاص‌یافته توسط IANA برای NBD، یعنی ۱۰۸۰۹ است.
رشته اولویت GnuTLS برای استفاده. متناظر با گزینه -y در خط فرمان است.
بهینه‌سازی برای فضای مبادله (swap)؛ متناظر با -s.
مدت زمان انتظار (مهلت زمانی). اگر این گزینه مشخص نشود، هیچ مهلت زمانی پیکربندی نمی‌شود.
متناظر با گزینه -t در خط فرمان است.
نام میزبان برای اهداف TLS؛ متناظر با -H.
استفاده از سوکت دامنه‌ای یونیکس برای اتصال به سرور؛ متناظر با -u.

nbd-server(1), nbd-client(8), nbd-trdump(8)

ماژول هسته NBD و ابزارهای NBD در ابتدا توسط Pavel Machek (pavel@ucw.cz) نوشته شدند.

ماژول هسته لینوکس اکنون توسط Paul Clements (Paul.Clements@steeleye.com) نگهداری می‌شود، در حالی که ابزارهای فضای کاربری توسط Wouter Verhelst (<wouter@debian.org>) نگهداری می‌شوند.

در سیستم‌عامل The Hurd یک مترجم (translator) معمولی برای اجرای سمت کلاینت پروتکل در دسترس است و استفاده از nbd-client ضروری نیست. لطفاً برای اطلاعات بیشتر به مستندات مربوطه مراجعه کنید.

این صفحه راهنما توسط Wouter Verhelst (<wouter@debian.org>) نوشته شده است. اجازه کپی، توزیع یا تغییر این سند تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License)، نسخه ۲، منتشرشده توسط بنیاد نرم‌افزار آزاد داده می‌شود.

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

# فضای مبادله (swap)، با نام "swapexport" روی سرور
# بهینه‌سازی برای swap و تلاش مجدد برای اتصال هنگام قطع ارتباط.
nbd0 nbdserver.example.com swapexport swap,persist
# مورد اشتراک دیگر، با نام "data" روی سرور. بدون گزینه برای این مورد.
nbd1 nbdserver.example.com data
$Date: 2006-10-18 15:01:57 +0200 (wo, 18 okt 2006) $