Content-type: text/html Man page of dxsession

dxsession

Section: Misc. Reference Manual Pages (1X)
Index Return to Main Contents
 

NAME

dxsession, dxpause - DECwindows session manager  

SYNOPSIS

dxsession

dxpause [-autopause] [-time n] [-wait]


 

OPTIONS

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. 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. 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: 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). 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: 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. 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: 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. 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. 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. Displays a dialog box that lets you specify characteristics of your keyboard (such as bell and keyclick volume). Displays a dialog box that lets you specify the language in which you prefer to work. Displays a dialog box that lets you specify characteristics of your pointer (such as its shape and color). Displays a dialog box that lets you specify the hosts that can display applications on this workstation. 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. 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. Restores the settings you last saved. Restores the system default settings. Saves the current settings. 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

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. Specifies the resource. 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: Specifies the name of the terminal emulator to run at dxsession startup. The default is xterm. 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. A list of applications, delimited by commas, to be considered for starting up by dxsession at startup time. 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. Specifies whether the keyboard bell is enabled or not. The default value is enabled. Specifies the integer value of the volume of the bell. The default value is 50. Specifies whether the keyclick resource is enabled or not. The default value is enabled. Specifies the integer value of the volume of the keyclick. The default value is 50. Specifies whether the autorepeat mode is enabled or not. The default value is enabled. Specifies the mode of the keyboard when the value of the resource is in use. The default value is caps. Specifies whether the screen_saver resource is enabled or not. The default value is enabled. 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). Specifies the color of the foreground of the display. The default value is black. Specifies the color of the background of the display. The default value is white. Specifies the pattern of the display. The default value is 0. Specifies the color of the foreground of the pointer. The default value is white. Specifies the color of the background of the display. The default value is white. Specifies the state of the session manager when it is started up. The default value is mapped. The alternate value is iconified. Specifies whether the session manager is to query for confirmation if the user chooses to Quit. The default value is 1 (true). 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. Specifies an integer representing the number of hosts mentioned in the host_list resource to be considered. The default value is 0. 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. Specifies an integer representing the number of applications mentioned in the AppMenu resource to be used. The default value is 0. 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. Specifies an integer representing the number of Applications mentioned in the AutoStart resource to be used. The default value is 0. Specifies an integer representing the X coordinate of the session manager window at startup time. The default value is 0. Specifies an integer representing the Y coordinate of the session manager window at startup time. The default value is 0. Specifies a string to be displayed in the Pause feature of the session manager. The default value is "Enter your password to resume". Specifies a string representing the name of the window manager to be started up by the session manager. The default value is System Default. Specifies a list of applications, delimited by commas, to be used by the Applications feature of the session manager. Indicates values to be replaced by the user. Specifies an integer representing the number of Applications mentioned in the applications resource to be used. The default value is 2. 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. 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

Specifies the height of the dxconsole window. Specifies the width of the dxconsole window.
 

DXpause Resources

The first name for lines that apply only to the Pause task should be labeled DXpause. 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. 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. 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. 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


 

SEE ALSO

dxconsole(1X), mwm(1X), X(1X), xdm(1X)


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
XDM LOGIN PROMPT
SESSION MANAGER WINDOW
DXCONSOLE
DXPAUSE
MENUS
Session Menu
Applications Menu
Customize
X DEFAULTS
dxconsole Resources
DXpause Resources
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:47 GMT, October 02, 2010