up | Inhaltsverzeichniss | Kommentar

Manual page for LOGINWINDOW(8)

loginwindow - allow user to log in on console


/usr/bin/loginwindow [ -LoginHook progname ] [ -LogoutHook progname ] [ -HostName hostname ] [ -ImageFile filename ] [ -DefaultUser username ] [ -PowerOffDisabled true ]


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:

	Keymap (or SwappedKeymap)

It also looks up the following two user parameters and places them in effect for the duration of the user's login session:


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.


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.


/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.

index | Inhaltsverzeichniss | Kommentar

Created by unroff & hp-tools. © by Hans-Peter Bischof. All Rights Reserved (1997).

Last modified 21/April/97