mirror of
https://github.com/opnsense/src.git
synced 2026-05-26 19:23:04 -04:00
4c02b6589e
+ correct misfile in section 8 + rewrite the document descirption to include -9660 + markup command modifiers as such instead of bold + markup variables as defined variables, enabling apropos + correct option syntax in description section + unwrap list offsets for legibility + fix line wrapping for standard BSD console + crossreference cd9660(5) and vis versa + tag SPDX for both manuals MFC after: 3 days Reviewed by: mhorne Approved by: mhorne (mentor) Differential Revision: https://reviews.freebsd.org/D48513 (cherry picked from commit 283be95ea29abd7f867e4084bafe368c47f6c038)
110 lines
3.4 KiB
Groff
110 lines
3.4 KiB
Groff
.\"
|
|
.\" SPDX-License-Identifier: BSD-2-Clause
|
|
.\"
|
|
.\" 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 AUTHOR 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 AUTHOR 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.
|
|
.\"
|
|
.Dd January 18, 2025
|
|
.Dt ETDUMP 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm etdump
|
|
.Nd dump ISO-9660 El Torito boot catalog information
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl f Ar format
|
|
.Op Fl o Ar file
|
|
.Ar
|
|
.Sh DESCRIPTION
|
|
This program reads El Torito boot catalog information
|
|
from an ISO-9660 image and outputs it in various formats.
|
|
It can be used to check the catalog in an image or
|
|
to output catalog data in a format that can be used by other tools
|
|
such as shell scripts.
|
|
.Pp
|
|
Supported options are:
|
|
.Bl -tag -width flag
|
|
.It Fl f Ar format | Fl -format Ar format
|
|
Select the output format.
|
|
Supported output formats are:
|
|
.Bl -tag -width indent
|
|
.It Cm text
|
|
Human-readable text (default)
|
|
.It Cm shell
|
|
Each boot entry is emitted as a string
|
|
suitable for passing to a sh-compatible eval command.
|
|
The variables emitted are:
|
|
.Bl -tag -width "et_platform"
|
|
.It Dv et_platform
|
|
The platform ID from the section header.
|
|
Set to 'default' for the initial (default) entry.
|
|
.It Dv et_system
|
|
The system ID from the boot entry.
|
|
.It Dv et_lba
|
|
The starting LBA (2048-byte blocks) of the boot image.
|
|
.It Dv et_sectors
|
|
The number of sectors (512-byte sectors) that comprise the boot image.
|
|
.El
|
|
.El
|
|
.It Fl o Ar file | Fl -output Ar file
|
|
Write output to
|
|
.Ar file .
|
|
If
|
|
.Ql -
|
|
is specified then standard out is used.
|
|
.El
|
|
.Sh EXAMPLES
|
|
To see what entries are in a given boot catalog run
|
|
.Nm
|
|
passing the filename of the image as an argument like so:
|
|
.Bd -literal -offset indent
|
|
% etdump bootonly.iso
|
|
Image in bootonly.iso
|
|
Default entry
|
|
System i386
|
|
Start LBA 420 (0x1a4), sector count 4 (0x4)
|
|
Media type: no emulation
|
|
|
|
Section header: efi, final
|
|
Section entry
|
|
System i386
|
|
Start LBA 20 (0x14), sector count 1600 (0x640)
|
|
Media type: no emulation
|
|
.Ed
|
|
.Pp
|
|
To use the output in a shell script a for loop can be used
|
|
to iterate over the entries returned using eval:
|
|
.Bd -literal -offset indent
|
|
for entry in `etdump --format shell bootonly.iso`; do
|
|
eval $entry
|
|
echo $et_platform $et_system $et_lba $et_sectors
|
|
done
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr cd9660 4
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
utility first appeared in
|
|
.Fx 11.2
|