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="application/xhtml+xml; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 8.6.3" />
\r
7 <title>grml-x(1)</title>
\r
8 <style type="text/css">
\r
9 /* Sans-serif font. */
\r
10 h1, h2, h3, h4, h5, h6,
\r
11 div.title, caption.title,
\r
12 thead, p.table.header,
\r
14 span#author, span#revnumber, span#revdate, span#revremark,
\r
16 font-family: Arial,Helvetica,sans-serif;
\r
21 font-family: Georgia,"Times New Roman",Times,serif;
\r
24 /* Monospace font. */
\r
30 margin: 1em 5% 1em 5%;
\r
35 text-decoration: underline;
\r
56 h1, h2, h3, h4, h5, h6 {
\r
59 margin-bottom: 0.5em;
\r
64 border-bottom: 2px solid silver;
\r
81 border: 1px solid silver;
\r
86 margin-bottom: 0.5em;
\r
92 ul > li { color: #aaa; }
\r
93 ul > li > * { color: black; }
\r
107 span#revnumber, span#revdate, span#revremark {
\r
112 border-top: 2px solid silver;
\r
113 padding-top: 0.5em;
\r
118 padding-bottom: 0.5em;
\r
120 div#footer-badges {
\r
122 padding-bottom: 0.5em;
\r
127 margin-bottom: 1.5em;
\r
129 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
\r
130 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
131 div.admonitionblock {
\r
133 margin-bottom: 1.5em;
\r
135 div.admonitionblock {
\r
137 margin-bottom: 2.0em;
\r
142 div.content { /* Block element content. */
\r
146 /* Block element titles. */
\r
147 div.title, caption.title {
\r
152 margin-bottom: 0.5em;
\r
158 td div.title:first-child {
\r
161 div.content div.title:first-child {
\r
164 div.content + div.title {
\r
168 div.sidebarblock > div.content {
\r
169 background: #ffffee;
\r
170 border: 1px solid #dddddd;
\r
171 border-left: 4px solid #f0f0f0;
\r
175 div.listingblock > div.content {
\r
176 border: 1px solid #dddddd;
\r
177 border-left: 5px solid #f0f0f0;
\r
178 background: #f8f8f8;
\r
182 div.quoteblock, div.verseblock {
\r
183 padding-left: 1.0em;
\r
184 margin-left: 1.0em;
\r
186 border-left: 5px solid #f0f0f0;
\r
190 div.quoteblock > div.attribution {
\r
191 padding-top: 0.5em;
\r
195 div.verseblock > pre.content {
\r
196 font-family: inherit;
\r
197 font-size: inherit;
\r
199 div.verseblock > div.attribution {
\r
200 padding-top: 0.75em;
\r
203 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
\r
204 div.verseblock + div.attribution {
\r
208 div.admonitionblock .icon {
\r
209 vertical-align: top;
\r
212 text-decoration: underline;
\r
214 padding-right: 0.5em;
\r
216 div.admonitionblock td.content {
\r
217 padding-left: 0.5em;
\r
218 border-left: 3px solid #dddddd;
\r
221 div.exampleblock > div.content {
\r
222 border-left: 3px solid #dddddd;
\r
223 padding-left: 0.5em;
\r
226 div.imageblock div.content { padding-left: 0; }
\r
227 span.image img { border-style: none; }
\r
228 a.image:visited { color: white; }
\r
232 margin-bottom: 0.8em;
\r
237 font-style: normal;
\r
240 dd > *:first-child {
\r
245 list-style-position: outside;
\r
248 list-style-type: decimal;
\r
251 list-style-type: lower-alpha;
\r
254 list-style-type: upper-alpha;
\r
257 list-style-type: lower-roman;
\r
260 list-style-type: upper-roman;
\r
263 div.compact ul, div.compact ol,
\r
264 div.compact p, div.compact p,
\r
265 div.compact div, div.compact div {
\r
267 margin-bottom: 0.1em;
\r
270 div.tableblock > table {
\r
271 border: 3px solid #527bbd;
\r
273 thead, p.table.header {
\r
286 /* Because the table frame attribute is overriden by CSS in most browsers. */
\r
287 div.tableblock > table[frame="void"] {
\r
288 border-style: none;
\r
290 div.tableblock > table[frame="hsides"] {
\r
291 border-left-style: none;
\r
292 border-right-style: none;
\r
294 div.tableblock > table[frame="vsides"] {
\r
295 border-top-style: none;
\r
296 border-bottom-style: none;
\r
302 margin-bottom: 0.8em;
\r
305 padding-bottom: 15px;
\r
307 dt.hdlist1.strong, td.hdlist1.strong {
\r
311 vertical-align: top;
\r
312 font-style: normal;
\r
313 padding-right: 0.8em;
\r
317 vertical-align: top;
\r
319 div.hdlist.compact tr {
\r
325 background: yellow;
\r
328 .footnote, .footnoteref {
\r
332 span.footnote, span.footnoteref {
\r
333 vertical-align: super;
\r
337 margin: 20px 0 20px 0;
\r
338 padding: 7px 0 0 0;
\r
341 #footnotes div.footnote {
\r
347 border-top: 1px solid silver;
\r
356 padding-right: 0.5em;
\r
357 padding-bottom: 0.3em;
\r
358 vertical-align: top;
\r
360 div.colist td img {
\r
365 div#footer-badges { display: none; }
\r
369 margin-bottom: 2.5em;
\r
377 margin-bottom: 0.1em;
\r
380 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
398 <script type="text/javascript">
\r
400 window.onload = function(){asciidoc.footnotes();}
\r
401 var asciidoc = { // Namespace.
\r
403 /////////////////////////////////////////////////////////////////////
\r
404 // Table Of Contents generator
\r
405 /////////////////////////////////////////////////////////////////////
\r
407 /* Author: Mihai Bazon, September 2002
\r
408 * http://students.infoiasi.ro/~mishoo
\r
410 * Table Of Content generator
\r
413 * Feel free to use this script under the terms of the GNU General Public
\r
414 * License, as long as you do not remove or alter this notice.
\r
417 /* modified by Troy D. Hanson, September 2006. License: GPL */
\r
418 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
\r
420 // toclevels = 1..4.
\r
421 toc: function (toclevels) {
\r
423 function getText(el) {
\r
425 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
426 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
\r
428 else if (i.firstChild != null)
\r
429 text += getText(i);
\r
434 function TocEntry(el, text, toclevel) {
\r
437 this.toclevel = toclevel;
\r
440 function tocEntries(el, toclevels) {
\r
441 var result = new Array;
\r
442 var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
\r
443 // Function that scans the DOM tree for header elements (the DOM2
\r
444 // nodeIterator API would be a better technique but not supported by all
\r
446 var iterate = function (el) {
\r
447 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
448 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
\r
449 var mo = re.exec(i.tagName);
\r
450 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
\r
451 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
\r
461 var toc = document.getElementById("toc");
\r
462 var entries = tocEntries(document.getElementById("content"), toclevels);
\r
463 for (var i = 0; i < entries.length; ++i) {
\r
464 var entry = entries[i];
\r
465 if (entry.element.id == "")
\r
466 entry.element.id = "_toc_" + i;
\r
467 var a = document.createElement("a");
\r
468 a.href = "#" + entry.element.id;
\r
469 a.appendChild(document.createTextNode(entry.text));
\r
470 var div = document.createElement("div");
\r
471 div.appendChild(a);
\r
472 div.className = "toclevel" + entry.toclevel;
\r
473 toc.appendChild(div);
\r
475 if (entries.length == 0)
\r
476 toc.parentNode.removeChild(toc);
\r
480 /////////////////////////////////////////////////////////////////////
\r
481 // Footnotes generator
\r
482 /////////////////////////////////////////////////////////////////////
\r
484 /* Based on footnote generation code from:
\r
485 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
\r
488 footnotes: function () {
\r
489 var cont = document.getElementById("content");
\r
490 var noteholder = document.getElementById("footnotes");
\r
491 var spans = cont.getElementsByTagName("span");
\r
494 for (i=0; i<spans.length; i++) {
\r
495 if (spans[i].className == "footnote") {
\r
497 // Use [\s\S] in place of . so multi-line matches work.
\r
498 // Because JavaScript has no s (dotall) regex flag.
\r
499 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
\r
500 noteholder.innerHTML +=
\r
501 "<div class='footnote' id='_footnote_" + n + "'>" +
\r
502 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
\r
503 n + "</a>. " + note + "</div>";
\r
504 spans[i].innerHTML =
\r
505 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
\r
506 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
507 var id =spans[i].getAttribute("id");
\r
508 if (id != null) refs["#"+id] = n;
\r
512 noteholder.parentNode.removeChild(noteholder);
\r
514 // Process footnoterefs.
\r
515 for (i=0; i<spans.length; i++) {
\r
516 if (spans[i].className == "footnoteref") {
\r
517 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
\r
518 href = href.match(/#.*/)[0]; // Because IE return full URL.
\r
520 spans[i].innerHTML =
\r
521 "[<a href='#_footnote_" + n +
\r
522 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
532 <body class="article">
\r
537 <div class="sect1">
\r
538 <h2 id="_name">Name</h2>
\r
539 <div class="sectionbody">
\r
540 <div class="paragraph"><p>grml-x - create xorg.conf file and start X window system on grml-system</p></div>
\r
543 <div class="sect1">
\r
544 <h2 id="_synopsis">Synopsis</h2>
\r
545 <div class="sectionbody">
\r
546 <div class="paragraph"><p>grml-x [ options ] [ window-manager ]</p></div>
\r
549 <div class="sect1">
\r
550 <h2 id="_description">Description</h2>
\r
551 <div class="sectionbody">
\r
552 <div class="paragraph"><p>grml-x creates the configuration file for the X server (X.org) letting you
\r
553 override some options and then starts up X server with the specified window
\r
557 <div class="sect1">
\r
558 <h2 id="_implementation">Implementation</h2>
\r
559 <div class="sectionbody">
\r
560 <div class="paragraph"><p>grml-x depends on the X server to configure itself. It will generate a very
\r
561 minimal xorg.conf, or, at your option, write some common options to it.
\r
562 If an xorg.conf file already exists, grml-x won’t touch the file unless the
\r
563 <em>--force</em> option is specified.</p></div>
\r
564 <div class="paragraph"><p>If you specify a window manager, the x-window-manager alias will be updated.</p></div>
\r
565 <div class="sidebarblock">
\r
566 <div class="content">
\r
567 <div class="paragraph"><p>Important! Please do <strong>not</strong> run X or grml-x with root permissions! When used in grml
\r
568 live-cd mode running grml-x works as normal user as well (thanks to sudo). Just
\r
569 switch to an appropriate console where user grml is logged in (for example on
\r
570 tty5 via pressing Alt-F5).
\r
571 If you use grml-x on systems other than grml in live mode you can invoke
\r
572 it as user root but please use the <em>--nostart</em> option to avoid startup
\r
573 X server. This allows you to generate a xorg.conf file on harddisk systems
\r
574 as well as on distributions other than grml/Debian.</p></div>
\r
576 <div class="admonitionblock">
\r
579 <div class="title">Note</div>
\r
581 <td class="content">Notice that you do not have to use grml-x to start X server if you already have
\r
582 a working X config file (usually the case on harddisk installations). Just
\r
583 adjust $HOME/.xinitrc to your needs (most common is adjusting the exec line for
\r
584 choosing the according windowmanager) and then run startx to start X server.</td>
\r
589 <div class="sect1">
\r
590 <h2 id="_options">Options</h2>
\r
591 <div class="sectionbody">
\r
592 <div class="dlist"><dl>
\r
593 <dt class="hdlist1">
\r
594 XOPTS=<em>…</em>
\r
598 Provide options for startx, see <em>man 1 startx</em>.
\r
601 <dt class="hdlist1">
\r
602 --display <number>
\r
606 Specify display for use with Xserver.
\r
609 <dt class="hdlist1">
\r
614 Force creation of xorg.conf file. This option is also assumed when another
\r
615 option which needs to be write values to the X config file is provided.
\r
618 <dt class="hdlist1">
\r
626 <dt class="hdlist1">
\r
627 --hsync <number>
\r
631 Specify horizontal sync frequencies. Use a number like "30-65".
\r
634 <dt class="hdlist1">
\r
635 --mode <width>x<height>
\r
639 Set resolution for X server.
\r
642 <dt class="hdlist1">
\r
643 --module <name>
\r
647 Use <name> as module for X server.
\r
650 <dt class="hdlist1">
\r
655 Do not start X server. Useful when you only want to generate
\r
659 <dt class="hdlist1">
\r
660 --vsync <number>
\r
664 Specify vertical sync frequencies. Use a number like "50-60".
\r
670 <div class="sect1">
\r
671 <h2 id="X7">Usage examples</h2>
\r
672 <div class="sectionbody">
\r
673 <div class="dlist"><dl>
\r
674 <dt class="hdlist1">
\r
675 grml-x --mode "1280x1024 1024x768" wm-ng
\r
679 Use resolutions 1280x1024 and 1024x768 and start windowmanager wm-ng.
\r
682 <dt class="hdlist1">
\r
683 grml-x --module vesa openbox
\r
687 Use vesa-module and start windowmanager openbox.
\r
690 <dt class="hdlist1">
\r
691 grml-x --hsync "30-65" fluxbox
\r
695 Use 30-65kHz for horizontal sync frequency and start windowmanager fluxbox.
\r
698 <dt class="hdlist1">
\r
699 grml-x --display 8 ratpoison
\r
703 Use display 8 for Xserver and start windowmanager ratpoison.
\r
706 <dt class="hdlist1">
\r
707 grml-x --nostart -f fluxbox
\r
711 Force writing of config file but do not start X server. Please do not forget to
\r
712 add a window manager as last option because grml-x changes the according
\r
713 exec-statement in $HOME/.xinitrc.
\r
719 <div class="sect1">
\r
720 <h2 id="_known_problems_and_limitations">Known problems and limitations</h2>
\r
721 <div class="sectionbody">
\r
722 <div class="paragraph"><p>Sometimes the X server does not find the correct resolution and/or frequency
\r
723 settings for the monitor. Please adjust configuration manually using the --hsync
\r
724 and the --vsync options then. Also check out the <a href="#X7">usage examples section</a>
\r
725 in this manpage and the help output of grml-x running <em>grml-x --help</em>.</p></div>
\r
728 <div class="sect1">
\r
729 <h2 id="_bugs">Bugs</h2>
\r
730 <div class="sectionbody">
\r
731 <div class="paragraph"><p>Please report feedback, <a href="http://grml.org/bugs/">bugreports</a> and wishes
\r
732 <a href="http://grml.org/contact/">to us</a>!</p></div>
\r
735 <div class="sect1">
\r
736 <h2 id="_author">Author</h2>
\r
737 <div class="sectionbody">
\r
738 <div class="paragraph"><p>This manual page and grml-x itself have been written by Michael Prokop
\r
739 <<a href="mailto:mika@grml.org">mika@grml.org</a>> and are licensed under the GPL v2 or any later version.</p></div>
\r
743 <div id="footnotes"><hr /></div>
\r
745 <div id="footer-text">
\r
746 Last updated 2010-12-02 18:47:32 CET
\r