.TH SPAWN 8
.ad
.fi
.SH "نام (NAME)"
spawn \- اجراکننده دستورات خارجی در Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBspawn\fR [generic Postfix daemon options] command_attributes...
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
دیمن \fBspawn\fR(8) بر یک سوکت جریانی (stream socket) از نوع TCP یا UNIX\-domain که در \fBmaster.cf\fR با نوع سرویس \fBinet\fR یا \fBunix\fR پیکربندی شده است، نظارت می‌کند.

این دیمن هنگام برقراری هر اتصال، یک دستور خارجی را اجرا می‌کند (spawn)، به‌طوری که توصیف‌کننده‌های فایل ورودی، خروجی و خطای استاندارد آن به کلاینت راه دور متصل می‌شوند.

فرآیند دستور تابع محدودیت زمانی تعیین‌شده با پارامتر \fItransport\fR_time_limit (پیش‌فرض: command_time_limit) است که در آن \fItransport\fR برابر با فیلد نام سرویس در master.cf می‌باشد. فرآیندی که از این محدودیت زمانی فراتر رود، سیگنال SIGKILL دریافت خواهد کرد.

سرویس دیمن \fBspawn\fR(8) معمولاً در تعریف سرویس خود در \fBmaster.cf\fR دارای محدودیت فرآیند (process limit) بزرگ‌تر از ۱ است، تا تعداد فرآیندها متناسب با تقاضا افزایش یابد.
.SH "نحو ویژگی‌های دستور (COMMAND ATTRIBUTE SYNTAX)"
.na
.nf
.ad
.fi
ویژگی‌های دستور خارجی در فایل \fBmaster.cf\fR در انتهای تعریف سرویس مشخص می‌شوند. نحو آن به شرح زیر است:
.IP "\fBuser\fR=\fIusername\fR (الزامی)"
.IP "\fBuser\fR=\fIusername\fR:\fIgroupname\fR"
دستور خارجی با دسترسی‌های \fIusername\fR مشخص‌شده اجرا می‌شود. نرم‌افزار از اجرای دستورات با دسترسی‌های ریشه (root) یا با دسترسی‌های مالک سامانه ایمیل خودداری می‌کند. اگر \fIgroupname\fR مشخص شود، شناسه گروه (group ID) متناظر به جای شناسه گروه \fIusername\fR استفاده می‌شود.
.IP "\fBargv\fR=\fIcommand\fR... (الزامی)"
دستوری که باید اجرا شود. این ویژگی باید به عنوان آخرین ویژگی دستور مشخص گردد.
دستور مستقیماً اجرا می‌شود، یعنی بدون تفسیر نویسه‌های فرامعمول شل (shell meta characters) توسط یک مفسر دستورات شل.
.sp
اگر یکی از آرگومان‌های دستور باید حاوی فاصله سفید باشد، یا اگر یک آرگومان دستور باید با "{" آغاز شود، آرگومان را درون "{" و "}" محصور کنید. این قالب، فاصله‌های سفید بعد از "{" بیرونی و قبل از "}" بیرونی را نادیده می‌گیرد. مثال:
.sp
.fi
    argv=/bin/sh \-c { shell syntax here }
.SH "عیب‌یابی (DIAGNOSTICS)"
.ad
.fi
دیمن \fBspawn\fR(8) خروج‌های غیرعادی فرآیندهای فرزند را گزارش می‌کند.
مشکلات در \fBsyslogd\fR(8) یا \fBpostlogd\fR(8) ثبت می‌شوند.
.SH "امنیت (SECURITY)"
.na
.nf
.fi
.ad
دیمن \fBspawn\fR(8) برای اجرای دستورات خارجی در قالب کاربر مشخص‌شده، به دسترسی ریشه (root) نیاز دارد. بنابراین از نظر امنیتی حساس است.

با این حال، دیمن \fBspawn\fR(8) داده‌ای را از یا درباره کلاینت‌های سرویس یا دستورات خارجی دریافت نمی‌کند، و بنابراین در برابر حملات مبتنی بر داده (data\-driven) آسیب‌پذیر نیست.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
تغییرات در \fBmain.cf\fR به‌طور خودکار اعمال می‌شوند، زیرا فرآیندهای \fBspawn\fR(8) تنها برای مدت زمان محدودی اجرا می‌گردند. برای تسریع در اعمال تغییرات از دستور "\fBpostfix reload\fR" استفاده کنید.

متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر شامل مثال‌ها به \fBpostconf\fR(5) مراجعه کنید.

در متن زیر، \fItransport\fR نخستین فیلد ورودی در فایل \fBmaster.cf\fR است.
.SH "کنترل منابع و نرخ (RESOURCE AND RATE CONTROL)"
.na
.nf
.ad
.fi
.IP "\fBtransport_time_limit ($command_time_limit)\fR"
یک مقدار جایگزین ویژه روش انتقال برای مقدار پارامتر command_time_limit، که در آن \fItransport\fR نام روش انتقال تحویل پیام در master.cf است.
.SH "متفرقه (MISCELLANEOUS)"
.na
.nf
.ad
.fi
.IP "\fBconfig_directory (خروجی 'postconf \-d' را ببینید)\fR"
مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
.IP "\fBdaemon_timeout (18000s)\fR"
حداکثر زمانی که یک فرآیند دیمن Postfix مجاز است برای رسیدگی به یک درخواست صرف کند، پیش از آن‌که توسط تایمر نگهبان داخلی (watchdog) متوقف شود.
.IP "\fBexport_environment (خروجی 'postconf \-d' را ببینید)\fR"
فهرست متغیرهای محیطی که یک فرآیند Postfix به فرآیندهای غیر Postfix صادر می‌کند.
.IP "\fBipc_timeout (3600s)\fR"
محدودیت زمانی برای ارسال یا دریافت اطلاعات از طریق یک کانال ارتباطی داخلی.
.IP "\fBmail_owner (postfix)\fR"
حساب کاربری یونیکس که مالک صف Postfix و اکثر فرآیندهای دیمن Postfix است.
.IP "\fBmax_idle (100s)\fR"
حداکثر مدت زمانی که یک فرآیند دیمن بیکار Postfix برای یک اتصال ورودی منتظر می‌ماند پیش از آن‌که به صورت داوطلبانه خاتمه یابد.
.IP "\fBmax_use (100)\fR"
حداکثر تعداد اتصالات ورودی که یک فرآیند دیمن Postfix پیش از توقف داوطلبانه به آن‌ها سرویس می‌دهد.
.IP "\fBprocess_id (فقط\-خواندنی)\fR"
شناسه فرآیند (PID) یک دستور یا فرآیند دیمن Postfix.
.IP "\fBprocess_name (فقط\-خواندنی)\fR"
نام فرآیند یک دستور یا فرآیند دیمن Postfix.
.IP "\fBqueue_directory (خروجی 'postconf \-d' را ببینید)\fR"
مکان دایرکتوری سطح بالای صف Postfix.
.IP "\fBsyslog_facility (mail)\fR"
تسهیلات syslog برای ثبت وقایع Postfix.
.IP "\fBsyslog_name (خروجی 'postconf \-d' را ببینید)\fR"
پیشوندی که به ابتدای نام فرآیند در رکوردهای syslog افزوده می‌شود، به‌طوری که برای مثال "smtpd" به "prefix/smtpd" تبدیل می‌شود.
.PP
موجود در Postfix نسخه 3.3 و بالاتر:
.IP "\fBservice_name (فقط\-خواندنی)\fR"
نام سرویس در master.cf برای یک فرآیند دیمن Postfix.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
postconf(5), configuration parameters
master(8), process manager
postlogd(8), Postfix logging
syslogd(8), system logging
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "نویسندگان (AUTHORS)"
.na
.nf
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA

Wietse Venema
Google, Inc.
111 8th Avenue
New York, NY 10011, USA