clogin(1)clogin(1)NAMEclogin - login on the graphics console
SYNOPSIS
/usr/Cadmin/bin/clogin [ -f ] [ -g ]
DESCRIPTION
The clogin command is executed at the beginning of each session on the
graphics console. It replaces the functionality of the command login(1).
The choice between login(1) and clogin is made on the basis of the
configuration variable visuallogin(4). If this configuration variable is
set to on then clogin is used in place of login(1).
clogin displays a window containing two areas. The top area contains
either icons representing users who can log onto the system or an SGI-
logo design. The bottom area contains a text field into which the user
can type a login name.
To log in, the user must first enter the correct login name. This can be
done by typing it at the keyboard, or by clicking with the left mouse
button on the icon representing the user. The user must then click with
the left mouse on the button labeled Login or press the Enter key.
Quickly clicking twice on the user icon (double-clicking) will have the
same effect as typing the login name and pressing the Enter key.
If the user has a password, a second text field is displayed. The user
must now type the correct password and either click on the Login button
or press Enter. If the password is correct, the login process begins.
Otherwise, clogin returns to its initial state.
To log in to an account for which an icon is not displayed, the user must
type both the login name and the password.
Users whose home directory does not exist cannot log in with clogin and
the user accounts will not be displayed as icons.
The standard user icons may be replaced with color or black & white
images. clogin will check for the files $HOME/.icons/login.icon,
/usr/local/lib/faces/$USER and /usr/lib/faces/$USER for login images,
where $HOME represents the user's home directory and $USER represents the
user's login name. The files must be in SGI image library format, and
should be 100 by 100 pixels in size or smaller (although larger images
will be scaled down automatically). The images must be either RGB color
or black & white images; colormap images cannot be displayed correctly.
The login process for the graphics console may be automated by
configuring the system to autologin. The autologin process, when
enabled, bypasses the clogin login when a valid entry is read from
/etc/autologin. The entry is then used as the identity for the session.
Autologin is disabled by login once it has successfully initiated a
session on the graphics console. Autologin is enabled during boot time if
the /etc/autologin file exists.
Page 1
clogin(1)clogin(1)
If the user is logging in on the graphics console, xdm(1) initiates and
manages a login session. If the string FAILSAFE (or failsafe) is entered
after the name, xdm(1) will bypass its normal session initialization, and
give the user a single window shell. See xdm(1).
For more information on how the initial environment is configured, see
login(1).
NOTES
The file /etc/passwd.sgi is no longer used to determine which icons
appear on clogin, and it is not used by the User Manager either. The
/var/sysadm/config/clogin.conf file is used instead to customize the
behavior of clogin as described in the next paragraph. Please note that
the path name of clogin.conf is changed from /var/Cadmin/clogin.conf to
/var/sysadm/config/clogin.conf.
ConfigClogin(1M) is available again in IRIX 6.5 and later releases.
Accessible from the System Manager, it can be used to customize the
behavior of clogin, including hiding icons for certain users, displaying
generic desktop-style geometric icons instead of photo-style images for
users, and displaying a larger clogin window to show more users. When
all users are hidden, the top section of the clogin window will be blank.
When the environment variable noiconlogin(4) is set to on then icons are
not displayed and in its place is the SGI logo. To manually turn on the
SGI-logo design (no user icons will be visible), execute the following
command as root:
chkconfig noiconlogin on
The image file of the logo is /usr/Cadmin/images/cloginlogo.rgb. In IRIX
6.5.14 and later releases, other image files are available in the same
/usr/Cadmin/images directory: clogin-05.rgb, clogin-10.rgb, clogin-
18.rgb, clogin-21.rgb, clogin-25.rgb, and old-cloginlogo.rgb. The login
design can be customized by moving aside the original cloginlogo.rgb file
and copying one of the other designs into its place (as root).
Autologin is controlled by the existence of the /etc/autologin.on file.
The file is normally created at boot time to automate the login process
and then removed by login or clogin to disable the autologin process for
succeeding terminal sessions.
The following issue applies only to the clogin tool, and only if the
visuallogin variable is on (see the chkconfig(1M) reference page): With
visuallogin on, clogin provides only a rudimentary form of privacy
control and security; when it starts, it removes hosts from the access
list (see the xhost(1) reference page). Environments that require more
sophisticated measures should turn off the visuallogin variable to use
the default xdm login screen (see the xdm(1) reference page).
Page 2
clogin(1)clogin(1)
Clogin doesn't support the PATH variable in /etc/default/login.
By default, clogin does not hang when accessing files from down nfs
servers. This allows clogin to be accessible even when its face server
goes down. If this feature causes problems in your environment, it can
be disabled by changing the line:
*useNoHang: True
to:
*useNoHang: False
in the file /usr/lib/X11/app-defaults/Clogin.
OPTIONS-f Specifies the clogin window as the grab window.
-g Disables processing of requests and close downs on all
connections other than clogin.
FILES
/etc/passwd password file
/var/sysadm/config/clogin.conf clogin configuration file
/etc/config/noiconlogin configuration flag for displaying icons
/etc/autologin autologin user identity
/etc/autologin.on enable autologin at boot time
SEE ALSOxdm(1), login(1), passwd(4), visuallogin(4), updateclogin(1M).
Page 3
