LOGINWINDOW(8)LOGINWINDOW(8)NAME
loginwindow - allow user to log in on console
SYNOPSIS
/usr/bin/loginwindow [ -LoginHook progname ] [ -LogoutHook progname ]
[ -HostName hostname ] [ -ImageFile filename ]
[ -DefaultUser username ] [ -PowerOffDisabled true ]
DESCRIPTION
loginwindow 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 /etc/ttys file.
loginwindow allows the user to enter his login name and password,
verifies those against the user/password database, and starts the
Workspace Manager ( /usr/lib/NextStep/Workspace.app) as that user.
If there is an account for the user me (or the user named by the
DefaultUser option) and that account has no password, then loginwindow
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 loginwindow is starting.
If the user has an entry for loginwindow named Workspace in his
defaults database the named program will be executed instead of
Workspace Manager. The workspace program is invoked with the command
line
program -LoginProgram YES
If the user name of exit is given, loginwindow immediately exits with
status 0 and restarts the Window Server. If the user name of console
is given, loginwindow immediately exits with status 1 and opens the
UNIX Console window. This may be used in conjunction with the onerror
feature of the ttys file.
Before starting the Workspace Manager, loginwindow 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:
MouseScaling
InitialKeyRepeat
KeyRepeat
ClickTime
ClickSpace
AutoDimTime
MouseHandedness
MouseButtonsTied
Keymap (or SwappedKeymap)
Volume
Mute
Brightness
It also looks up the following two user parameters and places them in
effect for the duration of the user's login session:
PublicWindowServer
umask
PublicWindowServer 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. umask gives an integer indicating the
user's desired default umask. See umask(2) for more information.
After the user has logged out, loginwindow clears the Pasteboard and
resets the parameters listed above to their default values.
OPTIONS
Note: Like other NEXTSTEP(tm) applications, loginwindow may accept
these options on the command line or as entries in the defaults
database of the user running the program, (which for loginwindow is
usually root).
-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
passwd database. 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 wtmp if desired. By
default, loginwindow does handle the utmp database, but not the
other activities performed by the terminal oriented login
program (for example, maintaining the wtmp database). 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. The LoginHook program should be specified as a full
pathname. Also, it is not 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
logged out. The program is invoked with the name of the user
who just logged out as its first argument. Like the LoginHook,
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 localhost, 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 loginwindow. Normally, it loads the file
/usr/lib/NextStep/loginwindow.app/LoginPanel.tiff and displays
that as the background for loginwindow. 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
loginwindow at coordinates (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 itself.
-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 me account above). If the DefaultUser
option is given, then that user name, rather than me, will be
checked, and if it has no password, it will be logged in.
-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. A quick way to do this is to
create a user named power, assign a suitable password to that user, and
set that user's Workspace default for loginwindow to be /etc/fasthalt
-p.
FILES
/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
~/.NeXT/.NeXTdefaults.L
/usr/lib/NextStep/Workspace.app Default location of Workspace
/usr/lib/NextStep/nextlogin.tiff Default image file
SEE ALSOutmp(5), login(8), ttys(5), passwd(5)
NEXTSTEP Network and System Administration manual
BUGS
utmp handling should be in the LoginHook program.
4th Berkeley Distribution January 12, 1989 LOGINWINDOW(8)