'\" t
.TH "SYSTEMD\-ESCAPE" "1" "" "systemd 231" "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 "描述"
.PP
\fBsystemd\-escape\fR
可用於 轉義單元名稱中的特殊字符， 也可用於還原操作。
.PP
可以在命令行上指定任意數量的字符串， 表示依次分別處理它們。 處理結果將使用空格分隔。
.PP
默認的行爲是轉義操作， 但若使用了
\fB\-\-unescape\fR
選項， 則表示反向的還原操作。如果使用了
\fB\-\-mangle\fR
選項， 則會使用一種特殊的轉義規則， 也就是假定字符串已經經過了轉義， 僅轉義那些顯而易見必須轉義的字符。
.SH "選項"
.PP
能夠識別的命令行選項如下：
.PP
\fB\-\-suffix=\fR
.RS 4
在輸出結果尾部添加一個單元類型後綴。 必須是
"\&.service"
或
"\&.mount"
這樣實際有效的後綴。不能與
\fB\-\-template=\fR,
\fB\-\-unescape\fR
,
\fB\-\-mangle\fR
選項一起使用。
.RE
.PP
\fB\-\-template=\fR
.RS 4
將轉義之後的結果插入一個單元名稱模版。 接收一個類似
foobar@\&.service
這樣的模版名。 不能與
\fB\-\-suffix=\fR,
\fB\-\-unescape\fR,
\fB\-\-mangle\fR
選項一起使用。
.RE
.PP
\fB\-\-path\fR, \fB\-p\fR
.RS 4
在轉義或還原字符串時， 假定其是一個文件系統路徑。 這將會對字符串頭的
"/"
字符進行特殊處理。
.RE
.PP
\fB\-\-unescape\fR
.RS 4
將已經轉義過的字符串還原。 不能與
\fB\-\-suffix=\fR,
\fB\-\-template=\fR,
\fB\-\-mangle\fR
選項一起使用。
.RE
.PP
\fB\-\-mangle\fR
.RS 4
與
\fB\-\-escape\fR
類似， 但是僅轉義那些顯而易見必須轉義的字符， 並且允許自動添加適當的單元類型後綴。 不能與
\fB\-\-suffix=\fR,
\fB\-\-template=\fR,
\fB\-\-unescape\fR
選項一起使用。
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
顯示簡短的幫助信息並退出。
.RE
.PP
\fB\-\-version\fR
.RS 4
顯示簡短的版本信息並退出。
.RE
.SH "例子"
.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
.\}
.SH "退出狀態"
.PP
返回值爲 0 表示成功， 非零返回值表示失敗代碼。
.SH "參見"
.PP
\fBsystemd\fR(1),
\fBsystemctl\fR(1)
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.PP
翻譯人員：金步國
.br
金步國作品集：http://www.jinbuguo.com
.br
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR