.TH lsdistcc 1 "1 May 2012"

.SH "نام (NAME)"
lsdistcc \- کشف ساده کارسازهای distcc

.SH "خلاصه دستور (SYNOPSIS)"
.B lsdistcc
[\fIOPTIONS\fR] [\fIFORMAT\fR]
.PP
.B lsdistcc
[\fIOPTIONS\fR]
.I host1 ...

.SH "توضیحات (DESCRIPTION)"
دستور
.B lsdistcc
کارسازهای در حال گوش‌دادن distcc را یا با جستجو در DNS برای میزبان‌هایی با نام منطبق بر یک
.IR FORMAT
مشخص، و یا با بررسی نام‌های میزبان داده‌شده در خط فرمان، به‌طور خودکار شناسایی می‌کند.

میزبان‌ها تنها بر این مبنا به عنوان کارسازهای خوب شناخته می‌شوند که آیا نام آن‌ها با قالب مطابقت دارد و روی درگاه (پورت) درستی گوش می‌دهند یا خیر (و به‌طور اختیاری آیا هنگام ارسال یک کار کامپایل به آن‌ها پاسخ می‌دهند یا خیر).

میزبان‌های نام‌گذاری‌شده طبق
.I FORMAT
(پیش‌فرض "distcc%d" است؛ ببینید
.BR printf (3))
و با شروع از ۱ (مانند میزبان‌های distcc1، distcc2 و غیره) را پایش می‌کند.
پس از ۷ ثانیه یا با نخستین نام میزبانی که تحلیل نشود (resolve نشود)، متوقف می‌شود.
نام تمامی چنین کارسازهایی را که به درگاه distcc گوش می‌دهند، چاپ می‌کند.

اگر فهرستی از نام‌های میزبان در خط فرمان داده شود،
.B lsdistcc
تنها همان میزبان‌ها را بررسی خواهد کرد.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B --help
نمایش خلاصه دستورالعمل‌ها

.TP
.B -l
خروجی دادن میزان تأخیر (latency) بر حسب میلی‌ثانیه پس از هر نام میزبان
(بدون احتساب تأخیر DNS)

.TP
.B -n
چاپ نشانی IP به جای نام میزبان

.TP
.B -x
الحاق ,down به میزبان‌های غیرفعال (down) در فهرست میزبان‌ها

.TP
.BI -t "TIMEOUT"
تعیین تعداد ثانیه‌ها برای متوقف کردن جستجو [پیش‌فرض: ۷]

.TP
.BI -h "HTIMEOUT"
تعیین تعداد میلی‌ثانیه‌ها پیش از تلاش مجدد برای gethostbyname [پیش‌فرض: ۵۰۰]

.TP
.BI -c "CTIMEOUT"
تعیین تعداد میلی‌ثانیه‌ها پیش از انصراف از اتصال [پیش‌فرض: ۹۰۰]
(مقدار ۰ برای جلوگیری از اتصال)

.TP
.BI -k "KTIMEOUT"
تعیین تعداد میلی‌ثانیه‌ها پیش از انصراف از کامپایل [پیش‌فرض: ۱۵۰۰]
(مقدار ۰ برای جلوگیری از کامپایل)

.TP
.BI -m "BITS"
تعیین تعداد بیت‌های نشانی که باید با نخستین میزبان یافت‌شده همخوانی داشته باشد [پیش‌فرض: ۰]

.TP
.BI -o "OVERLAP"
تعیین تعداد درخواست‌های اضافی DNS برای ارسال [پیش‌فرض: ۱]

.TP
.BI -g "DNSGAP"
تعیین تعداد ورودی‌های ناموجود DNS قابل تحمل [پیش‌فرض: ۰]

.TP
.BI -r "PORT"
درگاه (پورت) برای اتصال [پیش‌فرض: ۳۶۳۲]

.TP
.BI -P "PROTOCOL"
نسخه پروتکل مورد استفاده (۱-۳) [پیش‌فرض: ۱]

.TP
.BI -p "COMPILER"
نام کامپایلر مورد استفاده [پیش‌فرض: none]

.TP
.B -d
الحاق نام دامنه DNS به قالب

.TP
.B -v
حالت پرگو (verbose)

.SH "مثال‌ها (EXAMPLES)"
پایش کارسازهایی با نام‌های distcc1، distcc2، ...
که کامپایلری با نام gcc-4.6 ارائه می‌دهند
و گنجاندن تأخیر آن‌ها در خروجی:

.RS
$ lsdistcc \-l \-pgcc-4.6
.RE

پایش برای کامپایلری به نام gcc-4.6 روی کارسازهای hosta، somehost، hostx و hosty:

.RS
$ lsdistcc \-pgcc-4.6 hosta somehost hostx hosty
.RE

برای استفاده از برنامه در یک اسکریپت ساخت، خطوط زیر را اضافه کنید:

.RS
DISTCC_HOSTS=`lsdistcc`
.br
export DISTCC_HOSTS
.RE

پیش از خطی که make را فراخوانی می‌کند.
یا در یک Makefile، خط زیر را وارد کنید:

.RS
export DISTCC_HOSTS = $(shell lsdistcc)
.RE

یا از
.BR pump (1)
استفاده کنید که در صورت تنظیم متغیر DISTCC_POTENTIAL_HOSTS، به‌طور خودکار lsdistcc را فراخوانی می‌کند.

.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج در صورت یافتن هر کارساز برابر ۰، و در غیر این صورت ۱ است.
.PP
از دستور 'for i=1... sprintf(format, i)' برای ساخت نام کارسازها استفاده می‌کند،
پس از ۷ ثانیه یا در دومین کارسازی که تحلیل نشود متوقف می‌شود،
و نام تمام چنین کارسازهایی را که به درگاه distcc گوش می‌دهند چاپ می‌کند.
قالب پیش‌فرض distcc%d است.

.SH "همچنین ببینید (SEE ALSO)"
.BR distcc (1),
.BR distccd (1),
.BR pump (1),
.BR printf (3)

.I http://code.google.com/p/distcc

.SH "نویسنده (AUTHOR)"
.B lsdistcc
توسط Dan Kegel، Dongmin Zhang و Manos Renieris نوشته شده است.
.PP
این صفحه راهنما توسط Daniel Hartwig برای پروژه دبیان نوشته شده است.