نام (NAME)

gdomap - کارساز نام اشیاء توزیع‌شده گنو‌استپ (GNUstep Distributed Objects)

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

gdomap [-C|-H] [-I pidfile] [-L name] [-M name] [-N] [-P number] [-R name] [-S] [-T type] [-U name] [-a file] [-c file] [-d] [-f] [-i seconds] [-j path] [-p]

توضیحات (DESCRIPTION)

دیمن gdomap توسط برنامه‌های گنو‌استپ (GNUstep) برای یافتن اشیاء توزیع‌شده فرایندهای در حال اجرا در شبکه (و میان حساب‌های کاربری مختلف روی یک ماشین منفرد) استفاده می‌شود. این دیمن برای مواردی که دو فرایند متعلق به یک کاربر از اتصال محلی میزبان استفاده می‌کنند، به کار نمی‌رود. این صفحه راهنما نحوه استفاده از gdomap را توضیح می‌دهد. برای اطلاعات مربوط به طراحی و پیاده‌سازی (و نکات ویژه برای بسته‌بندها)، لطفاً مستندات HTML نصب‌شده در مسیر $GNUSTEP_SYSTEM_DOC زیر عنوان Command-line Tools را ببینید.

معمولاً دیمن gdomap هنگام بوت سیستم راه‌اندازی می‌شود و به درگاه ۵۳۸ متصل می‌گردد. برای یک نمونه اسکریپت راه‌اندازی به راهنمای ساخت گنو‌استپ (GNUstep Build Guide) مراجعه کنید.

به‌طور پیش‌فرض، gdomap تمامی ماشین‌های موجود در شبکه محلی را پویش می‌کند تا ببیند آیا نسخه‌ای از gdomap روی آن‌ها در حال اجرا است یا خیر. این کار برای شبکه‌های کلاس C و زیرشبکه‌های کلاس C انجام می‌شود. اگر میزبان شما در یک شبکه کلاس B یا کلاس A قرار دارد، رفتار پیش‌فرض این است که با آن مانند یک شبکه کلاس C رفتار کرده و فقط میزبان‌هایی را پویش کند که انتظار می‌رود در شبکه کلاس C با همان شماره وجود داشته باشند.

اگر در شبکه کلاس A یا کلاس B فعالیت می‌کنید، یا اگر شبکه شما دارای تعداد زیادی میزبان است که gdomap روی آن‌ها وجود ندارد، ممکن است بخواهید یک فایل پیکربندی ارائه دهید که میزبان‌های مورد نظر برای پویش را به‌طور صریح فهرست کند، به جای اینکه اجازه دهید gdomap تمام میزبان‌های موجود در شبکه محلی را پویش کند.

همچنین ممکن است بخواهید فایل پیکربندی را فراهم کنید تا میزبان‌هایی که در واقع روی شبکه محلی شما نیستند نیز وقتی کد شما تلاش می‌کند با استفاده از نام میزبان @"*" به یک میزبان متصل شود، پیدا شوند. توجه: این قابلیت در OpenStep وجود ندارد.

یک فایل پیکربندی شامل فهرستی از نشانی‌های IP برای پویش است. نشانی‌های IP باید در نماد نقطه‌دار استاندارد، در هر خط یکی درج شوند. خطوط خالی در فایل پیکربندی مجاز هستند. هر چیزی در یک خط پس از علامت هش ('#') نادیده گرفته می‌شود. می‌توانید با استفاده از گزینه خط فرمان -c فایل پیکربندی را به gdomap معرفی کنید.

gdomap از فراخوانی کنترل ورودی/خروجی SIOCGIFCONF ioctl برای ساخت فهرستی از نشانی‌های IP و ماسک‌های شبکه (netmasks) برای کارت‌های رابط شبکه در ماشین شما استفاده می‌کند. در برخی سیستم‌عامل‌ها، این سازوکار در دسترس نیست (یا دچار نقص است)، بنابراین باید نشانی‌ها و ماسک‌های رابط‌ها را با استفاده از گزینه خط فرمان -a به gdomap اعلام کنید. فایلی که با -a مشخص می‌شود باید شامل یک سری خطوط از جفت نشانی‌ها و ماسک‌های جداشده با فاصله در قالب نقطه‌دار باشد. نباید رابط‌های loopback (حلقه برگشتی) را در این فهرست بگنجانید. اگر می‌خواهید از برودکست (پخش همگانی) اطلاعات پویش روی یک شبکه پشتیبانی کنید، می‌توانید نشانی برودکست را به عنوان مورد سوم در همان خط درج نمایید. اگر سیستم‌عامل شما روش دیگری برای دریافت فهرست رابط‌های شبکه و ماسک‌ها دارد، لطفاً نمونه کدی برای توسعه‌دهنده ارسال کنید تا در gdomap پیاده‌سازی شود.

گزینه‌ها (OPTIONS)

-C

راهنمایی درباره پیکربندی.

-H

راهنمای عمومی.

-I pidfile

فایل pid برای نوشتن شناسه فرایند (PID).

-L name

جستجوی name و سپس خروج.

-M name

نام ماشین برای گزینه‌های -L و -N.

-N

فهرست کردن تمام نام‌های ثبت‌شده روی میزبان.

-P number

شماره درگاه مورد نیاز برای گزینه -R.

-R name

ثبت name به‌صورت محلی و سپس خروج.

-S

فهرست کردن نشانی‌های تمام کارسازهای gdomap شناخته‌شده برای میزبان.

-T type

نوع درگاه برای گزینه‌های -L، -R و -U - مقادیر: tcp_gdo، udp_gdo، tcp_foreign، udp_foreign.

-U name

لغو ثبت name به‌صورت محلی و سپس خروج.

-a file

استفاده از فایل پیکربندی برای فهرست رابط‌های شبکه.

-c file

استفاده از فایل پیکربندی برای پویش.

-d

ثبت لاگ‌های اشکال‌زدایی اضافی (به‌طور معمول از طریق syslog).

-f

جلوگیری از اجرای fork() جهت تسهیل اشکال‌زدایی.

-i seconds

پویش مجدد در این بازه زمانی (تقریبی)، حداقل ۶۰ ثانیه.

-j path

قرار دادن فرایند در یک محیط ایزوله chroot در این مسیر به جای /tmp.

-p

غیرفعال کردن پویش برای سایر کارسازها.

فایل‌ها (FILES)

از گزینه -c برای تعیین یک فایل پیکربندی برای gdomap استفاده کنید. برای پیکربندی‌های ممکن به بخش توضیحات (DESCRIPTION) مراجعه فرمایید.

عیب‌یابی (DIAGNOSTICS)

ارسال سیگنال SIGUSR1 برای دریافت خروجی تخلیه حافظه (dump) از تمام همتایان شناخته‌شده در مسیر /tmp/gdomap.dump

دستور gdomap -N تمامی نام‌های ثبت‌شده روی میزبان محلی را فهرست می‌کند.

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

دستور gdomap -C دستورالعمل‌های فوق را در مورد نحوه راه‌اندازی gdomap ارائه می‌دهد.

gdnc(1), GNUstep(7), gpbs(1)

راهنمای ساخت گنو‌استپ (GNUstep Build Guide) نمونه اسکریپت rc: http://gnustep.made-it.com/BuildGuide/index.html#GNUSTEP.SERVICES

تاریخچه (HISTORY)

کار روی gdomap در اکتبر ۱۹۹۶ آغاز شد.

این صفحه راهنما نخستین بار در gnustep-base نسخه 1.7.1 (ژوئن ۲۰۰۳) پدیدار شد.

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

gdomap توسط Richard Frith-Macdonald <rfm@gnu.org> نوشته شد.

این صفحه راهنما توسط Martin Brecher <martin@mb-itconsulting.com> گردآوری شد.