diff options
| author | Zsolt Dollenstein <zsol.zsol@gmail.com> | 2018-07-03 12:22:29 -0700 |
|---|---|---|
| committer | Zsolt Dollenstein <zsol@fb.com> | 2018-07-20 03:54:22 -0700 |
| commit | 566b7d23eb747e9c5a74e5647693077b52395fc5 (patch) | |
| tree | d18c8eb14208a543717ed590c4548adf71874344 /man | |
| parent | 48a0ab391c625b240433867ebf2c918270a93923 (diff) | |
| download | systemd-566b7d23eb747e9c5a74e5647693077b52395fc5.tar.gz | |
Add support for opening files for appending
Addresses part of #8983
Diffstat (limited to 'man')
| -rw-r--r-- | man/systemd.exec.xml | 16 |
1 files changed, 11 insertions, 5 deletions
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index ccf79b21d6..c898d226a7 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -1756,8 +1756,8 @@ SystemCallErrorNumber=EPERM</programlisting> of <option>inherit</option>, <option>null</option>, <option>tty</option>, <option>journal</option>, <option>syslog</option>, <option>kmsg</option>, <option>journal+console</option>, <option>syslog+console</option>, <option>kmsg+console</option>, - <option>file:<replaceable>path</replaceable></option>, <option>socket</option> or - <option>fd:<replaceable>name</replaceable></option>.</para> + <option>file:<replaceable>path</replaceable></option>, <option>append:<replaceable>path</replaceable></option>, + <option>socket</option> or<option>fd:<replaceable>name</replaceable></option>.</para> <para><option>inherit</option> duplicates the file descriptor of standard input for standard output.</para> @@ -1788,11 +1788,17 @@ SystemCallErrorNumber=EPERM</programlisting> <para>The <option>file:<replaceable>path</replaceable></option> option may be used to connect a specific file system object to standard output. The semantics are similar to the same option of - <varname>StandardInput=</varname>, see above. If standard input and output are directed to the same file path, - it is opened only once, for reading as well as writing and duplicated. This is particular useful when the - specified path refers to an <constant>AF_UNIX</constant> socket in the file system, as in that case only a + <varname>StandardInput=</varname>, see above. If <replaceable>path</replaceable> refers to a regular file + on the filesystem, it is opened (created if it doesn't exist yet) for writing at the beginning of the file, + but without truncating it. + If standard input and output are directed to the same file path, it is opened only once, for reading as well + as writing and duplicated. This is particularly useful when the specified path refers to an + <constant>AF_UNIX</constant> socket in the file system, as in that case only a single stream connection is created for both input and output.</para> + <para><option>append:<replaceable>path</replaceable></option> is similar to <option>file:<replaceable>path + </replaceable></option> above, but it opens the file in append mode.</para> + <para><option>socket</option> connects standard output to a socket acquired via socket activation. The semantics are similar to the same option of <varname>StandardInput=</varname>, see above.</para> |