From 378c18e5f024ac5a8aef4cb40d7c9aa9633d144c Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 16:30:35 +0200 Subject: Adding upstream version 2.38.1. Signed-off-by: Daniel Baumann --- login-utils/sulogin.8.adoc | 80 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 login-utils/sulogin.8.adoc (limited to 'login-utils/sulogin.8.adoc') diff --git a/login-utils/sulogin.8.adoc b/login-utils/sulogin.8.adoc new file mode 100644 index 0000000..3165d61 --- /dev/null +++ b/login-utils/sulogin.8.adoc @@ -0,0 +1,80 @@ +//po4a: entry man manual +//// +Copyright (C) 1998-2006 Miquel van Smoorenburg. +Copyright (C) 2012 Karel Zak + +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. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA +//// += sulogin(8) +:doctype: manpage +:man manual: System Administration +:man source: util-linux {release-version} +:page-layout: base +:command: sulogin +:asterisk: * + +== 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): + +If the root account is locked and *--force* is specified, no password is required. + +*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_). + +When the user exits from 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 from the system via *getpwnam*(3) fails, then examine _/etc/passwd_ and _/etc/shadow_ to get the password. If these files are damaged or nonexistent, or when root account is locked by '!' or '{asterisk}' at the begin of the password then *sulogin* will *start a root shell without asking for a password*. +//TRANSLATORS: Keep {asterisk} untranslated. ++ +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. + +include::man-common/help-version.adoc[] + +== ENVIRONMENT + +*sulogin* looks for the environment variable *SUSHELL* or *sushell* to determine 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_. + +== AUTHORS + +*sulogin* was written by Miquel van Smoorenburg for sysvinit and later ported to util-linux by Dave Reisner and Karel Zak. + +include::man-common/bugreports.adoc[] + +include::man-common/footer.adoc[] + +ifdef::translation[] +include::man-common/translation.adoc[] +endif::[] -- cgit v1.2.3