| Greg Hartman | 76d05dc | 2016-11-23 15:51:27 -0800 | [diff] [blame] | 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. */
|
| 12 | body {
|
| 13 | font-family: Georgia,serif;
|
| 14 | }
|
| 15 |
|
| 16 | /* Title font. */
|
| 17 | h1, h2, h3, h4, h5, h6,
|
| 18 | div.title, caption.title,
|
| 19 | thead, p.table.header,
|
| 20 | #toctitle,
|
| 21 | #author, #revnumber, #revdate, #revremark,
|
| 22 | #footer {
|
| 23 | font-family: Arial,Helvetica,sans-serif;
|
| 24 | }
|
| 25 |
|
| 26 | body {
|
| 27 | margin: 1em 5% 1em 5%;
|
| 28 | }
|
| 29 |
|
| 30 | a {
|
| 31 | color: blue;
|
| 32 | text-decoration: underline;
|
| 33 | }
|
| 34 | a:visited {
|
| 35 | color: fuchsia;
|
| 36 | }
|
| 37 |
|
| 38 | em {
|
| 39 | font-style: italic;
|
| 40 | color: navy;
|
| 41 | }
|
| 42 |
|
| 43 | strong {
|
| 44 | font-weight: bold;
|
| 45 | color: #083194;
|
| 46 | }
|
| 47 |
|
| 48 | h1, 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 |
|
| 55 | h1, h2, h3 {
|
| 56 | border-bottom: 2px solid silver;
|
| 57 | }
|
| 58 | h2 {
|
| 59 | padding-top: 0.5em;
|
| 60 | }
|
| 61 | h3 {
|
| 62 | float: left;
|
| 63 | }
|
| 64 | h3 + * {
|
| 65 | clear: left;
|
| 66 | }
|
| 67 | h5 {
|
| 68 | font-size: 1.0em;
|
| 69 | }
|
| 70 |
|
| 71 | div.sectionbody {
|
| 72 | margin-left: 0;
|
| 73 | }
|
| 74 |
|
| 75 | hr {
|
| 76 | border: 1px solid silver;
|
| 77 | }
|
| 78 |
|
| 79 | p {
|
| 80 | margin-top: 0.5em;
|
| 81 | margin-bottom: 0.5em;
|
| 82 | }
|
| 83 |
|
| 84 | ul, ol, li > p {
|
| 85 | margin-top: 0;
|
| 86 | }
|
| 87 | ul > li { color: #aaa; }
|
| 88 | ul > 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 | }
|
| 128 | div.imageblock, div.exampleblock, div.verseblock,
|
| 129 | div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
| 130 | div.admonitionblock {
|
| 131 | margin-top: 1.0em;
|
| 132 | margin-bottom: 1.5em;
|
| 133 | }
|
| 134 | div.admonitionblock {
|
| 135 | margin-top: 2.0em;
|
| 136 | margin-bottom: 2.0em;
|
| 137 | margin-right: 10%;
|
| 138 | color: #606060;
|
| 139 | }
|
| 140 |
|
| 141 | div.content { /* Block element content. */
|
| 142 | padding: 0;
|
| 143 | }
|
| 144 |
|
| 145 | /* Block element titles. */
|
| 146 | div.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 | }
|
| 153 | div.title + * {
|
| 154 | margin-top: 0;
|
| 155 | }
|
| 156 |
|
| 157 | td div.title:first-child {
|
| 158 | margin-top: 0.0em;
|
| 159 | }
|
| 160 | div.content div.title:first-child {
|
| 161 | margin-top: 0.0em;
|
| 162 | }
|
| 163 | div.content + div.title {
|
| 164 | margin-top: 0.0em;
|
| 165 | }
|
| 166 |
|
| 167 | div.sidebarblock > div.content {
|
| 168 | background: #ffffee;
|
| 169 | border: 1px solid #dddddd;
|
| 170 | border-left: 4px solid #f0f0f0;
|
| 171 | padding: 0.5em;
|
| 172 | }
|
| 173 |
|
| 174 | div.listingblock > div.content {
|
| 175 | border: 1px solid #dddddd;
|
| 176 | border-left: 5px solid #f0f0f0;
|
| 177 | background: #f8f8f8;
|
| 178 | padding: 0.5em;
|
| 179 | }
|
| 180 |
|
| 181 | div.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 |
|
| 189 | div.quoteblock > div.attribution {
|
| 190 | padding-top: 0.5em;
|
| 191 | text-align: right;
|
| 192 | }
|
| 193 |
|
| 194 | div.verseblock > pre.content {
|
| 195 | font-family: inherit;
|
| 196 | font-size: inherit;
|
| 197 | }
|
| 198 | div.verseblock > div.attribution {
|
| 199 | padding-top: 0.75em;
|
| 200 | text-align: left;
|
| 201 | }
|
| 202 | /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
|
| 203 | div.verseblock + div.attribution {
|
| 204 | text-align: left;
|
| 205 | }
|
| 206 |
|
| 207 | div.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 | }
|
| 215 | div.admonitionblock td.content {
|
| 216 | padding-left: 0.5em;
|
| 217 | border-left: 3px solid #dddddd;
|
| 218 | }
|
| 219 |
|
| 220 | div.exampleblock > div.content {
|
| 221 | border-left: 3px solid #dddddd;
|
| 222 | padding-left: 0.5em;
|
| 223 | }
|
| 224 |
|
| 225 | div.imageblock div.content { padding-left: 0; }
|
| 226 | span.image img { border-style: none; }
|
| 227 | a.image:visited { color: white; }
|
| 228 |
|
| 229 | dl {
|
| 230 | margin-top: 0.8em;
|
| 231 | margin-bottom: 0.8em;
|
| 232 | }
|
| 233 | dt {
|
| 234 | margin-top: 0.5em;
|
| 235 | margin-bottom: 0;
|
| 236 | font-style: normal;
|
| 237 | color: navy;
|
| 238 | }
|
| 239 | dd > *:first-child {
|
| 240 | margin-top: 0.1em;
|
| 241 | }
|
| 242 |
|
| 243 | ul, ol {
|
| 244 | list-style-position: outside;
|
| 245 | }
|
| 246 | ol.arabic {
|
| 247 | list-style-type: decimal;
|
| 248 | }
|
| 249 | ol.loweralpha {
|
| 250 | list-style-type: lower-alpha;
|
| 251 | }
|
| 252 | ol.upperalpha {
|
| 253 | list-style-type: upper-alpha;
|
| 254 | }
|
| 255 | ol.lowerroman {
|
| 256 | list-style-type: lower-roman;
|
| 257 | }
|
| 258 | ol.upperroman {
|
| 259 | list-style-type: upper-roman;
|
| 260 | }
|
| 261 |
|
| 262 | div.compact ul, div.compact ol,
|
| 263 | div.compact p, div.compact p,
|
| 264 | div.compact div, div.compact div {
|
| 265 | margin-top: 0.1em;
|
| 266 | margin-bottom: 0.1em;
|
| 267 | }
|
| 268 |
|
| 269 | tfoot {
|
| 270 | font-weight: bold;
|
| 271 | }
|
| 272 | td > div.verse {
|
| 273 | white-space: pre;
|
| 274 | }
|
| 275 |
|
| 276 | div.hdlist {
|
| 277 | margin-top: 0.8em;
|
| 278 | margin-bottom: 0.8em;
|
| 279 | }
|
| 280 | div.hdlist tr {
|
| 281 | padding-bottom: 15px;
|
| 282 | }
|
| 283 | dt.hdlist1.strong, td.hdlist1.strong {
|
| 284 | font-weight: bold;
|
| 285 | }
|
| 286 | td.hdlist1 {
|
| 287 | vertical-align: top;
|
| 288 | font-style: normal;
|
| 289 | padding-right: 0.8em;
|
| 290 | color: navy;
|
| 291 | }
|
| 292 | td.hdlist2 {
|
| 293 | vertical-align: top;
|
| 294 | }
|
| 295 | div.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 |
|
| 308 | span.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 |
|
| 331 | div.colist td {
|
| 332 | padding-right: 0.5em;
|
| 333 | padding-bottom: 0.3em;
|
| 334 | vertical-align: top;
|
| 335 | }
|
| 336 | div.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 |
|
| 356 | div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
|
| 357 | margin-top: 0;
|
| 358 | margin-bottom: 0;
|
| 359 | }
|
| 360 | div.toclevel2 {
|
| 361 | margin-left: 2em;
|
| 362 | font-size: 0.9em;
|
| 363 | }
|
| 364 | div.toclevel3 {
|
| 365 | margin-left: 4em;
|
| 366 | font-size: 0.9em;
|
| 367 | }
|
| 368 | div.toclevel4 {
|
| 369 | margin-left: 6em;
|
| 370 | font-size: 0.9em;
|
| 371 | }
|
| 372 |
|
| 373 | span.aqua { color: aqua; }
|
| 374 | span.black { color: black; }
|
| 375 | span.blue { color: blue; }
|
| 376 | span.fuchsia { color: fuchsia; }
|
| 377 | span.gray { color: gray; }
|
| 378 | span.green { color: green; }
|
| 379 | span.lime { color: lime; }
|
| 380 | span.maroon { color: maroon; }
|
| 381 | span.navy { color: navy; }
|
| 382 | span.olive { color: olive; }
|
| 383 | span.purple { color: purple; }
|
| 384 | span.red { color: red; }
|
| 385 | span.silver { color: silver; }
|
| 386 | span.teal { color: teal; }
|
| 387 | span.white { color: white; }
|
| 388 | span.yellow { color: yellow; }
|
| 389 |
|
| 390 | span.aqua-background { background: aqua; }
|
| 391 | span.black-background { background: black; }
|
| 392 | span.blue-background { background: blue; }
|
| 393 | span.fuchsia-background { background: fuchsia; }
|
| 394 | span.gray-background { background: gray; }
|
| 395 | span.green-background { background: green; }
|
| 396 | span.lime-background { background: lime; }
|
| 397 | span.maroon-background { background: maroon; }
|
| 398 | span.navy-background { background: navy; }
|
| 399 | span.olive-background { background: olive; }
|
| 400 | span.purple-background { background: purple; }
|
| 401 | span.red-background { background: red; }
|
| 402 | span.silver-background { background: silver; }
|
| 403 | span.teal-background { background: teal; }
|
| 404 | span.white-background { background: white; }
|
| 405 | span.yellow-background { background: yellow; }
|
| 406 |
|
| 407 | span.big { font-size: 2em; }
|
| 408 | span.small { font-size: 0.6em; }
|
| 409 |
|
| 410 | span.underline { text-decoration: underline; }
|
| 411 | span.overline { text-decoration: overline; }
|
| 412 | span.line-through { text-decoration: line-through; }
|
| 413 |
|
| 414 | div.unbreakable { page-break-inside: avoid; }
|
| 415 |
|
| 416 |
|
| 417 | /*
|
| 418 | * xhtml11 specific
|
| 419 | *
|
| 420 | * */
|
| 421 |
|
| 422 | div.tableblock {
|
| 423 | margin-top: 1.0em;
|
| 424 | margin-bottom: 1.5em;
|
| 425 | }
|
| 426 | div.tableblock > table {
|
| 427 | border: 3px solid #527bbd;
|
| 428 | }
|
| 429 | thead, p.table.header {
|
| 430 | font-weight: bold;
|
| 431 | color: #527bbd;
|
| 432 | }
|
| 433 | p.table {
|
| 434 | margin-top: 0;
|
| 435 | }
|
| 436 | /* Because the table frame attribute is overriden by CSS in most browsers. */
|
| 437 | div.tableblock > table[frame="void"] {
|
| 438 | border-style: none;
|
| 439 | }
|
| 440 | div.tableblock > table[frame="hsides"] {
|
| 441 | border-left-style: none;
|
| 442 | border-right-style: none;
|
| 443 | }
|
| 444 | div.tableblock > table[frame="vsides"] {
|
| 445 | border-top-style: none;
|
| 446 | border-bottom-style: none;
|
| 447 | }
|
| 448 |
|
| 449 |
|
| 450 | /*
|
| 451 | * html5 specific
|
| 452 | *
|
| 453 | * */
|
| 454 |
|
| 455 | table.tableblock {
|
| 456 | margin-top: 1.0em;
|
| 457 | margin-bottom: 1.5em;
|
| 458 | }
|
| 459 | thead, p.tableblock.header {
|
| 460 | font-weight: bold;
|
| 461 | color: #527bbd;
|
| 462 | }
|
| 463 | p.tableblock {
|
| 464 | margin-top: 0;
|
| 465 | }
|
| 466 | table.tableblock {
|
| 467 | border-width: 3px;
|
| 468 | border-spacing: 0px;
|
| 469 | border-style: solid;
|
| 470 | border-color: #527bbd;
|
| 471 | border-collapse: collapse;
|
| 472 | }
|
| 473 | th.tableblock, td.tableblock {
|
| 474 | border-width: 1px;
|
| 475 | padding: 4px;
|
| 476 | border-style: solid;
|
| 477 | border-color: #527bbd;
|
| 478 | }
|
| 479 |
|
| 480 | table.tableblock.frame-topbot {
|
| 481 | border-left-style: hidden;
|
| 482 | border-right-style: hidden;
|
| 483 | }
|
| 484 | table.tableblock.frame-sides {
|
| 485 | border-top-style: hidden;
|
| 486 | border-bottom-style: hidden;
|
| 487 | }
|
| 488 | table.tableblock.frame-none {
|
| 489 | border-style: hidden;
|
| 490 | }
|
| 491 |
|
| 492 | th.tableblock.halign-left, td.tableblock.halign-left {
|
| 493 | text-align: left;
|
| 494 | }
|
| 495 | th.tableblock.halign-center, td.tableblock.halign-center {
|
| 496 | text-align: center;
|
| 497 | }
|
| 498 | th.tableblock.halign-right, td.tableblock.halign-right {
|
| 499 | text-align: right;
|
| 500 | }
|
| 501 |
|
| 502 | th.tableblock.valign-top, td.tableblock.valign-top {
|
| 503 | vertical-align: top;
|
| 504 | }
|
| 505 | th.tableblock.valign-middle, td.tableblock.valign-middle {
|
| 506 | vertical-align: middle;
|
| 507 | }
|
| 508 | th.tableblock.valign-bottom, td.tableblock.valign-bottom {
|
| 509 | vertical-align: bottom;
|
| 510 | }
|
| 511 |
|
| 512 |
|
| 513 | /*
|
| 514 | * manpage specific
|
| 515 | *
|
| 516 | * */
|
| 517 |
|
| 518 | body.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 | }
|
| 524 | body.manpage h2 {
|
| 525 | border-style: none;
|
| 526 | }
|
| 527 | body.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 | /*<+'])');
|
| 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 |
|
| 645 | footnotes: 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 |
|
| 705 | install: 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 | }
|
| 728 | asciidoc.install();
|
| 729 | /*]]>*/
|
| 730 | </script>
|
| 731 | </head>
|
| 732 | <body class="manpage">
|
| 733 | <div id="header">
|
| 734 | <h1>
|
| 735 | syslinux(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
|
| 761 | installing the <em>ldlinux.sys</em> boot loader file. For the Linux installer
|
| 762 | extlinux, <em>PATH</em> is the desired path for the control files on a mounted,
|
| 763 | supported file system and sets the install-time working directory. For
|
| 764 | all others, <em>DEVICE</em> must specify a FAT12/FAT16/FAT32 file system. For
|
| 765 | the Linux installers syslinux and syslinux-mtools, <em>DEVICE</em> should be an
|
| 766 | unmounted file system. For the DOS/Win32/Win64 installers, <em>DEVICE</em>
|
| 767 | should 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
|
| 769 | specified unless modifying the ADV of an existing install (options
|
| 770 | tagged 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
|
| 772 | Scroll locks are set, <strong>Syslinux</strong> will display a <strong>lilo</strong>(8) -style "boot:"
|
| 773 | prompt. The user can then type a kernel file name followed by any kernel
|
| 774 | parameters. The <strong>Syslinux</strong> bootloader does not need to know about the
|
| 775 | kernel or config files in advance.</p></div>
|
| 776 | <div class="paragraph"><p><strong>Syslinux</strong> supports the loading of initial ramdisks (initrd) and the
|
| 777 | bzImage 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
|
| 780 | boot-time integrity. File systems with a sufficiently large boot loader
|
| 781 | reserved area, like btrfs, will have ldlinux.sys installed there rather
|
| 782 | than as a normal file. Prior to version 4.00, extlinux would install a
|
| 783 | file 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
|
| 806 | boot 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>
|
| 814 | Display help/usage information.
|
| 815 | </p>
|
| 816 | </dd>
|
| 817 | <dt class="hdlist1">
|
| 818 | <strong>-v</strong>, <strong>--version</strong>
|
| 819 | </dt>
|
| 820 | <dd>
|
| 821 | <p>
|
| 822 | Display 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’s partition
|
| 836 | active.
|
| 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
|
| 855 | only).
|
| 856 | </p>
|
| 857 | </dd>
|
| 858 | <dt class="hdlist1">
|
| 859 | <strong>-f</strong>, <strong>--force</strong>
|
| 860 | </dt>
|
| 861 | <dd>
|
| 862 | <p>
|
| 863 | Force 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>
|
| 872 | Override 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
|
| 894 | use of <strong>-o</strong> for the Linux installers syslinux or syslinux-mtools has
|
| 895 | been 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>
|
| 903 | Clear 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
|
| 912 | in the boot sequence (usually the next hard disk) instead of stopping
|
| 913 | with 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>
|
| 929 | Override 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>
|
| 938 | Install a "safe, slow and stupid" version of <strong>SYSLINUX</strong>. This version
|
| 939 | may work on some very buggy BIOSes on which <strong>SYSLINUX</strong> would otherwise
|
| 940 | fail. If you find a machine on which the -s option is required to make
|
| 941 | it boot reliably, please send as much info about your machine as you
|
| 942 | can, 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
|
| 951 | at 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>
|
| 956 | Assume zipdrive geometry (<em>--heads 64 --sectors 32</em>). See also <strong>--head</strong>
|
| 957 | and <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
|
| 967 | and generally reliable solution to substitute in SYSLINUX as the primary
|
| 968 | boot loader.</p></div>
|
| 969 | <div class="ulist"><ul>
|
| 970 | <li>
|
| 971 | <p>
|
| 972 | Make 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
|
| 977 | sys a:</code></pre>
|
| 978 | </div></div>
|
| 979 | </li>
|
| 980 | <li>
|
| 981 | <p>
|
| 982 | Copy 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
|
| 987 | copybs a: a:dos.bss</code></pre>
|
| 988 | </div></div>
|
| 989 | </li>
|
| 990 | <li>
|
| 991 | <p>
|
| 992 | Install SYSLINUX using one of:
|
| 993 | </p>
|
| 994 | <div class="literalblock">
|
| 995 | <div class="content">
|
| 996 | <pre><code>syslinux a:
|
| 997 | syslinux /dev/fd0 (before 4.00)
|
| 998 | syslinux -i /dev/fd0 (4.00+)</code></pre>
|
| 999 | </div></div>
|
| 1000 | </li>
|
| 1001 | <li>
|
| 1002 | <p>
|
| 1003 | For 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
|
| 1008 | cp dos.bss /mnt</code></pre>
|
| 1009 | </div></div>
|
| 1010 | </li>
|
| 1011 | <li>
|
| 1012 | <p>
|
| 1013 | Copy 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>
|
| 1038 | For 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
|
| 1050 | mode, 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>
|
| 1058 | If using FDISK, FDISK or a similar application must also be used to mark
|
| 1059 | the partition as active.
|
| 1060 | </p>
|
| 1061 | <div class="literalblock">
|
| 1062 | <div class="content">
|
| 1063 | <pre><code> fdisk /mbr
|
| 1064 | OR
|
| 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
|
| 1077 | the 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
|
| 1084 | data loss or overwritting. For this reason, using <em>dd</em> is recommended
|
| 1085 | for 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 <<a href="mailto:hpa@zytor.com">hpa@zytor.com</a>>. The conversion to
|
| 1103 | a manpage was made by Arthur Korn <<a href="mailto:arthur@korn.ch">arthur@korn.ch</a>>. The conversion to
|
| 1104 | an AsciiDoc was made by Gene Cumm <<a href="mailto:gene.cumm@gmail.com">gene.cumm@gmail.com</a>></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
|
| 1111 | under 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">
|
| 1119 | Last updated 2014-01-17 16:09:56 PST
|
| 1120 | </div>
|
| 1121 | </div>
|
| 1122 | </body>
|
| 1123 | </html>
|