Query: dxsession
OS: ultrix
Section: 1x
Links: ultrix man pages all man pages
Forums: unix linux community forum categories
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
dxsession(1X) dxsession(1X) Name dxsession, Xprompter - DECwindows session manager and login window Syntax dxsession Description The dxsession program provides a window-oriented interface that gives you access to a workstation. In addition, you can use dxsession to invoke high-level applications and customize the workstation environment. By default, dxsession is automatically executed from the /etc/ttys file. A sample command line in the /etc/ttys file for a color worksta- tion is as follows: :0 "/usr/bin/login -P /usr/bin/Xprompter -C /usr/bin/dxsession" none on secure window= "/usr/bin/Xqdsg -fd 75 -bp #000080 c 70" For a monochrome workstation the command line is as follows: :0 "/usr/bin/login -P /usr/bin/Xprompter -C /usr/bin/dxsession" none on secure window= "/usr/bin/Xqvsm -fd 75 c 70" In these command lines, login has two flags. The first flag, -P, specifies the prompting program (in this case, Xprompter). The Xprompter command displays the dialog box through which you log into a session. The second flag, -C, specifies the command that login runs through your shell (in this case, it runs dxsession). The last command starts the X Server. A DECwindows session begins when you log into the workstation through the Start Session dialog box. Once you complete logging in, dxses- sion reads your .Xdefaults file and incorporates any values that it contains into the X Server. Next, dxsession sets the DISPLAY variable to :0 and starts the window manager. The default window manager is dxwm. (You can use another window manager by specifying it in the .Xde- faults file or by entering it in the Customize Window dialog box.) The session manager window appears, and dxsession starts up the applications contained in the AutoStartup list. If you have an .X11Startup file in your home directory, dxsession reads that as well. The .X11Startup file is a shell script that you can use to execute commands at startup. It is usually unnecessary, unless you execute commands that use environment variables, because you can use the AutoStartup list to specify which applications should start automatically. Use the Customize menu to tailor dxsession. Whenever you save the attributes you have specified by means of the Customize dialog boxes, dxsession writes resource specifications into your .Xdefaults file (from which it again reads them at subsequent startups). Start Session Dialog Box The start session dialog box gives you initial access to the workstation by displaying text input fields that accept a login name and a password. The Login field has input focus when the dialog box appears. After entering your login name, press the Return key to move to the password field. You can also set the insertion point at a text field by positioning the pointer there and clicking MB1 (the left but- ton, unless you have redefined it). If your login name is longer than its text field, the text in the field scrolls one character to the left each time you type a new charac- ter. Password characters are not echoed on the screen. To confirm your login name and password, click on the OK button or press the Return key after typing your password. To cancel the operation, click on the Cancel button. After the login name and password are confirmed, dxsession starts the window manager and displays the session manager window. 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 Menu Bar Lists the available dxsession menus (such as Applications and Customize). Message Region Displays system status messages. By default, the message region is a scrollable text region that displays seven lines of text. If system status messages are received while the session manager window is in icon form, the appearance of the icon changes. Menus The session manager window contains the following menus: Session Applications Customize Print Screen 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 applica- tions (Notepad, Mail, Cardfiler, DECterm, User Executive, and so forth). Choose one of the applications to start it up. You can add appli- cations 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 to the Applications menu. AutoStartup... Displays a dialog box that lets you specify the applications that dxsession automatically starts each time a ses- sion starts. You must define an application by means of the Customize Applications Definitions menu before you add it to 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). Print Screen... Displays the Customize Print Screen dialog box, which lets you customize the following attributes: Output Format Selects the image's output format. Output can be prepared for printing on a PostScript, sixel, or DDIF printer. A bitmap can also be placed directly in a file. The options are PostScript, standard sixel file format, or DDIF image format for bitmap files. The default format is PostScript. Output Color Specifies that the image is black and white, that black and white should be combined to produce gray shades, or that the image should be prepared for a color printer. The default is black and white. Aspect ratio Specifies how many printer pixels represent each screen pixel. Some devices have square pixels and some have rectangular pixels. The aspect ratio 2 to 1 uses twice as many device pixels as screen pixels in one direction to make the image shape come out correctly on devices with rectangular pixels. The default is 1 to 1. Ribbon or Toner Saver Specifies that ribbon or toner should be saved by reversing the image. When dxsession is printing color or gray shades, this option is ignored. The default is a positive image. Rotate Picture to Fit Paper Specifies that a picture's orientation is automatically rotated or its size reduced so that it fits on a single sheet of paper. Prompt for File Name Specifies that each Capture Screen operation displays a dialog box asking for the name of the output file. When the toggle is on, the dialog box appears; when the toggle is off, the output file is the one whose name appears in the Output File Name text field. Output File Name Lets you specify the name of the Capture Screen output file. The default destination for captured screen images is printscreen.ps. If the output file name starts with a vertical bar (|), the destina- tion is interpreted as a command to which the output is piped (for example, |lpr). 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. Print Screen Menu The Print Screen menu lets you print screen images or capture them to a file. You can print or capture the entire screen or a portion of it. The Print menu consists of the following items: Print Entire Screen Takes a snapshot of the screen, displays the Print Options dialog box so that you can specify print attributes, and sends the snapshot to the printer. Print Portion of Screen Lets you delineate the portion to print, takes a snapshot of the area you delineated, displays the Print Options dialog box so that you can specify print attributes, and sends the snapshot to the printer. To delineate the portion to save, use the following technique: Position the pointer at one corner of the area you want to mark off. Press and hold MB1 to display a box outline, and then adjust the size and location of the box outline by dragging the pointer. Release MB1. Capture Entire Screen Saves an image of the entire screen in a file. The file name is specified in the Customize Print Screen dia- log box; if the toggle button for Prompt for File Name is on in that dialog box, you are prompted to confirm or specify the file name. Capture Portion Of Screen Saves a portion of the screen in a file. The file name is specified in the Customize Print Screen dialog box; if the toggle button for Prompt for File Name is on in that dialog box, you are prompted to confirm or specify the file name. To delineate the portion to save, use the following technique: Position the pointer at one corner of the area you want to mark off. Press and hold MB1 to display a box outline, and then adjust the size and location of the box outline by dragging the pointer. Release MB1. X Defaults The dxsession application uses the values in the .Xdefaults file when you logged in and uses the appropriate resource specification to cus- tomize the appearance or characteristics of its displayed dxsession window. 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 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 identi- fiers, see Note that the first name for lines that apply only to the session manager should be labeled "sm". For dxsession, the available classes are: AttachedDialogBox Dialog Label MainWindow Menu Menubar Message Pulldown Pushbutton SText Toggle For dxsession, the available names are: ConfirmFilename ConfirmPrint CreatePulldown CustomizeAutoStart CustomizeAppDef CustomizeAppMenu CustomizeKeyboard CustomizePrinter CustomizePulldown CustomizeSecurity CustomizeSession CustomizeWindow MainWindow Menubar Messages PrintPulldown SessionPulldown SETLANGUAGE_BOX WorkAreaDialog In addition to the general resources listed in 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 dxterm. create_vue Specifies the number of User Executive windows to create at startup. The default is 0. create_terminal Specifies the number of terminal emulator windows to create at startup. The default is 1. rootPasswd Specifies whether the root password can be used to resume a paused session. True means that the root password or the user's password is accepted; false means that only the user's password is accepted. The default is False. 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. Files ~/.login ~/.cshrc ~/.X11Startup ~/.Xdefaults /usr/lib/X11/app-defaults/SessionManager /usr/lib/X11/app-defaults/XSessionManager /usr/lib/X11/getcons See Also DECwindows User's Guide dxsession(1X)