VUESESSION(1X) UNIX Programmer's Manual VUESESSION(1X)
NAME
vuesession - The HP VUE Session Manager.
SYNOPSIS
vuesession [options]
DESCRIPTION
Vuesession provides session management functionality during
an HP VUE session, the time from login to logout. It allows
for saving a session, restoring a session, locking a ses-
sion, and allocating colors for HP VUE compatible clients.
When a session is saved, client information, server set-
tings, and resources are retained. Client information con-
sists 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
RESOURCE_MANAGER property on the root window of the default
screen.
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 pass-
word is entered. Correct passwords include the user who
locked the display, the root password for the system, and
any users specified in the keys resource.
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 VUE Style
Manager (vuestyle(1X)).
Vuesession is automatically invoked by the HP VUE Login
Manager (vuelogin(1X)). If the HP VUE Login Manager is not
currently being used, vuesession can be invoked by putting
the following command in an .xsession or .x11start file:
/usr/vue/bin/vuesession -norestore
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 wmStartupCommand
resource.
HP VUE 3.0 1
VUESESSION(1X) UNIX Programmer's Manual VUESESSION(1X)
OPTIONS
-norestore
This option allows users to use vuesession in a lim-
ited way. The advantage of using this option is
that vuesession can be started directly from an
.x11start or .xsession script. See use and warning
above.
CUSTOMIZATION
Vuesession's behavior can be customized through the use of
the HP VUE Style Manager's startup dialog. The following is
the behavior that can be customized.
HP VUE Session Manager Customization Options
Name Default
Display Logout Confirmation On
Set Home Session N/A
Startup Behavior Resume Current Session
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 vuewm 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.
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 chang-
ing logout options.
Startup Behavior
The startup behavior allows you to specify which
state the HP VUE Session Manager will restore upon
startup (login). The default is that it automati-
cally restarts the state you were in at logout
(Resume Current Session). The other states avail-
able 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 ses-
sion will appear at next login. Note that "Ask Me
at Logout" cannot be active while "Display Logout
HP VUE 3.0 2
VUESESSION(1X) UNIX Programmer's Manual VUESESSION(1X)
Confirmation" is turned off.
RESOURCES
Vuesession uses the following resources.
HP VUE 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
saveFontPath SaveFontPath Boolean False
shadowPixmaps ShadowPixmaps int dynamic*
wmStartupCommand WmStartupCommand executable path NULL
writeXrdbColors writeXrdbColors Boolean True
*The display type determines default.
alarmTime
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 alarmTime seconds, the dialog is
removed from the screen. The lock dialog is
redisplayed as soon as a pointer or keyboard event is
detected. An alarmTime of 0 leaves the lock dialog in
place for the entire time the display is locked. The
default value is 10 seconds.
colorUse
This resource specifies the number of colors to use for
the user interface. Valid types are:
⊕ 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 dynamically change. To change
a palette, all applications using that color palette
must be restarted. This resource value forces Sha-
dowPixmaps 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
HP VUE 3.0 3
VUESESSION(1X) UNIX Programmer's Manual VUESESSION(1X)
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
ShadowPixmaps and ForegroundColor.
⊕ MEDIUM_COLOR - Specifies a medium color system. The
color palettes will have 4 color sets and use a max-
imum 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 ForegroundColor.
⊕ HIGH_COLOR - Specifies a high color system. The
color palettes will have 8 color sets and use a max-
imum 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 ForegroundColor.
The default value for this resource will be deter-
mined by querying the X server for the number of
color cells on the system.
planes ColorUse
_____________________
2-3 | B_W
4 | LOW_COLOR
6 | MEDIUM_COLOR
8+ | HIGH_COLOR
coverScreen
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.
dynamicColor
This resource can have values of True or False. dynam-
icColor 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 VUE 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.
foregroundColor
This resource can have values of White, Black or
HP VUE 3.0 4
VUESESSION(1X) UNIX Programmer's Manual VUESESSION(1X)
Dynamic. ForegroundColor 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.
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 session:
Vuesession*keys: fred,keith
Users fred and keith have the ability to unlock the
display when kim locks it.
lockOnTimeout
This resource specifies whether or not vuesession 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 vueses-
sion when the period of inactivity has occurred.
queryServerSettings
This resource specifies whether vuesession queries the
server at logout for all its settings or saves only
those settings set by using the HP VUE 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.
saveFontPath
This resource specifies whether or not the X server
font path should be saved and restored at session shut-
down and startup. If set to True, any previously
saved, valid font path will, at session startup,
replace whatever font path is currently in effect.
Unless there is no previously saved font path informa-
tion, the incoming font path will be lost. The default
value is False, which means that the incoming font path
is left untouched, and no font path information is
saved at session exit.
shadowPixmaps
For color systems, this resource can have a value of
True or False. If True, topShadowColor and
HP VUE 3.0 5
VUESESSION(1X) UNIX Programmer's Manual VUESESSION(1X)
bottomShadowColor use the same pixel as background and
topShadowPixmap and bottomShadowPixmap 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, vueses-
sion starts /usr/vue/bin/vuewm. An alternate startup
might look like:
Vuesession*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
vuewm is used, clients will be restored, but may not be
restored to the correct position. By default, this
resource contains a NULL value.
writeXrdbColors
This resource should only be used if you are running
non HP Motif 1.1 clients that have color schemes that
conflict with HP VUE 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, background and
foreground 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 VUE colors when they
are started. The default value is True.
COPYRIGHT
Copyright 1990, 1991, 1992, 1993 Hewlett-Packard Company.
ORIGIN
Hewlett-Packard Comany UTD-CV.
SEE ALSO
X(1), vuestyle(1X), vuewm(1X), vuelogin(1X).
HP VUE 3.0 6