grml-debootstrap/index.html

   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
   4 <head>\r
   5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
   6 <meta name="generator" content="AsciiDoc 8.5.2" />\r
   7 <title>grml-debootstrap(8)</title>\r
   8 <style type="text/css">\r
   9 /* Debug borders */\r
  10 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {\r
  11 /*\r
  12   border: 1px solid red;\r
  13 */\r
  14 }\r
  15 \r
  16 body {\r
  17   margin: 1em 5% 1em 5%;\r
  18 }\r
  19 \r
  20 a {\r
  21   color: blue;\r
  22   text-decoration: underline;\r
  23 }\r
  24 a:visited {\r
  25   color: fuchsia;\r
  26 }\r
  27 \r
  28 em {\r
  29   font-style: italic;\r
  30   color: navy;\r
  31 }\r
  32 \r
  33 strong {\r
  34   font-weight: bold;\r
  35   color: #083194;\r
  36 }\r
  37 \r
  38 tt {\r
  39   color: navy;\r
  40 }\r
  41 \r
  42 h1, h2, h3, h4, h5, h6 {\r
  43   color: #527bbd;\r
  44   font-family: sans-serif;\r
  45   margin-top: 1.2em;\r
  46   margin-bottom: 0.5em;\r
  47   line-height: 1.3;\r
  48 }\r
  49 \r
  50 h1, h2, h3 {\r
  51   border-bottom: 2px solid silver;\r
  52 }\r
  53 h2 {\r
  54   padding-top: 0.5em;\r
  55 }\r
  56 h3 {\r
  57   float: left;\r
  58 }\r
  59 h3 + * {\r
  60   clear: left;\r
  61 }\r
  62 \r
  63 div.sectionbody {\r
  64   font-family: serif;\r
  65   margin-left: 0;\r
  66 }\r
  67 \r
  68 hr {\r
  69   border: 1px solid silver;\r
  70 }\r
  71 \r
  72 p {\r
  73   margin-top: 0.5em;\r
  74   margin-bottom: 0.5em;\r
  75 }\r
  76 \r
  77 ul, ol, li > p {\r
  78   margin-top: 0;\r
  79 }\r
  80 \r
  81 pre {\r
  82   padding: 0;\r
  83   margin: 0;\r
  84 }\r
  85 \r
  86 span#author {\r
  87   color: #527bbd;\r
  88   font-family: sans-serif;\r
  89   font-weight: bold;\r
  90   font-size: 1.1em;\r
  91 }\r
  92 span#email {\r
  93 }\r
  94 span#revnumber, span#revdate, span#revremark {\r
  95   font-family: sans-serif;\r
  96 }\r
  97 \r
  98 div#footer {\r
  99   font-family: sans-serif;\r
 100   font-size: small;\r
 101   border-top: 2px solid silver;\r
 102   padding-top: 0.5em;\r
 103   margin-top: 4.0em;\r
 104 }\r
 105 div#footer-text {\r
 106   float: left;\r
 107   padding-bottom: 0.5em;\r
 108 }\r
 109 div#footer-badges {\r
 110   float: right;\r
 111   padding-bottom: 0.5em;\r
 112 }\r
 113 \r
 114 div#preamble {\r
 115   margin-top: 1.5em;\r
 116   margin-bottom: 1.5em;\r
 117 }\r
 118 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
 119 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
 120 div.admonitionblock {\r
 121   margin-top: 1.0em;\r
 122   margin-bottom: 1.5em;\r
 123 }\r
 124 div.admonitionblock {\r
 125   margin-top: 2.0em;\r
 126   margin-bottom: 2.0em;\r
 127   margin-right: 10%;\r
 128   color: #606060;\r
 129 }\r
 130 \r
 131 div.content { /* Block element content. */\r
 132   padding: 0;\r
 133 }\r
 134 \r
 135 /* Block element titles. */\r
 136 div.title, caption.title {\r
 137   color: #527bbd;\r
 138   font-family: sans-serif;\r
 139   font-weight: bold;\r
 140   text-align: left;\r
 141   margin-top: 1.0em;\r
 142   margin-bottom: 0.5em;\r
 143 }\r
 144 div.title + * {\r
 145   margin-top: 0;\r
 146 }\r
 147 \r
 148 td div.title:first-child {\r
 149   margin-top: 0.0em;\r
 150 }\r
 151 div.content div.title:first-child {\r
 152   margin-top: 0.0em;\r
 153 }\r
 154 div.content + div.title {\r
 155   margin-top: 0.0em;\r
 156 }\r
 157 \r
 158 div.sidebarblock > div.content {\r
 159   background: #ffffee;\r
 160   border: 1px solid silver;\r
 161   padding: 0.5em;\r
 162 }\r
 163 \r
 164 div.listingblock > div.content {\r
 165   border: 1px solid silver;\r
 166   background: #f4f4f4;\r
 167   padding: 0.5em;\r
 168 }\r
 169 \r
 170 div.quoteblock, div.verseblock {\r
 171   padding-left: 1.0em;\r
 172   margin-left: 1.0em;\r
 173   margin-right: 10%;\r
 174   border-left: 5px solid #dddddd;\r
 175   color: #777777;\r
 176 }\r
 177 \r
 178 div.quoteblock > div.attribution {\r
 179   padding-top: 0.5em;\r
 180   text-align: right;\r
 181 }\r
 182 \r
 183 div.verseblock > div.content {\r
 184   white-space: pre;\r
 185 }\r
 186 div.verseblock > div.attribution {\r
 187   padding-top: 0.75em;\r
 188   text-align: left;\r
 189 }\r
 190 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */\r
 191 div.verseblock + div.attribution {\r
 192   text-align: left;\r
 193 }\r
 194 \r
 195 div.admonitionblock .icon {\r
 196   vertical-align: top;\r
 197   font-size: 1.1em;\r
 198   font-weight: bold;\r
 199   text-decoration: underline;\r
 200   color: #527bbd;\r
 201   padding-right: 0.5em;\r
 202 }\r
 203 div.admonitionblock td.content {\r
 204   padding-left: 0.5em;\r
 205   border-left: 3px solid #dddddd;\r
 206 }\r
 207 \r
 208 div.exampleblock > div.content {\r
 209   border-left: 3px solid #dddddd;\r
 210   padding-left: 0.5em;\r
 211 }\r
 212 \r
 213 div.imageblock div.content { padding-left: 0; }\r
 214 span.image img { border-style: none; }\r
 215 a.image:visited { color: white; }\r
 216 \r
 217 dl {\r
 218   margin-top: 0.8em;\r
 219   margin-bottom: 0.8em;\r
 220 }\r
 221 dt {\r
 222   margin-top: 0.5em;\r
 223   margin-bottom: 0;\r
 224   font-style: normal;\r
 225   color: navy;\r
 226 }\r
 227 dd > *:first-child {\r
 228   margin-top: 0.1em;\r
 229 }\r
 230 \r
 231 ul, ol {\r
 232     list-style-position: outside;\r
 233 }\r
 234 ol.arabic {\r
 235   list-style-type: decimal;\r
 236 }\r
 237 ol.loweralpha {\r
 238   list-style-type: lower-alpha;\r
 239 }\r
 240 ol.upperalpha {\r
 241   list-style-type: upper-alpha;\r
 242 }\r
 243 ol.lowerroman {\r
 244   list-style-type: lower-roman;\r
 245 }\r
 246 ol.upperroman {\r
 247   list-style-type: upper-roman;\r
 248 }\r
 249 \r
 250 div.compact ul, div.compact ol,\r
 251 div.compact p, div.compact p,\r
 252 div.compact div, div.compact div {\r
 253   margin-top: 0.1em;\r
 254   margin-bottom: 0.1em;\r
 255 }\r
 256 \r
 257 div.tableblock > table {\r
 258   border: 3px solid #527bbd;\r
 259 }\r
 260 thead, p.table.header {\r
 261   font-family: sans-serif;\r
 262   font-weight: bold;\r
 263 }\r
 264 tfoot {\r
 265   font-weight: bold;\r
 266 }\r
 267 td > div.verse {\r
 268   white-space: pre;\r
 269 }\r
 270 p.table {\r
 271   margin-top: 0;\r
 272 }\r
 273 /* Because the table frame attribute is overriden by CSS in most browsers. */\r
 274 div.tableblock > table[frame="void"] {\r
 275   border-style: none;\r
 276 }\r
 277 div.tableblock > table[frame="hsides"] {\r
 278   border-left-style: none;\r
 279   border-right-style: none;\r
 280 }\r
 281 div.tableblock > table[frame="vsides"] {\r
 282   border-top-style: none;\r
 283   border-bottom-style: none;\r
 284 }\r
 285 \r
 286 \r
 287 div.hdlist {\r
 288   margin-top: 0.8em;\r
 289   margin-bottom: 0.8em;\r
 290 }\r
 291 div.hdlist tr {\r
 292   padding-bottom: 15px;\r
 293 }\r
 294 dt.hdlist1.strong, td.hdlist1.strong {\r
 295   font-weight: bold;\r
 296 }\r
 297 td.hdlist1 {\r
 298   vertical-align: top;\r
 299   font-style: normal;\r
 300   padding-right: 0.8em;\r
 301   color: navy;\r
 302 }\r
 303 td.hdlist2 {\r
 304   vertical-align: top;\r
 305 }\r
 306 div.hdlist.compact tr {\r
 307   margin: 0;\r
 308   padding-bottom: 0;\r
 309 }\r
 310 \r
 311 .comment {\r
 312   background: yellow;\r
 313 }\r
 314 \r
 315 .footnote, .footnoteref {\r
 316   font-size: 0.8em;\r
 317 }\r
 318 \r
 319 span.footnote, span.footnoteref {\r
 320   vertical-align: super;\r
 321 }\r
 322 \r
 323 #footnotes {\r
 324   margin: 20px 0 20px 0;\r
 325   padding: 7px 0 0 0;\r
 326 }\r
 327 \r
 328 #footnotes div.footnote {\r
 329   margin: 0 0 5px 0;\r
 330 }\r
 331 \r
 332 #footnotes hr {\r
 333   border: none;\r
 334   border-top: 1px solid silver;\r
 335   height: 1px;\r
 336   text-align: left;\r
 337   margin-left: 0;\r
 338   width: 20%;\r
 339   min-width: 100px;\r
 340 }\r
 341 \r
 342 \r
 343 @media print {\r
 344   div#footer-badges { display: none; }\r
 345 }\r
 346 \r
 347 div#toc {\r
 348   margin-bottom: 2.5em;\r
 349 }\r
 350 \r
 351 div#toctitle {\r
 352   color: #527bbd;\r
 353   font-family: sans-serif;\r
 354   font-size: 1.1em;\r
 355   font-weight: bold;\r
 356   margin-top: 1.0em;\r
 357   margin-bottom: 0.1em;\r
 358 }\r
 359 \r
 360 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {\r
 361   margin-top: 0;\r
 362   margin-bottom: 0;\r
 363 }\r
 364 div.toclevel2 {\r
 365   margin-left: 2em;\r
 366   font-size: 0.9em;\r
 367 }\r
 368 div.toclevel3 {\r
 369   margin-left: 4em;\r
 370   font-size: 0.9em;\r
 371 }\r
 372 div.toclevel4 {\r
 373   margin-left: 6em;\r
 374   font-size: 0.9em;\r
 375 }\r
 376 /* Workarounds for IE6's broken and incomplete CSS2. */\r
 377 \r
 378 div.sidebar-content {\r
 379   background: #ffffee;\r
 380   border: 1px solid silver;\r
 381   padding: 0.5em;\r
 382 }\r
 383 div.sidebar-title, div.image-title {\r
 384   color: #527bbd;\r
 385   font-family: sans-serif;\r
 386   font-weight: bold;\r
 387   margin-top: 0.0em;\r
 388   margin-bottom: 0.5em;\r
 389 }\r
 390 \r
 391 div.listingblock div.content {\r
 392   border: 1px solid silver;\r
 393   background: #f4f4f4;\r
 394   padding: 0.5em;\r
 395 }\r
 396 \r
 397 div.quoteblock-attribution {\r
 398   padding-top: 0.5em;\r
 399   text-align: right;\r
 400 }\r
 401 \r
 402 div.verseblock-content {\r
 403   white-space: pre;\r
 404 }\r
 405 div.verseblock-attribution {\r
 406   padding-top: 0.75em;\r
 407   text-align: left;\r
 408 }\r
 409 \r
 410 div.exampleblock-content {\r
 411   border-left: 3px solid #dddddd;\r
 412   padding-left: 0.5em;\r
 413 }\r
 414 \r
 415 /* IE6 sets dynamically generated links as visited. */\r
 416 div#toc a:visited { color: blue; }\r
 417 </style>\r
 418 <script type="text/javascript">\r
 419 /*<![CDATA[*/\r
 420 window.onload = function(){asciidoc.footnotes();}\r
 421 var asciidoc = {  // Namespace.\r
 422 \r
 423 /////////////////////////////////////////////////////////////////////\r
 424 // Table Of Contents generator\r
 425 /////////////////////////////////////////////////////////////////////\r
 426 \r
 427 /* Author: Mihai Bazon, September 2002\r
 428  * http://students.infoiasi.ro/~mishoo\r
 429  *\r
 430  * Table Of Content generator\r
 431  * Version: 0.4\r
 432  *\r
 433  * Feel free to use this script under the terms of the GNU General Public\r
 434  * License, as long as you do not remove or alter this notice.\r
 435  */\r
 436 \r
 437  /* modified by Troy D. Hanson, September 2006. License: GPL */\r
 438  /* modified by Stuart Rackham, 2006, 2009. License: GPL */\r
 439 \r
 440 // toclevels = 1..4.\r
 441 toc: function (toclevels) {\r
 442 \r
 443   function getText(el) {\r
 444     var text = "";\r
 445     for (var i = el.firstChild; i != null; i = i.nextSibling) {\r
 446       if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.\r
 447         text += i.data;\r
 448       else if (i.firstChild != null)\r
 449         text += getText(i);\r
 450     }\r
 451     return text;\r
 452   }\r
 453 \r
 454   function TocEntry(el, text, toclevel) {\r
 455     this.element = el;\r
 456     this.text = text;\r
 457     this.toclevel = toclevel;\r
 458   }\r
 459 \r
 460   function tocEntries(el, toclevels) {\r
 461     var result = new Array;\r
 462     var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');\r
 463     // Function that scans the DOM tree for header elements (the DOM2\r
 464     // nodeIterator API would be a better technique but not supported by all\r
 465     // browsers).\r
 466     var iterate = function (el) {\r
 467       for (var i = el.firstChild; i != null; i = i.nextSibling) {\r
 468         if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {\r
 469           var mo = re.exec(i.tagName);\r
 470           if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {\r
 471             result[result.length] = new TocEntry(i, getText(i), mo[1]-1);\r
 472           }\r
 473           iterate(i);\r
 474         }\r
 475       }\r
 476     }\r
 477     iterate(el);\r
 478     return result;\r
 479   }\r
 480 \r
 481   var toc = document.getElementById("toc");\r
 482   var entries = tocEntries(document.getElementById("content"), toclevels);\r
 483   for (var i = 0; i < entries.length; ++i) {\r
 484     var entry = entries[i];\r
 485     if (entry.element.id == "")\r
 486       entry.element.id = "_toc_" + i;\r
 487     var a = document.createElement("a");\r
 488     a.href = "#" + entry.element.id;\r
 489     a.appendChild(document.createTextNode(entry.text));\r
 490     var div = document.createElement("div");\r
 491     div.appendChild(a);\r
 492     div.className = "toclevel" + entry.toclevel;\r
 493     toc.appendChild(div);\r
 494   }\r
 495   if (entries.length == 0)\r
 496     toc.parentNode.removeChild(toc);\r
 497 },\r
 498 \r
 499 \r
 500 /////////////////////////////////////////////////////////////////////\r
 501 // Footnotes generator\r
 502 /////////////////////////////////////////////////////////////////////\r
 503 \r
 504 /* Based on footnote generation code from:\r
 505  * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html\r
 506  */\r
 507 \r
 508 footnotes: function () {\r
 509   var cont = document.getElementById("content");\r
 510   var noteholder = document.getElementById("footnotes");\r
 511   var spans = cont.getElementsByTagName("span");\r
 512   var refs = {};\r
 513   var n = 0;\r
 514   for (i=0; i<spans.length; i++) {\r
 515     if (spans[i].className == "footnote") {\r
 516       n++;\r
 517       // Use [\s\S] in place of . so multi-line matches work.\r
 518       // Because JavaScript has no s (dotall) regex flag.\r
 519       note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];\r
 520       noteholder.innerHTML +=\r
 521         "<div class='footnote' id='_footnote_" + n + "'>" +\r
 522         "<a href='#_footnoteref_" + n + "' title='Return to text'>" +\r
 523         n + "</a>. " + note + "</div>";\r
 524       spans[i].innerHTML =\r
 525         "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +\r
 526         "' title='View footnote' class='footnote'>" + n + "</a>]";\r
 527       var id =spans[i].getAttribute("id");\r
 528       if (id != null) refs["#"+id] = n;\r
 529     }\r
 530   }\r
 531   if (n == 0)\r
 532     noteholder.parentNode.removeChild(noteholder);\r
 533   else {\r
 534     // Process footnoterefs.\r
 535     for (i=0; i<spans.length; i++) {\r
 536       if (spans[i].className == "footnoteref") {\r
 537         var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");\r
 538         href = href.match(/#.*/)[0];  // Because IE return full URL.\r
 539         n = refs[href];\r
 540         spans[i].innerHTML =\r
 541           "[<a href='#_footnote_" + n +\r
 542           "' title='View footnote' class='footnote'>" + n + "</a>]";\r
 543       }\r
 544     }\r
 545   }\r
 546 }\r
 547 \r
 548 }\r
 549 /*]]>*/\r
 550 </script>\r
 551 </head>\r
 552 <body>\r
 553 <div id="header">\r
 554 <h1>grml-debootstrap(8)</h1>\r
 555 </div>\r
 556 <div id="content">\r
 557 <h2 id="_name">Name</h2>\r
 558 <div class="sectionbody">\r
 559 <div class="paragraph"><p>grml-debootstrap - wrapper around debootstrap for installing plain Debian via grml</p></div>\r
 560 </div>\r
 561 <h2 id="_synopsis">Synopsis</h2>\r
 562 <div class="sectionbody">\r
 563 <div class="paragraph"><p>grml-debootstrap [ <em>options</em> ]</p></div>\r
 564 <div class="paragraph"><p><span class="image">\r
 565 <img src="images/screenshot.png" alt="Screenshot" />\r
 566 </span></p></div>\r
 567 </div>\r
 568 <h2 id="_introduction">Introduction</h2>\r
 569 <div class="sectionbody">\r
 570 <div class="paragraph"><p>grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap if you\r
 571 want) for installing a plain Debian system via grml very fast and easy.</p></div>\r
 572 <div class="paragraph"><p>All you have to do is adjust a few variables in configuration file\r
 573 /etc/debootstrap/config (or specify some variables via commandline) and invoke\r
 574 grml-debootstrap without any further options then.</p></div>\r
 575 <div class="paragraph"><p>A plain and base Debian system will be installed on the given device (or\r
 576 directory) then. Customization of this process is possible as well.</p></div>\r
 577 <div class="admonitionblock">\r
 578 <table><tr>\r
 579 <td class="icon">\r
 580 <img src="./images/icons/caution.png" alt="Caution" />\r
 581 </td>\r
 582 <td class="content">The grml team does not take responsibility for loss of any data!</td>\r
 583 </tr></table>\r
 584 </div>\r
 585 </div>\r
 586 <h2 id="_options_and_environment_variables">Options and environment variables</h2>\r
 587 <div class="sectionbody">\r
 588 <div class="dlist"><dl>\r
 589 <dt class="hdlist1">\r
 590 <strong>--arch</strong> &lt;_architecture_&gt;\r
 591 </dt>\r
 592 <dd>\r
 593 <p>\r
 594     Architecture you want to bootstrap. Currently only i386 is supported.\r
 595     Defaults to the architecture that is currently running on your system. If\r
 596     you&#8217;re running an amd64 system and want to deploy a i386 system use this option.\r
 597     Note: deploying amd64 from a i386 system won&#8217;t work.\r
 598 </p>\r
 599 </dd>\r
 600 <dt class="hdlist1">\r
 601 <strong>--bootappend</strong> &lt;_appendline for the kernel_&gt;\r
 602 </dt>\r
 603 <dd>\r
 604 <p>\r
 605     Specify appendline for the kernel.\r
 606     E.g. "<em>pci=nomsi</em>"\r
 607 </p>\r
 608 </dd>\r
 609 <dt class="hdlist1">\r
 610 <strong>-c</strong>, <strong>--config</strong> &lt;_file_&gt;\r
 611 </dt>\r
 612 <dd>\r
 613 <p>\r
 614     Use specified configuration file, defaults to /etc/debootstrap/config.\r
 615 </p>\r
 616 </dd>\r
 617 <dt class="hdlist1">\r
 618 <strong>--chroot-scripts</strong> &lt;_directory_&gt;\r
 619 </dt>\r
 620 <dd>\r
 621 <p>\r
 622     Execute chroot scripts from specified directory. This allows customisation\r
 623     of the chroot setup, the executable script(s) present in the given directory\r
 624     are executed at the end of the chroot procedure.\r
 625     Default directory: /etc/debootstrap/chroot-scripts/\r
 626 </p>\r
 627 </dd>\r
 628 <dt class="hdlist1">\r
 629 <strong>-d</strong>, <strong>--confdir</strong> &lt;_path_&gt;\r
 630 </dt>\r
 631 <dd>\r
 632 <p>\r
 633     Place of configuration files for debootstrap, defaults to /etc/debootstrap.\r
 634 </p>\r
 635 </dd>\r
 636 <dt class="hdlist1">\r
 637 <strong>--debconf</strong> &lt;_file_&gt;\r
 638 </dt>\r
 639 <dd>\r
 640 <p>\r
 641     Use specified file for preseeding Debian packages instead of using\r
 642     the default &lt;confdir&gt;/debconf-selections.\r
 643 </p>\r
 644 </dd>\r
 645 <dt class="hdlist1">\r
 646 <strong>--debopt</strong> &lt;_params_&gt;\r
 647 </dt>\r
 648 <dd>\r
 649 <p>\r
 650     Extra parameters passed to the debootstrap command.\r
 651 </p>\r
 652 </dd>\r
 653 <dt class="hdlist1">\r
 654 <strong>--grub</strong> &lt;_device_&gt;\r
 655 </dt>\r
 656 <dd>\r
 657 <p>\r
 658     Device where grub should be installed to. Note that only the MBR (master\r
 659     boot record) can be used (/dev/sda, /dev/sdb,&#8230;). Partitions (like\r
 660     /dev/sda1, /dev/sdb2,&#8230;) are NOT supported because grub2 doesn&#8217;t support\r
 661     installation into the PBR (partition boot record) anymore.  Usage example:\r
 662     <em>--grub /dev/sda</em>.  Note: just do not set this option to avoid installation\r
 663     of grub.\r
 664 </p>\r
 665 </dd>\r
 666 <dt class="hdlist1">\r
 667 <strong>--help</strong>, <strong>-h</strong>\r
 668 </dt>\r
 669 <dd>\r
 670 <p>\r
 671     Show summary of options and exit.\r
 672 </p>\r
 673 </dd>\r
 674 <dt class="hdlist1">\r
 675 <strong>--hostname</strong> &lt;_hostname_&gt;\r
 676 </dt>\r
 677 <dd>\r
 678 <p>\r
 679     Use specified hostname instead of the default (being <em>grml</em>).\r
 680 </p>\r
 681 </dd>\r
 682 <dt class="hdlist1">\r
 683 <strong>-i</strong>, <strong>--iso</strong> &lt;_/mntpoint_&gt;\r
 684 </dt>\r
 685 <dd>\r
 686 <p>\r
 687     Specify mountpoint where you have a Debian ISO mounted loopback.\r
 688     Using this option instead of the mirror option gives you the possibility\r
 689     to install the base-system without network access. Make sure you\r
 690     mounted the according Debian-ISO to the given &lt;_/mntpoint_&gt;. See section\r
 691     <em>Usage examples</em> for a demonstration.\r
 692 </p>\r
 693 </dd>\r
 694 <dt class="hdlist1">\r
 695 <strong>--keep_src_list</strong>\r
 696 </dt>\r
 697 <dd>\r
 698 <p>\r
 699      Do not overwrite user provided /etc/apt/sources.list.\r
 700 </p>\r
 701 </dd>\r
 702 <dt class="hdlist1">\r
 703 <strong>-m</strong>, <strong>--mirror</strong> &lt;_URL_&gt;\r
 704 </dt>\r
 705 <dd>\r
 706 <p>\r
 707     Specify mirror which should be used for apt-get/aptitude.\r
 708     Corresponding with configuration variable MIRROR.\r
 709 </p>\r
 710 </dd>\r
 711 <dt class="hdlist1">\r
 712 <strong>--nodebootstrap</strong>\r
 713 </dt>\r
 714 <dd>\r
 715 <p>\r
 716     Skip debootstrap, only do configuration to the target.\r
 717 </p>\r
 718 </dd>\r
 719 <dt class="hdlist1">\r
 720 <strong>--nopackages</strong>\r
 721 </dt>\r
 722 <dd>\r
 723 <p>\r
 724     Skip installation of packages defined in /etc/debootstrap/packages.\r
 725 </p>\r
 726 </dd>\r
 727 <dt class="hdlist1">\r
 728 <strong>--insecure</strong>\r
 729 </dt>\r
 730 <dd>\r
 731 <p>\r
 732     Do not download and check signatures for retrieved Release files.\r
 733 </p>\r
 734 </dd>\r
 735 <dt class="hdlist1">\r
 736 <strong>-p</strong>, <strong>--mntpoint</strong> &lt;_/mntpoint_&gt;\r
 737 </dt>\r
 738 <dd>\r
 739 <p>\r
 740     Specify mountpoint that should be used for mounting the target system.\r
 741     Corresponding with configuration variable MNTPOINT.\r
 742     Note: this option has no effect if option -t is given and represents a\r
 743     directory.\r
 744 </p>\r
 745 </dd>\r
 746 <dt class="hdlist1">\r
 747 <strong>--packages</strong> &lt;_file_&gt;\r
 748 </dt>\r
 749 <dd>\r
 750 <p>\r
 751     Use specified file as list for packages that should be installed instead of\r
 752     the default package list file &lt;confdir&gt;/packages.\r
 753 </p>\r
 754 </dd>\r
 755 <dt class="hdlist1">\r
 756 <strong>--password</strong> &lt;_password_&gt;\r
 757 </dt>\r
 758 <dd>\r
 759 <p>\r
 760     Use specified password as password for user root. Use with caution, as your\r
 761     commandline might be visible in the process list and the shell history.\r
 762     It&#8217;s meant for automatic installation only.\r
 763 </p>\r
 764 </dd>\r
 765 <dt class="hdlist1">\r
 766 <strong>-r</strong>, <strong>--release</strong> &lt;_releasename_&gt;\r
 767 </dt>\r
 768 <dd>\r
 769 <p>\r
 770     Specify release of new Debian system. Supported releases names: lenny,\r
 771     squeeze (note: requires current version of debootstrap) and sid.\r
 772     Corresponding with configuration variable RELEASE.\r
 773 </p>\r
 774 </dd>\r
 775 <dt class="hdlist1">\r
 776 <strong>--pre-scripts</strong> &lt;_directory_&gt;\r
 777 </dt>\r
 778 <dd>\r
 779 <p>\r
 780     Execute scripts from specified directory before executing the chroot\r
 781     script. This allows customisation of the system before the chroot has\r
 782     been set up.  The environment variable $MNTPOINT is available inside the\r
 783     scripts for direct access of the chroot.\r
 784     Default directory: /etc/debootstrap/pre-scripts/\r
 785 </p>\r
 786 </dd>\r
 787 <dt class="hdlist1">\r
 788 <strong>--scripts</strong> &lt;_directory_&gt;\r
 789 </dt>\r
 790 <dd>\r
 791 <p>\r
 792     Execute scripts from specified directory. This allows customisation of\r
 793     the system after the chroot has been set up. The environment variable\r
 794     $MNTPOINT is available inside the scripts for direct access of the chroot.\r
 795     Default directory: /etc/debootstrap/scripts/\r
 796 </p>\r
 797 </dd>\r
 798 <dt class="hdlist1">\r
 799 <strong>-t</strong>, <strong>--target</strong> &lt;_target_&gt;\r
 800 </dt>\r
 801 <dd>\r
 802 <p>\r
 803     Target partition (/dev/&#8230;) or directory (anything else without /dev at the\r
 804     beginning). To install grub using <strong>--grub</strong> make sure to use a <em>device</em>\r
 805     instead of a directory as <em>target</em> (installation of grub as bootloader when\r
 806     using directories is NOT supported).\r
 807 </p>\r
 808 </dd>\r
 809 <dt class="hdlist1">\r
 810 <strong>-v</strong>, <strong>--verbose</strong>\r
 811 </dt>\r
 812 <dd>\r
 813 <p>\r
 814     Increase verbosity.\r
 815 </p>\r
 816 </dd>\r
 817 <dt class="hdlist1">\r
 818 <strong>-V</strong>, <strong>--version</strong>\r
 819 </dt>\r
 820 <dd>\r
 821 <p>\r
 822     Show version of program and exit.\r
 823 </p>\r
 824 </dd>\r
 825 </dl></div>\r
 826 <div class="admonitionblock">\r
 827 <table><tr>\r
 828 <td class="icon">\r
 829 <img src="./images/icons/warning.png" alt="Warning" />\r
 830 </td>\r
 831 <td class="content">the commandline parsing of grml-debootstrap does not validate the provided\r
 832 arguments for the commandline options. Please be careful and check docs and\r
 833 /etc/debootstrap/config for further information.</td>\r
 834 </tr></table>\r
 835 </div>\r
 836 </div>\r
 837 <h2 id="_usage_examples">Usage examples</h2>\r
 838 <div class="sectionbody">\r
 839 <div class="literalblock">\r
 840 <div class="content">\r
 841 <pre><tt>grml-debootstrap --target /dev/sda1 --grub /dev/sda</tt></pre>\r
 842 </div></div>\r
 843 <div class="paragraph"><p>Install default Debian release (stable/lenny) on /dev/sda1 and install bootmanager\r
 844 Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition.</p></div>\r
 845 <div class="literalblock">\r
 846 <div class="content">\r
 847 <pre><tt>grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid</tt></pre>\r
 848 </div></div>\r
 849 <div class="paragraph"><p>Install Debian unstable/sid on /dev/sda6, install bootmanager Grub in MBR\r
 850 (master boot record) of /dev/sda and use /dev/sda6 as system partition.</p></div>\r
 851 <div class="literalblock">\r
 852 <div class="content">\r
 853 <pre><tt>mount /dev/sda1 /data/chroot\r
 854 grml-debootstrap --target /data/chroot</tt></pre>\r
 855 </div></div>\r
 856 <div class="paragraph"><p>Install default Debian release (stable/lenny) in directory /data/chroot (without\r
 857 any bootloader).</p></div>\r
 858 <div class="literalblock">\r
 859 <div class="content">\r
 860 <pre><tt>grml-debootstrap --target /dev/sda3 --grub /dev/sda  --mirror ftp://ftp.tugraz.at/mirror/debian</tt></pre>\r
 861 </div></div>\r
 862 <div class="paragraph"><p>Install default Debian release (stable/lenny) on /dev/sda3 and install bootmanager\r
 863 Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.\r
 864 Use specified mirror instead of the default (<a href="ftp://ftp.debian.de/debian">ftp://ftp.debian.de/debian</a>) one.</p></div>\r
 865 <div class="literalblock">\r
 866 <div class="content">\r
 867 <pre><tt>mount -o loop /mnt/sda6/debian-40r0-i386-CD-1.iso /mnt/iso\r
 868 grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso file:/mnt/iso/debian/</tt></pre>\r
 869 </div></div>\r
 870 <div class="paragraph"><p>Install Debian stable/lenny on /dev/sda1 using the loopback mounted Debian-ISO\r
 871 for the base-system and install bootmanager Grub in MBR (master boot record) of\r
 872 /dev/sda and use /dev/sda1 as system partition. Please notice, that the chroot\r
 873 system requires network access for all packages which are not part of the\r
 874 ISO.</p></div>\r
 875 </div>\r
 876 <h2 id="_files">Files</h2>\r
 877 <div class="sectionbody">\r
 878 <div class="literalblock">\r
 879 <div class="content">\r
 880 <pre><tt>/etc/debootstrap/config</tt></pre>\r
 881 </div></div>\r
 882 <div class="paragraph"><p>Main configuration file. You have to adjust it according to your needs\r
 883 if you want to execute grml-debootstrap in the non-interactive mode without\r
 884 any special command line arguments.</p></div>\r
 885 <div class="literalblock">\r
 886 <div class="content">\r
 887 <pre><tt>/etc/debootstrap/chroot-script</tt></pre>\r
 888 </div></div>\r
 889 <div class="paragraph"><p>The script executed within the new Debian system as soon as the main system\r
 890 has been installed via [c]debootstrap.</p></div>\r
 891 <div class="literalblock">\r
 892 <div class="content">\r
 893 <pre><tt>/etc/debootstrap/locale.gen</tt></pre>\r
 894 </div></div>\r
 895 <div class="paragraph"><p>Defines the default locales used for generating locales via locale-gen.</p></div>\r
 896 <div class="literalblock">\r
 897 <div class="content">\r
 898 <pre><tt>/etc/debootstrap/packages</tt></pre>\r
 899 </div></div>\r
 900 <div class="paragraph"><p>Defines the software packages which should be installed in the new\r
 901 Debian system by default.</p></div>\r
 902 <div class="literalblock">\r
 903 <div class="content">\r
 904 <pre><tt>/etc/debootstrap/extrapackages</tt></pre>\r
 905 </div></div>\r
 906 <div class="paragraph"><p>Debian Packages dropped here will be installed into the new Debian system by\r
 907 default (Controlvariable: EXTRAPACKAGES)</p></div>\r
 908 <div class="literalblock">\r
 909 <div class="content">\r
 910 <pre><tt>/etc/debootstrap/stages/</tt></pre>\r
 911 </div></div>\r
 912 <div class="paragraph"><p>The default directory for storing information about executed stages. Every\r
 913 single function of grml-debootstrap will write <em>done</em> to the stages directory\r
 914 into a file named as the function itself if it has been executed successfully.\r
 915 You can adjust the location of the directory via configuration variable STAGES\r
 916 via /etc/debootstrap/config.  Please notice that you have to remove the stages\r
 917 directory on your own if you want to re-execute grml-debootstrap after running it\r
 918 successfully once. This should avoid recurrent execution by error of\r
 919 grml-debootstrap (which might delete present data).</p></div>\r
 920 </div>\r
 921 <h2 id="_customization">Customization</h2>\r
 922 <div class="sectionbody">\r
 923 <div class="paragraph"><p>You can control execution of grml-debootstrap via adjusting\r
 924 /etc/debootstrap/config for some main stuff or via setting some selected\r
 925 variables via commandline.  The packages which should be installed in the new\r
 926 Debian system can be defined via the file /etc/debootstrap/packages.  If you\r
 927 want to put existing files to the new Debian system you can place them into the\r
 928 (by default non-existing) directories boot, etc, share, usr and var in\r
 929 /etc/debootstrap/. Every existing directory will be copied to the new Debian\r
 930 system then. If you want to install additional packages that are not available\r
 931 via the grml or debian mirror drop them into /etc/debootstrap/extrapackages and\r
 932 make sure that EXTRAPACKAGES is set to "yes".</p></div>\r
 933 </div>\r
 934 <h2 id="_automatic_installation">Automatic installation</h2>\r
 935 <div class="sectionbody">\r
 936 <div class="paragraph"><p>If environment variable AUTOINSTALL is set grml-debootstrap can be executed in a\r
 937 full automatic mode. While this mode isn&#8217;t really useful for interactive\r
 938 execution (just configure /etc/debootstrap/configure or specify the relevant\r
 939 variables on the commandline instead) it is meant for use via bootoption\r
 940 debian2hd. The bootoption debian2hd (more precise: the kernelname on bootprompt)\r
 941 supports the following bootoptions (they correspond with the commandline options\r
 942 mentioned above):</p></div>\r
 943 <div class="literalblock">\r
 944 <div class="content">\r
 945 <pre><tt>target=...</tt></pre>\r
 946 </div></div>\r
 947 <div class="paragraph"><p>The target partition/directory of the new Debian system. Usage example:\r
 948 target=/dev/sda1</p></div>\r
 949 <div class="literalblock">\r
 950 <div class="content">\r
 951 <pre><tt>grub=...</tt></pre>\r
 952 </div></div>\r
 953 <div class="paragraph"><p>Where do you want to install grub to? Usage example: grub=/dev/sda</p></div>\r
 954 <div class="literalblock">\r
 955 <div class="content">\r
 956 <pre><tt>release=...</tt></pre>\r
 957 </div></div>\r
 958 <div class="paragraph"><p>Specify release of new Debian system. Defaults to Debian stable.  Supported\r
 959 relases: lenny, squeeze and sid. Usage example: release=sid</p></div>\r
 960 <div class="literalblock">\r
 961 <div class="content">\r
 962 <pre><tt>mirror=...</tt></pre>\r
 963 </div></div>\r
 964 <div class="paragraph"><p>Specify mirror which should be used for apt-get/aptitude instead\r
 965 of the default one (<a href="ftp://ftp.debian.de/debian">ftp://ftp.debian.de/debian</a>).\r
 966 Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian</p></div>\r
 967 <div class="literalblock">\r
 968 <div class="content">\r
 969 <pre><tt>password=...</tt></pre>\r
 970 </div></div>\r
 971 <div class="paragraph"><p>Set password of user root without prompting for it but set it to the given\r
 972 argument. Usage example: password=AiTh5ahn</p></div>\r
 973 <h3 id="_usage_example_for_automatic_installation">Usage example for automatic installation:</h3><div style="clear:left"></div>\r
 974 <div class="literalblock">\r
 975 <div class="content">\r
 976 <pre><tt>debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar</tt></pre>\r
 977 </div></div>\r
 978 <div class="paragraph"><p>You have to enter this commandline at the bootprompt of grml. Please make sure\r
 979 that /dev/sda1 is the partition where you really want to install your new Debian\r
 980 system.</p></div>\r
 981 <div class="admonitionblock">\r
 982 <table><tr>\r
 983 <td class="icon">\r
 984 <img src="./images/icons/note.png" alt="Note" />\r
 985 </td>\r
 986 <td class="content">Automatic installation within booting process is done in grml-autoconfig via\r
 987 setting environment variable AUTOINSTALL and creation of\r
 988 /usr/bin/grml-debootstrap_noninteractive with the available and relevant\r
 989 bootoptions for grml-debootstrap.</td>\r
 990 </tr></table>\r
 991 </div>\r
 992 </div>\r
 993 <h2 id="_supported_releases">Supported Releases</h2>\r
 994 <div class="sectionbody">\r
 995 <div class="tableblock">\r
 996 <table rules="all"\r
 997 frame="hsides"\r
 998 cellspacing="0" cellpadding="4">\r
 999 <caption class="title">TableCurrent status</caption>\r
1000 <col width="114" />\r
1001 <col width="205" />\r
1002 <col width="182" />\r
1003 <thead>\r
1004   <tr>\r
1005     <th align="right">\r
1006     Release /\r
1007     </th>\r
1008     <th align="center">\r
1009     Tool  debootstrap\r
1010     </th>\r
1011     <th align="center">\r
1012     cdebootstrap\r
1013     </th>\r
1014   </tr>\r
1015 </thead>\r
1016 <tbody valign="top">\r
1017   <tr>\r
1018     <td align="right">\r
1019     Lenny\r
1020     </td>\r
1021     <td align="center">\r
1022     works\r
1023     </td>\r
1024     <td align="center">\r
1025     works\r
1026     </td>\r
1027   </tr>\r
1028   <tr>\r
1029     <td align="right">\r
1030     Squeeze\r
1031     </td>\r
1032     <td align="center">\r
1033     works\r
1034     </td>\r
1035     <td align="center">\r
1036     works\r
1037     </td>\r
1038   </tr>\r
1039   <tr>\r
1040     <td align="right">\r
1041     Sid\r
1042     </td>\r
1043     <td align="center">\r
1044     works\r
1045     </td>\r
1046     <td align="center">\r
1047     works\r
1048     </td>\r
1049   </tr>\r
1050 </tbody>\r
1051 </table>\r
1052 </div>\r
1053 <div class="admonitionblock">\r
1054 <table><tr>\r
1055 <td class="icon">\r
1056 <img src="./images/icons/note.png" alt="Note" />\r
1057 </td>\r
1058 <td class="content">\r
1059 <div class="title">Etch-Release</div>\r
1060 <div class="paragraph"><p>[1] Please notice that Etch is the current old-stable within Debian.\r
1061 grml-debootstrap can handle the release but you really should not use Etch\r
1062 anymore unless you really know what you are doing. Choose Lenny instead.</p></div>\r
1063 </td>\r
1064 </tr></table>\r
1065 </div>\r
1066 </div>\r
1067 <h2 id="_bugs">Bugs</h2>\r
1068 <div class="sectionbody">\r
1069 <div class="paragraph"><p>Probably. Please send bugreports to Michael Prokop &lt;<a href="mailto:mika@grml.org">mika@grml.org</a>&gt;.</p></div>\r
1070 </div>\r
1071 <h2 id="_see_also">See also</h2>\r
1072 <div class="sectionbody">\r
1073 <div class="paragraph"><p>debootstrap (8), cdebootstrap (1).</p></div>\r
1074 </div>\r
1075 <h2 id="_author">Author</h2>\r
1076 <div class="sectionbody">\r
1077 <div class="paragraph"><p>Michael Prokop &lt;<a href="mailto:mika@grml.org">mika@grml.org</a>&gt;</p></div>\r
1078 </div>\r
1079 </div>\r
1080 <div id="footnotes"><hr /></div>\r
1081 <div id="footer">\r
1082 <div id="footer-text">\r
1083 Last updated 2010-02-23 00:21:26 CEST\r
1084 </div>\r
1085 </div>\r
1086 </body>\r
1087 </html>\r