CDE/cde/programs/dtsession/dtsession.man

.\" $XConsortium: dtsession.man /main/2 1995/07/17 10:51:34 drk $
.\" *                                                                      *
.\" * (c) Copyright 1993, 1994 Hewlett-Packard Company                     *
.\" * (c) Copyright 1993, 1994 International Business Machines Corp.       *
.\" * (c) Copyright 1993, 1994 Sun Microsystems, Inc.                      *
.\" * (c) Copyright 1993, 1994 Novell, Inc.                                *
.\" *
.TH DTSESSION 1X
.ds ]W HP DT 3.0
.SH NAME
\fBdtsession \(em The HP DT Session Manager.\fP
.sp 1
.SH SYNOPSIS
.B dtsession
[options]
.sp 1
.SH DESCRIPTION
\fIDtsession\fP provides session management functionality during an HP DT
session, the time from login to logout.  It allows for saving a session, 
restoring a session, locking a session, and allocating colors for HP DT 
compatible clients.
.P
When a session is saved, client information, server settings, and
resources are retained.  Client information consists of
all clients currently active in the session.  Server settings consist of
settings (such as the beeper or keyboard) that are modified by a call to
the server.  Resources consist of all resources currently stored on the
\fBRESOURCE_MANAGER\fP property on the root window of the default screen.
.P
The session is locked by pressing the "lock" button on the workspace manager
(front panel).
When the display is locked, no further input is accepted until a correct
password is entered.  Correct passwords include the user who locked the
display, the root password for the system, and any users specified in
the \fBkeys\fP resource.
.P
Color allocation provides each client with a set of colors which are used
in creating visual components.  These colors can then be dynamically
changed by using the HP DT Style Manager (\fIdtstyle(1X)\fP).
.P
\fIDtsession\fP is automatically invoked by the HP DT Login Manager
(\fIdtlogin(1X)\fP).  If the
HP DT Login Manager is not currently being used, \fIdtsession\fP can
be invoked by putting the following command in an .xsession or .x11start
file:
.P
/usr/dt/bin/dtsession -norestore
.P
WARNING:  This command must be the first X11 client in the file (other
than xrdb).  It must be run in the foreground.  When using this command,
no save and restore functionality is available.  Any calls that start
up window managers must be removed from the startup file.  The default
window manager can only be changed by setting the \fBwmStartupCommand\fP 
resource.
.sp 1
.SH OPTIONS
.TP 8
.BI \-norestore
This option allows users to use \fIdtsession\fP in a limited way.  The
advantage of using this option is that \fIdtsession\fP can be started
directly from an .x11start or .xsession script.  See use and warning above.
.SH CUSTOMIZATION
\fIDtsession's\fP behavior can be customized through the use of the HP DT 
Style Manager's startup dialog.  The following is the behavior that can be
customized.
.sp 1
.TS
center;
cB s
lB lB
l l.
HP DT Session Manager Customization Options
Name	Default
Display Logout Confirmation	On
Set Home Session	N/A
Startup Behavior	Resume Current Session
.TE
.sp 1
.TP 8
.BR "Display Logout Confirmation"
"Display Logout Confirmation" allows you to toggle the appearance of the logout
confirmation box that appears after you click on the logout button
located in the workspace manager, or choose the "Log out..." option available in
the \fIdtwm\fP root menu.  Setting the button displays the logout dialog.
Clearing the button causes immediate exit with no
confirmation.  The default behavior is that the logout confirmation
dialog will be displayed.
.TP 8
.BR "Set Home Session"
The "Set Home Session" button allows you to save a home session for use
later.  The home session is a "snapshot" session that you can return to
by changing logout options.
.TP 8
.BR "Startup Behavior"
The startup behavior allows you to specify which state the HP DT Session
Manager will restore upon startup (login).  The default is that it
automatically restarts the state you were in at logout (Resume Current
Session).  The other
states available are "Return to Home Session" and "Ask Me at Logout."  "Return
to Home Session" returns you to the last saved home session at next
startup.  "Ask Me at Logout" allows you to choose which behavior you would
prefer at logout time.  If "Return to Home Session" is chosen, a home
session has to have been previously saved.  Otherwise the default system
session will appear at next login.  Note that "Ask Me at Logout" cannot be
active while "Display Logout Confirmation" is turned off.
.SH RESOURCES
\fIDtsession\fP uses the following resources.
.sp 1
.TS
center;
cB sss
lB lB lB lB
l l l l.
HP DT Session Manager Resource Set
Name	Class	Type	Default
_
alarmTime	AlarmTime	unsigned int	10
colorUse	ColorUse	int	dynamic*
coverScreen	CoverScreen	Boolean	False
dynamicColor	DynamicColor	Boolean	True
foregroundColor	ForegroundColor	int	dynamic*
lockOnTimeout	LockOnTimeout	Boolean	False
keys	Keys	unsigned char	NULL
queryServerSettings	QueryServerSettings	Boolean	False
shadowPixmaps	ShadowPixmaps	int	dynamic*
wmStartupCommand	WmStartupCommand	executable path	NULL
writeXrdbColors	writeXrdbColors	Boolean	True
.TE
.ps 7
\h'30p'*The display type determines default.
.ps
.sp 1
.IP "\fBalarmTime\fP"
This resource specifies (in seconds) the amount of time before the lock
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 \fBalarmTime\fP seconds, the dialog is removed from the screen.  The lock
dialog is redisplayed as soon as a pointer or keyboard event is
detected.  An
\fBalarmTime\fP of 0 leaves the lock dialog in place for the entire time the
display is locked.  The default value is 10 seconds.
.IP "\fBcolorUse\fP"
This resource specifies the number of colors to use for the user interface.
Valid types are:
.RS
.IP \(bu 3
\fBB_W\fP \(em  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 dynamically change.  To change a palette,
all applications using that color palette must be restarted.
This resource value forces \fBShadowPixmaps\fP to True, and 
\fBForegroundColor\fP to either black or white depending on the palette chosen.
.IP \(bu 3
\fBLOW_COLOR\fP \(em 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 color cells can be reduced by using the resources 
\fBShadowPixmaps\fP and \fBForegroundColor\fP.
.IP \(bu 3
\fBMEDIUM_COLOR\fP \(em 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 
\fBShadowPixmaps\fP and \fBForegroundColor\fP.
.IP \(bu 3
\fBHIGH_COLOR\fP \(em 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 
\fBShadowPixmaps\fP
and \fBForegroundColor\fP.
The default value for this resource will be determined by querying
the X server for the number of color cells on the system.
.RE
.sp 1
.TS
center;
cb  cb
l | l.
planes	ColorUse
_
2-3	B_W
4	LOW_COLOR
6	MEDIUM_COLOR
8+	HIGH_COLOR
.TE
.sp 1
.IP "\fBcoverScreen\fP"
This resource specifies whether or not the screens of the display will
be covered when the display is locked.  The default value is True,
which means that the screens will be covered.

.IP "\fBdynamicColor\fP"
This resource can have values of True or False.  \fBdynamicColor\fP 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,  \fBdynamicColor\fP 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 session.
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.

.IP "\fBforegroundColor\fP" 
This resource can have values of White, Black or Dynamic.
\fBForegroundColor\fP causes all text (foreground) to use either pixel 0 
or 1 (Black
or White) or to have a color cell dedicated to foreground and changes in
response to the background color (Dynamic) for each ColorSet.
If set to White or Black, the number of color cells used per ColorSet is
reduced by 1.
.IP "\fBkeys\ \ \ \ \      \fP"
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 session:
.sp 1
\fBDtsession*keys: fred,keith\fP
.sp 1
Users fred and keith have the ability to unlock the display when kim
locks it.
.IP "\fBlockOnTimeout\fP"
This resource specifies whether or not dtsession will lock the screen
when there has been a period of time without pointer or keyboard activity.
The default value is False,
which means that the screen will not be locked automatically.  This 
resource only applies when using a server that has the ability to 
notify dtsession when the period of inactivity has occurred.
.IP "\fBqueryServerSettings\fP"
This resource specifies whether \fIdtsession\fP queries the server at
logout for all its settings or saves only those settings set by using
the HP 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 be queried.
.IP "\fBshadowPixmaps\fP"
For color systems, this resource can have a value of True or False.
If True, \fBtopShadowColor\fP and \fBbottomShadowColor\fP use the same
pixel as background and \fBtopShadowPixmap\fP and 
\fBbottomShadowPixmap\fP are specified
instead of solid color to create the 3D look.
This reduces the number of color cells per ColorSet by 2.
\fBShadowPixmaps\fP 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.
.IP "\fBwmStartupCommand\fP"
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:
.sp 1
\fBDtsession*wmStartupCommand: /usr/bin/X11/mwm\fP
.sp 1
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 \fIdtwm\fP is used, clients will be restored,
but may not be restored to the correct position.  By default, this resource
contains a NULL value.
.IP "\fBwriteXrdbColors\fP"
This resource should only be used if you are running non HP Motif 1.1 clients
that have color schemes that conflict with HP DT colors.  This has no
impact on clients linked with the Motif 1.1 library.  This resource
specifies whether color resource information should be written out.
If set to False, \fBbackground\fP and \fBforeground\fP resources will not
be written out with the values of the current palette.  This means that
non HP Motif 1.1 clients will not get HP DT colors when they are started.
The default value is True.
.sp 1
.SH COPYRIGHT
Copyright 1990, 1991, 1992 Hewlett-Packard Company.
.br
(c) Copyright 1993, 1994 Hewlett-Packard Company
.br
(c) Copyright 1993, 1994 International Business Machines Corp.
.br
(c) Copyright 1993, 1994 Sun Microsystems, Inc.
.br
(c) Copyright 1993, 1994 Novell, Inc.
.sp 1 
.SH ORIGIN
Hewlett-Packard Comany UTD-CV.
.br
International Business Machines Corp.
.br
Sun Microsystems, Inc.
.br
Novell, Inc.
.sp 1
.SH SEE ALSO
\fBX(1)\fP, \fBdtstyle(1X)\fP, \fBdtwm(1X)\fP, \fBdtlogin(1X)\fP.