← Back to branch summary

~ubuntu-branches/debian/jessie/systemd/jessie

« back to all changes in this revision

Viewing changes to man/systemd-journalctl.1

  • Committer: Package Import Robot
  • Author(s): Tollef Fog Heen, Tollef Fog Heen, Michael Biebl
  • Date: 2012-04-03 19:59:17 UTC
  • mfrom: (1.1.10) (6.1.3 experimental)
  • Revision ID: package-import@ubuntu.com-20120403195917-l532urrbg4pkreas
Tags: 44-1
http://bugs.debian.org/664364
http://bugs.debian.org/663219
http://bugs.debian.org/663323
[ Tollef Fog Heen ]
* New upstream version.
  - Backport 3492207: journal: PAGE_SIZE is not known on ppc and other
    archs
  - Backport 5a2a2a1: journal: react with immediate rotation to a couple
    of more errors
  - Backport 693ce21: util: never follow symlinks in rm_rf_children()
    Fixes CVE-2012-1174, closes: #664364
* Drop output message from init-functions hook, it's pointless.
* Only rmdir /lib/init/rw if it exists.
* Explicitly order debian-fixup before sysinit.target to prevent a
  possible race condition with the creation of sockets.  Thanks to
  Michael Biebl for debugging this.
* Always restart the initctl socket on upgrades, to mask sysvinit
  removing it.

[ Michael Biebl ]
* Remove workaround for non-interactive sessions from pam config again.
* Create compat /dev/initctl symlink in case we are upgrading from a system
  running a newer version of sysvinit (using /run/initctl) and sysvinit is
  replaced with systemd-sysv during the upgrade. Closes: #663219
* Install new man pages.
* Build-Depend on valac (>= 0.12) instead of valac-0.12. Closes: #663323

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/systemd-journalctl.1
 
1
'\" t
 
2
.\"     Title: systemd-journalctl
 
3
.\"    Author: Lennart Poettering <lennart@poettering.net>
 
4
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
 
5
.\"      Date: 03/16/2012
 
6
.\"    Manual: systemd-journalctl
 
7
.\"    Source: systemd
 
8
.\"  Language: English
 
9
.\"
 
10
.TH "SYSTEMD\-JOURNALCTL" "1" "03/16/2012" "systemd" "systemd-journalctl"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * Define some portability stuff
 
13
.\" -----------------------------------------------------------------
 
14
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
15
.\" http://bugs.debian.org/507673
 
16
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 
17
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
18
.ie \n(.g .ds Aq \(aq
 
19
.el       .ds Aq '
 
20
.\" -----------------------------------------------------------------
 
21
.\" * set default formatting
 
22
.\" -----------------------------------------------------------------
 
23
.\" disable hyphenation
 
24
.nh
 
25
.\" disable justification (adjust text to left margin only)
 
26
.ad l
 
27
.\" -----------------------------------------------------------------
 
28
.\" * MAIN CONTENT STARTS HERE *
 
29
.\" -----------------------------------------------------------------
 
30
.SH "NAME"
 
31
systemd-journalctl \- Query the systemd journal
 
32
.SH "SYNOPSIS"
 
33
.HP \w'\fBsystemd\-journalctl\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[MATCH]\fR\ 'u
 
34
\fBsystemd\-journalctl \fR\fB[OPTIONS...]\fR\fB \fR\fB[MATCH]\fR
 
35
.SH "DESCRIPTION"
 
36
.PP
 
37
\fBsystemd\-journalctl\fR
 
38
may be used to query the contents of the
 
39
\fBsystemd\fR(1)
 
40
journal\&.
 
41
.PP
 
42
If called without parameter will show the full contents of the journal, starting with the oldest entry collected\&.
 
43
.PP
 
44
If a match argument is passed the output is filtered accordingly\&. A match is in the format
 
45
FIELD=VALUE, e\&.g\&.
 
46
_SYSTEMD_UNIT=httpd\&.service\&.
 
47
.PP
 
48
Output is interleaved from all accessible journal files, whether they are rotated or currently being written, and regardless whether they belong to the system itself or are accessible user journals\&.
 
49
.PP
 
50
All users are granted access to their private per\-user journals\&. However, by default only root and users who are members of the
 
51
adm
 
52
group get access to the system journal and the journals of other users\&.
 
53
.SH "OPTIONS"
 
54
.PP
 
55
The following options are understood:
 
56
.PP
 
57
\fB\-\-help\fR, \fB\-h\fR
 
58
.RS 4
 
59
Prints a short help text and exits\&.
 
60
.RE
 
61
.PP
 
62
\fB\-\-version\fR
 
63
.RS 4
 
64
Prints a short version string and exits\&.
 
65
.RE
 
66
.PP
 
67
\fB\-\-no\-pager\fR
 
68
.RS 4
 
69
Do not pipe output into a pager\&.
 
70
.RE
 
71
.PP
 
72
\fB\-\-all\fR, \fB\-a\fR
 
73
.RS 4
 
74
Show all fields in full, even if they include unprintable characters or are very long\&.
 
75
.RE
 
76
.PP
 
77
\fB\-\-follow\fR, \fB\-f\fR
 
78
.RS 4
 
79
Show only most recent journal entries, and continously print new entries as they are appended to the journal\&.
 
80
.RE
 
81
.PP
 
82
\fB\-\-lines=\fR, \fB\-n\fR
 
83
.RS 4
 
84
Controls the number of journal lines to show, counting from the most recent ones\&. Takes a positive integer argument\&. In follow mode defaults to 10, otherwise is unset thus not limiting how many lines are shown\&.
 
85
.RE
 
86
.PP
 
87
\fB\-\-no\-tail\fR
 
88
.RS 4
 
89
Show all stored output lines, even in follow mode\&. Undoes the effect of
 
90
\fB\-\-lines=\fR\&.
 
91
.RE
 
92
.PP
 
93
\fB\-\-output=\fR, \fB\-o\fR
 
94
.RS 4
 
95
Controls the formatting of the journal entries that are shown\&. Takes one of
 
96
short,
 
97
short\-monotonic,
 
98
verbose,
 
99
export,
 
100
json,
 
101
cat\&.
 
102
short
 
103
is the default and generates an output that is mostly identical to the formatting of classic syslog log files, showing one line per journal entry\&.
 
104
short\-monotonic
 
105
is very similar but shows monotonic timestamps instead of wallclock timestamps\&.
 
106
verbose
 
107
shows the full structered entry items with all fiels\&.
 
108
export
 
109
serializes the journal into a binary (but mostly text\-based) stream suitable for backups and network transfer\&.
 
110
json
 
111
formats entries as JSON data structures\&.
 
112
cat
 
113
generates a very terse output only showing the actual message of each journal entry with no meta data, not even a timestamp\&.
 
114
.RE
 
115
.PP
 
116
\fB\-\-quiet\fR, \fB\-q\fR
 
117
.RS 4
 
118
Suppresses any warning message regarding inaccessable system journals when run as normal user\&.
 
119
.RE
 
120
.PP
 
121
\fB\-\-new\-id128\fR
 
122
.RS 4
 
123
Instead of showing journal contents generate a new 128 bit ID suitable for identifying messages\&. This is intended for usage by developers who need a new identifier for a new message they introduce and want to make recognizable\&. Will print the new ID in three different formats which can be copied into source code or similar\&.
 
124
.RE
 
125
.SH "EXIT STATUS"
 
126
.PP
 
127
On success 0 is returned, a non\-zero failure code otherwise\&.
 
128
.SH "ENVIRONMENT"
 
129
.PP
 
130
\fI$SYSTEMD_PAGER\fR
 
131
.RS 4
 
132
Pager to use when
 
133
\fB\-\-no\-pager\fR
 
134
is not given; overrides
 
135
\fI$PAGER\fR\&. Setting this to an empty string or the value
 
136
cat
 
137
is equivalent to passing
 
138
\fB\-\-no\-pager\fR\&.
 
139
.RE
 
140
.SH "SEE ALSO"
 
141
.PP
 
142
 
 
143
\fBsystemd\fR(1),
 
144
\fBsystemctl\fR(1),
 
145
\fBsystemd-journald.conf\fR(5)
 
146
.SH "AUTHOR"
 
147
.PP
 
148
\fBLennart Poettering\fR <\&lennart@poettering\&.net\&>
 
149
.RS 4
 
150
Developer
 
151
.RE