Yolinux.com

sulogin manpage

Search topic Section


SULOGIN(8)		     System Administration		    SULOGIN(8)



NAME
       sulogin - Single-user login

SYNOPSIS
       sulogin [options] [tty]

DESCRIPTION
       sulogin is invoked by init when the system goes into single user mode.

       The user is prompted:

	    Give root password for system maintenance
	    (or type Control-D for normal startup):

       sulogin	will  be connected to the current terminal, or to the optional
       tty device that	can  be	 specified  on	the  command  line  (typically
       /dev/console).

       After  the user exits the single-user shell or presses control-D at the
       prompt, the system will continue to boot.

OPTIONS
       -e, --force
	      If the default method of obtaining the root password via	getpw-
	      nam(3)  from  the system fails, manually examine /etc/passwd and
	      /etc/shadow to get the password.	If they are damaged or	nonex-
	      istent,  sulogin	will  start  a root shell without asking for a
	      password.

	      Only use the -e option if you are sure the console is physically
	      protected against unauthorized access.

       -p, --login-shell
	      Specifying this option causes sulogin to start the shell process
	      as a login shell.

       -t, --timeout seconds
	      Specify the maximum amount of time to wait for user  input.   By
	      default, sulogin will wait forever.

       -h, --help
	      Print a help message.

       -V, --version
	      Output version.

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

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

AVAILABILITY
       The  sulogin command is part of the util-linux package and is available
       from Linux Kernel  Archive  <ftp://ftp.kernel.org/pub/linux/utils/util-
       linux/>.



util-linux			   Jul 2012			    SULOGIN(8)