1
1
<?xml version="1.0" encoding="UTF-8"?>
3
Copyright (c) 1989 - 1994, Julianne Frances Haugh
4
Copyright (c) 2007 - 2008, Nicolas François
7
Redistribution and use in source and binary forms, with or without
8
modification, are permitted provided that the following conditions
10
1. Redistributions of source code must retain the above copyright
11
notice, this list of conditions and the following disclaimer.
12
2. Redistributions in binary form must reproduce the above copyright
13
notice, this list of conditions and the following disclaimer in the
14
documentation and/or other materials provided with the distribution.
15
3. The name of the copyright holders or contributors may not be used to
16
endorse or promote products derived from this software without
17
specific prior written permission.
19
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
22
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2
31
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.5//EN"
3
32
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
33
<!ENTITY CONSOLE SYSTEM "login.defs.d/CONSOLE.xml">
50
79
<refsynopsisdiv id='synopsis'>
52
81
<command>login</command>
53
<arg choice='opt'>-p </arg>
82
<arg choice='opt'>-p</arg>
83
<arg choice='opt'>-h <replaceable>host</replaceable></arg>
55
85
<replaceable>username</replaceable></arg>
56
86
<arg choice='opt' rep='repeat'> <replaceable>ENV=VAR</replaceable></arg>
59
89
<command>login</command>
60
<arg choice='opt'>-p </arg>
90
<arg choice='opt'>-p</arg>
61
91
<arg choice='opt'>-h <replaceable>host</replaceable></arg>
62
<arg choice='opt'>-f <replaceable>username</replaceable></arg>
92
<arg choice='plain'>-f</arg>
93
<arg choice='plain'><replaceable>username</replaceable></arg>
65
96
<command>login</command>
66
<arg choice='opt'>-p </arg>
97
<arg choice='opt'>-p</arg>
67
98
<arg choice='plain'>-r <replaceable>host</replaceable></arg>
75
106
with the system. It is normally invoked automatically by responding to
76
107
the <emphasis remap='I'>login:</emphasis> prompt on the user's
77
108
terminal. <command>login</command> may be special to the shell and may
78
not be invoked as a sub-process. Typically, <command>login</command>
79
is treated by the shell as <emphasis remap='B'>exec login</emphasis>
80
which causes the user to exit from the current shell. Attempting to
109
not be invoked as a sub-process. When called from a shell,
110
<command>login</command> should be executed as
111
<emphasis remap='B'>exec login</emphasis> which will cause the user
112
to exit from the current shell (and thus will prevent the new logged
113
in user to return to the session of the caller). Attempting to
81
114
execute <command>login</command> from any shell but the login shell
82
115
will produce an error message.
159
192
<option>-f</option>
162
<para>Do not perform authentication, user is preauthenticated.
196
Do not perform authentication, user is preauthenticated.
199
Note: In that case, <replaceable>username</replaceable> is