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
17            (or type Control-D for normal 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       After the user exits the single-user shell or presses control-D at  the
27       prompt, the system will continue to boot.
28

OPTIONS

30       -e, --force
31              If  the default method of obtaining the root password via getpw‐
32              nam(3) from the system fails, manually 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 with‐
36              out 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
43              as 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              Print a help message.
51
52       -V, --version
53              Output version.
54

ENVIRONMENT VARIABLES

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

AUTHOR

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

AVAILABILITY

66       The  sulogin command is part of the util-linux package and is available
67       from Linux Kernel  Archive  ⟨ftp://ftp.kernel.org/pub/linux/utils/util-
68       linux/⟩.
69
70
71
72util-linux                         Jul 2012                         SULOGIN(8)
Impressum