1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 8.2.2" />
\r
7 <style type="text/css">
\r
9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
\r
11 border: 1px solid red;
\r
16 margin: 1em 5% 1em 5%;
\r
21 text-decoration: underline;
\r
39 h1, h2, h3, h4, h5, h6 {
\r
41 font-family: sans-serif;
\r
43 margin-bottom: 0.5em;
\r
48 border-bottom: 2px solid silver;
\r
51 border-bottom: 2px solid silver;
\r
61 border: 1px solid silver;
\r
66 margin-bottom: 0.5em;
\r
76 font-family: sans-serif;
\r
83 font-family: sans-serif;
\r
87 font-family: sans-serif;
\r
89 border-top: 2px solid silver;
\r
95 padding-bottom: 0.5em;
\r
99 padding-bottom: 0.5em;
\r
103 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
\r
104 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
105 div.admonitionblock {
\r
108 margin-bottom: 1.5em;
\r
110 div.admonitionblock {
\r
112 margin-bottom: 2.5em;
\r
115 div.content { /* Block element content. */
\r
119 /* Block element titles. */
\r
120 div.title, caption.title {
\r
121 font-family: sans-serif;
\r
125 margin-bottom: 0.5em;
\r
131 td div.title:first-child {
\r
134 div.content div.title:first-child {
\r
137 div.content + div.title {
\r
141 div.sidebarblock > div.content {
\r
142 background: #ffffee;
\r
143 border: 1px solid silver;
\r
150 div.listingblock > div.content {
\r
151 border: 1px solid silver;
\r
152 background: #f4f4f4;
\r
156 div.quoteblock > div.content {
\r
157 padding-left: 2.0em;
\r
163 div.verseblock + div.attribution {
\r
167 div.admonitionblock .icon {
\r
168 vertical-align: top;
\r
171 text-decoration: underline;
\r
173 padding-right: 0.5em;
\r
175 div.admonitionblock td.content {
\r
176 padding-left: 0.5em;
\r
177 border-left: 2px solid silver;
\r
180 div.exampleblock > div.content {
\r
181 border-left: 2px solid silver;
\r
185 div.verseblock div.content {
\r
189 div.imageblock div.content { padding-left: 0; }
\r
190 div.imageblock img { border: 1px solid silver; }
\r
191 span.image img { border-style: none; }
\r
195 margin-bottom: 0.8em;
\r
200 font-style: italic;
\r
202 dd > *:first-child {
\r
207 list-style-position: outside;
\r
210 list-style-type: lower-alpha;
\r
213 div.tableblock > table {
\r
214 border: 3px solid #527bbd;
\r
217 font-family: sans-serif;
\r
226 margin-bottom: 0.8em;
\r
229 padding-bottom: 5px;
\r
232 vertical-align: top;
\r
233 font-style: italic;
\r
234 padding-right: 0.8em;
\r
237 vertical-align: top;
\r
241 div#footer-badges { display: none; }
\r
246 font-family: sans-serif;
\r
250 margin-bottom: 0.1em;
\r
253 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
269 /* Workarounds for IE6's broken and incomplete CSS2. */
\r
271 div.sidebar-content {
\r
272 background: #ffffee;
\r
273 border: 1px solid silver;
\r
276 div.sidebar-title, div.image-title {
\r
277 font-family: sans-serif;
\r
280 margin-bottom: 0.5em;
\r
283 div.listingblock div.content {
\r
284 border: 1px solid silver;
\r
285 background: #f4f4f4;
\r
289 div.quoteblock-content {
\r
290 padding-left: 2.0em;
\r
293 div.exampleblock-content {
\r
294 border-left: 2px solid silver;
\r
295 padding-left: 0.5em;
\r
298 /* IE6 sets dynamically generated links as visited. */
\r
299 div#toc a:visited { color: blue; }
\r
301 <title>grml-x(1)</title>
\r
308 <div class="sectionbody">
\r
309 <p>grml-x - create xorg.conf file and start X window system on grml-system</p>
\r
312 <div class="sectionbody">
\r
313 <p>grml-x [ options ] $windowmanager_you_want_to_use</p>
\r
315 <h2>Description</h2>
\r
316 <div class="sectionbody">
\r
317 <p>grml-x creates the configuration file for the X server (X.org) providing
\r
318 hardware detection and then starts up X server with the specified window
\r
321 <h2>Implementation</h2>
\r
322 <div class="sectionbody">
\r
323 <p>grml-x uses hwinfo for collection hardware related information for further
\r
324 processing. It creates the X configuration file /etc/X11/xorg.conf for the X
\r
325 server (X.org) and needs root permissions therefore. If a X
\r
326 config file is present already, grml-x won't touch the file unless the <em>-force</em>
\r
327 option or another option which modifies content of the X config file is
\r
328 specified. The old config file gets backed up via adding the extension .old
\r
329 (available as /etc/X11/xorg.conf.old therefore).</p>
\r
330 <p>Afterwards the <em>exec</em> command in $HOME/.xinitrc gets adjusted to start the provided
\r
331 window manager and then startx is executed. If $HOME/.xinitrc does not exist a
\r
332 simple default one will be created.</p>
\r
333 <div class="sidebarblock">
\r
334 <div class="sidebar-content">
\r
335 <p>Important! Please do <strong>not</strong> run X or grml-x with root permissions! When used in grml
\r
336 live-cd mode running grml-x works as normal user as well (thanks to sudo). Just
\r
337 switch to an appropriate console where user grml is logged in (for example on
\r
338 tty5 via pressing Alt-F5).
\r
339 If you use grml-x on systems other than grml in live mode you can invoke
\r
340 it as user root but please use the <em>-nostart</em> option to avoid startup
\r
341 X server. This allows you to generate a xorg.conf file on harddisk systems
\r
342 as well as on distributions other than grml/Debian.</p>
\r
344 <div class="admonitionblock">
\r
347 <div class="title">Note</div>
\r
349 <td class="content">Notice that you do not have to use grml-x to start X server if you already have
\r
350 a working X config file (usually the case on harddisk installations). Just
\r
351 adjust $HOME/.xinitrc to your needs (most common is adjusting the exec line for
\r
352 choosing the according windowmanager) and then run startx to start X server.</td>
\r
357 <div class="sectionbody">
\r
360 XOPTS=<em>…</em>
\r
364 Provide options for startx, see <em>man 1 startx</em>.
\r
372 Enable composite extension within /etc/X11/xorg.conf. Disabled by default.
\r
376 -display <number>
\r
380 Specify display for use with Xserver.
\r
388 Force creation of xorg.conf file. This option is also assumed when another
\r
389 option which needs to be write values to the X config file is provided. The old
\r
390 X config file (/etc/X11/xorg.conf or /etx/X11/XFree86Config-4) is renamed
\r
391 via adding the extension .old.
\r
399 Generate generic entry for mouse using /dev/input/mice and auto protocol.
\r
411 -hsync <number>
\r
415 Specify horizontal sync frequencies. Use a number like "30-65".
\r
419 -mode <width>x<height>
\r
423 Set resolution for X server.
\r
427 -module <name>
\r
431 Use <name> as module for X server.
\r
439 Do not use ddc probing but use static entries for resolution modes.
\r
447 Do not activate HorizSync-entry in xorg.conf file.
\r
455 Do not start X server (useful when you want to generate new xorg.conf
\r
456 only. Do not forget to use -force option as well if xorg.conf exists
\r
465 Do not activate a present Synaptics touchpad but use it only with <em>normal</em> touchpad
\r
474 Do not activate horizontal and vertical sync frequencies. This option is useful
\r
475 on many modern computers using a LCD/TFT display. To avoid problems on very old
\r
476 monitors this option is not the default.
\r
484 Do not activate VertRefresh-entry in xorg.conf file.
\r
492 Add an entry for PS/2 mouse in the xorg.conf file.
\r
500 Add an entry for U mouse in the xorg.conf file.
\r
504 -vsync <number>
\r
508 Specify vertical sync frequencies. Use a number like "50-60".
\r
516 Enable Xinerama support - disabled by default. Xinerama is an X server extension
\r
517 that allows multiple physical screens to behave as a single screen. With
\r
518 traditional multi-head in X11, windows cannot span or cross physical screens.
\r
519 Please notice that some window managers are not Xinerama-aware, and so some
\r
520 operations like window placement and resizing might not behave in an ideal way.
\r
521 This is an issue that needs to be dealt with in the individual window managers
\r
522 and not within grml-x or X server.
\r
527 <h2><a id="X7"></a>Usage examples</h2>
\r
528 <div class="sectionbody">
\r
531 grml-x -mode <em>1280x1024 1024x768</em> wmi
\r
535 Use resolutions 1280x1024 and 1024x768 and start windowmanager wmi.
\r
539 grml-x -module vesa openbox
\r
543 Use vesa-module and start windowmanager openbox.
\r
547 grml-x -hsync "30-65" fluxbox
\r
551 Use 30-65kHz for horizontal sync frequency and start windowmanager fluxbox.
\r
555 grml-x -display 8 ratpoison
\r
559 Use display 8 for Xserver and start windowmanager ratpoison.
\r
563 grml-x -xinerama -composite openbox
\r
567 Enable Xinerama setup and composite extension and start windowmanager openbox.
\r
571 grml-x -nostart -f fluxbox
\r
575 Force writing of config file but do not start X server. Please do not forget to
\r
576 add a window manager as last option because grml-x changes the according
\r
577 exec-statement in $HOME/.xinitrc.
\r
581 XOPTS='-depth 16' grml-x fluxbox
\r
585 Set color depth to 16 bit and start windowmanager fluxbox.
\r
590 <h2>Known problems and limitations</h2>
\r
591 <div class="sectionbody">
\r
592 <p>Sometimes the X server does not find the correct resolution and/or frequency
\r
593 settings for the monitor. Please adjust configuration manually using the -hsync
\r
594 and the -vsync options then. Also check out the <a href="#X7">usage examples section</a> in
\r
595 this manpage and the help output of grml-x running <em>grml-x -help</em>.</p>
\r
596 <p>The support for the Xinerama extension is brand new within grml-x and has not
\r
597 been tested on many boxes but only on systems using the intel driver of current
\r
598 X server. Please provide feedback!</p>
\r
601 <div class="sectionbody">
\r
602 <p>Please report feedback, <a href="http://grml.org/bugs/">bugreports</a> and wishes
\r
603 <a href="http://grml.org/contact/">to us</a>!</p>
\r
606 <div class="sectionbody">
\r
607 <p>This manual page and grml-x itself have been written by Michael Prokop
\r
608 <mika@grml.org> and are licensed under the GPL v2 or any later version.</p>
\r
611 <div id="footer-text">
\r
612 Last updated 07-Dec-2007 04:31:39 CEST
\r