1SULOGIN(8)                   System Administration                  SULOGIN(8)
2
3
4

NAME

6       sulogin - single-user login
7

SYNOPSIS

9       sulogin [options] [tty]
10

DESCRIPTION

12       sulogin is invoked by init when the system goes into single-user mode.
13
14       The user is prompted:
15
16       Give root password for system maintenance (or type Control-D for normal
17       startup):
18
19       If the root account is locked and --force is specified, no password is
20       required.
21
22       sulogin will be connected to the current terminal, or to the optional
23       tty device that can be specified on the command line (typically
24       /dev/console).
25
26       When the user exits from the single-user shell, or presses control-D at
27       the prompt, the system will continue to boot.
28

OPTIONS

30       -e, --force
31           If the default method of obtaining the root password from the
32           system via getpwnam(3) fails, then examine /etc/passwd and
33           /etc/shadow to get the password. If these files are damaged or
34           nonexistent, or when root account is locked by '!' or '*' at the
35           begin of the password then sulogin will start a root shell without
36           asking for a password.
37
38           Only use the -e option if you are sure the console is physically
39           protected against unauthorized access.
40
41       -p, --login-shell
42           Specifying this option causes sulogin to start the shell process as
43           a login shell.
44
45       -t, --timeout seconds
46           Specify the maximum amount of time to wait for user input. By
47           default, sulogin will wait forever.
48
49       -h, --help
50           Display help text and exit.
51
52       -V, --version
53           Display version information and exit.
54

ENVIRONMENT

56       sulogin looks for the environment variable SUSHELL or sushell to
57       determine what shell to start. If the environment variable is not set,
58       it will try to execute root’s shell from /etc/passwd. If that fails, it
59       will fall back to /bin/sh.
60

AUTHORS

62       sulogin was written by Miquel van Smoorenburg for sysvinit and later
63       ported to util-linux by Dave Reisner and Karel Zak.
64

REPORTING BUGS

66       For bug reports, use the issue tracker at
67       https://github.com/karelzak/util-linux/issues.
68

AVAILABILITY

70       The sulogin command is part of the util-linux package which can be
71       downloaded from Linux Kernel Archive
72       <https://www.kernel.org/pub/linux/utils/util-linux/>.
73
74
75
76util-linux 2.37.2                 2021-06-02                        SULOGIN(8)
Impressum