From nobody Fri Jun 13 19:27:56 2025 X-Original-To: dev-commits-src-all@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 4bJqDX3VkBz510f5; Fri, 13 Jun 2025 19:27:56 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4bJqDX2JSzz44Zg; Fri, 13 Jun 2025 19:27:56 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1749842876; 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=y3kPvJ8E5t/LORnEO8+AydxWzcc1t1SMvB0u7Cwh/gc=; b=TEbXKt5Ics9Otl5/UXRMObgVtf2NlsO1V6yhei3J4mFbMFBavzFy1xNXWTXNqueZfUWu5R FbYw605ogDA4mA3ev7VF64HdaT8IjuHhAmMg2iqgpbv/qaaA+kkJgw4nnBwbRXB4bmUTBp Taw6zWUHBr7zrSBxcAuZESHgODd/HQQKdTVA3fHfIeypnroy+Jyh7jH5e8/xD3Occ3JJJV ZMee2bBW6sEzIiivYQZ5huT19UMyXy4wcZMpZ78miN/yDWeCEPzbLSkdZKESLdyMQS731E z63wmZkdEAsDZJ/27HtZ4nvEDqgMA6Ph5+w78BiagpOI2FjCDiK2cuzvU0Kzzg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1749842876; 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=y3kPvJ8E5t/LORnEO8+AydxWzcc1t1SMvB0u7Cwh/gc=; b=euYsnm7jKs7vySs0tGDR2w0oUb35xe4OvJn8OpktMqFIEiQze69v4xhhSWgNCx1DknJ5oW YPLv1/UkkqAe/nvlZqPXzUjIQVKlX+6iD3LggabzwvVBKPck0bkmn28xRcUGJxWlpZxu6X jzUaeI4WGzGyLlzH9++yEzpCU+PM87lfWyqS+Q7GqVb0ZwOW1kestTDMty7QpkNHnLXtX6 rbouZaYrRSmx3vSCuFy0LGrkDYaswy/fRcLdPivzJ26rcRS5J3Fao7vTAq2DDJsES3ZY8L G+P/wnHAW/Nn7nzKFfRc+w3djwYE1WpQKOkWLAmhNovBkizFE8V2V86527rKUQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1749842876; a=rsa-sha256; cv=none; b=LUPQeYhgvD0AnjG2k29BQM3ZDyT7wRPj3L8ytzKtWQFu0W9FNPA2xW7gHSegpd+LozvFPo brMaafcM96ezoBInKIgCjdzjPBXDkIdzRoK78gT+z+xvh9bSkBGvE/kF+T+gZZ04sIUyje yX5d6XBc+yG4n2NzDYi13V12Y5d4+kAw4MDXcdxB68U4sziJKNQa0AhjWwZaJMlWg5dOI+ 3iK8dMOJ0NN+B3fVU1gDk+e0V2UkJWL7q9a7xBNgq5R0fFjqxs4tkvCjC45VDxar3tCVXB 9EM7MWjB6IQ/3CZRbIZY+U5+RkDHOhJgpSmrE8ZLZ5VNpbxwCODvbXGR80J61Q== 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 4bJqDX1bqlz19JM; Fri, 13 Jun 2025 19:27:56 +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 55DJRuVP018241; Fri, 13 Jun 2025 19:27:56 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 55DJRux0018238; Fri, 13 Jun 2025 19:27:56 GMT (envelope-from git) Date: Fri, 13 Jun 2025 19:27:56 GMT Message-Id: <202506131927.55DJRux0018238@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: 3fd42db26c3d - main - ctfconvert.1: Minor cleanup List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@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: 3fd42db26c3dd0882cf69c54850a59e79b027e33 Auto-Submitted: auto-generated The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=3fd42db26c3dd0882cf69c54850a59e79b027e33 commit 3fd42db26c3dd0882cf69c54850a59e79b027e33 Author: Alexander Ziaee AuthorDate: 2025-04-18 00:41:29 +0000 Commit: Alexander Ziaee CommitDate: 2025-06-13 19:24:12 +0000 ctfconvert.1: Minor cleanup Alphabetize option table to improve first glance access. Markup semantics to differentiate them and add them to apropos. MFC after: 3 days Reviewed by: Pau Amma Approved by: mhorne (mentor, implicit) Differential Revision: https://reviews.freebsd.org/D49883 --- cddl/usr.bin/ctfconvert/ctfconvert.1 | 40 +++++++++++++++++++++--------------- 1 file changed, 23 insertions(+), 17 deletions(-) diff --git a/cddl/usr.bin/ctfconvert/ctfconvert.1 b/cddl/usr.bin/ctfconvert/ctfconvert.1 index 7697513d0740..8baf9895b0e1 100644 --- a/cddl/usr.bin/ctfconvert/ctfconvert.1 +++ b/cddl/usr.bin/ctfconvert/ctfconvert.1 @@ -1,4 +1,6 @@ .\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\" Copyright (c) 2010 The FreeBSD Foundation .\" All rights reserved. .\" @@ -31,44 +33,48 @@ .Os .Sh NAME .Nm ctfconvert -.Nd convert debug data to CTF data +.Nd convert debug data to Compact C Type Format data .Sh SYNOPSIS .Nm .Op Fl gis -.Fl l Ar label .Fl L Ar labelenv +.Fl l Ar label .Op Fl o Ar outfile object_file .Sh DESCRIPTION The .Nm -utility converts debug information from a binary file to CTF (Compact C Type -Format) data and replaces the debug section of that file with a CTF section +utility converts debug information from a binary file to CTF +.Pq Compact C Type Format +data and replaces the debug section of that file with a CTF section called SUNW_ctf. -This new section is added to the input file, unless the -o +This new section is added to the input file, unless the +.Fl o option is present. You can also opt to keep the original debugging section with the --g option. +.Fl g +option. .Pp The following options are available: -.Bl -tag -width indent -.It Fl l Ar label -Sets the label as -.Ar label . -.It Fl L Ar labelenv -Instructs -.Nm -to read the label from the environment variable -.Ar labelenv . +.Bl -tag -width "-L labelenv" .It Fl g Don't delete the original debugging section. .It Fl i Ignore object files built from other languages than C. -.It Fl s -Use the .dynsym ELF section instead of the .symtab ELF section. +.It Fl L Ar labelenv +Instructs +.Nm +to read the label from the +.Ev labelenv +environment variable. +.It Fl l Ar label +Sets the label as +.Ar label . .It Fl o Ar outfile Write the output to file in .Ar outfile . +.It Fl s +Use the .dynsym ELF section instead of the .symtab ELF section. .El .Sh EXIT STATUS .Ex -std