Manual page for LOGINWINDOW(8)
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 ALSO
utmp(5), login(8), ttys(5), passwd(5)
NEXTSTEP Network and System Administration manual
BUGS
utmp handling should be in the LoginHook program.
Created by unroff & hp-tools.
© somebody (See intro for details). All Rights Reserved.
Last modified 11/5/97
