X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-journal-remote.xml;h=ef998355ce2a1ba26b5a45de1347529ce210e68a;hb=3c6d3052d3597100e9d531df03cb15e9988dc94d;hp=a6e67e58417c8c10004a5d4bbdadc4e1de37fc81;hpb=8201af08fa09c2bd0f005fbe262f27e2c5bd2d86;p=elogind.git
diff --git a/man/systemd-journal-remote.xml b/man/systemd-journal-remote.xml
index a6e67e584..ef998355c 100644
--- a/man/systemd-journal-remote.xml
+++ b/man/systemd-journal-remote.xml
@@ -1,4 +1,4 @@
-
+
@@ -21,7 +21,8 @@ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
-
+systemd-journal-remote
@@ -44,14 +45,14 @@ along with systemd; If not, see .
systemd-journal-remote
- Stream journal messages over the network
+ Receive journal messages over the networksystemd-journal-remoteOPTIONS
- -o/--output=DIR|FILE
+ -o/--output=DIR|FILESOURCES
@@ -62,12 +63,14 @@ along with systemd; If not, see .
systemd-journal-remote is a command to
receive serialized journal events and store them to the journal.
- Input streams must be in the
+ Input streams are in the
Journal Export Format
,
i.e. like the output from
- journalctl --output=export.
+ journalctl --output=export. For transport over
+ the network, this serialized stream is usually carried over an
+ HTTPS connection.
@@ -184,17 +187,18 @@ along with systemd; If not, see .
SinksThe location of the output journal can be specified
- with or .
+ with or . For "active"
+ sources, this option is required.
- Will write to this journal. The filename must
- end with .journal. The file will be
- created if it does not exist. If necessary (journal file
- full, or corrupted), the file will be renamed following normal
+ Will write to this journal file. The filename
+ must end with .journal. The file will be
+ created if it does not exist. If necessary (journal file full,
+ or corrupted), the file will be renamed following normal
journald rules and a new journal file will be created in its
stead.
@@ -211,24 +215,18 @@ along with systemd; If not, see .
- If is not used, the output directory
- /var/log/journal/machine-id/
- will be used, where machine-id is the
- identifier of the current system (see
- machine-id5).
- In case the output file is not specified, journal files will be
- created underneath the selected directory. Files will be called
- remote-variable.journal,
- where the variable part is generated
- based on what passive and active sources are specified. It is
- recommended to give a full output filename.
-
- In case of "active" sources, if the hostname is known, it
- will be used in the variable part.
- Otherwise, local address and port number will be used, or
- stdin for events passed over standard
- input, and multiple if more than one source
- is specified.
+ If is not used, the output
+ directory /var/log/journal/remote/ will be
+ used. In case the output file is not specified, journal files
+ will be created underneath the selected directory. Files will be
+ called
+ remote-hostname.journal,
+ where the hostname part is the
+ escaped hostname of the source endpoint of the connection, or the
+ numerical address if the hostname cannot be determined.
+
+ In case of "active" sources, the output file name must
+ always be given explicitly.
@@ -237,21 +235,6 @@ along with systemd; If not, see .
The following options are understood:
-
-
-
-
- Print a short help
- text and exit.
-
-
-
-
-
- Print a short version
- string and exit.
-
-
@@ -296,6 +279,9 @@ along with systemd; If not, see .
--getter='wget --header="Accept: application/vnd.fdo.journal" -O- https://some.host:19531/'
+
+
+
@@ -320,9 +306,10 @@ systemd-journal-remote --url http://some.host:19531/
See Also
+ systemd-journal-upload8,
journalctl1,
systemd-journald.service8,
- systemd-journal-gatewayd.service8.
+ systemd-journal-gatewayd.service8