[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 6

X Command

Purpose

Starts the X server.

Syntax

X [ -a Number ] [ -auth FileName ] [ -bc | +bc ] [ -bp Color ] [ -broadcast ] [ -bs | -nobs ] [ -c Volume ] [ -cc VisualType [ :Display ] ] [ -class DisplayClass ] [ -co File ] [ -cookie XDMAuthenticationBit ] [ -D File ] [ -d Depth [ :Display ] ] -displayID DisplayID ] [ -f Number ] [-fc Font ] [-fn Font ] [ -fp Font ] [-help ] [ -I ] [ -indirect HostName] [-layer # [ :Display ] ] [ -logo | nologo ] [ -n :Number ] [ -once ] [ -P RowColumn Display } ] [ -p Number ] [ -port PortNumber ] [ -query HostName ] [ -r | r ]  [ -s Number ] [ -secIP [PermissionCode]] [ -secLocal [PermissionCode]] [ -secSMT [PermissionCode]] [ -su ] [ -T ] [ -t Number ] [ -to Number ] [ -v ] [ -wm ] [ -wp Color ] [ -wrap | [ -wrapx ] [ -wrapy ] ]  [ -x ExtensionName ]

Description

The X command starts the X server, a display server that runs on bitmapped terminals. The X server distributes input and output requests to or from programs located on either the host system or systems connected to it through a network.

End an Enhanced X-Windows session by using the Ctrl-Alt-Backspace key sequence.

You can specify one or more display devices. If none are specified, the default is all. The default configuration order is determined by the adapter slot order. The adapter in the first slot is initialized as the left most screen, the adapter in the second slot is the next screen to the right. To rearrange the layout of the screens, use the -P flag. The -P flag associates the row and column of the device with the device name. You can determine the device name by using the lsdisp command.

The two displays are arranged either vertically or horizontally. The following example shows -P flags specifying a horizontal arrangement: 

-P11 ppr0 -P12 ppr1

The 2 in the right position of the second -P flag indicates that the second monitor view is along the x-axis. This produces the horizontal arrangement:

         Display                        Display
                  1                                  2

To see two monitors in a vertical arrangement, the -P flags should read:

-P11 ppr0 -P21 ppr1

The 2 in the first position indicates that the monitors are in a vertical configuration along the y-axis:

         Display
                  1
         Display
                  2

In the horizontal configuration, when a mouse is traveling from left to right in Display 1 and reaches the border of Display 1 and 2, the cursor continues into Display 2 at the same y-axis position. When it reaches the edge of Display 2 and the -wrapx flag is set, it appears at the leftmost edge of Display 1 in the same y-axis position. If the -wrapx flag is not set, the mouse stops at the far edge of Display 2.

In a vertical configuration, when the mouse is traveling from top to bottom in Display 1 and reaches the border of Display 1 and Display 2, the cursor continues into Display 2 at the same x-axis position. When the cursor reaches the bottom of the display 2 and the -wrapy flag is set, the cursor appears at the top edge of Display 1 in the same x-axis position. If the -wrapy flag is not set, the mouse stops at the bottom of Display 2.

Flags

-a Number Specifies the acceleration multiplier for mouse movement. For example, a value of 5 causes the cursor to move five times as fast as the mouse. The default is 4 pixels; any value specified must be a positive value greater than 0.
-auth FileName Specifies to X the file from which to read the MIT (Massachusetts Institute of Technology) magic cookie.
-bc Turns off backward compatibility with Enhanced X-Windows version 1.1.
+bc Turns on backward compatibility with Enhanced X-Windows version 1.1. This is the default.
-bp Color Specifies a black pixel color for the display. The default is display dependent.
-bs Enables backing store support on all screens. Backing store support is disabled by default.
-c Volume Specifies key click volume.
-cc VisualType[:Display]
                          Specifies the type of visual to use for the root window of the screen specified by the display name. Not all visual types are available on all adapters at all depths. The :Display parameter is optional, but useful when using the multihead option. The :Display parameter is the name of the display as shown in the lsdisp command. If no display number or name is supplied, the specified visual is selected for all screens.

To specify the visual type and depth for the default visual, use the -cc and -d flags, respectively.

Values for the VisualType parameter are specified as a string or a number as follows:

String		Numeric equivalent
StaticGray		0
GrayScale		1
StaticColor		2
PseudoColor		3		
TrueColor		4
DirectColor		5
-co File Sets the name of the red, green, and blue (RGB) color database. This is the default flag for the color database.
-D File Specifies the full path name of the color definition database file. The default is /usr/lib/X11/rgb.
-d Depth[:Display] Specifies the root depth for the screen specified by the display name. Not all visual types will be available on all adapters at all depths.

The :Display parameter is optional, but useful when using the multihead option and must correspond to the values passed with the -P flag. The :Display parameter is the name of the display as shown in the lsdisp command. In the absence of the :Display parameter, the specified depth is selected for all the selected displays in the multihead option, as specified in the -P flag.

-f Number Specifies the beep volume. The default is -1 or medium. The supported values are as follows: 
Value			Setting
0		 	 Off
1-33		 	 Low
-1 or 34-66       	 Medium
67-100			 High
-fc Font Specifies the cursor font for cursor glyphs and cursor masks. The default depends on the operating system and the display.
-fn Font Specifies the default text font. The default depends on the operating system and the display.
-fp Font Specifies the font path.
-I Causes all remaining command line arguments to be ignored. (Uppercase i)
-help Prints a usage message.
-layer #[:Display] Specifies that the default visual should be in the # (number sign) layer. The :Display parameter is the name of the display as shown in the lsdisp command. Specifying this flag for an adapter that does not have overlays, or has less than 8 bits of overlay, has no effect. Specifying this flag with a # higher than the number of supported layers results in the default visual residing in the default layer of the screen (as if no -layer flag had been used).
-logo Turns on the X Window System logo display in the screen saver. There is currently no way to change this from a client.
-n :Number Specifies the connection number. Valid values for the Number parameter are 0 to 255. The default is the next available number. The Number parameter is used by programs to communicate with a specific X server. For example, the command: 
X -n :18

specifies that communication to the activated X server takes place by unix:18 or by Hostname:18.

-nobs Disables backing store support on all screens. This is the default.
nologo Turns off the X Window System logo display in the screen saver. There is currently no way to change this from a client.
-once Instructs the server to exit after the first session ends. Normally, the server starts sessions automatically.
-PRowColumn Display Specifies the physical positioning of the displays in a multihead configuration. The Row parameter indicates the row in which the display is located. The Column parameter indicates the column in which the display is located.

The Display parameter is the device name of the display as shown in the first column of output from the Isdisp command. The first -PRowColumn Display occurrence on the command line describes screen 0 to the X server, the second describes screen 1, and so on.

The -P flag is for use with multiple head support.

-p Number Specifies the time interval, in minutes, between changes of the X Window System logo position. This flag is used with the -s (screen saver timeout) flag to control the blanking of the screen.
-r Disables autorepeat. The default is autorepeat enabled.
r Turns on autorepeat.
-s Number Specifies the number of minutes to wait before blanking the screen. The default is 10 minutes. If this value is set to 0, the screen-saver is disabled.
-secIP [PermissionCode] Sets local access control on the internet socket. The PermissionCode is 3 octal digits which can set read, write, and execute bits. If no PermissionCode is specified after a security flag, then permission is defaulted to 0 for that socket.
-secLocal [PermissionCode] Sets access control on the unix socket. The PermissionCode is 3 octal digits which can set read, write, and execute bits. If no PermissionCode is specified after a security flag, then permission is defaulted to 0 for that socket.
-secSMT [PermissionCode] Sets access control on the shared memory transport socket. The PermissionCode is 3 octal digits which can set read, write, and execute bits. If no PermissionCode is specified after a security flag, then permission is defaulted to 0 for that socket.
-su Disables save under support on all screens.
-T Disables the Ctrl-Alt-Backspace key sequence that, by default, ends the AIXwindows session and all windows opened from it.
-t Number Specifies the mouse threshold. The default is 2 pixels. Acceleration takes effect only if the mouse is moved beyond the mouse threshold in one time interval and only applies to the amount beyond the threshold.
-to Number Specifies the number of minutes to elapse between connection checks. The default is 60 minutes. A specified value must be greater than 0.
-v Specifies that the display be replaced with the current background color after the time specified by the -s flag expires. By default, if the -v flag is not used, the entire display is painted with the background tile after the time specified by the -s flag expires.
-wm Forces the default backing store of all windows to have the WhenMapped value. This is a convenient way of applying backing store to all windows.
-wp Color Specifies a white pixel display color. The default depends on the display.
-wrap Specifies the behavior of the mouse when its hotspot reaches the left or right border or the top or bottom of any root window. If this flag is set and the hotspot of the mouse reaches the left border of the leftmost root window, the mouse is automatically positioned at the right border of the rightmost root window at the same y position.

Conversely, if this flag is set and the hotspot of the mouse reaches the right border of the rightmost root window, the mouse is automatically positioned at the left border of the leftmost root window at the same y position. If this flag is not set, the mouse stops at the left or right border of any root window.

If this flag is set and the hotspot of the mouse reaches the top border of the topmost root window, the mouse is positioned at the bottom border of the bottommost root window at the same x position.

Conversely, if this flag is set and the hotspot of the mouse reaches the bottom border of the bottommost root window, the mouse is positioned at the top border of the topmost root window at the same x position.

The -wrap flag is for use with multiple head support.

-wrapx Specifies the behavior of the mouse when its hotspot reaches the left or right border of any root window. If this flag is set and the hotspot of the mouse reaches the left border of the leftmost root window, the mouse is positioned at the right border of the rightmost root window at the same y position. Conversely, if this flag is set and the hotspot of the mouse reaches the right border of the rightmost root window, the mouse is positioned at the left border of the leftmost root window at the same y position. If this flag is not set, the mouse stops at the left or right border of any root window.

The -wrapx flag is for use with multiple head support.

-wrapy Specifies the behavior of the mouse when its hotspot reaches the top or bottom border of any root window. If this flag is set and the hotspot of the mouse reaches the top border of the topmost root window, the mouse is positioned at the bottom border of the bottommost root window at the same x position. Conversely, if this flag is set and the hotspot of the mouse reaches the bottom border of the bottommost root window, the mouse is positioned at the top border of the topmost root window at the same x position. If this flag is not set, the mouse stops at the top or bottom border of any root window.

The -wrapy flag is for use with multiple head support.

-x ExtensionName Specifies that the extension name should be loaded when the server is initialized. This is particularly useful for large extensions, such as the PHIGS Extension to X (pex) and Display PostScript Level 2 (dps). This flag can be specified more than once with multiple extension names.
-query HostName Enables Enhanced X-Windows Display Manager Control Protocol (XDMCP) and sends a Query packet to the specified host.

The -query flag is for use with XDMCP.

-broadcast Enables XDMCP and broadcasts BroadcastQuery packets to the network. The first responding display manager is chosen for the session.

The -broadcast flag is for use with XDMCP.

-indirect HostName Enables XDMCP and sends IndirectQuery packets to the specified host.

The -indirect flag is for use with XDMCP.

-port PortNumber Specifies an alternative port number for XDMCP. This flag must be specified before any -query, -broadcast, or -indirect flags. Normally, the server starts sessions one after another. This flag causes the server to exit after the first session ends.

The -port flag is for use with XDMCP.

-class DisplayClass Sets the value for an additional display qualifier used by XDMCP in resource lookup for display-specific options.

The -class flag is for use with XDMCP.

-cookie XDMAuthenticationBits Specifies a private key to be shared between the server and the manager when testing XDM-AUTHENTICATION-1.

The -cookie flag is for use with XDMCP.

-displayID DisplayID Allows the display manager to identify each display so that it can locate the shared key specified by the -cookie flag.

The -displayID flag is for use with XDMCP.

Related Information

The aixterm command, xclock command, xhost command, xinit command, xlsfonts command, xwd command, xwud command.

The lsdisp shell command.

[ Previous | Next | Contents | Glossary | Home | Search ]