XLOGIN XLOGIN
NAME
xlogin - sign on
SYNOPSIS
xlogin
DESCRIPTION
The xlogin command allows you to identify yourself to the system in an X
Windows environment. It should be invoked by the system, via init(1).
Xlogin asks for your user name, and, if appropriate, your password. As
you type your password, the computer echos asterisks so your password
will not be visible on the screen. An invalid login name will cause a
request for a password. This is done to make it more difficult for an
unauthorized user to log in on the system by trial and error.
If password aging has been invoked by the super-user on your behalf, your
password may have expired. In this case, you will be asked for a new
password after you have logged in.
If you don't wish to use X Windows, you may click on the ``no windows''
button. This will cause getty(1) to run, with a one-minute timeout. (If
you click on the button by accident, you may either wait for the timeout
to expire, or you may login incorrectly three times. See getty(1) for
more information.)
After a successful login, the accounting files are updated, environment
variables are set, and another program, xsession(1), is started.
If /etc/btmp is present, all unsuccessful login attempts are logged to
this file. This feature is disabled if the file is not present. A
summary of bad login attempts may be viewed using lastb, see last(1).
If /etc/securetty is present, login security is in effect and the super-
user may only login successfully on the ttys listed in this file. Ttys
are listed by device name, one per line. Valid tty names are dependent
on installation. Some examples could be "console", "tty01", "ttya1",
etc. Note that this feature does not inhibit a normal user from using
su.
Xlogin will start the X Window System environment for only a specific
list of login shells. The recognized shells are /bin/sh, /bin/csh, and
/bin/ksh. If the login shell is something else, then xlogin will
terminate the X server, and then exec the indicated shell. This insures
that restricted shells and other non-standard shells behave correctly.
FILES
/etc/btmp history of bad login attempts
/etc/logingroup group file - defines group access lists
/etc/passwd password file - defines users, passwords, and
primary groups
/etc/securetty list of valid ttys for root login
/etc/utmp users currently logged in
/etc/wtmp history of logins, logouts, and date changes
VARIABLES
HOME The users home directory.
PATH The path to be searched for commands.
SHELL Which command interpreter is being used.
MAIL Where to look for mail.
TERM The user's terminal type.
TZ The current timezone.
START ADDED XDEFAULTS
X RESOURCES
The following resources can be defined in your .Xdefaults file to
customize xlogin to be the way you want it. Other combinations are
possible, using classes, wild cards, and such. For more details, see the
X documentation. System defaults are stored in the file
/usr/lib/X11/app-defaults/XLogin.
Overall Login Screen Colors
Foreground Color used for overall screen boarders and text.
Background Color used for overall screen background.
Colors for User Prompts
Prompt*foreground Color used for prompt text.
Prompt*font Font used in login prompt.
login_label*string Login prompt string. The default string is "Login:".
password_label*string
Password Prompt String. The default is "Password:".
Setup of User Reply
Reply*foreground Color used for reply text.
Reply*Background Color used in the background of reply box.
Reply*cursor Color of reply box text cursor. The default is Red.
Reply*topShadowColor
Color of top and left sides of the pushbuttons.
Reply*bottomShadowColor
Color of bottom and right sides of the pushbuttons.
Reply*highlightColor
Color used to highlight the exterior of the active
reply box.
Reply*highlightThickness
Integer width in pixels of the highlighting. The
default is 3.
Reply*font font used for the user reply text. The default is
swd-s30.
Setup of Push Buttons
PushButton*hSpace Space to right and left of the pushbutton label in
pixels. The default is 5.
PushButton*vSpace Space above and below the pushbutton label in pixels.
The default is 5.
Push Button Label Text
ok.label OK push button label. The default is "OK".
clear.label CLEAR push button label. The default is "Clear".
no_windows.label No Windows push button label. The default is "No
Windows".
help.label HELP push button label. The default is "Help".
wrong*foreground
Color used for the Error Message text. The default
is Red.
wrong*font Font used for the Error Message. The default is
hp8.10x20.
wrong*string Error Message text. The default is Illegal or
Improper Login... Try Again .
EXAMPLES
HP supplies the following defaults in the file /usr/lib/X11/app-
defaults/XLogin.
Overall Colors
XLogin*Foreground: Black
XLogin*Background: White
User Prompts (for login and password)
XLogin*Prompt*foreground:Black
XLogin*Prompt*background:White
XLogin*Prompt*cursor:Red
XLogin*Prompt*font: swd-s30
Prompt Strings
XLogin*login_label*string:Login:
XLogin*password_label*string:Password:
User Replys (for login and password)
XLogin*Reply*topShadowColor:LightBlue
XLogin*Reply*bottomShadowColor:DarkSlateBlue
XLogin*Reply*foreground:Black
XLogin*Reply*Background:White
XLogin*Reply*cursor: Red
XLogin*Reply*highlightColor:Cadet Blue
XLogin*Reply*highlightThickness:3
XLogin*Reply*font: swd-s30
Overall Button extra Space
XLogin*PushButton*hSpace:5
XLogin*PushButton*vSpace:5
Push Button Labels
XLogin*ok.label: OK
XLogin*clear.label: Clear
XLogin*no_windows.label:No Windows
XLogin*help.label: Help
Error Message, which shows up below
XLogin*wrong*foreground:Red
XLogin*wrong*font: hp8.10x20
XLogin*wrong*string: Illegal or Improper Login... Try Again
END ADDED XDEFAULTS
SEE ALSO
login(1), xsession(1), last(1), newgrp(1), passwd(1), sh(1), su(1),
getty(1M), initgroups(3C), dialups(4), group(4), passwd(4), profile(4),
utmp(4), environ(5).
DIAGNOSTICS
The following diagnostics will appear if problems occur:
Login incorrect:
if the user name or the password cannot be matched.
No shell, cannot open password file, or no directory:
consult your system manager.
Your password has expired. Choose a new one:
if password aging is implemented.
No Root Directory:
attempted to log into a subdirectory that does not exist
(i.e., passwd file entry had shell name "*", but the
system cannot chroot to the given directory).
No /bin/login or /etc/login on root:
same as above except sub-root login command not found.
Bad user id. or Bad group id.:
setuid or setgid failed.
Unable to change to directory <name>:
cannot chdir to your home directory.
No shell: your shell (or /bin/sh if your shell name is null in
/etc/passwd) could not be exec'd.
cannot run unrecognized shell from windows:
This message occurs if the login shell is not recognized
by xlogin. The recognized shells are /bin/sh, /bin/csh,
and /bin/ksh. For unrecognized shells, xlogin terminates
the X server then spawns the unrecognized shell without
the windows environment.
Sorry, single-user:
occurs if the version field from uname(2) starts with A
(or if the uname system call fails) and if your terminal
name is not /dev/console and if your home shell is not
named /usr/lib/uucp/uucico. You are not logged in.
No utmp entry. You must exec "login" from the lowest level "sh":
if you attempted to execute login as a command without
using the shell's exec internal command or from other than
the initial shell.
.rhosts is a soft link:
if your personal equivalence file is a symbolic link.
Bad .rhosts ownership:
if your personal equivalence file is not owned by the
local user or by the super-user.
Remuser too long, locuser too long, or terminal type too long:
if the indicated string was too long for xlogin's internal
buffer.
AUTHOR
Xlogin was derived from login, which was developed by AT&T and HP.