systemd-journal-remote.8		systemd-journal-remote.8
	SYSTEMD-JOURNAL-REMOTE(8) systemd-journal-remote SYSTEMD-JOURNAL-REMOTE (8)		SYSTEMD-JOURNAL-REMOTE(8) systemd-journal-remote SYSTEMD-JOURNAL-REMOTE (8)
	NAME		NAME
	systemd-journal-remote - Stream journal messages over the network		systemd-journal-remote - Receive journal messages over the network
	SYNOPSIS		SYNOPSIS
	systemd-journal-remote [OPTIONS...] [-o/--output=DIR|FILE] [SOURCES. ..]		systemd-journal-remote [OPTIONS...] [-o/--output=DIR|FILE] [SOURCES. ..]
	DESCRIPTION		DESCRIPTION
	systemd-journal-remote is a command to receive serialized journal		systemd-journal-remote is a command to receive serialized journal
	events and store them to the journal. Input streams must be in the		events and store them to the journal. Input streams are in the Journ
	Journal Export Format[1], i.e. like the output from journalctl		al
	--output=export.		Export Format[1], i.e. like the output from journalctl --output=expo
			rt.
			For transport over the network, this serialized stream is usually
			carried over an HTTPS connection.
	SOURCES		SOURCES
	Sources can be either "active" (systemd-journal-remote requests and		Sources can be either "active" (systemd-journal-remote requests and
	pulls the data), or "passive" (systemd-journal-remote waits for a		pulls the data), or "passive" (systemd-journal-remote waits for a
	connection and then receives events pushed by the other side).		connection and then receives events pushed by the other side).
	systemd-journal-remote can read more than one event stream at a time .		systemd-journal-remote can read more than one event stream at a time .
	They will be interleaved in the output file. In case of "active"		They will be interleaved in the output file. In case of "active"
	connections, each "source" is one stream, and in case of "passive"		connections, each "source" is one stream, and in case of "passive"
	connections, each connection can result in a separate stream. Socket s		connections, each connection can result in a separate stream. Socket s
	skipping to change at line 71		skipping to change at line 72
	systemd-journal-remote supports the $LISTEN_FDS/$LISTEN_PID		systemd-journal-remote supports the $LISTEN_FDS/$LISTEN_PID
	protocol. Open sockets inherited through socket activation behav e		protocol. Open sockets inherited through socket activation behav e
	like those opened with --listen-raw= described above, unless the y		like those opened with --listen-raw= described above, unless the y
	are specified as an argument in --listen-http=-n or		are specified as an argument in --listen-http=-n or
	--listen-https=-n above. In the latter case, an HTTP or HTTPS		--listen-https=-n above. In the latter case, an HTTP or HTTPS
	server will be spawned using this descriptor and connections mus t		server will be spawned using this descriptor and connections mus t
	be made over the HTTP protocol.		be made over the HTTP protocol.
	SINKS		SINKS
	The location of the output journal can be specified with -o or		The location of the output journal can be specified with -o or
	--output=.		--output=. For "active" sources, this option is required.
	--output=FILE		--output=FILE
	Will write to this journal. The filename must end with .journal.		Will write to this journal file. The filename must end with
	The file will be created if it does not exist. If necessary		.journal. The file will be created if it does not exist. If
	(journal file full, or corrupted), the file will be renamed		necessary (journal file full, or corrupted), the file will be
	following normal journald rules and a new journal file will be		renamed following normal journald rules and a new journal file w
	created in its stead.		ill
			be created in its stead.
	--output=DIR		--output=DIR
	Will create journal files underneath directory DIR. The director y		Will create journal files underneath directory DIR. The director y
	must exist. If necessary (journal files over size, or corrupted) ,		must exist. If necessary (journal files over size, or corrupted) ,
	journal files will be rotated following normal journald rules.		journal files will be rotated following normal journald rules.
	Names of files underneath DIR will be generated using the rules		Names of files underneath DIR will be generated using the rules
	described below.		described below.
	If --output= is not used, the output directory		If --output= is not used, the output directory /var/log/journal/remo
	/var/log/journal/machine-id/ will be used, where machine-id is the		te/
	identifier of the current system (see machine-id(5)). In case the		will be used. In case the output file is not specified, journal file
	output file is not specified, journal files will be created undernea		s
	th		will be created underneath the selected directory. Files will be cal
	the selected directory. Files will be called remote-variable.journal		led
	,		remote-hostname.journal, where the hostname part is the escaped
	where the variable part is generated based on what passive and activ		hostname of the source endpoint of the connection, or the numerical
	e		address if the hostname cannot be determined.
	sources are specified. It is recommended to give a full output
	filename.		In case of "active" sources, the output file name must always be giv
			en
	In case of "active" sources, if the hostname is known, it will be us		explicitly.
	ed
	in the variable part. Otherwise, local address and port number will
	be
	used, or "stdin" for events passed over standard input, and "multipl
	e"
	if more than one source is specified.
	OPTIONS		OPTIONS
	The following options are understood:		The following options are understood:
	--help, -h		--split-mode
	Print a short help text and exit.		One of none or host. For the first, only one output journal file
			is
			used. For the latter, a separate output file is used, based on t
			he
			hostname of the other endpoint of a connection.
	--version		In case of "active" sources, the output file name must always be
	Print a short version string and exit.		given explicitly and only none is allowed.
	--compress, --no-compress		--compress, --no-compress
	Compress or not, respectively, the data in the journal using XZ.		Compress or not, respectively, the data in the journal using XZ.
	--seal, --no-seal		--seal, --no-seal
	Periodically sign or not, respectively, the data in the journal		Periodically sign or not, respectively, the data in the journal
	using Forward Secure Sealing.		using Forward Secure Sealing.
	--getter=PROG --option1 --option2		--getter=PROG --option1 --option2
	Program to invoke to retrieve data. The journal event stream mus t		Program to invoke to retrieve data. The journal event stream mus t
	be generated on standard output.		be generated on standard output.
	Examples:		Examples:
	--getter='curl "-HAccept: application/vnd.fdo.journal" https ://some.host:19531/'		--getter='curl "-HAccept: application/vnd.fdo.journal" https ://some.host:19531/'
	--getter='wget --header="Accept: application/vnd.fdo.journal " -O- https://some.host:19531/'		--getter='wget --header="Accept: application/vnd.fdo.journal " -O- https://some.host:19531/'
			-h, --help
			Print a short help text and exit.
			--version
			Print a short version string and exit.
	EXAMPLES		EXAMPLES
	Copy local journal events to a different journal directory:		Copy local journal events to a different journal directory:
	journalctl -o export | systemd-journal-remote -o /tmp/dir -		journalctl -o export | systemd-journal-remote -o /tmp/dir -
	Retrieve events from a remote systemd-journal-gatewayd(8) instance a nd		Retrieve events from a remote systemd-journal-gatewayd(8) instance a nd
	store them in /var/log/journal/some.host/remote-some~host.journal:		store them in /var/log/journal/some.host/remote-some~host.journal:
	systemd-journal-remote --url http://some.host:19531/		systemd-journal-remote --url http://some.host:19531/
	SEE ALSO		SEE ALSO
	journalctl(1), systemd-journald.service(8), systemd-journal-		systemd-journal-upload(8), journalctl(1), systemd-journald.service(8
	gatewayd.service(8).		),
			systemd-journal-gatewayd.service(8)
	NOTES		NOTES
	1. Journal Export Format		1. Journal Export Format
	http://www.freedesktop.org/wiki/Software/systemd/export		http://www.freedesktop.org/wiki/Software/systemd/export
	2. http://some.host:19531/		2. http://some.host:19531/
	3. https://some.host:19531/		3. https://some.host:19531/
	systemd 215 SYSTEMD-JOURNAL-REMOTE (8)		systemd 216 SYSTEMD-JOURNAL-REMOTE (8)
End of changes. 10 change blocks.
	35 lines changed or deleted		44 lines changed or added
This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/