Changeset View
Changeset View
Standalone View
Standalone View
stand/i386/isoboot/isoboot.8
- This file was added.
| .\" Copyright (c) 2018 iXsystems, Inc. | |||||
| .\" All rights reserved. | |||||
| .\" | |||||
| .\" Redistribution and use in source and binary forms, with or without | |||||
| .\" modification, are permitted provided that the following conditions | |||||
| .\" are met: | |||||
| .\" 1. Redistributions of source code must retain the above copyright | |||||
| .\" notice, this list of conditions and the following disclaimer. | |||||
| .\" 2. Redistributions in binary form must reproduce the above copyright | |||||
| .\" notice, this list of conditions and the following disclaimer in the | |||||
| .\" documentation and/or other materials provided with the distribution. | |||||
| .\" | |||||
| .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND | |||||
| .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |||||
| .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |||||
| .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE | |||||
| .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |||||
| .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |||||
| .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |||||
| .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |||||
| .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |||||
| .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |||||
| .\" SUCH DAMAGE. | |||||
| .\" | |||||
| .\" $FreeBSD$ | |||||
| .\" | |||||
| .Dd March 30, 2018 | |||||
| .Dt ISOBOOT 8 | |||||
| .Os | |||||
| .Sh NAME | |||||
| .Nm isoboot | |||||
| .Nd Boot code for hybrid ISO/USB images on BIOS-based computers | |||||
| .Sh DESCRIPTION | |||||
| .Nm | |||||
| is used on BIOS-based computers to boot from an ISO image that has | |||||
| been written to a USB flash drive or other HDD-like device. | |||||
| .Nm | |||||
| is installed in a | |||||
| .Cm freebsd-boot | |||||
| partition with | |||||
| .Xr mkimg 1 . | |||||
| .Sh IMPLEMENTATION NOTES | |||||
| The El Torito standard for bootable CDs provides a 32KB "System Area" | |||||
| at the beginning of an image. | |||||
| To create an image that is able to be booted by the BIOS as either a | |||||
| CD-ROM ("ISO") and as a more HDD-like image (e.g. on a USB flash drive) | |||||
| it is necessary to have both a standard El Torito boot catalog | |||||
| containing a HDD-style partition table and boot code. | |||||
| .Nm | |||||
| is intended to be placed in a GPT partition to allow the system to find | |||||
| the standard | |||||
| .Fx | |||||
| .Xr loader 8 | |||||
| in the ISO filesystem later in the image. | |||||
| .Sh BOOTING | |||||
| .Nm | |||||
| looks for an ISO filesystem image on the device it was booted from and | |||||
| seeks to read either the primary | |||||
| .Fx | |||||
| .Xr loader 8 | |||||
| or kernel from there. | |||||
| .Sh SEE ALSO | |||||
| .Xr mkimg 1 | |||||
| .Sh HISTORY | |||||
| .Nm | |||||
| appeared in FreeBSD 12.0. | |||||
| .Sh AUTHORS | |||||
| This manual page written by | |||||
| .An Benno Rice Aq benno@FreeBSD.org . | |||||