3 grml-x \- create xconfig file and start X window system on grml-system
6 .RI "[ OPTIONS ]" " windowmanager_you_want_to_use"
8 grml-x creates the configuration file for X server (X.org or XFree86)
9 and starts up X server with specified window manager.
11 grml-x uses hwinfo for getting hardware related information.
12 It creates the X config file /etc/X11/xorg.conf for X.org or /etc/X11/XF86Config-4 for
13 XFree86 (needs root permissions therefore). If a X config file is present
14 already, grml-x won't touch the file unless the '-force' option or another option
15 which modifies content of the X config file is specified, the old config file gets backed up
16 via adding the extension .old.
17 Afterwards the 'exec' command in ~/.xinitrc gets adjusted to start the provided window manager
18 and then startx is executed. If ~/.xinitrc does not exist a simple default one will be created.
19 Notice that you do not have to use grml-x to start X server if you already have a working
20 X config file. Adjust ~/.xinitrc to your needs and then run startx to start X server.
24 Provide options for startx, see 'man 1 startx'.
27 Specifiy display for use with Xserver.
30 Force creation of xconfig file. This option is also assumed when another
31 option which needs to be write values to the X config file is provided. The old
32 X config file (/etc/X11/xorg.conf or /etx/X11/XFree86Config-4) is renamed
33 via adding the extension .old.
36 Generate generic entry for mouse using /dev/input/mice and auto protocol. This option
37 is useful in combination with '-nousb -nops2' for example in VMWare.
43 Specify horizontal sync frequencies. Use a number like "30-65".
45 .B \-mode <width>x<height>
46 Resolution-mode for xserver.
52 Do not use ddc probing but use static entries for resolution modes.
55 Do not activate HorizSync-entry in xconfig file.
58 Deactivate entry for PS/2 mouse.
61 Do not start X server.
64 Do not activate a present Synaptics touchpad but use it only with 'normal' touchpad
68 Do not activate horizontal and vertical sync frequencies. This option is useful
69 on many modern computers using a LCD/TFT display. To avoid problems on very old
70 monitors this option is not the default.
73 Do not set an entry for USB mouse in the xconfig file.
76 Do not activate VertRefresh-entry in xconfig file.
79 Specify vertical sync frequencies. Use a number like "50-60".
81 .B \-xserver [XFree86|Xorg]
82 Specify Xserver which should be used for creation of xconfig file.
83 For XFree86 the file /etc/X11/XF86Config-4 is written, for Xorg the
84 file /etc/X11/xorg.conf.
87 .B grml-x -mode '1280x1024 1024x768' wmi
88 Use resolutions 1280x1024 and 1024x768 and start windowmanager wmi.
90 .B grml-x -module vesa ion3
91 Use vesa-module and start windowmanager ion3.
93 .B grml-x -hsync "30-65" fluxbox
94 Use 30-65kHz for horizontal sync frequency and start windowmanager fluxbox.
96 .B grml-x -display 8 ratpoison
97 Use display 8 for Xserver and start windowmanager ratpoison.
99 .B grml-x -nostart -f fluxbox
100 Force writing of config file but do not start X server. Please do not forget to add a window manager as last option because
101 grml-x changes the according exec-statement in $HOME/.xinitrc.
103 .B XOPTS='-depth 16' grml-x fluxbox
104 Set color depth to 16 bit and start windowmanager fluxbox.
107 Please report any problems to the grml-team! http://grml.org/bugs/
109 This manual page was written by the grml-team. http://grml.org/ (c)Michael Prokop <mika@grml.org>