source: bootcd/isolinux/syslinux-6.03/efi32/txt/html/syslinux.html @ e16e8f2

Last change on this file since e16e8f2 was e16e8f2, checked in by Edwin Eefting <edwin@datux.nl>, 3 years ago

bootstuff
  • Property mode set to 100644
File size: 27.4 KB
Line 
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
6<meta name="generator" content="AsciiDoc 8.6.8" />
7<title>syslinux(1)</title>
8<style type="text/css">
9/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
10
11/* Default font. */
12body {
13  font-family: Georgia,serif;
14}
15
16/* Title font. */
17h1, h2, h3, h4, h5, h6,
18div.title, caption.title,
19thead, p.table.header,
20#toctitle,
21#author, #revnumber, #revdate, #revremark,
22#footer {
23  font-family: Arial,Helvetica,sans-serif;
24}
25
26body {
27  margin: 1em 5% 1em 5%;
28}
29
30a {
31  color: blue;
32  text-decoration: underline;
33}
34a:visited {
35  color: fuchsia;
36}
37
38em {
39  font-style: italic;
40  color: navy;
41}
42
43strong {
44  font-weight: bold;
45  color: #083194;
46}
47
48h1, h2, h3, h4, h5, h6 {
49  color: #527bbd;
50  margin-top: 1.2em;
51  margin-bottom: 0.5em;
52  line-height: 1.3;
53}
54
55h1, h2, h3 {
56  border-bottom: 2px solid silver;
57}
58h2 {
59  padding-top: 0.5em;
60}
61h3 {
62  float: left;
63}
64h3 + * {
65  clear: left;
66}
67h5 {
68  font-size: 1.0em;
69}
70
71div.sectionbody {
72  margin-left: 0;
73}
74
75hr {
76  border: 1px solid silver;
77}
78
79p {
80  margin-top: 0.5em;
81  margin-bottom: 0.5em;
82}
83
84ul, ol, li > p {
85  margin-top: 0;
86}
87ul > li     { color: #aaa; }
88ul > li > * { color: black; }
89
90.monospaced, code, pre {
91  font-family: "Courier New", Courier, monospace;
92  font-size: inherit;
93  color: navy;
94  padding: 0;
95  margin: 0;
96}
97
98
99#author {
100  color: #527bbd;
101  font-weight: bold;
102  font-size: 1.1em;
103}
104#email {
105}
106#revnumber, #revdate, #revremark {
107}
108
109#footer {
110  font-size: small;
111  border-top: 2px solid silver;
112  padding-top: 0.5em;
113  margin-top: 4.0em;
114}
115#footer-text {
116  float: left;
117  padding-bottom: 0.5em;
118}
119#footer-badges {
120  float: right;
121  padding-bottom: 0.5em;
122}
123
124#preamble {
125  margin-top: 1.5em;
126  margin-bottom: 1.5em;
127}
128div.imageblock, div.exampleblock, div.verseblock,
129div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
130div.admonitionblock {
131  margin-top: 1.0em;
132  margin-bottom: 1.5em;
133}
134div.admonitionblock {
135  margin-top: 2.0em;
136  margin-bottom: 2.0em;
137  margin-right: 10%;
138  color: #606060;
139}
140
141div.content { /* Block element content. */
142  padding: 0;
143}
144
145/* Block element titles. */
146div.title, caption.title {
147  color: #527bbd;
148  font-weight: bold;
149  text-align: left;
150  margin-top: 1.0em;
151  margin-bottom: 0.5em;
152}
153div.title + * {
154  margin-top: 0;
155}
156
157td div.title:first-child {
158  margin-top: 0.0em;
159}
160div.content div.title:first-child {
161  margin-top: 0.0em;
162}
163div.content + div.title {
164  margin-top: 0.0em;
165}
166
167div.sidebarblock > div.content {
168  background: #ffffee;
169  border: 1px solid #dddddd;
170  border-left: 4px solid #f0f0f0;
171  padding: 0.5em;
172}
173
174div.listingblock > div.content {
175  border: 1px solid #dddddd;
176  border-left: 5px solid #f0f0f0;
177  background: #f8f8f8;
178  padding: 0.5em;
179}
180
181div.quoteblock, div.verseblock {
182  padding-left: 1.0em;
183  margin-left: 1.0em;
184  margin-right: 10%;
185  border-left: 5px solid #f0f0f0;
186  color: #888;
187}
188
189div.quoteblock > div.attribution {
190  padding-top: 0.5em;
191  text-align: right;
192}
193
194div.verseblock > pre.content {
195  font-family: inherit;
196  font-size: inherit;
197}
198div.verseblock > div.attribution {
199  padding-top: 0.75em;
200  text-align: left;
201}
202/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
203div.verseblock + div.attribution {
204  text-align: left;
205}
206
207div.admonitionblock .icon {
208  vertical-align: top;
209  font-size: 1.1em;
210  font-weight: bold;
211  text-decoration: underline;
212  color: #527bbd;
213  padding-right: 0.5em;
214}
215div.admonitionblock td.content {
216  padding-left: 0.5em;
217  border-left: 3px solid #dddddd;
218}
219
220div.exampleblock > div.content {
221  border-left: 3px solid #dddddd;
222  padding-left: 0.5em;
223}
224
225div.imageblock div.content { padding-left: 0; }
226span.image img { border-style: none; }
227a.image:visited { color: white; }
228
229dl {
230  margin-top: 0.8em;
231  margin-bottom: 0.8em;
232}
233dt {
234  margin-top: 0.5em;
235  margin-bottom: 0;
236  font-style: normal;
237  color: navy;
238}
239dd > *:first-child {
240  margin-top: 0.1em;
241}
242
243ul, ol {
244    list-style-position: outside;
245}
246ol.arabic {
247  list-style-type: decimal;
248}
249ol.loweralpha {
250  list-style-type: lower-alpha;
251}
252ol.upperalpha {
253  list-style-type: upper-alpha;
254}
255ol.lowerroman {
256  list-style-type: lower-roman;
257}
258ol.upperroman {
259  list-style-type: upper-roman;
260}
261
262div.compact ul, div.compact ol,
263div.compact p, div.compact p,
264div.compact div, div.compact div {
265  margin-top: 0.1em;
266  margin-bottom: 0.1em;
267}
268
269tfoot {
270  font-weight: bold;
271}
272td > div.verse {
273  white-space: pre;
274}
275
276div.hdlist {
277  margin-top: 0.8em;
278  margin-bottom: 0.8em;
279}
280div.hdlist tr {
281  padding-bottom: 15px;
282}
283dt.hdlist1.strong, td.hdlist1.strong {
284  font-weight: bold;
285}
286td.hdlist1 {
287  vertical-align: top;
288  font-style: normal;
289  padding-right: 0.8em;
290  color: navy;
291}
292td.hdlist2 {
293  vertical-align: top;
294}
295div.hdlist.compact tr {
296  margin: 0;
297  padding-bottom: 0;
298}
299
300.comment {
301  background: yellow;
302}
303
304.footnote, .footnoteref {
305  font-size: 0.8em;
306}
307
308span.footnote, span.footnoteref {
309  vertical-align: super;
310}
311
312#footnotes {
313  margin: 20px 0 20px 0;
314  padding: 7px 0 0 0;
315}
316
317#footnotes div.footnote {
318  margin: 0 0 5px 0;
319}
320
321#footnotes hr {
322  border: none;
323  border-top: 1px solid silver;
324  height: 1px;
325  text-align: left;
326  margin-left: 0;
327  width: 20%;
328  min-width: 100px;
329}
330
331div.colist td {
332  padding-right: 0.5em;
333  padding-bottom: 0.3em;
334  vertical-align: top;
335}
336div.colist td img {
337  margin-top: 0.3em;
338}
339
340@media print {
341  #footer-badges { display: none; }
342}
343
344#toc {
345  margin-bottom: 2.5em;
346}
347
348#toctitle {
349  color: #527bbd;
350  font-size: 1.1em;
351  font-weight: bold;
352  margin-top: 1.0em;
353  margin-bottom: 0.1em;
354}
355
356div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
357  margin-top: 0;
358  margin-bottom: 0;
359}
360div.toclevel2 {
361  margin-left: 2em;
362  font-size: 0.9em;
363}
364div.toclevel3 {
365  margin-left: 4em;
366  font-size: 0.9em;
367}
368div.toclevel4 {
369  margin-left: 6em;
370  font-size: 0.9em;
371}
372
373span.aqua { color: aqua; }
374span.black { color: black; }
375span.blue { color: blue; }
376span.fuchsia { color: fuchsia; }
377span.gray { color: gray; }
378span.green { color: green; }
379span.lime { color: lime; }
380span.maroon { color: maroon; }
381span.navy { color: navy; }
382span.olive { color: olive; }
383span.purple { color: purple; }
384span.red { color: red; }
385span.silver { color: silver; }
386span.teal { color: teal; }
387span.white { color: white; }
388span.yellow { color: yellow; }
389
390span.aqua-background { background: aqua; }
391span.black-background { background: black; }
392span.blue-background { background: blue; }
393span.fuchsia-background { background: fuchsia; }
394span.gray-background { background: gray; }
395span.green-background { background: green; }
396span.lime-background { background: lime; }
397span.maroon-background { background: maroon; }
398span.navy-background { background: navy; }
399span.olive-background { background: olive; }
400span.purple-background { background: purple; }
401span.red-background { background: red; }
402span.silver-background { background: silver; }
403span.teal-background { background: teal; }
404span.white-background { background: white; }
405span.yellow-background { background: yellow; }
406
407span.big { font-size: 2em; }
408span.small { font-size: 0.6em; }
409
410span.underline { text-decoration: underline; }
411span.overline { text-decoration: overline; }
412span.line-through { text-decoration: line-through; }
413
414div.unbreakable { page-break-inside: avoid; }
415
416
417/*
418 * xhtml11 specific
419 *
420 * */
421
422div.tableblock {
423  margin-top: 1.0em;
424  margin-bottom: 1.5em;
425}
426div.tableblock > table {
427  border: 3px solid #527bbd;
428}
429thead, p.table.header {
430  font-weight: bold;
431  color: #527bbd;
432}
433p.table {
434  margin-top: 0;
435}
436/* Because the table frame attribute is overriden by CSS in most browsers. */
437div.tableblock > table[frame="void"] {
438  border-style: none;
439}
440div.tableblock > table[frame="hsides"] {
441  border-left-style: none;
442  border-right-style: none;
443}
444div.tableblock > table[frame="vsides"] {
445  border-top-style: none;
446  border-bottom-style: none;
447}
448
449
450/*
451 * html5 specific
452 *
453 * */
454
455table.tableblock {
456  margin-top: 1.0em;
457  margin-bottom: 1.5em;
458}
459thead, p.tableblock.header {
460  font-weight: bold;
461  color: #527bbd;
462}
463p.tableblock {
464  margin-top: 0;
465}
466table.tableblock {
467  border-width: 3px;
468  border-spacing: 0px;
469  border-style: solid;
470  border-color: #527bbd;
471  border-collapse: collapse;
472}
473th.tableblock, td.tableblock {
474  border-width: 1px;
475  padding: 4px;
476  border-style: solid;
477  border-color: #527bbd;
478}
479
480table.tableblock.frame-topbot {
481  border-left-style: hidden;
482  border-right-style: hidden;
483}
484table.tableblock.frame-sides {
485  border-top-style: hidden;
486  border-bottom-style: hidden;
487}
488table.tableblock.frame-none {
489  border-style: hidden;
490}
491
492th.tableblock.halign-left, td.tableblock.halign-left {
493  text-align: left;
494}
495th.tableblock.halign-center, td.tableblock.halign-center {
496  text-align: center;
497}
498th.tableblock.halign-right, td.tableblock.halign-right {
499  text-align: right;
500}
501
502th.tableblock.valign-top, td.tableblock.valign-top {
503  vertical-align: top;
504}
505th.tableblock.valign-middle, td.tableblock.valign-middle {
506  vertical-align: middle;
507}
508th.tableblock.valign-bottom, td.tableblock.valign-bottom {
509  vertical-align: bottom;
510}
511
512
513/*
514 * manpage specific
515 *
516 * */
517
518body.manpage h1 {
519  padding-top: 0.5em;
520  padding-bottom: 0.5em;
521  border-top: 2px solid silver;
522  border-bottom: 2px solid silver;
523}
524body.manpage h2 {
525  border-style: none;
526}
527body.manpage div.sectionbody {
528  margin-left: 3em;
529}
530
531@media print {
532  body.manpage div#toc { display: none; }
533}
534
535
536</style>
537<script type="text/javascript">
538/*<![CDATA[*/
539var asciidoc = {  // Namespace.
540
541/////////////////////////////////////////////////////////////////////
542// Table Of Contents generator
543/////////////////////////////////////////////////////////////////////
544
545/* Author: Mihai Bazon, September 2002
546 * http://students.infoiasi.ro/~mishoo
547 *
548 * Table Of Content generator
549 * Version: 0.4
550 *
551 * Feel free to use this script under the terms of the GNU General Public
552 * License, as long as you do not remove or alter this notice.
553 */
554
555 /* modified by Troy D. Hanson, September 2006. License: GPL */
556 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
557
558// toclevels = 1..4.
559toc: function (toclevels) {
560
561  function getText(el) {
562    var text = "";
563    for (var i = el.firstChild; i != null; i = i.nextSibling) {
564      if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
565        text += i.data;
566      else if (i.firstChild != null)
567        text += getText(i);
568    }
569    return text;
570  }
571
572  function TocEntry(el, text, toclevel) {
573    this.element = el;
574    this.text = text;
575    this.toclevel = toclevel;
576  }
577
578  function tocEntries(el, toclevels) {
579    var result = new Array;
580    var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
581    // Function that scans the DOM tree for header elements (the DOM2
582    // nodeIterator API would be a better technique but not supported by all
583    // browsers).
584    var iterate = function (el) {
585      for (var i = el.firstChild; i != null; i = i.nextSibling) {
586        if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
587          var mo = re.exec(i.tagName);
588          if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
589            result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
590          }
591          iterate(i);
592        }
593      }
594    }
595    iterate(el);
596    return result;
597  }
598
599  var toc = document.getElementById("toc");
600  if (!toc) {
601    return;
602  }
603
604  // Delete existing TOC entries in case we're reloading the TOC.
605  var tocEntriesToRemove = [];
606  var i;
607  for (i = 0; i < toc.childNodes.length; i++) {
608    var entry = toc.childNodes[i];
609    if (entry.nodeName.toLowerCase() == 'div'
610     && entry.getAttribute("class")
611     && entry.getAttribute("class").match(/^toclevel/))
612      tocEntriesToRemove.push(entry);
613  }
614  for (i = 0; i < tocEntriesToRemove.length; i++) {
615    toc.removeChild(tocEntriesToRemove[i]);
616  }
617
618  // Rebuild TOC entries.
619  var entries = tocEntries(document.getElementById("content"), toclevels);
620  for (var i = 0; i < entries.length; ++i) {
621    var entry = entries[i];
622    if (entry.element.id == "")
623      entry.element.id = "_toc_" + i;
624    var a = document.createElement("a");
625    a.href = "#" + entry.element.id;
626    a.appendChild(document.createTextNode(entry.text));
627    var div = document.createElement("div");
628    div.appendChild(a);
629    div.className = "toclevel" + entry.toclevel;
630    toc.appendChild(div);
631  }
632  if (entries.length == 0)
633    toc.parentNode.removeChild(toc);
634},
635
636
637/////////////////////////////////////////////////////////////////////
638// Footnotes generator
639/////////////////////////////////////////////////////////////////////
640
641/* Based on footnote generation code from:
642 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
643 */
644
645footnotes: function () {
646  // Delete existing footnote entries in case we're reloading the footnodes.
647  var i;
648  var noteholder = document.getElementById("footnotes");
649  if (!noteholder) {
650    return;
651  }
652  var entriesToRemove = [];
653  for (i = 0; i < noteholder.childNodes.length; i++) {
654    var entry = noteholder.childNodes[i];
655    if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
656      entriesToRemove.push(entry);
657  }
658  for (i = 0; i < entriesToRemove.length; i++) {
659    noteholder.removeChild(entriesToRemove[i]);
660  }
661
662  // Rebuild footnote entries.
663  var cont = document.getElementById("content");
664  var spans = cont.getElementsByTagName("span");
665  var refs = {};
666  var n = 0;
667  for (i=0; i<spans.length; i++) {
668    if (spans[i].className == "footnote") {
669      n++;
670      var note = spans[i].getAttribute("data-note");
671      if (!note) {
672        // Use [\s\S] in place of . so multi-line matches work.
673        // Because JavaScript has no s (dotall) regex flag.
674        note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
675        spans[i].innerHTML =
676          "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
677          "' title='View footnote' class='footnote'>" + n + "</a>]";
678        spans[i].setAttribute("data-note", note);
679      }
680      noteholder.innerHTML +=
681        "<div class='footnote' id='_footnote_" + n + "'>" +
682        "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
683        n + "</a>. " + note + "</div>";
684      var id =spans[i].getAttribute("id");
685      if (id != null) refs["#"+id] = n;
686    }
687  }
688  if (n == 0)
689    noteholder.parentNode.removeChild(noteholder);
690  else {
691    // Process footnoterefs.
692    for (i=0; i<spans.length; i++) {
693      if (spans[i].className == "footnoteref") {
694        var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
695        href = href.match(/#.*/)[0];  // Because IE return full URL.
696        n = refs[href];
697        spans[i].innerHTML =
698          "[<a href='#_footnote_" + n +
699          "' title='View footnote' class='footnote'>" + n + "</a>]";
700      }
701    }
702  }
703},
704
705install: function(toclevels) {
706  var timerId;
707
708  function reinstall() {
709    asciidoc.footnotes();
710    if (toclevels) {
711      asciidoc.toc(toclevels);
712    }
713  }
714
715  function reinstallAndRemoveTimer() {
716    clearInterval(timerId);
717    reinstall();
718  }
719
720  timerId = setInterval(reinstall, 500);
721  if (document.addEventListener)
722    document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
723  else
724    window.onload = reinstallAndRemoveTimer;
725}
726
727}
728asciidoc.install();
729/*]]>*/
730</script>
731</head>
732<body class="manpage">
733<div id="header">
734<h1>
735syslinux(1) Manual Page
736</h1>
737<h2>NAME</h2>
738<div class="sectionbody">
739<p>syslinux -
740   Install SYSLINUX to a file system
741</p>
742</div>
743</div>
744<div id="content">
745<div class="sect1">
746<h2 id="_synopsis">SYNOPSIS</h2>
747<div class="sectionbody">
748<div class="verseblock">
749<pre class="content"><strong>syslinux</strong> [<em>OPTIONS</em>] <em>DEVICE</em>
750<strong>extlinux</strong> [<em>OPTIONS</em>] <em>PATH</em>
751<strong>syslinux</strong> [-h | --help | -v | --version]
752<strong>extlinux</strong> [-h | --help | -v | --version]</pre>
753<div class="attribution">
754</div></div>
755</div>
756</div>
757<div class="sect1">
758<h2 id="_description">DESCRIPTION</h2>
759<div class="sectionbody">
760<div class="paragraph"><p>Install <strong>SYSLINUX</strong> to the <em>DEVICE</em>/<em>PATH</em>, altering the boot sector and
761installing the <em>ldlinux.sys</em> boot loader file.  For the Linux installer
762extlinux, <em>PATH</em> is the desired path for the control files on a mounted,
763supported file system and sets the install-time working directory.  For
764all others, <em>DEVICE</em> must specify a FAT12/FAT16/FAT32 file system.  For
765the Linux installers syslinux and syslinux-mtools, <em>DEVICE</em> should be an
766unmounted file system.  For the DOS/Win32/Win64 installers, <em>DEVICE</em>
767should be a drive like <em>a:</em> (case insensitive).</p></div>
768<div class="paragraph"><p>For versions ~4.00 and later, either -i/--install or -U/--update must be
769specified unless modifying the ADV of an existing install (options
770tagged with <em>ADV</em>) or requesting the help/usage or version info, .</p></div>
771<div class="paragraph"><p>If, during boot, the Shift or Alt keys are held down, or the Caps or
772Scroll locks are set, <strong>Syslinux</strong> will display a <strong>lilo</strong>(8) -style "boot:"
773prompt. The user can then type a kernel file name followed by any kernel
774parameters. The <strong>Syslinux</strong> bootloader does not need to know about the
775kernel or config files in advance.</p></div>
776<div class="paragraph"><p><strong>Syslinux</strong> supports the loading of initial ramdisks (initrd) and the
777bzImage kernel format.</p></div>
778<div class="paragraph"><p>Please note, the ldlinux.sys boot loader file is flagged as immutable
779(where applicable) and is modified after copying in to help ensure
780boot-time integrity.  File systems with a sufficiently large boot loader
781reserved area, like btrfs, will have ldlinux.sys installed there rather
782than as a normal file.  Prior to version 4.00, extlinux would install a
783file extlinux.sys which versions 4.00 and later installers will replace with ldlinux.sys.</p></div>
784</div>
785</div>
786<div class="sect1">
787<h2 id="_options">OPTIONS</h2>
788<div class="sectionbody">
789<div class="sect2">
790<h3 id="_standalone_options">Standalone options</h3>
791<div class="dlist"><dl>
792<dt class="hdlist1">
793<strong>-i</strong>, <strong>--install</strong>
794</dt>
795<dd>
796<p>
797(~4.00+) Install SYSLINUX, regardless of an existing install.
798</p>
799</dd>
800<dt class="hdlist1">
801<strong>-U</strong>, <strong>--update</strong>
802</dt>
803<dd>
804<p>
805(~4.00+) Update an existing SYSLINUX/EXTLINUX install.  If no Syslinux
806boot loader is present, return an error.
807</p>
808</dd>
809<dt class="hdlist1">
810<strong>-h</strong>, <strong>--help</strong>
811</dt>
812<dd>
813<p>
814Display help/usage information.
815</p>
816</dd>
817<dt class="hdlist1">
818<strong>-v</strong>, <strong>--version</strong>
819</dt>
820<dd>
821<p>
822Display version information and exit immediately.
823</p>
824</dd>
825</dl></div>
826</div>
827<div class="sect2">
828<h3 id="_regular_options">Regular Options</h3>
829<div class="dlist"><dl>
830<dt class="hdlist1">
831<strong>-a</strong>, <strong>--active</strong>
832</dt>
833<dd>
834<p>
835(DOS/Win32/Win64 ONLY) Mark the install target file system&#8217;s partition
836active.
837</p>
838</dd>
839<dt class="hdlist1">
840<strong>-d</strong>, <strong>--directory</strong> <em>subdirectory</em>
841</dt>
842<dd>
843<p>
844(Not necessary for extlinux as it is implied by <em>PATH</em>) Install the
845<strong>SYSLINUX</strong> control files in a subdirectory with the specified name
846(relative to the root directory on the device).
847</p>
848</dd>
849<dt class="hdlist1">
850<strong>--device</strong> <em>DEVICE</em>
851</dt>
852<dd>
853<p>
854(extlinux ONLY; 4.06+) Force use of a specific block device (experts
855only).
856</p>
857</dd>
858<dt class="hdlist1">
859<strong>-f</strong>, <strong>--force</strong>
860</dt>
861<dd>
862<p>
863Force install even if it appears unsafe.  Before 4.00, -f was used for
864--offset in the Linux installers.
865</p>
866</dd>
867<dt class="hdlist1">
868<strong>-H</strong>, <strong>--heads</strong> <em>head-count</em>
869</dt>
870<dd>
871<p>
872Override the detected number of heads for the geometry.  See also
873<strong>--sector</strong>.
874</p>
875</dd>
876</dl></div>
877<div class="paragraph"><p><strong>-m</strong>, <strong>--mbr</strong>:
878(DOS/Win32/Win64 ONLY) Install the regular Syslinux MBR code to the MBR.</p></div>
879<div class="dlist"><dl>
880<dt class="hdlist1">
881<strong>-M</strong>, <strong>--menu-save</strong>
882</dt>
883<dd>
884<p>
885(4.00+; ADV) Set the label to select as default on the next boot.
886</p>
887</dd>
888<dt class="hdlist1">
889<strong>-o</strong>, <strong>--once</strong> <em>command</em>
890</dt>
891<dd>
892<p>
893(ADV) Declare a boot command to be tried on the first boot only.  The
894use of <strong>-o</strong> for the Linux installers syslinux or syslinux-mtools has
895been deprecated as of ~4.00 and is no longer valid as of ~4.02.
896</p>
897</dd>
898<dt class="hdlist1">
899<strong>-O</strong>, <strong>--clear-once</strong>
900</dt>
901<dd>
902<p>
903Clear the boot-once command.  See also <strong>--once</strong>.
904</p>
905</dd>
906<dt class="hdlist1">
907<strong>-r</strong>, <strong>--raid</strong>
908</dt>
909<dd>
910<p>
911(ADV) RAID mode.  If boot fails, tell the BIOS to boot the next device
912in the boot sequence (usually the next hard disk) instead of stopping
913with an error message.  This is useful for RAID-1 booting.
914</p>
915</dd>
916<dt class="hdlist1">
917<strong>--reset-adv</strong>
918</dt>
919<dd>
920<p>
921(ADV) Reset auxilliary data vector.
922</p>
923</dd>
924<dt class="hdlist1">
925<strong>-S</strong>, <strong>--sectors</strong> <em>sector-count</em>
926</dt>
927<dd>
928<p>
929Override the detected number of sectors for the geometry.  See also
930<strong>--head</strong>.
931</p>
932</dd>
933<dt class="hdlist1">
934<strong>-s</strong>, <strong>--stupid</strong>
935</dt>
936<dd>
937<p>
938Install a "safe, slow and stupid" version of <strong>SYSLINUX</strong>. This version
939may work on some very buggy BIOSes on which <strong>SYSLINUX</strong> would otherwise
940fail. If you find a machine on which the -s option is required to make
941it boot reliably, please send as much info about your machine as you
942can, and include the failure mode.
943</p>
944</dd>
945<dt class="hdlist1">
946<strong>-t</strong>, <strong>--offset</strong> <em>offset</em>
947</dt>
948<dd>
949<p>
950(Linux syslinux/syslinux-mtools ONLY) Indicates that the filesystem is
951at an offset from the base of the device or file.
952</p>
953</dd>
954</dl></div>
955<div class="paragraph"><p><strong>-z</strong>, <strong>--zipdrive</strong>
956Assume zipdrive geometry (<em>--heads 64 --sectors 32</em>).  See also <strong>--head</strong>
957and <strong>--sector</strong>.</p></div>
958</div>
959</div>
960</div>
961<div class="sect1">
962<h2 id="_examples">EXAMPLES</h2>
963<div class="sectionbody">
964<div class="sect2">
965<h3 id="_booting_dos">Booting DOS</h3>
966<div class="paragraph"><p>For booting DOS and other similar operating systems, there is an easy
967and generally reliable solution to substitute in SYSLINUX as the primary
968boot loader.</p></div>
969<div class="ulist"><ul>
970<li>
971<p>
972Make a DOS-bootable disk;  The following are possible commands:
973</p>
974<div class="literalblock">
975<div class="content">
976<pre><code>format a: /s
977sys a:</code></pre>
978</div></div>
979</li>
980<li>
981<p>
982Copy the DOS boot sector off using Linux or copybs.com:
983</p>
984<div class="literalblock">
985<div class="content">
986<pre><code>dd if=/dev/fd0 of=dos.bss bs=512 count=1
987copybs a: a:dos.bss</code></pre>
988</div></div>
989</li>
990<li>
991<p>
992Install SYSLINUX using one of:
993</p>
994<div class="literalblock">
995<div class="content">
996<pre><code>syslinux a:
997syslinux /dev/fd0               (before 4.00)
998syslinux -i /dev/fd0            (4.00+)</code></pre>
999</div></div>
1000</li>
1001<li>
1002<p>
1003For Linux, mount the disk and copy the dos.bss to the disk:
1004</p>
1005<div class="literalblock">
1006<div class="content">
1007<pre><code>mount -t msdos /dev/fd0 /mnt
1008cp dos.bss /mnt</code></pre>
1009</div></div>
1010</li>
1011<li>
1012<p>
1013Copy a Linux kernel image and initrd payload files:
1014</p>
1015<div class="dlist"><dl>
1016<dt class="hdlist1">
1017<strong>Linux:</strong>
1018</dt>
1019<dd>
1020<p>
1021        cp vmlinux /mnt
1022        cp initrd.gz /mnt
1023</p>
1024</dd>
1025<dt class="hdlist1">
1026<strong>DOS/Windows:</strong>
1027</dt>
1028<dd>
1029<p>
1030        copy vmlinux a:
1031        copy initrd.gz a:
1032</p>
1033</dd>
1034</dl></div>
1035</li>
1036<li>
1037<p>
1038For Linux, umount the disk (if applicable):
1039</p>
1040<div class="literalblock">
1041<div class="content">
1042<pre><code>umount /mnt</code></pre>
1043</div></div>
1044</li>
1045</ul></div>
1046</div>
1047<div class="sect2">
1048<h3 id="_mbr">MBR</h3>
1049<div class="paragraph"><p>In order to boot from a hard disk (or hard disk-like device) in BIOS
1050mode, an appropriate MBR boot block must also be installed in the MBR
1051(first sector or 512 bytes of the disk), occupying at most 440 bytes.</p></div>
1052<div class="dlist"><dl>
1053<dt class="hdlist1">
1054<strong>DOS/Windows:</strong>
1055</dt>
1056<dd>
1057<p>
1058If using FDISK, FDISK or a similar application must also be used to mark
1059the partition as active.
1060</p>
1061<div class="literalblock">
1062<div class="content">
1063<pre><code>    fdisk /mbr
1064OR
1065    syslinux -ma c:</code></pre>
1066</div></div>
1067</dd>
1068<dt class="hdlist1">
1069<strong>Linux:</strong>
1070</dt>
1071<dd>
1072<div class="literalblock">
1073<div class="content">
1074<pre><code>dd bs=440 count=1 conv=notrunc if=mbr/mbr.bin of=/dev/sda</code></pre>
1075</div></div>
1076<div class="paragraph"><p>For altmbr.bin, an easy way to overwrite the MBR boot block and specify
1077the partion number is:</p></div>
1078<div class="literalblock">
1079<div class="content">
1080<pre><code>printf '\1' | cat altmbr.bin - | dd bs=440 count=1 \
1081  iflag=fullblock conv=notrunc of=/dev/sda</code></pre>
1082</div></div>
1083<div class="paragraph"><p>Note: using <em>cat</em> for writing the MBR can under some circumstances cause
1084data loss or overwritting.  For this reason, using <em>dd</em> is recommended
1085for all situations.</p></div>
1086</dd>
1087</dl></div>
1088</div>
1089</div>
1090</div>
1091<div class="sect1">
1092<h2 id="_see_also">SEE ALSO</h2>
1093<div class="sectionbody">
1094<div class="paragraph"><p><strong>syslinux.cfg</strong>(5), <strong>syslinux-cli</strong>(1), <strong>lilo</strong>(8), <strong>keytab-lilo.pl</strong>(8),
1095<strong>fdisk</strong>(8), <strong>mkfs</strong>(8), <strong>superformat</strong>(1).</p></div>
1096</div>
1097</div>
1098<div class="sect1">
1099<h2 id="_author">AUTHOR</h2>
1100<div class="sectionbody">
1101<div class="paragraph"><p>This AsciiDoc derived document is a modified version of the original
1102<strong>SYSLINUX</strong> documentation by H. Peter Anvin &lt;<a href="mailto:hpa@zytor.com">hpa@zytor.com</a>&gt;. The conversion to
1103a manpage was made by Arthur Korn &lt;<a href="mailto:arthur@korn.ch">arthur@korn.ch</a>&gt;.  The conversion to
1104an AsciiDoc was made by Gene Cumm &lt;<a href="mailto:gene.cumm@gmail.com">gene.cumm@gmail.com</a>&gt;</p></div>
1105</div>
1106</div>
1107<div class="sect1">
1108<h2 id="_copyright">COPYRIGHT</h2>
1109<div class="sectionbody">
1110<div class="paragraph"><p>Copyright (C) 1994-2012 H. Peter Anvin. Free use of this software is granted
1111under the terms of the GNU General Public License (GPL), version 2
1112(GPLv2) (or, at your option, any later version).</p></div>
1113</div>
1114</div>
1115</div>
1116<div id="footnotes"><hr /></div>
1117<div id="footer">
1118<div id="footer-text">
1119Last updated 2014-01-17 16:09:56 PST
1120</div>
1121</div>
1122</body>
1123</html>
Note: See TracBrowser for help on using the repository browser.