xref: /illumos-gate/usr/src/man/man7/isoboot.7 (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
1*bbf21555SRichard Lowe.\" Copyright (c) 2018 iXsystems, Inc.
2*bbf21555SRichard Lowe.\" All rights reserved.
3*bbf21555SRichard Lowe.\"
4*bbf21555SRichard Lowe.\" Redistribution and use in source and binary forms, with or without
5*bbf21555SRichard Lowe.\" modification, are permitted provided that the following conditions
6*bbf21555SRichard Lowe.\" are met:
7*bbf21555SRichard Lowe.\" 1. Redistributions of source code must retain the above copyright
8*bbf21555SRichard Lowe.\"    notice, this list of conditions and the following disclaimer.
9*bbf21555SRichard Lowe.\" 2. Redistributions in binary form must reproduce the above copyright
10*bbf21555SRichard Lowe.\"    notice, this list of conditions and the following disclaimer in the
11*bbf21555SRichard Lowe.\"    documentation and/or other materials provided with the distribution.
12*bbf21555SRichard Lowe.\"
13*bbf21555SRichard Lowe.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
14*bbf21555SRichard Lowe.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15*bbf21555SRichard Lowe.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16*bbf21555SRichard Lowe.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
17*bbf21555SRichard Lowe.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18*bbf21555SRichard Lowe.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19*bbf21555SRichard Lowe.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20*bbf21555SRichard Lowe.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21*bbf21555SRichard Lowe.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22*bbf21555SRichard Lowe.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23*bbf21555SRichard Lowe.\" SUCH DAMAGE.
24*bbf21555SRichard Lowe.\"
25*bbf21555SRichard Lowe.Dd March 30, 2018
26*bbf21555SRichard Lowe.Dt ISOBOOT 7
27*bbf21555SRichard Lowe.Os
28*bbf21555SRichard Lowe.Sh NAME
29*bbf21555SRichard Lowe.Nm isoboot
30*bbf21555SRichard Lowe.Nd Boot code for hybrid ISO/USB images on BIOS-based computers
31*bbf21555SRichard Lowe.Sh DESCRIPTION
32*bbf21555SRichard Lowe.Nm
33*bbf21555SRichard Loweis used on BIOS-based computers to boot from an ISO image that has
34*bbf21555SRichard Lowebeen written to a USB flash drive or other HDD-like device.
35*bbf21555SRichard Lowe.Nm
36*bbf21555SRichard Loweis installed in a
37*bbf21555SRichard Lowe.Cm x86 Boot
38*bbf21555SRichard Lowepartition with
39*bbf21555SRichard Lowe.Xr installboot 8 .
40*bbf21555SRichard Lowe.Sh IMPLEMENTATION NOTES
41*bbf21555SRichard LoweThe El Torito standard for bootable CDs provides a 32KB "System Area"
42*bbf21555SRichard Loweat the beginning of an image.
43*bbf21555SRichard LoweTo create an image that is able to be booted by the BIOS as either a
44*bbf21555SRichard LoweCD-ROM ("ISO") and as a more HDD-like image (e.g. on a USB flash drive)
45*bbf21555SRichard Loweit is necessary to have both a standard El Torito boot catalog
46*bbf21555SRichard Lowecontaining a HDD-style partition table and boot code.
47*bbf21555SRichard Lowe.Nm
48*bbf21555SRichard Loweis intended to be placed in a MBR x86 boot partition to allow the system to find
49*bbf21555SRichard Lowethe standard
50*bbf21555SRichard Lowe.Fx
51*bbf21555SRichard Lowe.Xr loader 7
52*bbf21555SRichard Lowein the ISO filesystem later in the image.
53*bbf21555SRichard Lowe.Sh BOOTING
54*bbf21555SRichard Lowe.Nm
55*bbf21555SRichard Lowelooks for an ISO filesystem image on the device it was booted from and
56*bbf21555SRichard Loweseeks to read the primary illumos
57*bbf21555SRichard Lowe.Xr loader 7
58*bbf21555SRichard Lowefrom there.
59*bbf21555SRichard Lowe.Sh SEE ALSO
60*bbf21555SRichard Lowe.Xr installboot 8
61*bbf21555SRichard Lowe.Sh HISTORY
62*bbf21555SRichard Lowe.Nm
63*bbf21555SRichard Loweappeared in FreeBSD 12.0.
64*bbf21555SRichard Lowe.Sh AUTHORS
65*bbf21555SRichard LoweThis manual page written by
66*bbf21555SRichard Lowe.An Benno Rice Aq benno@FreeBSD.org .
67