'\" t
.TH "SYSTEMD\-CAT" "1" "" "systemd 231" "systemd-cat"
.\" -----------------------------------------------------------------
.\" * 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-cat \- 通向系統日誌的管道
.SH "SYNOPSIS"
.HP \w'\fBsystemd\-cat\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[COMMAND]\fR\fB\ \fR\fB[ARGUMENTS...]\fR\ 'u
\fBsystemd\-cat \fR\fB[OPTIONS...]\fR\fB \fR\fB[COMMAND]\fR\fB \fR\fB[ARGUMENTS...]\fR
.HP \w'\fBsystemd\-cat\ \fR\fB[OPTIONS...]\fR\ 'u
\fBsystemd\-cat \fR\fB[OPTIONS...]\fR
.SH "描述"
.PP
\fBsystemd\-cat\fR
可以將標準輸入重定向到系統日誌中， 也可以將進程的標準輸出與標準錯誤重定向到系統日誌中， 還可以用作管道過濾器， 將捕獲的其他進程的標準輸出重定向到系統日誌中。
.PP
如果未指定任何
[COMMAND]
參數，那麼
\fBsystemd\-cat\fR
將會把它從標準輸入讀取到的所有內容 重定向到系統日誌中。
.PP
如果傳遞了
[COMMAND]
參數， 那麼將會把
[COMMAND]
進程的標準輸出與標準錯誤重定向到系統日誌中。
.SH "選項"
.PP
能夠識別的命令行選項如下：
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
顯示簡短的幫助信息並退出。
.RE
.PP
\fB\-\-version\fR
.RS 4
顯示簡短的版本信息並退出。
.RE
.PP
\fB\-t\fR, \fB\-\-identifier=\fR
.RS 4
設置一個短字符串， 用作日誌的來源標誌。 默認值是"unknown"。
.RE
.PP
\fB\-p\fR, \fB\-\-priority=\fR
.RS 4
指定日誌消息的默認日誌等級。 可設爲
"emerg",
"alert",
"crit",
"err",
"warning",
"notice",
"info",
"debug"
之一， 或者與上述日誌等級對應的 0 到 7 之間的整數。 詳見
\fBsyslog\fR(3)
手冊。 默認值是
"info"
等級。 注意，此選項僅設置默認的日誌等級， 通過開啓
\fB\-\-level\-prefix=\fR
選項， 某些特定的行可以使用不同的日誌等級。
.RE
.PP
\fB\-\-level\-prefix=\fR
.RS 4
是否解析傳統的 syslog 日誌等級前綴。 必須指定爲一個布爾值。 默認值"yes"表示遵守傳統的 syslog 日誌等級前綴習慣。 例如，一條以
"<5>"
開頭的日誌 表示其日誌等級爲 5("notice")。 其他以此類推。
.RE
.SH "退出狀態"
.PP
返回值爲 0 表示成功， 非零返回值表示失敗代碼。
.SH "例子"
.PP
\fBExample\ \&1.\ \&調用一個程序\fR
.PP
調用
/bin/ls
程序，並將其標準輸出與標準錯誤重定向到系統日誌中。
.sp
.if n \{\
.RS 4
.\}
.nf
# systemd\-cat ls
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&2.\ \&用作一個管道\fR
.PP
接收
/bin/ls
的標準輸出， 並將其重定向到系統日誌中。
.sp
.if n \{\
.RS 4
.\}
.nf
# ls | systemd\-cat
.fi
.if n \{\
.RE
.\}
.PP
雖然上述兩個例子的最終效果差不多， 但是首選使用前一種方法，因爲同一時間僅需要運行一個進程， 並且可以同時捕獲 stdout 與 stderr 的內容， 而第二種方法只能捕獲 stdout 的內容。
.SH "參見"
.PP
\fBsystemd\fR(1),
\fBsystemctl\fR(1),
\fBlogger\fR(1)
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.PP
翻譯人員：金步國
.br
金步國作品集：http://www.jinbuguo.com
.br
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR