'\" t
.TH "SYSTEMD\-ESCAPE" "1" "" "systemd 261.2" "systemd-escape"
.\" -----------------------------------------------------------------
.\" * 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-escape \- اسکیپ کردن رشته‌ها برای استفاده در نام واحدهای سیستم‌دی
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-escape\fR\ 'u
\fBsystemd\-escape\fR [OPTIONS...] [STRING...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-escape\fR
می‌تواند برای اسکیپ کردن رشته‌ها جهت گنجاندن در نام واحدهای سیستم‌دی استفاده شود\&. این دستور می‌تواند برای اسکیپ کردن و همچنین لغو اسکیپ (unescape) رشته‌ها به کار رود\&.
.PP
این دستور هر تعداد رشته را در خط فرمان می‌پذیرد و آن‌ها را به صورت جداگانه، یکی پس از دیگری پردازش می‌کند\&. خروجی آن‌ها با فاصله جدا شده و در خروجی استاندارد (stdout) چاپ می‌شود\&.
.PP
به‌طور پیش‌فرض، این دستور رشته‌های دریافت‌شده را اسکیپ می‌کند، مگر اینکه
\fB\-\-unescape\fR
ارسال شود که منجر به اعمال عملیات معکوس می‌گردد\&. اگر
\fB\-\-mangle\fR
داده شود، در عوض حالت ویژه‌ای از اسکیپ کردن اعمال می‌شود که فرض می‌کند رشته از قبل اسکیپ شده است اما هر آنچه را که آشکارا اسکیپ‌نشده به نظر می‌رسد اسکیپ می‌کند\&.
.PP
برای جزئیات بیشتر درباره الگوریتم‌های اسکیپ کردن و لغو اسکیپ، به بخش مربوطه در
\fBsystemd.unit\fR(5)
مراجعه کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-suffix=\fR
.RS 4
پسوند نوع واحد مشخص‌شده را به انتهای رشته اسکیپ‌شده اضافه می‌کند\&. یکی از انواع واحدهای پشتیبانی‌شده توسط سیستم‌دی را می‌پذیرد، مانند
"service"
یا
"mount"\&.
نمی‌تواند همراه با
\fB\-\-template=\fR,
\fB\-\-unescape\fR
یا
\fB\-\-mangle\fR
استفاده شود\&.
.sp
افزوده‌شده در نسخه 216\&.
.RE
.PP
\fB\-\-template=\fR
.RS 4
رشته‌های اسکیپ‌شده را در یک قالب (تمپلیت) نام واحد وارد می‌کند\&. یک قالب نام واحد مانند
foobar@\&.service
را می‌پذیرد\&. همراه با
\fB\-\-unescape\fR,
انتظار نام‌های واحد نمونه‌سازی‌شده (instantiated) را برای این قالب دارد و فقط بخش نمونه (instance) را استخراج کرده و از حالت اسکیپ خارج می‌کند\&. نمی‌تواند همراه با
\fB\-\-suffix=\fR,
\fB\-\-instance\fR
یا
\fB\-\-mangle\fR
استفاده شود\&.
.sp
افزوده‌شده در نسخه 216\&.
.RE
.PP
\fB\-\-path\fR, \fB\-p\fR
.RS 4
هنگام اسکیپ کردن یا لغو اسکیپ یک رشته، فرض می‌کند که رشته به یک مسیر فایل‌سیستم اشاره دارد\&. این کار مسیر را ساده‌سازی می‌کند (کاراکترهای
"/"
ابتدایی، انتهایی و تکراری حذف می‌شوند، اجزای مسیر بی‌اثر
"\&."
حذف می‌شوند، و برای مسیرهای مطلق، اجزای
"\&.\&."
ابتدایی حذف می‌گردند)\&. پس از ساده‌سازی، مسیر نباید شامل
"\&.\&."
باشد\&.
.sp
این گزینه به ویژه برای تولید رشته‌های مناسب جهت لغو اسکیپ با مشخص‌کننده
"%f"
در فایل‌های واحد مفید است؛
\fBsystemd.unit\fR(5)
را ببینید\&.
.sp
افزوده‌شده در نسخه 216\&.
.RE
.PP
\fB\-\-unescape\fR, \fB\-u\fR
.RS 4
به جای اسکیپ کردن رشته‌های مشخص‌شده، اسکیپ آن‌ها را لغو کرده و عملیات را معکوس می‌کند\&. نمی‌تواند همراه با
\fB\-\-suffix=\fR
یا
\fB\-\-mangle\fR
استفاده شود\&.
.sp
افزوده‌شده در نسخه 216\&.
.RE
.PP
\fB\-\-mangle\fR, \fB\-m\fR
.RS 4
مانند
\fB\-\-escape\fR
است، اما فقط کاراکترهایی را اسکیپ می‌کند که مشخصاً هنوز اسکیپ نشده‌اند و در صورت امکان به طور خودکار پسوند نوع واحد مناسب را به انتهای رشته اضافه می‌کند\&. نمی‌تواند همراه با
\fB\-\-suffix=\fR,
\fB\-\-template=\fR
یا
\fB\-\-unescape\fR
استفاده شود\&.
.sp
افزوده‌شده در نسخه 216\&.
.RE
.PP
\fB\-\-instance\fR
.RS 4
همراه با
\fB\-\-unescape\fR,
تنها بخش نمونه (instance) از یک قالب نام واحد نمونه‌سازی‌شده را از حالت اسکیپ خارج کرده و چاپ می‌کند\&. برای قالب‌های نمونه‌سازی‌نشده مانند
ssh@\&.service
یا نام‌های غیرقالبی مانند
ssh\&.service
منجر به خطا می‌شود\&. باید همراه با
\fB\-\-unescape\fR
استفاده شود و نمی‌تواند همراه با
\fB\-\-template\fR
به کار رود\&.
.sp
افزوده‌شده در نسخه 240\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای اسکیپ کردن یک رشته منفرد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-escape \*(AqHallöchen, Meister\*(Aq
Hall\exc3\exb6chen\ex2c\ex20Meister
.fi
.if n \{\
.RE
.\}
.PP
برای لغو اسکیپ یک رشته منفرد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-escape \-u \*(AqHall\exc3\exb6chen\ex2c\ex20Meister\*(Aq
Hallöchen, Meister
.fi
.if n \{\
.RE
.\}
.PP
برای تولید واحد مانت برای یک مسیر:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-escape \-p \-\-suffix=mount "/tmp//waldi/foobar/"
tmp\-waldi\-foobar\&.mount
.fi
.if n \{\
.RE
.\}
.PP
برای تولید نام‌های نمونه از سه رشته:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-escape \-\-template=systemd\-nspawn@\&.service \*(AqMy Container 1\*(Aq \*(Aqcontainerb\*(Aq \*(Aqcontainer/III\*(Aq
systemd\-nspawn@My\ex20Container\ex201\&.service systemd\-nspawn@containerb\&.service systemd\-nspawn@container\-III\&.service
.fi
.if n \{\
.RE
.\}
.PP
برای استخراج بخش نمونه از یک واحد نمونه‌سازی‌شده:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-escape \-u \-\-instance \*(Aqsystemd\-nspawn@My\ex20Container\ex201\&.service\*(Aq
My Container 1
.fi
.if n \{\
.RE
.\}
.PP
برای استخراج بخش نمونه از یک نمونه از قالبی خاص:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-escape \-u \-\-template=systemd\-nspawn@\&.service \*(Aqsystemd\-nspawn@My\ex20Container\ex201\&.service\*(Aq
My Container 1
.fi
.if n \{\
.RE
.\}
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت، 0 بازگردانده می‌شود، در غیر این صورت یک کد خطای غیر صفر برگردانده خواهد شد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd.unit\fR(5), \fBsystemctl\fR(1)