~ubuntu-branches/ubuntu/raring/shadow/raring-proposed

« back to all changes in this revision

Viewing changes to man/sulogin.8

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2009-05-05 09:45:21 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20090505094521-wpk2wn3q7957tlah
Tags: 1:4.1.3.1-1ubuntu1
* Merge from debian unstable, remaining changes:
  - Ubuntu specific:
    + debian/login.defs: use SHA512 by default for password crypt routine.
  - debian/patches/stdout-encrypted-password.patch: chpasswd can report
    password hashes on stdout (debian bug 505640).
  - debian/login.pam: Enable SELinux support (debian bug 527106).
  - debian/securetty.linux: support Freescale MX-series (debian bug 527095).
* Add debian/patches/300_lastlog_failure: fixed upstream (debian bug 524873).
* Drop debian/patches/593_omit_lastchange_field_if_clock_is_misset: fixed
  upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\"     Title: sulogin
2
2
.\"    Author: 
3
3
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
4
 
.\"      Date: 04/03/2008
 
4
.\"      Date: 04/15/2009
5
5
.\"    Manual: System Management Commands
6
6
.\"    Source: System Management Commands
7
7
.\"
8
 
.TH "SULOGIN" "8" "04/03/2008" "System Management Commands" "System Management Commands"
 
8
.TH "SULOGIN" "8" "04/15/2009" "System Management Commands" "System Management Commands"
9
9
.\" disable hyphenation
10
10
.nh
11
11
.\" disable justification (adjust text to left margin only)
22
22
\fBsulogin\fR
23
23
command is invoked by
24
24
\fBinit\fR
25
 
prior to allowing the user access to the system when in single user mode\. This feature may only be available on certain systems where
 
25
prior to allowing the user access to the system when in single user mode\&. This feature may only be available on certain systems where
26
26
\fBinit\fR
27
27
has been modified accordingly, or where the
28
28
\fI/etc/inittab\fR
29
 
has an entry for a single user login\.
 
29
has an entry for a single user login\&.
30
30
.PP
31
31
The user is prompted
32
32
.PP
33
33
Type control\-d to proceed with normal startup,
34
34
(or give root password for system maintenance):
35
35
.PP
36
 
Input and output will be performed with the standard file descriptors unless the optional device name argument is provided\.
 
36
Input and output will be performed with the standard file descriptors unless the optional device name argument is provided\&.
37
37
.PP
38
 
If the user enters the correct root password, a login session is initiated\. When
 
38
If the user enters the correct root password, a login session is initiated\&. When
39
39
\fIEOF\fR
40
 
is pressed instead, the system enters multi\-user mode\.
 
40
is pressed instead, the system enters multi\-user mode\&.
41
41
.PP
42
42
After the user exits the single\-user shell, or presses
43
 
\fIEOF\fR, the system begins the initialization process required to enter multi\-user mode\.
 
43
\fIEOF\fR, the system begins the initialization process required to enter multi\-user mode\&.
44
44
.SH "CAVEATS"
45
45
.PP
46
46
This command can only be used if
50
50
instead of
51
51
\fI/bin/sh\fR, or if the user has set the
52
52
\fIinittab\fR
53
 
to support a single user login\. For example, the line:
 
53
to support a single user login\&. For example, the line:
54
54
.PP
55
55
co:s:respawn:/etc/sulogin /dev/console
56
56
.PP
57
 
should execute the sulogin command in single user mode\.
 
57
should execute the sulogin command in single user mode\&.
58
58
.PP
59
 
As complete an environment as possible is created\. However, various devices may be unmounted or uninitialized and many of the user commands may be unavailable or nonfunctional as a result\.
 
59
As complete an environment as possible is created\&. However, various devices may be unmounted or uninitialized and many of the user commands may be unavailable or nonfunctional as a result\&.
60
60
.SH "CONFIGURATION"
61
61
.PP
62
62
The following configuration variables in
63
 
\fI/etc/login\.defs\fR
 
63
\fI/etc/login\&.defs\fR
64
64
change the behavior of this tool:
65
65
.PP
66
66
\fBENV_HZ\fR (string)
67
67
.RS 4
68
 
If set, it will be used to define the HZ environment variable when a user login\. The value must be preceded by
69
 
\fIHZ=\fR\. A common value on Linux is
70
 
\fIHZ=100\fR\.
 
68
If set, it will be used to define the HZ environment variable when a user login\&. The value must be preceded by
 
69
\fIHZ=\fR\&. A common value on Linux is
 
70
\fIHZ=100\fR\&.
71
71
.RE
72
72
.PP
73
73
\fBENV_TZ\fR (string)
74
74
.RS 4
75
 
If set, it will be used to define the TZ environment variable when a user login\. The value can be the name of a timezone preceded by
 
75
If set, it will be used to define the TZ environment variable when a user login\&. The value can be the name of a timezone preceded by
76
76
\fITZ=\fR
77
77
(for example
78
78
\fITZ=CST6CDT\fR), or the full path to the file containing the timezone specification (for example
79
 
\fI/etc/tzname\fR)\.
 
79
\fI/etc/tzname\fR)\&.
80
80
.sp
81
81
If a full path is specified but the file does not exist or cannot be read, the default is to use
82
 
\fITZ=CST6CDT\fR\.
 
82
\fITZ=CST6CDT\fR\&.
83
83
.RE
84
84
.SH "FILES"
85
85
.PP
86
86
\fI/etc/passwd\fR
87
87
.RS 4
88
 
User account information\.
 
88
User account information\&.
89
89
.RE
90
90
.PP
91
91
\fI/etc/shadow\fR
92
92
.RS 4
93
 
Secure user account information\.
 
93
Secure user account information\&.
94
94
.RE
95
95
.SH "SEE ALSO"
96
96
.PP
97
97
 
98
98
\fBlogin\fR(1),
99
99
\fBsh\fR(1),
100
 
\fBinit\fR(8)\.
 
100
\fBinit\fR(8)\&.