showconsole/blogctl.8 at master · bitstreamout/showconsole · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
.\"
.\" Copyright 2016 Werner Fink, 2016 SUSE Linux GmbH.
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.TH BLOGCTL 8 "Jan 14, 2016" "Version 2.12" "The SUSE boot concept"
.UC 8
.SH NAME
blogctl \- Control the boot loggind daemon blogd
.SH SYNOPSIS
.\"
.B /sbin/blogctl
.RI [ ping | quit\ [--wait] | root=<path> | ready | close | ask-for-password | ask-question | display-message | hide-message ]
.SH DESCRIPTION
.B blogctl
may be used to check if a
.B blogd
daemon is active as well as to send comands to such a daemon.
.SH COMANDS
The following commands are known:
.TP
.B ask-for-password
Ask the user for a password on the system console.
.RS
.TP
.BI \-\-command= STRING
Command to send the password to via standard input.
.TP
.BI \-\-prompt= STRING
Message to display when asking for the password.
.TP
.BI \-\-number-of-tries= INTEGER
Number of times to ask before giving up (requires \fB\-\-command\fR).
.TP
.B \-\-dont-pause-progress
Silently ignored by \fBblogctl\fR (provided for plymouth compatibility).
.RE
.TP
.B ask-question
Ask the user a question on the system console.
.RS
.TP
.BI \-\-command= STRING
Command to send the answer to via standard input.
.TP
.BI \-\-prompt= STRING
Message to display when asking the question.
.TP
.B \-\-dont-pause-progress
Silently ignored by \fBblogctl\fR.
.RE
.TP
.B display-message
Display a message. \fBblogd\fR prints this message to all active hardware
consoles and injects it into the boot log stream.
.RS
.TP
.BI \-\-text= STRING
The message text to display.
.RE
.TP
.B hide-message
Hide a message.
.RS
.TP
.BI \-\-text= STRING
The message text to hide. Note: \fBblogd\fR intentionally ignores the visual
clearing of messages to prevent screen corruption and preserve the scroll
buffer on line-based hardware consoles (like s390x 3215).
.RE
.TP
.B ping
Send a simply ping request if
.B blogd
daemon is up and running.
.TP
.B quit \fR[\fB\-\-wait\fR]
Cause the
.B blogd
daemon to finish its logging and then gracefully quits.  If the optional
\fB\-\-wait\fR flag is specified, \fBblogctl\fR will block and wait
until the daemon has fully flushed the logs and closed the connection.
.TP
.BI root= <path>
This command take a path as further value of the new root file
system which is mounted e.g. in initrd.
.TP
.B ready
Tells the
.B blogd
daemon that the file systems had becomes writable.
.TP
.B close
Cause the
.B blogd
daemon to finish its logging only to allow
.BR systemd (8)
to unmount the file systems finally.
.TP
.B deactivate
This let the daemon disconnect from system console.
.TP
.B reactivate
Whereas this cause the daemon reconnect to system console.
.TP
.B final
Evoke the daemon to rename an already open log file
.I /var/log/boot.log
to the new name
.I /var/log/boot.old
as well as mask it own program name in the process table
with the @ character.
.TP
.B help
Show a help text.
.SH SEE ALSO
.BR blogd (8),
.BR systemd (1),
.SH COPYRIGHT
2015,2026 Werner Fink,
2015 SUSE Linux GmbH,
2026 SUSE Software Solutions Germany GmbH.
.SH AUTHOR
Werner Fink <[email protected]>