From nobody Fri Mar 21 20:22:08 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ZKDPr5kjPz5qdYm; Fri, 21 Mar 2025 20:22:08 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ZKDPr4gM0z3gMd; Fri, 21 Mar 2025 20:22:08 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1742588528; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=cSCJXgZ9177Zcfyucbibr3NuhhNFMc94CppRLldnDMo=; b=wK+cR5zmAFDneJeMHAcZLbwncvJBdz6hsbEciFXcmek6N5NwM6CXV2sifh7fvBwKTAb924 O3veVTID/J/yPKsHOINsRA96hw079z4tyVL8IqZxfF9szXDJBq403KB9L/Xj3yWTe+3vq2 5Uub4l6+8Nebn4cQq1849AhaGEtU2MzbUpauVOlUmIB5LsXwCQmeangvNaLkOZ5skzmgAw kgC6s/0SqoJQE4M3WIZuQ+LO/60dYdwmwZPA3yTrHEb5woEt/32qSkFj5cprpnNpYog9mI Sftg91vk5CJ8OXndUrhaR7YVhz/W4P+LbCkPiiWWxdIKcUMk1rptknrxff1IpA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1742588528; a=rsa-sha256; cv=none; b=ZJhsOexv9KtIVR77r5GnL2VA+zFC7bkZyP0zqVkjyXOeolDKmadyTPSBpZYbBi8osk2bt1 L7iGY1iwB/YtjSHaTWXNuZkeLXb909985XzQpgM1p82Nty9vfLrxMhYTyBLOR2e9yrDuEl I5pkQsC9ZMG07yTOsG03NlDrlfEzXDgOw6vml59rkl01nrSRblEgiBxTOdGfM4yAf8BcQV zNuY9Q998Jh+eHvFtHY6ODKlYq04J4GkbStnPEkMg8dVNLuax1DJtB3UwdU3RNA7zIiRJX R1uL0Q7h0/eKFq45eaM24aYgBoS1Lzu7PkB0w5KKDLUuQCTUBHI72QC0eIcogg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1742588528; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=cSCJXgZ9177Zcfyucbibr3NuhhNFMc94CppRLldnDMo=; b=xP2w186djgYt9jHiVuZxY/avtdCC6tiyHAJyVbwTGW/zX2ZEaD3dbxnWVUeyubdBa/R+jg TuLxkTzu8W3AJN3qhNe+gBYfRKifOsOBaGQzAqaYismhdLlMOYukpRi1MkWWFGIWlrjd2m tNlDVHzChx7X4JSC1jgWcy5Im4MukKHP6Je8dOohyqRXGgvR/KVzgbrL5PfTMSc7Sr9W7D zYi/bM0WNOkel85pR5dCNYD5xV1lsoie3NTbZ/XAjk3X2Ly3/tOra0tpqj2lnBAlriHzrh QSh2l67QnfLTwSw3dOIv386cZmjKwDKzSfeskzzyl9b4+Il04P4dPWTr65Gphw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4ZKDPr41WRzrJ6; Fri, 21 Mar 2025 20:22:08 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 52LKM8wB011555; Fri, 21 Mar 2025 20:22:08 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 52LKM8PP011552; Fri, 21 Mar 2025 20:22:08 GMT (envelope-from git) Date: Fri, 21 Mar 2025 20:22:08 GMT Message-Id: <202503212022.52LKM8PP011552@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Alexander Ziaee Subject: git: 283be95ea29a - main - etdump.1: Polish + xref cd9660(4) List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 283be95ea29abd7f867e4084bafe368c47f6c038 Auto-Submitted: auto-generated The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=283be95ea29abd7f867e4084bafe368c47f6c038 commit 283be95ea29abd7f867e4084bafe368c47f6c038 Author: Alexander Ziaee AuthorDate: 2025-01-19 02:04:36 +0000 Commit: Alexander Ziaee CommitDate: 2025-03-21 20:20:21 +0000 etdump.1: Polish + xref cd9660(4) + 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(4) 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 --- share/man/man4/cd9660.4 | 5 ++++- usr.bin/etdump/etdump.1 | 52 ++++++++++++++++++++++++++++--------------------- 2 files changed, 34 insertions(+), 23 deletions(-) diff --git a/share/man/man4/cd9660.4 b/share/man/man4/cd9660.4 index 0e4fd33637cb..a684df37bab9 100644 --- a/share/man/man4/cd9660.4 +++ b/share/man/man4/cd9660.4 @@ -1,4 +1,6 @@ .\" +.\" SPDX-License-Identifier: BSD-3-Clause +.\" .\" Copyright (c) 2017 Enji Cooper .\" .\" Redistribution and use in source and binary forms, with or without @@ -23,7 +25,7 @@ .\" (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 April 25, 2023 +.Dd January 18, 2025 .Dt CD9660 4 .Os .Sh NAME @@ -57,6 +59,7 @@ volume located on .Pp .Dl "mount -t cd9660 /dev/cd0 /mnt" .Sh SEE ALSO +.Xr etdump 1 , .Xr nmount 2 , .Xr unmount 2 , .Xr cd 4 , diff --git a/usr.bin/etdump/etdump.1 b/usr.bin/etdump/etdump.1 index bec8d201eb4f..a86a5e24742c 100644 --- a/usr.bin/etdump/etdump.1 +++ b/usr.bin/etdump/etdump.1 @@ -1,3 +1,6 @@ +.\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\" Copyright (c) 2018 iXsystems, Inc .\" All rights reserved. .\" @@ -22,51 +25,54 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd April 25, 2018 -.Dt ETDUMP 8 +.Dd January 18, 2025 +.Dt ETDUMP 1 .Os .Sh NAME .Nm etdump -.Nd Dump El Torito boot catalog information from ISO images +.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 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. +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 +.It Fl f Ar format | Fl -format Ar format Select the output format. Supported output formats are: -.Bl -tag -width shell -offset indent -.It Sy text +.Bl -tag -width indent +.It Cm text Human-readable text (default) -.It Sy shell -Each boot entry is emitted as a string suitable for passing to a sh-compatible -eval command. +.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 -offset indent -.It et_platform +.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 et_system +.It Dv et_system The system ID from the boot entry. -.It et_lba +.It Dv et_lba The starting LBA (2048-byte blocks) of the boot image. -.It et_sectors +.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 +.It Fl o Ar file | Fl -output Ar file Write output to .Ar file . -If '-' is specified then standard out is used. +If +.Ql - +is specified then standard out is used. .El .Sh EXAMPLES To see what entries are in a given boot catalog run @@ -87,14 +93,16 @@ Section header: efi, final 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: +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