.TH pump 1 "9 June 2008"
.SH "نام (NAME)"
pump \- شتاب‌بخشی به کامپایل از راه دور با distcc
.SH "خلاصه دستور (SYNOPSIS)"
.B pump
.I BUILD-COMMAND [ARGS]
\& ...
.BR
.PP
eval `
.B pump
--startup `;
.I BUILD-COMMAND [ARGS]
\& ...
;
.B pump
--shutdown
.BR
.SH "توضیحات (DESCRIPTION)"
دستور
.B pump
بخشی از distcc است.
این دستور برای حالت pump در distcc استفاده می‌شود.
حالت pump در distcc با توزیع پیش‌پردازش به سرورها، به کامپایل از راه دور با distcc شتاب می‌بخشد.
.PP
برای توضیحات دقیق درباره حالت pump، به‌ویژه برخی
.B محدودیت‌های مهم،
صفحه راهنمای
.BR distcc(1)
را ببینید، به ویژه بخش
.B HOW PUMP-MODE WORKS
و بخش
.BR "RESTRICTIONS ON PUMP MODE" .
.PP
ساده‌ترین روش استفاده به صورت زیر است:
.RS
.B pump
.I COMMAND [ARG]
\& ...
.RE
این کار یک include server برای حالت «pump» در distcc راه‌اندازی می‌کند؛
در صورت نیاز
.B lsdistcc
را برای محاسبه فهرست میزبان‌های distcc اجرا می‌کند؛
برخی متغیرهای محیطی کمکی را تنظیم می‌کند؛
متغیر PATH را تغییر می‌دهد تا از کلاینت distcc در همان دایرکتوری اسکریپت «pump» استفاده کند؛
دستور
.I COMMAND
را با
.IR ARG(s)
مشخص‌شده اجرا می‌کند؛
و سپس include server را خاموش می‌کند.
دستور
.I COMMAND
معمولاً یک دستور ساخت موازی مانند «make -j80» است که فراخوانی‌های هم‌روند بسیاری از distcc را انجام خواهد داد.
.PP
یک روش جایگزین برای اجرای
.B pump
فراخوانی صریح «pump --startup» برای راه‌اندازی include server و «pump --shutdown» برای متوقف کردن include server است.
دستور «pump --startup» سرور include server را راه‌اندازی کرده و تنظیمات چند متغیر محیطی را در خروجی چاپ می‌کند. این متغیرهای محیطی برای برقراری ارتباط بین کلاینت حالت pump در «distcc» و include server، و همچنین برای ارتباط میان «pump --startup» و «pump --shutdown» استفاده می‌شوند.
فراخوانندهٔ «pump --startup» مسئول تنظیم این متغیرهای محیطی پیش از اجرای «distcc» یا «pump --shutdown» است.
.PP
برای مثال:
.RS
eval `pump --startup`
.br
make -j80
.br
pump --shutdown
.RE
.PP
توجه داشته باشید که حالت pump در distcc فرض می‌کند که فایل‌های منبع در طول چرخه حیات include server تغییر نخواهند کرد؛ بنابراین تغییر فایل‌های منبع در حین ساخت ممکن است منجر به نتایج متناقض شود.
.SH "فراخوانی LSDISTCC (INVOKING LSDISTCC)"
هنگامی که به شکل سادهٔ «
.B pump
.I COMMAND [ARG]
\&... »
یا به صورت «
.B pump --startup
\&» فراخوانی شود، اسکریپت
.B pump
هر زمان که DISTCC_POTENTIAL_HOSTS تنظیم شده باشد و DISTCC_HOSTS تنظیم نشده باشد،
.B lsdistcc
را فراخوانی خواهد کرد. این اسکریپت مقدار DISTCC_POTENTIAL_HOSTS را به
.B lsdistcc
ارسال کرده و از خروجی
.B lsdistcc
برای تنظیم DISTCC_HOSTS استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 
.B --help
دستورالعمل‌های خلاصه را نمایش می‌دهد.
.TP
.B --startup
یک include server را راه‌اندازی کرده و تنظیمات متغیرهای محیطی مورد نیاز برای دسترسی
.BR distcc(1)
یا
.B pump --shutdown
به آن را در خروجی چاپ می‌کند.
.TP
.B --shutdown
یک include server را که با
.B pump --startup
راه‌اندازی شده است خاموش می‌کند.
.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی زیر همگی اختیاری هستند.
.TP
.B DISTCC_LOCATION
مکان دایرکتوری bin در distcc، که به‌طور معمول از دایرکتوری پیوند-حل‌شدهٔ argv[0] استنباط می‌شود. اگر این مکان در واقع دایرکتوری bin داخل یک مسیر نصب باشد (همان‌طور که هنگام اجرای اسکریپت pump در محل نصب رخ می‌دهد)، فایل‌های اجرایی Python و خود distcc از دایرکتوری والد این مکان بازیابی خواهند شد.
.TP
.B "DISTCC_MAX_DISCREPANCY"
صفحه راهنمای
.BR distcc(1)
را ببینید.
.TP
.B DISTCC_POTENTIAL_HOSTS
سرورهای distcc که برای تولید مقداری برای DISTCC_HOSTS توسط lsdistcc پرس‌وجو می‌شوند. این مقدار می‌تواند تنظیم‌نشده یا خالی (null) باشد. در چنین مواردی، lsdistcc فراخوانی نخواهد شد و distcc از DISTCC_HOSTS یا فایل پیکربندی میزبان‌های distcc استفاده خواهد کرد، همان‌طور که در بخش «Host Specifications» از
.BR distcc(1)
توضیح داده شده است.
.TP
.B DISTCC_HOSTS
این متغیر به distcc منتقل می‌شود اما تنها در صورتی که DISTCC_POTENTIAL_HOSTS تنظیم نشده باشد.
.TP
.B LSDISTCC_ARGS
آرگومان‌های اضافی برای ارسال به lsdistcc. برای جزئیات بیشتر به
.B lsdistcc --help
مراجعه کنید.
.TP
.B INCLUDE_SERVER_ARGS
آرگومان‌های اضافی برای ارسال به include server.
.TP
.B PYTHONOPTIMIZE
اگر روی "" تنظیم شود، بهینه‌سازی پایتون غیرفعال می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.B pump make -j20
.SH "گزارش باگ‌ها (BUGS)"
.\" TODO:
.\" Fix inconsistency between BUGS section and bug reporting instructions
.\" in the AUTHORS section, both here and in distcc.1 and elsewhere.
اگر فکر می‌کنید باگی در distcc پیدا کرده‌اید، لطفاً برای اطلاعات در مورد نحوه گزارش آن، فایل
.I reporting-bugs.txt
را در دایرکتوری مستندات ببینید.
.SH "نویسندگان (AUTHORS)"
اسکریپت pump و حالت pump در distcc توسط Nils Klarlund،
Manos Renieris، Fergus Henderson، و Craig Silverstein نوشته شده‌اند. لطفاً باگ‌ها را به <distcc@lists.samba.org> گزارش دهید.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.B pump
بخشی از distcc است.
شما مجاز به استفاده از distcc هستید. distcc (شامل این راهنما) تنها تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ یا بالاتر می‌تواند کپی، اصلاح یا توزیع شود. distcc بدون هیچ‌گونه ضمانتی ارائه می‌شود. نسخه‌ای از GPL در فایل COPYING گنجانده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.\" TODO: add lsdistcc(1) once we have a man page for lsdistcc.
\fBdistcc\fR(1)، \fBdistccd\fR(1)، \fBinclude_server\fR(1)، \fBgcc\fR(1)، و
\fBmake\fR(1)