 |
Click this button to go to the index for this section. |
dxsession(1X)
NAME
dxsession, dxpause - DECwindows session manager
SYNOPSIS
dxsession
dxpause [-autopause] [-time n] [-wait]
OPTIONS
-autopause
If the -autopause option is set, when the display is unlocked, dxpause
does not exit but instead becomes an icon. In this case, dxpause
automatically locks the display when the X server goes into screensaver
mode if the X Screensaver extension is present in the X server. De-
iconifying dxpause also causes the display to be locked.
-time n
The -time option only has meaning if the -autopause option is also set.
The -time n option sets the autolock timeout period to n minutes. The
default period is whatever the X server's screensaver timeout is set
to, and the latter defaults to 5 minutes.
-wait
The -wait option only has meaning if the -autopause option is also set,
and causes dxpause to start in the iconified state rather than
immediately locking the display.
Without any of these options set, dxpause locks the display immediately
when invoked and exits when the display is unlocked.
DESCRIPTION
The dxsession program provides a graphical interface to DECwindows session
management functionality. You can use dxsession to invoke applications and
to customize the workstation environment.
A DECwindows session begins when you log into the workstation through the
xdm login prompt. The dxsession program is automatically executed by xdm
as the default DECwindows session manager. When started, dxsession first
reads the .Xdefaults file in your home directory and incorporates those
resource values into the X Server. Next, dxsession starts a window manager,
the default being mwm. You may specify another window manager in your
.Xdefaults file or with the session manager Customize Window dialog.
After the session manager window appears dxsession runs the applications
and shell scripts specified in the AutoStart list. If you have a
.X11Startup file in your home directory, it will be appended to the
AutoStart list automatically. This script is rarely necessary, unless you
require complex startup actions or the setting of environment variables.
Use the Customize menu to tailor dxsession. Whenever you save the
attributes you have specified by means of the Customize dialogs, dxsession
writes resource specifications into your .Xdefaults file. Note that the
.Xdefaults file is only read by dxsession once, when it starts.
XDM LOGIN PROMPT
The xdm login prompt gives you initial access to the workstation by
prompting you for a name and password. For more information see xdm(1X).
SESSION MANAGER WINDOW
The session manager window consists of the following areas:
Title Bar
Displays window manager icons that let you move and resize the session
manager window, and shrink the window to an icon. For more
information, see mwm(1X).
Menu Bar
Lists the available dxsession menus (such as Applications and
Customize).
DXCONSOLE
The dxconsole is started by the session manager at login. The dxconsole
records all messages sent to /dev/console as well as any output from the
session manager.
DXPAUSE
The dxpause program starts when the user selects Pause from the Session
menu on the Session Manager Menu Bar. The program places a blank screen
over the workstation screen and displays the Continue Session dialog box.
This box prompts for the password of the person whose session was paused.
When you enter the correct password, the blank screen is removed and the
session resumes.
MENUS
The session manager window contains the following menus:
· Session
· Applications
· Customize
· Help
Session Menu
The Session menu contains the following items:
Pause
Places a blank screen over the workstation screen and displays the
Continue Session dialog box, which prompts for the password of the
person whose session was paused. When you enter the correct password,
dxsession removes the blank screen and resumes the session.
Quit
Ends the current session and exits from all applications.
Applications Menu
The Applications menu contains a list of applications that you can start.
By default it includes all of the standard DECwindows applications (Mail,
Calendar, DECterm, and so forth). Choose one of the applications to start
it up. You can add applications as items on the menu or remove those
currently listed by choosing the Applications Menu item from the Customize
menu.
Customize
The Customize menu contains the following items:
Application Definitions...
Displays a dialog box that lets you provide or change application
definitions. An application definition consists of the name to use in
Session Manager menus and the associated command that is executed when
dxsession starts the application. Applications must be defined before
you can add them to the Applications menu or Autostartup list.
Applications Menu...
Displays a dialog box that lets you specify the applications that
appear on the Applications menu. You must define an application by
means of the Customize Applications Definitions menu before you add it
to the Applications menu. you add it to the Applications menu.
AutoStartup...
Displays a dialog box that lets you specify the applications that
dxsession automatically starts each time a session starts. You must
define an application by means of the Customize Applications
Definitions menu before you add it to the Applications menu.
Keyboard...
Displays a dialog box that lets you specify characteristics of your
keyboard (such as bell and keyclick volume).
Language...
Displays a dialog box that lets you specify the language in which you
prefer to work.
Pointer...
Displays a dialog box that lets you specify characteristics of your
pointer (such as its shape and color).
Security...
Displays a dialog box that lets you specify the hosts that can display
applications on this workstation.
Session Manager...
Displays a dialog box that lets you customize attributes of dxsession.
These include its start-up state (as an icon or opened window), the
text that appears when your workstation is paused, and the message
region's size and header.
Window...
Displays a dialog box that lets you specify screen and window
characteristics. These include colors, size of your icons, and on some
systems, the screen background pattern. In addition, if you want to
use a window manager other than the default DECwindows one, you can
specify it here.
Use Last Saved Settings
Restores the settings you last saved.
Use System Defaults
Restores the system default settings.
Save Current Settings
Saves the current settings.
Help
Overview gives an overview of Session Manager's menus and features.
About provides information about the software version.
X DEFAULTS
The dxsession application uses the values present in the .Xdefaults file in
your home directory, when you first log in to customize the appearance and
characteristics of its windows and dialogs. The format for a resource
specification in the .Xdefaults file is:
[name*]resource: value
name
Specifies the application name or the name string that restricts the
resource assignment to that application or to a component of an
application. If this argument is not specified, the resource
assignment is globally available to all X applications.
resource
Specifies the resource.
value
Specifies the value that is to be assigned to the resource.
For more information, see X(1X).
Because each toolkit-based application can consist of a combination of
widgets (for example, push buttons and a scroll bar), you can form the name
string by adding widget class and name identifiers to the string. For
further information about adding class and name identifiers, see X(1X).
Note that the first name for lines that apply only to the session manager
should be labeled "DXsession". The first name for lines that apply only to
the dxconsole should be labeled dxconsole.
For dxsession, the available classes are:
· AttachedDialogBox
· Dialog
· Label
· MainWindow
· Menu
· Menubar
· Message
· Pulldown
· Pushbutton
· Text
· Toggle
For dxsession, the available names are:
· ConfirmFilename
· ConfirmPrint
· CreatePulldown
· CustomizeAutoStart
· CustomizeAppDef
· CustomizeAppMenu
· CustomizeKeyboard
· CustomizePrinter
· CustomizePulldown
· CustomizeSecurity
· CustomizeSession
· CustomizeWindow
· MainWindow
· Menubar
· Messages
· SessionPulldown
· SETLANGUAGE_BOX
· WorkAreaDialog
In addition to the general resources listed in X(1X), and those that the
Customize dialog boxes specify, dxsession uses the following resources:
terminalEmulatorName
Specifies the name of the terminal emulator to run at dxsession
startup. The default is xterm.
pointer_shape
Specifies the design of the pointer character. DECwindows pointers
are specified by negative numbers; choose the pointer by using the
Customize Pointer dialog box. MIT pointers can be specified by
positive numbers that correspond to values in
/usr/include/X11/cursorfont.h.
AutoStart
A list of applications, delimited by commas, to be considered for
starting up by dxsession at startup time.
num_AutoStart
An integer indicating how many of the applications specified in the
AutoStart resource to actually be started. If the AutoStart resource
contains 5 applications and the value of num_AutoStart is 3, only the
first three of the AutoStart applications are started.
Xsession.bell_enable
Specifies whether the keyboard bell is enabled or not. The default
value is enabled.
bell_percent
Specifies the integer value of the volume of the bell. The default
value is 50.
keyclick_enable
Specifies whether the keyclick resource is enabled or not. The default
value is enabled.
keyclick_percent
Specifies the integer value of the volume of the keyclick. The default
value is 50.
autorepeat_mode
Specifies whether the autorepeat mode is enabled or not. The default
value is enabled.
lock_state
Specifies the mode of the keyboard when the value of the resource is in
use. The default value is caps.
screen_saver_enable
Specifies whether the screen_saver resource is enabled or not. The
default value is enabled.
screen_saver_period
Specifies the integer value of the number of minutes during which, if
there is no keyboard or mouse activity, the system enables the
screen_saver. The default value is 10 (minutes).
display_foreground
Specifies the color of the foreground of the display. The default value
is black.
display_background
Specifies the color of the background of the display. The default value
is white.
display_pattern
Specifies the pattern of the display. The default value is 0.
pointer_foreground
Specifies the color of the foreground of the pointer. The default value
is white.
pointer_background
Specifies the color of the background of the display. The default value
is white.
startup_state
Specifies the state of the session manager when it is started up. The
default value is mapped. The alternate value is iconified.
confirm_endsession
Specifies whether the session manager is to query for confirmation if
the user chooses to Quit. The default value is 1 (true).
host_list
Specifies a list of hosts, delimited by commas. The list is used by
the Security feature of the session manager. The default value is an
empty list.
num_hosts
Specifies an integer representing the number of hosts mentioned in the
host_list resource to be considered. The default value is 0.
AppMenu
Specifies a list of applications, delimited by commas, to be used by
the Applications button of the Customize feature of the session
manager. The default value is an empty list.
num_AppMenu
Specifies an integer representing the number of applications mentioned
in the AppMenu resource to be used. The default value is 0.
AutoStart
Specifies a list of applications, delimited by commas, to be started up
by the session manager at startup time. The default value is an empty
list.
num_AutoStart
Specifies an integer representing the number of Applications mentioned
in the AutoStart resource to be used. The default value is 0.
x Specifies an integer representing the X coordinate of the session
manager window at startup time. The default value is 0.
y Specifies an integer representing the Y coordinate of the session
manager window at startup time. The default value is 0.
PauseLabel.labelString
Specifies a string to be displayed in the Pause feature of the session
manager. The default value is "Enter your password to resume".
windowManagerName
Specifies a string representing the name of the window manager to be
started up by the session manager. The default value is System
Default.
applications
Specifies a list of applications, delimited by commas, to be used by
the Applications feature of the session manager.
a,b,c,d
Indicates values to be replaced by the user.
num_applications
Specifies an integer representing the number of Applications mentioned
in the applications resource to be used. The default value is 2.
startupfilename
Specifies a file to be executed at startup time by the session manager.
This feature will become obsolete in the next release, and it is
suggested that the resource value for this resource be appended to the
list of AutoStart resource value. The current release append the value
(if any) to the AutoStart list, and comments out the line containing
this resource name.
RootPasswd
Specifies whether the session manager is to consider the root password
also while checking whether a typed string matches the user's password.
It becomes useful when the session is to be resumed from a paused
state. The default value is false.
dxconsole Resources
rows
Specifies the height of the dxconsole window.
columns
Specifies the width of the dxconsole window.
DXpause Resources
DXpause
The first name for lines that apply only to the Pause task should be
labeled DXpause.
grabServer
When this resource is True, dxpause executes an XGrabServer library
call, thereby inhibiting all processing of requests or close downs on
any other connection. Although this action absolutely insures that no
information is displayed "through" the pause screen, it also
effectively suspends other tasks that need to output information to
their windows. When this resource is False, the protective pause
screen is raised to the top of the display stack 20 times per second,
thus re-covering any other window that might have been displayed.
Tasks that need to output to their own windows will not be suspended.
The default is False.
autoPause
When this resource is True, dxpause behaves as if it were run with the
-autopause option. See the OPTIONS section, above. The default is
False.
pauseSaver
When this resource is set to a numeric value n, dxpause behaves as if
it were run with the -time n option. See the OPTIONS section, above.
This resource only has meaning if the autoPause resource is set, or if
dxpause is started with the -autopause option. The value n defaults to
whatever the X server's screensaver timeout is set to, and the latter
defaults to 5 minutes.
wait
When this resource is True, dxpause behaves as if it were run with the
-wait option. See the OPTIONS section, above. This resource only has
meaning if the autoPause resource is set, or if dxpause is started with
the -autopause option. The default is False.
FILES
~/.login
~/.cshrc
~/.X11Startup
~/.Xdefaults
/usr/lib/X11/app-defaults/DXsession
/usr/lib/X11/uid/DXsession
/usr/lib/X11/getcons
SEE ALSO
dxconsole(1X), mwm(1X), X(1X), xdm(1X)