294 lines
12 KiB
Groff
294 lines
12 KiB
Groff
.\" $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.
|