Manual page for LOGINWINDOW(8)
loginwindow - allow user to log in on console
[ -LoginHook progname ]
[ -LogoutHook progname ]
[ -HostName hostname ]
[ -ImageFile filename ]
[ -DefaultUser username ]
[ -PowerOffDisabled true ]
is the login front end for the console
of the NEXTSTEP(tm) environment.
It's usally run as the program on the console tty from the
allows the user to enter his login name and password,
verifies those against the
user/password database, and starts the
as that user.
If there is an account for the user
(or the user named by the
and that account has no password, then
does not actually go through the login procedure;
it immediately executes the Workspace for that user.
This can be disabled by holding down the left mouse button while
If the user has an entry
in his defaults database
the named program will be executed instead of
The workspace program is invoked with the command line
program -LoginProgram YES
If the user name of
immediately exits with status 0
and restarts the Window Server.
If the user name of
immediately exits with status 1
and opens the UNIX Console window.
This may be used in conjunction with the
feature of the
Before starting the Workspace Manager,
clears the Pasteboard, and
reads the following user parameters
(set by the user with the Preferences application)
from the user's defaults database and places them in effect:
Keymap (or SwappedKeymap)
It also looks up the following two user parameters
and places them in effect for the duration of the user's
is a parameter indicating whether unrestricted access
to the Window Server on this machine
should be allowed while the user is logged in.
If it is YES, then any client on any machine
may connect to the window server.
Otherwise, only processes descended from the Workspace or
special system processes such as the printer daemon
will be allowed to connect.
gives an integer indicating the user's desired default umask.
for more information.
After the user has logged out,
clears the Pasteboard and
resets the parameters listed above
to their default values.
Note: Like other NEXTSTEP(tm) applications,
may accept these options on the command line or as entries
in the defaults database of the user running the program,
- -LoginHook progname
provides a program for loginwindow to call before allowing
a user to log in.
This program, if specified, will be called
after the user's name and password have been verified aginst
The intention of this hook is to allow system administrators
to do logging of the user and necessary bookkeeping with the
Unix databases such as
By default, loginwindow does handle the
database, but not the other activities performed by the terminal
program (for example, maintaining the
The program is called with its first argument as
the user name of the person logging in.
If the hook program
exits with return code 0, the user will be logged in;
otherwise the login will be prevented.
program should be specified as a full pathname.
called when the default user (me) is logged in without
being asked for a password.
- -LogoutHook progname
provides a program for loginwindow to call after a user has
The program is invoked with the name of the user
who just logged out as its first argument.
the program should be given by its full pathname, and it
is not called when the single-user account (default 'me')
is logged out.
- -HostName hostname
provides a host name to be displayed in the window.
If such a name is provided, it is drawn
towards the upper-right region of the window.
If the host
name provided is
then the hostname the machine
was configured with at startup time is used.
- -ImageFile filename
provides an alternate file to use as the background of the
window used by
Normally, it loads the file
and displays that as the background for
The file used should contain an image
462 pixels wide by 260 pixels high.
White rectangles for the user name and password
will be drawn by
(124, 102) and (123, 136), with the text
``Name:'' and ``Password:'' before each
(these may appear in a language other than English).
Both rectangles are 310 pixels wide and 22 pixels high.
Subject to these restrictions,
the image may contain whatever is desired.
Note that though the image will be centered on the screen
if it is larger than the default size,
the name and password fields are still drawn
relative to the bottom left of the image
- -DefaultUser username
provides for designating any particular username as the
name to use when checking for single-user status
(see the description of the treatment of the
If the DefaultUser option is given,
then that user name, rather than
checked, and if it has no password, it will be logged
- -PowerOffDisabled true
allows the System Administrator to prevent users from casually
powering down the system.
If this option is supplied, then
pressing the power key while loginwindow is active has no affect.
Additionally, if the user presses the power key
while in the Workspace Manager,
then Workspace Manager will exit
but the system will not be powered down.
This may be used to make it less likely for users to
casually power down a system that is providing some shared
service, for example, a print server.
If this is done, system administrators may wish to allow the
system to be powered down under password control.
way to do this is to create a user named
assign a suitable password to that user, and set that user's
/etc/utmp user/terminal database
/etc/ttys terminal configuration file
/etc/halt program used to shut down system
~/.NeXT/.NeXTdefaults.D files for user's defaults
/usr/lib/NextStep/Workspace.app Default location of Workspace
/usr/lib/NextStep/nextlogin.tiff Default image file
utmp(5), login(8), ttys(5), passwd(5)
NEXTSTEP Network and System Administration manual
utmp handling should be in the LoginHook program.
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97