/usr/dt/share/man/cat1/dtsession.1(/usr/dt/share/man/cat1/dtsession.1)
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
NAME
dtsession - the TED Session Manager
SYNOPSIS
dtsession [options] NOTE : The dtsession client is automati-
cally invoked by the DT Login Manager (dtlogin(1X)) via the
Xsession script. If desired, dtsession may be started via
the Xsession script on an existing X server. NOTE : dtses-
sion automatically starts a window manager.
DESCRIPTION
The dtsession client provides ICCCM 1.1 compliant session
management functionality during a user's session, the time
from login to logout. It launches a window manager and
allows for saving a session, restoring a session, locking a
session, launching screen savers and allocating colors for
desktop compatible clients.
Key Supported Tasks
The dtsession client supports the following key tasks:
- Initializing a session. - Launching a window
manager. - Restoring a `home' or `current' session. -
Providing session locking on command or timeout. -
Providing session screen saving on command or timeout.
- Acting as a color allocation server for other DT
clients. - Saving a `home' or `current' session. -
Displaying confirmation dialog at logout. - Displaying
session selection dialog at logout. - Terminating a
session.
A Session
A session is the collection of applications, settings and
resources that are present on the user's desktop. Session
management is a set of conventions and protocols that allow
a special session manager such as dtsession to save and
restore a user's session. A user is able to log into their
system and be presented with the same set of running appli-
cations, settings and resources as were present when the
user logged off. When a user logs into the desktop for the
first time, a default initial session is loaded. Afterward,
dtsession supports the notion of a current and a home ses-
sion.
The Initial Session
When a user logs into the desktop for the first time, dtses-
sion will generate the user's initial session using system
default values. Refer to Session Resource Management and
Session Application Management for more information.
Unix System LaboratoLast change: 1 August 1995 1
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
The Current Session
The user's running session is always considered the current
session, whether restored upon login from a saved home ses-
sion, a saved current session or the system default initial
session. Based on the user's Style Manager Startup settings,
when the user exits the session, the current session is
automatically saved. When the user next logs into the desk-
top, the previously saved current session is restarted. This
means that the desktop will be restored to same state as it
was when the user last logged out.
The Home Session
Another option is having the desktop be restored to the same
state every time the user logs in, regardless of its state
when the user logged out. The user may save the state of the
current session, then via the Style Manager Startup set-
tings, have the desktop start that session every time the
user logs in.
Display-specific Sessions
To run a specific session for a specific display, a user may
create a display-specific session. To do this, the user can
copy the $HOME/.dt/sessions directory to $HOME/.dt/display
where display is the real, unqualified hostname (for exam-
ple, pablo:0 is valid, pablo.gato.com:0 or local:0 is not).
When the user logs in on display pablo:0, that display
specific session will take precedence.
The ICCCM Session Management Protocol
For an application to be saved upon logout and restarted
upon login, it must participate in a simple session manage-
ment protocol. Dtsession supports the ICCCM 1.1 Session
Management Protocol.
Applications that wish to save their state can take part in
the WM_SAVE_YOURSELF protocol. To do this, an application
needs to set the WM_SAVE_YOURSELF property on one and only
one of its top-level windows. When a session is saved,
dtsession will send the application's top-level window a
WM_SAVE_YOURSELF client message. At this point the applica-
tion can proceed to quietly save its state. The application
cannot interact with the user in any way as it is saving its
state. As an application will likely save its state into a
file, the session manager provides a convenience function
DtSessionSavePath() which returns a full pathname of a file
in which an application can save its state. While the appli-
cation is saving its state, dtsession is awaiting notice
from the application that it is done. To tell dtsession that
the state save is complete, the application needs to update
the WM_COMMAND property on its top-level window.
Unix System LaboratoLast change: 1 August 1995 2
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
The WM_COMMAND property on an application's top-level window
serves two purposes. First, a change of this property is the
indication to dtsession that an application is done saving
its state and dtsession can proceed to the next application.
Second, the WM_COMMAND property value is expected to contain
the command line that dtsession will use to restart the
application at session startup. If an application is
launched with a full pathname, then it should use the full
pathname when setting WM_COMMAND. Applications that do not
need to save their state, but wish to be restarted, can sim-
ply set WM_COMMAND during application startup and forget
about it.
Refer to the XmAddWmProtocols(), XmAddWMProtocolCallback()
and XSetCommand() API's for more information.
Restoring A Session
At session startup time, dtsession will determine which ses-
sion to restore. The following describes the precedence: -
Display-specific Current or Home Session -OR- - Current or
Home Session -OR- - Initial Session
Session Resource Management
The session manager uses the X Server RESOURCE_MANAGER pro-
perty on which to make available desktop resources to all
applications. The session manager will load the
RESOURCE_MANAGER in the following manner: - load the system
default resources -AND- - merge any system administrator
specified resources -AND- - merge any user specified
resources
The desktop default resources can be found in
/usr/dt/config/$LANG/sys.resources. These resources will be
made available to each user's session via the
RESOURCE_MANAGER property. This file should not be edited as
it will be unconditionally overwritten upon subsequent desk-
top installations.
A system administrator may augment the system default
resources by creating /etc/dt/config/$LANG/sys.resources. In
this file, a system administrator may override system
default resources or specify additional resources. As this
file is merged into the desktop default resources during
session startup, it is preferrable that only new or updated
resource specifications be placed in this file, rather than
a copy being made of the desktop default resource file.
Resources specified in this file will be made available to
each user's session via the RESOURCE_MANAGER property.
Resources specified in this file take precedence over those
specified in the desktop default resource file.
Unix System LaboratoLast change: 1 August 1995 3
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
A user may augment the desktop default and system adminis-
trator resources via their $HOME/.Xdefaults file. Resources
specified in this file will be made available to only that
user's session via the RESOURCE_MANAGER property. Resources
specified in this file take precedence over those specified
in the desktop default or system administrator resource
files.
NOTE : The X Toolkit Intrinsics specifies that it will load
resources for an application from either RESOURCE_MANAGER or
from $HOME/.Xdefaults, but not both. Ordinarily, this would
mean that the user's $HOME/.Xdefaults file would be ignored.
However, the session manager accomodates $HOME/.Xdefaults by
merging it into the RESOURCE_MANAGER at session startup as
described above. If a user changes their $HOME/.Xdefaults,
their changes will not be visible to new applications until
the user invokes the ReloadResources action.
The ReloadResources action will instruct the session manager
to reload the RESOURCE_MANAGER with the system, system
administrator and user specified resources. This is useful
to make available to new applications changes made to system
administrator or user specified resource files.
See also dtresourcesfile(4) and dtsessionactions(5).
Session Application Management
At session startup, the session manager will restart any
applications that were saved as part of the session. The
system default set of applications to be restored as part of
the user's Initial Session can be found in
/usr/dt/config/$LANG/sys.session. This file should not be
edited as it will be unconditionally overwritten upon subse-
quent desktop installations.
See also dtsessionfile(4).
A system administrator may replace the set of applications
that are restored as part of the user's Initial Session by
creating a file named /etc/dt/config/$LANG/sys.session.
Unlike the resource files, this file will be used as a com-
plete replacement for the desktop default file, so it is
valid to make a copy of the system default file and make any
necessary modifications.
The Window Manager
Dtsession is responsible for starting the window manager. By
default /usr/dt/bin/dtwm is started. An alternate window
manager can be specified with the wmStartupCommand resource.
Refer to the Workspace Manager specification for more infor-
mation.
Unix System LaboratoLast change: 1 August 1995 4
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
The Style Manager
The style manager provides the interface by which a user can
change various desktop and X server settings for the current
session. Refer to the Style Manager specification for more
information.
The Color Server
Dtsession serves as the color server for the desktop and
provides a set of resources that can be used to configure
it. The foregroundColor resource controls whether a pixel is
allocated for the foreground color. The dynamicColor
resource specifies whether read-only colors are allocated.
The shadowPixmaps resource specifies whether colors are
allocated for top shadow or bottom shadow. The colorUse
resource limits color allocation. Finally, the wri-
teXrdbColors resource specifies whether the *background and
*foreground resources are placed in the resource database.
See the Color Server Resources section and the Color Model
specification for more information.
Session Lock
Dtsession provides session locking. The current session can
be locked directly by pressing the lock icon on the front
panel. If supported by the X server, the current session can
be locked after a specified period of inactivity. To unlock
the session, the user must enter their login password.
By default, dtsession supports traditional local UNIX
authentication for unlocking the session. Additional re-
authentication function such as that required by DCE may be
added by individual vendors.
Screen Savers
Dtsession provides support for the launching of external
screen savers as a part of session locking from the front
panel or, if supported by the X server, after a specified
period of inactivity. Refer to the Screen Saver specifica-
tion for information as to how screen savers are integrated
into the desktop.
X Server Screen Saver Extensions
Dtsession's ability to provide session lock or screen saver
launch after a specified period of inactivity depends upon
the availability of an X server screen saver extension.
Dtsession supports two such extensions:
- X Consortium Sample X11 Screen Saver Extension 1.0 -
HP X Screen Saver Extension
The ability of dtsession to recognize both, either or none
of these extensions is vendor specific.
Unix System LaboratoLast change: 1 August 1995 5
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
Launching The Session Manager
Dtsession should be launched from the Xsession script. Xses-
sion is described in the login manager specification. It is
recommended that Xsession be launched from dtlogin as part
of the login sequence as is the default but there are alter-
native methods of starting Xsession:
dtlogin the default dtlogin configuration launches
Xsession when a user logs in
proxy some systems will allow programs such as
xinit, x11start or startx to start Xsession
OPTIONS
The dtsession client is automatically invoked by the DT
Login Manager (dtlogin(1X)). If desired, dtsession may also
be started on an existing X server. Note that dtsession
automatically starts a window manager.
-norestore
This option instructs dtsession not to restore a previous
session nor save the session upon logout.
RETURN VALUE
Exit values are:
0 Successful completion.
>1 Error condition occurred.
EXAMPLES
dtsession -norestore
Start session manager from command line without restoring
previous session.
RESOURCES
Color Server
Name ClassClass Type Default
_____________________________________________________
colorUse ColorUse String DEFAULT
dynamicColor DynamicColor Boolean True
foregroundColor ForegroundColor String DYNAMIC
shadowPixmaps ShadowPixmaps String DEFAULT
writeXrdbColors WriteXrdbColors Boolean True
_____________________________________________________
Screen Lock/Screen Save
Name ClassClass Type Default
___________________________________________________________
keys Keys unsigned char NULL
passwordTimeout passwordTimeout unsigned int 10
Unix System LaboratoLast change: 1 August 1995 6
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
___________________________________________________________
Miscellaneous
Name ClassClass Type Default
_____________________________________________________________________
queryServerSettings QueryServerSettings Boolean False
saveFontPath SaveFontPath Boolean False
wmStartupCommand WmStartupCommand executable path NULL
_____________________________________________________________________
colorUse - DEFAULT
This resource specifies the number of colors to use for the
user interface. Valid types are: Color server will determine
type of monitor based upon number of display planes of the
screen as follows:
1,2 B_W
4 LOW_COLOR
6 MEDIUM_COLOR
7+ HIGH_COLOR
B_W - Specifies a black and white system. The color palettes
will use two color cells for the user interface. In this
configuration only two color palettes are available:
BlackWhite and WhiteBlack. These palettes cannot dynami-
cally change. To change a palette, all applications using
that color palette must be restarted. This resource value
forces ShadowPixmaps to True, and ForegroundColor to either
black or white depending on the palette chosen.
LOW_COLOR - Specifies a low color system. The color palettes
will have two color sets and use a maximum of 12 color cells
for the user interface, including black and white (color
cells 0 and 1). The number of co ShadowPixmaps and Fore-
groundColor.
MEDIUM_COLOR - Specifies a medium color system. The color
palettes will have 4 color sets and use a maximum of 22
color cells for the user interface, including black and
white (color cells 0 and 1). The number of color cells can
be reduced by using the resources ShadowPixmaps and Fore-
groundColor.
HIGH_COLOR - Specifies a high color system. The color
palettes will have 8 color sets and use a maximum of 42
color cells for the user interface. including black and
white (color cells 0 and 1). The number of color cells can
be reduced by using the resources ShadowPixmaps and Fore-
groundColor.
Unix System LaboratoLast change: 1 August 1995 7
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
dynamicColor
This resource can have values of True or False. dynamicColor
is used to reduce the number of color cells being used. Once
a palette has been selected and it is not likely to be
changed, dynamicColor can be set to False. If set to False
colors cannot be dynamically changed using the DT style
manager. A selected palette will take effect the next ses-
sion. The next time the session comes up, the color server
uses Read Only color cells that can be shared by all
clients, thus reducing the number of color cells used.
foregroundColor
This resource can have values of White, Black or Dynamic.
ForegroundColor causes all text (foreground) to use either
pixel 0 or 1 (Black or White) or to have a color cell dedi-
cated to foreground and changes in response to the back-
ground color (Dynamic) for each ColorSet. If set to White or
Black, the number of color cells used per ColorSet is
reduced by 1.
keys
This resource is a list of keyholders who have the ability
to unlock the screen any time it is locked by the user. The
list is a list of user id's separated by commas. For example
if user kim has the following resource active during a ses-
sion:
Dtsession*keys: fred,keith
Users fred and keith have the ability to unlock the
display when kim locks it.
passwordTimeout
This resource specifies (in seconds) the amount of time
before the password dialog is removed from the screen. When
the display is locked, the pointer shows a lock cursor, and
a dialog appears which asks for the user password. If no
activity from the pointer or keyboard is detected for
passwordTimeout seconds, the dialog is removed from the
screen. The dialog is redisplayed as soon as a pointer or
keyboard event is detected. An passwordTimeout of 0 leaves
the password dialog in place for the entire time the display
is locked. The default value is 10 seconds.
queryServerSettings
This resource specifies whether dtsession queries the server
at logout for all its settings or saves only those settings
set by using the DT Style Manager. Querying the server
ensures that all settings are saved; however, there is a
degradation in performance when a full query is done. The
default value is False, which means that the server will not
Unix System LaboratoLast change: 1 August 1995 8
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
be queried.
shadowPixmaps
For color systems, this resource can have a value of True or
False. If True, topShadowColor and bottomShadowColor use the
same pixel as background and topShadowPixmap and bottomSha-
dowPixmap are specified instead of solid color to create the
3D look. This reduces the number of color cells per ColorSet
by 2. ShadowPixmaps defaults to True for systems with 4 or
less color planes (16 or less color cells), and False for
systems with more than 4 color planes.
wmStartupCommand
This resource allows for an alternate window manager to be
started at login. If this resource is NULL , dtsession
starts /usr/dt/bin/dtwm. An alternate startup might look
like: Dtsession*wmStartupCommand: /usr/bin/X11/mwm NOTE :
that the command should not have any commands to a shell in
it, and that it should not be surrounded by quotes. Also, if
any other window manager other than dtwm is used, clients
will be restored, but may not be restored to the correct
position. By default, this resource contains a NULL value.
FILES
/usr/dt/config/$LANG/sys.session
The desktop default set of applications for
the user's Initial Session.
/etc/dt/config/$LANG/sys.session
System Administrator specified set of appli-
cations for the user's Initial Session.
/usr/dt/config/$LANG/sys.resources
The desktop default resources.
/etc/dt/config/$LANG/sys.resources
System administrator specified resources.
$HOME/.Xdefaults
User specified resources.
Dtsession stores session information in $HOME/.dt/display or
$HOME/.dt/sessions. The content of these directories should
not be directly edited by the user.
/usr/dt/app-defaults/$LANG/Dtsession
Default dtsession resources.
SEE ALSO
See related specifications:
Unix System LaboratoLast change: 1 August 1995 9
dtsession(1X) MISC. REFERENCE MANUAL PAGES dtsession(1X)
dtstyle Customization of many session properties
dtscreen Desktop screen savers
dtwm Window manager
dtlogin Login manager
dtsessionaction
Session manager actions
dtsessionfile Format and location of desktop session files
dtresourcesfile
Format and location of desktop resource files
Unix System LaboratoLast change: 1 August 1995 10
See also dtsession(1)
Man(1) output converted with
man2html