From 378c18e5f024ac5a8aef4cb40d7c9aa9633d144c Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Sun, 7 Apr 2024 16:30:35 +0200
Subject: Adding upstream version 2.38.1.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 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 <kzak@redhat.com>
+
+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

