Changing the Login Screen Appearance

To customize the login screen appearance, you can change the logo or graphic, the welcome messages, and the fonts.

To modify Xresources, copy Xresources from /usr/dt/config/language to /etc/dt/config/language. The login screen will reflect any changes the next time the login screen is displayed. To force a redisplay of a login screen, select Reset Login Screen from the login screen Options menu.

Attributes of the login screen that can be determined by resource specifications in the Xresources file include:

`DtloginlogobitmapFile`	Bitmap or pixmap file to display as logo image
`DtlogingreetinglabelString`	Welcome message
`DtlogingreetingpersLabelString`	Personalized welcome message
`DtlogingreetingfontList`	Font for welcome messages
`Dtlogin*labelFont`	Font for push buttons and labels
`Dtlogin*textFont`	Font for help and error messages
`Dtlogin``language``languageName`	Alternate text for locale name `language`

To Change the Logo

Set the Dtlogin*logo*bitmapFile resource in Xresources.
The logo can be a color pixmap or a bitmap file.

The following example uses the Mylogo bitmap as the logo:

Dtlogin*logo*bitmapFile: /usr/local/lib/X11/dt/bitmaps/Mylogo.bm

To Change the Welcome Message

By default, the login server displays the message Welcome to host name on the login screen. To change this message:

Set the Dtlogin*greeting*labelString resource in Xresources.
The value of the labelString resource can contain %LocalHost%, which will be replaced by the login server host name, and %DisplayName%, which will be replaced by the X server display name.

The following example changes the welcome message to Here's host name!:

Dtlogin*greeting*labelString: Here's %LocalHost%!

Once the user name has been entered, the login server displays the message Welcome username by default. You can change this message by setting the Dtlogin*greeting*persLabelString resource in Xresources. The value of the persLabelString can contain %s, which will be replaced by the username.

The following example changes the personalized welcome message to Hello username.

Dtlogin*greeting*persLabelString: Hello %s

To Change the Fonts

You can change the fonts used on the login screen by setting one of the following font resources in Xresources:

To list the available fonts, type:

xlsfonts [-options] [-fn pattern]

`DtlogingreetingfontList`	Font for welcome messages
`Dtlogin*labelFont`	Font for push buttons and labels
`Dtlogin*textFont`	Font for help and error messages

The following example uses a large font for the welcome message (the value you specify must be contained on one line):

Dtlogin*greeting*fontList: -dt-interface system-medium-r-normal-xxl*-*-*-*-*-*-*-*-*:

To Provide Alternate Text to Display for Each Language

To display per-locale text on the login screen Language menu instead of the default display of the locale name, modify the Dtlogin*language*languageName resource name resource in Xresources:

Dtlogin*En_US*languageName: American

The text American will now be displayed rather than the locale name En_US.

Changing the Login Screen Behavior

To customize the login screen behavior, you can modify resources specified in the Xconfig file.

To modify Xconfig, copy Xconfig from /usr/dt/config to /etc/dt/config. After modifying /etc/dt/config/Xconfig, tell the login server to reread Xconfig by typing:

/usr/dt/bin/dtconfig -reset

This which issues the command kill -HUP login server process ID)

Resources specified in the Xconfig file include:

`Dtlogin*authorize`	Xaccess file specification
`Dtlogin*environment`	X server environment
`Dtlogin*language`	Default language
`Dtlogin*languageList`	Language list for login screen Language menu
`Dtlogin*resources`	Xresources specification
`Dtlogin*setup`	Xsetup file specification
`Dtlogin*`startup	Xstartup file specification
Dtlogin*session	Xsession file specification
Dtlogin*failsafeClient	Xfailsafe script specification
Dtlogin*reset	Xreset script specification
Dtlogin*userPath	PATH for Xsession and Xfailsafe
Dtlogin*systemPath	PATH for Xsetup, Xstartup and Xfailsafe
Dtlogin*systemShell	SHELL for Xsetup, Xstartup and Xfailsafe
Dtlogin.timeZone	TZ for all scripts

Changing the Login Screen Behavior Per Display

In the examples below, changing an Xconfig resource changes the login screen behavior for all displays. The resources listed with an * (asterisk) can be specified on a per-display basis. This enables you to specify custom login screen behavior for certain displays. To specify a resource for a particular display, the resource is specified as Dtlogin*displayName*resource. For example, if you would like to turn off user based access control for display expo:0 but leave it on for other displays, you would specify:

Dtlogin*expo_0*authorize: False




	NOTE: Any special character in the display name, such as a: (colon) or. (period), is replaced by an _ (underbar).

Changing the X Server Access

By default, the login server allows X server access control on a per user basis and is based on authorization data stored and protected in the HomeDirectory/.Xauthority file. Only users who can read this file are allowed to connect to the X server. Generally, this is the preferred method of X server access control.

An alternative to user-based access control is host-based access control. Using this method, if a host is granted access to the X server, any user on that host is allowed to connect to the X server. Reasons to use host-based control include:

Older R2 and R3 X clients will not be able to connect to an X server using user-based access control.
On unsecured networks, a snooper may be able to intercept the authorization data passed between the X client and X server on the network.

The Xconfig Dtlogin*authorize resource tells the login server to use user-based X server access control. To use host-based access control, change the authorize resource value to False, for example:

Dtlogin*authorize: False

To Change the X Server Environment

If you want to provide the X server with one or more environment variables and values when started by the login server, you can specify them using the Dtlogin*environment resource in Xconfig. For example:

Dtlogin*environment: VAR1=foo VAR2=bar

will make the variables VAR1 and VAR2 available to the local X server process. These variables will also be exported to the Xsession and Xfailsafe scripts.

To Change the Default Language

When the user logs in to the desktop from the login screen, the user session is run under the locale selected from the Language submenu of the Options menu. If the user does not select a language, the login server default language is used. You can control the value of the default language by setting the Dtlogin*language resource in Xconfig. For example:

Dtlogin*language: Ja_JP

Check your system documentation to determine the languages installed on your system.

To Change the Content of the Login Screen Language Menu

By default the login server creates the login screen Language menu containing a list of all locales installed on the system. When the user selects a locale from the login screen language list, the login server will redisplay the login screen in the selected locale. When the user subsequently logs in, the login server will start a desktop session for the user in that locale.

You can specify your own list of languages by modifying the Dtlogin*languageList resource in Xconfig:

Dtlogin*languageList: En_US De_DE

The login server now displays only En_US and De_DE in the login screen Language menu.

Issuing Commands Before the Login Screen Appears

After the X server has started but before the login screen appears, the login server runs the Xsetup script. Xsetup runs with root authority and issues commands needing to be run before the display of the login screen.

To modify Xsetup, copy Xsetup from /usr/dt/config to /etc/dt/config. The next time the login screen is displayed, the modified Xsetup will be run.

Issuing Commands Before Starting the User Session

After the user enters the user name and password and they are authenticated, but before the user session is started, the login server runs the Xstartup script. Xstartup runs with root authority and issues commands needing to be run as root prior to the user session start.

To modify Xstartup, copy Xstartup from /usr/dt/config to /etc/dt/config. The next time the user logs in, the modified Xstartup will be run.

Starting a Desktop Session

By default, the login server starts the user session by running the Xsession script. Xsession runs with the user's authority and issues commands needed to start the desktop.




	NOTE: Do not directly update the Xsession script.

See Chapter 2 “Configuring Session Manager” for information on how to customize the user's desktop session startup.

Starting a Failsafe Session

If the user selects Failsafe Session from the Sessions submenu of the login screen Options menu, the login server runs the Xfailsafe script. Xfailsafe runs with the user's authority and issues commands needed to start a minimal windowing environment, usually a Terminal window and an optional window manager.

To modify Xfailsafe, copy Xfailsafe from /usr/dt/config to /etc/dt/config. The next time the user logs in, the modified Xfailsafe will be run.

Providing an Alternative Desktop Session

An alternative desktop session — one other than the CDE session manager (dtwm) — can be configured and added to the CDE login Options Session menu. Each session is described in a configuraton file located in the /usr/dt/config/LANG/Xresources.d directory.

Alternative Desktop Session Resources

You can use the following resources to specify an alternate desktop session:

altDtsIncrement: Specifies an incremented count number to be appended to each of the following resources. Thus, n represents the appended integer.
altDtNamen: Specifies the name of the alternate desktop. This name will be used in the Sessions menu and appear in the login greet window.
altDtKeyn: Specifies a key file, which, if present, causes the alternate desktop to be added to the Options Session menu.Typically, this file is the desktop's window manager.
altDtStartn: Identifies the script used to start the alternate desktop.
altDtLogon: Provides the base name of the alternate desktop's icon logo.

For a complete example of adding an alternate desktop, refer to the dtlogin man page.

After the User's Session Ends

After the user exits the desktop or failsafe session, the login server runs the Xreset script. Xreset runs with root authority and issues commands needing to be run as root after the end of the user's session.

If you wish to modify Xreset, copy Xreset from /usr/dt/config to /etc/dt/config. The next time the user logs in, the modified Xreset will be run.

The Login Server Environment

The login server provides an environment that it exports to the Xsetup, Xstartup, Xsession, Xfailsafe and Xreset scripts. This environment is described in Table 1-1 “Login Server Environments” Additional variables may also be exported by the login server.

Table 1-1 Login Server Environments

`EnvironmentVariable`	`Xsetup`	`Xstartup`	Xsession	`Xreset`	`Description`
`LANG`	X	X	X	X	Default or selected language
`XAUTHORITY`	X	X	X	X	Alternate X authority file (optional)
`PATH`	X	X	X	X	Value of the *DtloginuserPath resource (Xsession, Xfailsafe*) or `DtloginsystemPath` resource (Xsetup, Xstartup, Xreset)
`DISPLAY`	X	X	X	X	X server connection number
`SHELL`	X	X	X	X	Shell specified in `/etc/passwd` (Xsession, Xfailsafe) or `DtloginsystemShell` resource (Xsetup, Xstartup, Xreset*)
`TZ`	X	X	X	X	Value of `Dtlogin.timeZone` resource or timezone determined from system
`USER`		X	X	X	User name
`HOME`		X	X	X	Home directory specified in /etc/passwd
`LOGNAME`		X	X	X	User name

Changing the User or System Path

The login server sets the PATH e nvironment variable when it runs the Xsession and Xfailsafe scripts. You can provide an alternate path to these scripts

To Change the User Path

Set the Dtlogin*userPath resource in Xconfig. For example:

Dtlogin*userPath:/usr/bin:/etc:/usr/sbin:/usr/ucb:/usr/bin/X11

To Change the System Path

Set the Dtlogin* systemPath resource in Xconfig. For example:

Dtlogin*systemPath: /usr/bin/X11:/etc:/bin:/usr/bin:/usr/ucb

To Change the System Shell

The login server sets the SHELL environment variable when it runs the Xsetup, Xstartup and Xfailsafe scripts. The default is /bin/sh. If you wish to provide an alternate shell to these scripts, you can set the Dtlogin*systemShell resource in Xconfig. For example:

Dtlogin*systemShell: /bin/ksh

To Change the Time Zone

The login server sets the TZ environment variable when it runs the Xsetup, Xstartup, Xsession, Xfailsafe, and Xreset scripts. The default value is derived from the system so usually you w ill not need to change this behavior. To provide an alternate time zone to these scripts, set the Dtlogin. timeZone resource in Xconfig. For example:

Dtlogin.timeZone: CST6CDT