From nobody Fri Jul 04 18:23:10 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 4bYhp73LgPz61jmW; Fri, 04 Jul 2025 18:23:11 +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 4bYhp65mHhz3nNd; Fri, 04 Jul 2025 18:23:10 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1751653390; 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=i21TUAMJCmOWl0yw/lWObONvaw2RnpDlim0ZS4PH8kA=; b=gumjk8ivvDBUw58WFxOAAX7jkdgayNHUaJb1vd3URIXoytLS10PH5Zi0eEqa47kap6JM9E 2yE+CI5cY+4eqGBg5ams2tEVjwiLQdf1nm7Id41W4TNoG2dcZbimNAkU/mKSiFmmREDgQR jbzN63yejLmdcnKwgzpe01YedG6/Cu/Mcri9YFCgGpCzJ8E6esDOgTub1kqfMPm2rR93zE 81wKvYWUEu6GHtGl+SRDQceKo0pGA5NPj8qi4AugwFj2YDejdTIa4UeGuoE64Sxl13DYlZ LfIkazmSRdnt7U+vLwzHihnx7ctzBm2LQI2mvJOqbsQCzSf4om3MFRHP2kdUgA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1751653390; 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=i21TUAMJCmOWl0yw/lWObONvaw2RnpDlim0ZS4PH8kA=; b=wBSLmiLOF54tbCjIrBZrA68f7l7sLHTK5LLlFEXOenxBJ4KUu+FTztue/zTWbo3C/hAKxz Z2cXEbXXys632ihhyYfa/t1OkUkpWoWMSRtomhhqek11b2Ek0hpYlokMgJwEAUA7OFVXrN 9gX/v3ZwFjRljYULW4CU23wzLPfQU+alrA/W/S33lApkPpEIG4HvfDuxSQ04Ex7p6NdDFE KH82+pl+ohRGYl0Y0mUC4fE+tuUdD6U5LQjUn62SAErztp9Aqh1FEzdxZNc8yo4+1u1xVc hqclt6OvRsNC94v+yEYBa9CywtKNJjzfp25urxLavSrB3qiXRUp6rHV8gDRaOg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1751653390; a=rsa-sha256; cv=none; b=tet1ZFczwjgIspbnXxyHRv09tXWIqaz6ObaH5jen/TGsGLbhVEN5xcb4mRwAzXf5SnEIy4 rMpozuyxZdNStUzpWO8rzzdrV8Rm/Wr2w8cT0k3my/jXVJp7K+fN928d2T9CmTz9DVyC4P rCHpPhOI5jXr9PNPpOkU1+St7Y0/GIdERDPntKbvc42c4XJjfmsBn2tmXxIi0Ljaw4AF7k gXPCi8QeqK2QQCn0JQHl0tZv49EbG1uaeb5rI0p3v9Fi5xSZCmOUuowznpsM2yVnS2sXGv tpwrQKaXYRYiTmf4M9Rh56TvX6k2YMY2XmStb3rNMqRFWpqH/JWfkFwrVIaMIw== 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 4bYhp65448z11cJ; Fri, 04 Jul 2025 18:23:10 +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 564INAPv069822; Fri, 4 Jul 2025 18:23:10 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 564INAMY069818; Fri, 4 Jul 2025 18:23:10 GMT (envelope-from git) Date: Fri, 4 Jul 2025 18:23:10 GMT Message-Id: <202507041823.564INAMY069818@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 992be3acfe68 - stable/14 - 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/stable/14 X-Git-Reftype: branch X-Git-Commit: 992be3acfe68d315e081ba27f7087e8261dc4ecf Auto-Submitted: auto-generated The branch stable/14 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=992be3acfe68d315e081ba27f7087e8261dc4ecf commit 992be3acfe68d315e081ba27f7087e8261dc4ecf Author: Alexander Ziaee AuthorDate: 2025-04-18 00:41:29 +0000 Commit: Alexander Ziaee CommitDate: 2025-07-04 18:20:33 +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 (cherry picked from commit 3fd42db26c3dd0882cf69c54850a59e79b027e33) --- 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