XCONFIG(8X11) COMMAND REFERENCE XCONFIG(8X11) NAME xconfig - configure workstation for X windows operation SYNOPSIS /etc/xconfig [ -print ] [ -system X10 | X11 | Path ] [ -enable yes | no ] [ -server server_name server_flags ] [ -console console_emulator console_flags ] [ -login login_emulator login_flags ] This is supported. DESCRIPTION A workstation is configured using xconfig, thereby enabling the workstation to use the X Window System software. The program xconfig allows the user to set or change the following X attributes on the workstation: X server to be enabled Arguments of the X server Terminal emulator for login window Arguments of terminal emulator Terminal emulator for console window Arguments of terminal emulator The program xconfig records those changes in the X.conf(5x11) file. When rebooted, rc.X(8x11) is executed; xconfig then reads the X.conf(5x11) file to decide if and how the X window system should be started up. After changing any necessary attributes the X window system must be restarted so that the server or terminal emulator may be restarted; this can be done by sending the hangup signal (SIGHUP) to the xsystem(8x11) process, if the system is currently running. This destroys any windows currently active and forces the display back to a login window. Typically, xconfig, when invoked with no options, prompts the user for the required input to set all of the above attriubes. If both X11 and X10 are installed on the workstation, it will ask the user to select which X window system to configure. Next (if the user is root) xconfig will prompt the user to select the display model. xconfig will allow the user to configure X to use a set of foreign fonts. The default is determined by the international keyboard connected to the workstation. Printed 3/22/89 1
XCONFIG(8X11) COMMAND REFERENCE XCONFIG(8X11) Finally xconfig allows the user to interactively change anyu or all of the data in the X.conf file. This data specifies whether the X window system is to be enabled at system startup and the specific X server, console emulator, and login emulator command lines to be executed. Typically, once the system administrator has configured the X window system using xconf , subsequent changes can be made using specific options to xconfig. These options will allow the system administrator to change specific configuration attributes without changing or entering data for any other attributes. The xsystem process invoked from init uses the X.conf(5x11) file, starting the appropriate X window system processes. OPTIONS The full list of capabilities follows: -print Prints the configuration values from the file X.conf(5x11). -system X10 | X11 | PATH Selects which version of the X system to srart up. -enable yes | no Enable or disables the X window system when invoked from init. -server server_name server_flags xconfig writes the name of the chosen server and options to be passed to the server in the X.conf(5x11) file. -console console_name console_flags xconfig writes the name of the chosen terminal emulator to be used for the console window and options to be passed to the emulator in the X.conf(5x11) file. -login login_name login_flags xconfig writes the name of the chosen terminal emulator to be used for the login window and Printed 3/22/89 2
XCONFIG(8X11) COMMAND REFERENCE XCONFIG(8X11) options to be passed to the emulator in the X.conf(5x11) file. FILES X.conf(5x11) This file is created by xconfig(8x11) and is used by xsystem(8x11) so that the X window configuration is remembered from one boot to the next. RETURN VALUE [NO_ERRS] Command completed without error. [USAGE] Incorrect command line syntax. Execution terminated. [P_ERR] A system error occurred. Execution terminated. See intro(2) for more information on system errors. [NP_WARN] An error warranting a warning message occurred. Execution continues. CAVEATS No input validation is done for entered data. When the X window system is turned off using xconfig and xsystem, the file /etc/ttys is modified and a SIGHUP signal is sent to the init process; this ensures that a user may login to the system. The file /etc/ttys should never have the console device enabled for login when the X window system is running. SEE ALSO X(1x11), xsystem(8x11), X.conf(5x11), rc.X(8x11). REFERENCES Appendix A of the X11 User Manual Printed 3/22/89 3
%%index%% na:384,107; sy:491,1035; de:1526,2617;4599,1014; op:5613,2591;8660,202; fi:8862,520; rv:9382,666; ca:10048,589; se:10637,199; re:10836,188; %%index%%000000000173