'\" t
.TH "SYSTEMD\-SOCKET\-ACTIVATE" "1" "" "systemd 261.2" "systemd-socket-activate"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-socket-activate \- آزمایش فعال‌سازی سوکت برای دیمن‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-socket\-activate\fR\ 'u
\fBsystemd\-socket\-activate\fR [OPTIONS...] \fICOMMAND\fR\ [ARGS...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-socket\-activate\fR
می‌تواند برای راه‌اندازی یک برنامه سرویس فعال‌شونده با سوکت از خط فرمان جهت اهداف آزمایشی استفاده شود\&. همچنین می‌تواند برای راه‌اندازی نمونه‌های مجزای برنامه سرویس به ازای هر اتصال به کار رود\&.
.PP
دیمن مورد نظر برای راه‌اندازی و گزینه‌های آن باید پس از گزینه‌های در نظر گرفته شده برای
\fBsystemd\-socket\-activate\fR
مشخص شوند\&.
.PP
اگر گزینه
\fB\-\-inetd\fR
داده شود، توصیف‌کننده فایل سوکت به عنوان ورودی و خروجی استاندارد فرآیند راه‌اندازی‌شده استفاده خواهد شد\&. در غیر این صورت، ورودی و خروجی استاندارد به ارث برده می‌شوند و سوکت‌ها از طریق توصیف‌کننده‌های فایل ۳ و بالاتر منتقل خواهند شد\&. سوکت‌هایی که از طریق
\fI$LISTEN_FDS\fR
به
\fBsystemd\-socket\-activate\fR
منتقل می‌شوند، در همان موقعیت‌های اصلی به دیمن منتقل خواهند شد\&. سایر سوکت‌های مشخص‌شده با
\fB\-\-listen=\fR
از توصیف‌کننده‌های متوالی استفاده خواهند کرد\&. به طور پیش‌فرض،
\fBsystemd\-socket\-activate\fR
روی یک سوکت جریانی (stream socket) گوش فرا می‌دهد؛ برای گوش دادن روی سوکت‌های دیتاگرام (datagram) یا بسته‌ای ترتیبی (sequential packet) به جای آن، از
\fB\-\-datagram\fR
و
\fB\-\-seqpacket\fR
استفاده کنید (زیر را ببینید)\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-l \fR\fB\fIaddress\fR\fR, \fB\-\-listen=\fR\fB\fIaddress\fR\fR
.RS 4
روی این
\fIaddress\fR (نشانی)
گوش فرا می‌دهد\&. رشته‌ای مانند
"2000"
یا
"127\&.0\&.0\&.1:2001"
را می‌پذیرد\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.PP
\fB\-a\fR, \fB\-\-accept\fR
.RS 4
برای هر اتصال، یک نمونه از برنامه سرویس را راه‌اندازی کرده و سوکت اتصال را منتقل می‌کند\&. نباید با
\fB\-\-now\fR
ترکیب شود\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.PP
\fB\-d\fR, \fB\-\-datagram\fR
.RS 4
به جای یک سوکت جریانی (\fBSOCK_STREAM\fR)، روی یک سوکت دیتاگرام (\fBSOCK_DGRAM\fR) گوش فرا می‌دهد\&. نباید با
\fB\-\-seqpacket\fR
ترکیب شود\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.PP
\fB\-\-seqpacket\fR
.RS 4
به جای یک سوکت جریانی (\fBSOCK_STREAM\fR)، روی یک سوکت بسته‌ای ترتیبی (\fBSOCK_SEQPACKET\fR) گوش فرا می‌دهد\&. نباید با
\fB\-\-datagram\fR
ترکیب شود\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.PP
\fB\-\-inetd\fR
.RS 4
از پروتکل inetd برای انتقال توصیف‌کننده‌های فایل استفاده می‌کند، یعنی به عنوان ورودی استاندارد و خروجی استاندارد، به جای پروتکل سبک جدید برای انتقال توصیف‌کننده‌های فایل با استفاده از
\fI$LISTEN_FDS\fR
(بالا را ببینید)\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.PP
\fB\-E \fR\fB\fIVAR\fR\fR\fB[=\fIVALUE\fR]\fR, \fB\-\-setenv=\fR\fB\fIVAR\fR\fR\fB[=\fIVALUE\fR]\fR
.RS 4
این متغیر را به محیط فرآیند راه‌اندازی‌شده اضافه می‌کند\&. اگر پس از
\fIVAR\fR
علامت
"="
بیاید، فرض می‌شود که یک جفت متغیر\(enمقدار است\&. در غیر این صورت، مقدار را از محیط خود
\fBsystemd\-socket\-activate\fR
به دست می‌آورد\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.PP
\fB\-\-fdname=\fR\fB\fINAME\fR\fR\fB[:\fINAME\fR\&...]\fR
.RS 4
نام‌هایی را برای توصیف‌کننده‌های فایل منتقل‌شده مشخص می‌کند\&. این معادل تنظیم
\fIFileDescriptorName=\fR
در فایل‌های واحد سوکت است و امکان استفاده از
\fBsd_listen_fds_with_names\fR(3)
را فراهم می‌سازد\&. چندین ورودی را می‌توان با استفاده از گزینه‌های جداگانه یا با جدا کردن نام‌ها با دونقطه (":") در یک گزینه مشخص کرد\&. در صورتی که نام‌های داده‌شده بیشتر از توصیف‌کننده‌ها باشد، موارد اضافی نادیده گرفته خواهند شد\&. در صورتی که نام‌های داده‌شده کمتر از توصیف‌کننده‌ها باشد، توصیف‌کننده‌های فایل باقی‌مانده بدون نام خواهند بود\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.PP
\fB\-\-now\fR
.RS 4
برنامه سرویس را فوراً شروع می‌کند، به جای اینکه منتظر اتصال روی سوکت(ها) بماند\&. نباید با
\fB\-\-accept\fR
ترکیب شود\&.
.sp
در نسخه 258 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fI$LISTEN_FDS\fR, \fI$LISTEN_PID\fR, \fI$LISTEN_PIDFDID\fR, \fI$LISTEN_FDNAMES\fR
.RS 4
به
\fBsd_listen_fds\fR(3)
مراجعه کنید\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.PP
\fI$SYSTEMD_LOG_TARGET\fR, \fI$SYSTEMD_LOG_LEVEL\fR, \fI$SYSTEMD_LOG_TIME\fR, \fI$SYSTEMD_LOG_COLOR\fR, \fI$SYSTEMD_LOG_LOCATION\fR
.RS 4
همانند
\fBsystemd\fR(1)\&.
.sp
در نسخه 230 اضافه شد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&1.\ \&اجرای یک سرور echo روی درگاه 2000\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-socket\-activate \-l 2000 \-\-inetd \-a cat
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&2.\ \&اجرای یک نمونه فعال‌شونده با سوکت از systemd-journal-gatewayd(8)\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-socket\-activate \-l 19531 /usr/lib/systemd/systemd\-journal\-gatewayd
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd.socket\fR(5), \fBsystemd.service\fR(5), \fBsystemd-run\fR(1), \fBsd_listen_fds\fR(3), \fBsd_listen_fds_with_names\fR(3), \fBcat\fR(1)