[Bug 291550] pkg.7 - example has the wrong position of the debug option

From: <bugzilla-noreply_at_freebsd.org>
Date: Wed, 10 Dec 2025 10:55:00 UTC 
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=291550

            Bug ID: 291550
           Summary: pkg.7 - example has the wrong position of the debug
                    option
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: erichanskrs@gmail.com
                CC: doc@FreeBSD.org

ref:
https://cgit.freebsd.org/src/commit/usr.sbin/pkg/pkg.7?id=8900283fa37f6555055d8af5ffa1a5a2fbe2940e


In the pkg(7) EXAMPLES section:
- to function as the debug option, the -d option should be moved
- the example seems non practicle as there is no actual package named 'perl'


Suggested changes:
     Fetch a package for a different FreeBSD version, along with all its
     dependencies:
-           # pkg -o ABI=FreeBSD:15:amd64 -o IGNORE_OSVERSION=yes fetch -o
-          destdir -d perl
+           # pkg -d -o ABI=FreeBSD:15:amd64 -o IGNORE_OSVERSION=yes fetch -o
+          destdir lsof


ON 14.3-RELEASE
[0-0] # date -u; uname -apKU
Wed Dec 10 10:36:25 UTC 2025
FreeBSD tm1 14.3-RELEASE-p5 FreeBSD 14.3-RELEASE-p5 GENERIC amd64 amd64 1403000
1403000
[1-0] # /usr/sbin/pkg -o ABI=FreeBSD:15:amd64 -o IGNORE_OSVERSION=yes fetch -o
./ -d perl
pkg: Setting ABI requires setting OSVERSION, guessing the OSVERSION as: 1500000
pkg: Warning: Major OS version upgrade detected.  Running "pkg bootstrap -f"
recommended
Updating FreeBSD repository catalogue...
FreeBSD repository is up to date.
Updating FreeBSD-kmods repository catalogue...
FreeBSD-kmods repository is up to date.
All repositories are up to date.
pkg: No packages matching 'perl' have been found in the repositories
[2->1<] # /usr/sbin/pkg -o ABI=FreeBSD:15:amd64 -o IGNORE_OSVERSION=yes fetch
-o ./ -d lsof
pkg: Setting ABI requires setting OSVERSION, guessing the OSVERSION as: 1500000
pkg: Warning: Major OS version upgrade detected.  Running "pkg bootstrap -f"
recommended
Updating FreeBSD repository catalogue...
FreeBSD repository is up to date.
Updating FreeBSD-kmods repository catalogue...
FreeBSD-kmods repository is up to date.
All repositories are up to date.
The following packages will be fetched:

New packages to be FETCHED:
        lsof: 4.99.5,8 (117 KiB: 100.00% of the 117 KiB to download)

Number of packages to be fetched: 1

117 KiB to be downloaded.

Proceed with fetching packages? [y/N]: n
[3->1<] # /usr/sbin/pkg -d -o ABI=FreeBSD:15:amd64 -o IGNORE_OSVERSION=yes
fetch -o ./ lsof
pkg: Setting ABI requires setting OSVERSION, guessing the OSVERSION as: 1500000
pkg: Warning: Major OS version upgrade detected.  Running "pkg bootstrap -f"
recommended
Updating FreeBSD repository catalogue...
DBG(1)[70575]> PkgRepo: verifying update for FreeBSD
DBG(1)[70575]> Pkgrepo, begin update of '/var/db/pkg/repos/FreeBSD/db'
DBG(1)[70575]> (fetch) Request to fetch
pkg+https://pkg.freebsd.org/FreeBSD:15:amd64/latest/meta.conf
DBG(1)[70575]> (fetch) Fetch: fetcher used: pkg+https
DBG(1)[70575]> (fetch) Request to fetch
pkg+https://pkg.freebsd.org/FreeBSD:15:amd64/latest/data.pkg
DBG(1)[70575]> (fetch) Fetch: fetcher used: pkg+https
FreeBSD repository is up to date.
Updating FreeBSD-kmods repository catalogue...
DBG(1)[70575]> PkgRepo: verifying update for FreeBSD-kmods
DBG(1)[70575]> Pkgrepo, begin update of '/var/db/pkg/repos/FreeBSD-kmods/db'
DBG(1)[70575]> (fetch) Request to fetch
pkg+https://pkg.freebsd.org/FreeBSD:15:amd64/kmods_latest_0/meta.conf
DBG(1)[70575]> (fetch) Fetch: fetcher used: pkg+https
DBG(1)[70575]> (fetch) Request to fetch
pkg+https://pkg.freebsd.org/FreeBSD:15:amd64/kmods_latest_0/data.pkg
DBG(1)[70575]> (fetch) Fetch: fetcher used: pkg+https
FreeBSD-kmods repository is up to date.
All repositories are up to date.
DBG(1)[70575]> (solver) for package: lsof cannot find provide for requirement:
libutil.so.10
DBG(1)[70575]> (solver) problem has no requests
The following packages will be fetched:

New packages to be FETCHED:
        lsof: 4.99.5,8 (117 KiB: 100.00% of the 117 KiB to download)

Number of packages to be fetched: 1

117 KiB to be downloaded.

Proceed with fetching packages? [y/N]: y
DBG(1)[70575]> (fetch) Request to fetch
pkg+https://pkg.freebsd.org/FreeBSD:15:amd64/latest/All/Hashed/lsof-4.99.5,8~028c9fd230.pkg
DBG(1)[70575]> (fetch) Fetch: fetcher used: pkg+https
Fetching lsof-4.99.5,8~028c9fd230.pkg: 100%  117 KiB 119.9kB/s    00:01
[4-0] # ls -l ./All/Hashed/lsof*
-rw-r--r--  1 root eric 119871 Dec  4 02:14
./All/Hashed/lsof-4.99.5,8~028c9fd230.pkg
[5-0] #


On 15.0-RELEASE
[0-0] # date -u; uname -apKU
Wed Dec 10 10:40:44 UTC 2025
FreeBSD q210 15.0-RELEASE FreeBSD 15.0-RELEASE releng/15.0-n280995-7aedc8de6446
GENERIC amd64 amd64 1500068 1500068
[1-0] # /usr/sbin/pkg -o ABI=FreeBSD:15:amd64 -o IGNORE_OSVERSION=yes fetch -o
./ -d perl
pkg: Setting ABI requires setting OSVERSION, guessing the OSVERSION as: 1500000
Updating FreeBSD-ports repository catalogue...
FreeBSD-ports repository is up to date.
Updating FreeBSD-ports-kmods repository catalogue...
Fetching data.pkg: 100%   31 KiB  31.9kB/s    00:01
Processing entries: 100%
FreeBSD-ports-kmods repository update completed. 207 packages processed.
Updating FreeBSD-base repository catalogue...
FreeBSD-base repository is up to date.
All repositories are up to date.
pkg: No packages matching 'perl' have been found in the repositories
[2->1<] # /usr/sbin/pkg -o ABI=FreeBSD:15:amd64 -o IGNORE_OSVERSION=yes fetch
-o ./ -d lsof
pkg: Setting ABI requires setting OSVERSION, guessing the OSVERSION as: 1500000
Updating FreeBSD-ports repository catalogue...
FreeBSD-ports repository is up to date.
Updating FreeBSD-ports-kmods repository catalogue...
FreeBSD-ports-kmods repository is up to date.
Updating FreeBSD-base repository catalogue...
FreeBSD-base repository is up to date.
All repositories are up to date.
The following packages will be fetched:

New packages to be FETCHED:
        lsof: 4.99.5,8 (117 KiB: 100.00% of the 117 KiB to download)

Number of packages to be fetched: 1

117 KiB to be downloaded.

Proceed with fetching packages? [y/N]: n
[3->1<] # /usr/sbin/pkg -d -o ABI=FreeBSD:15:amd64 -o IGNORE_OSVERSION=yes
fetch -o ./ lsof
pkg: Setting ABI requires setting OSVERSION, guessing the OSVERSION as: 1500000
Updating FreeBSD-ports repository catalogue...
DBG(1)[25504]> PkgRepo: verifying update for FreeBSD-ports
DBG(1)[25504]> Pkgrepo, begin update of '/var/db/pkg/repos/FreeBSD-ports/db'
DBG(1)[25504]> (fetch) Request to fetch
pkg+https://pkg.FreeBSD.org/FreeBSD:15:amd64/quarterly/meta.conf
DBG(1)[25504]> (fetch) Fetch: fetcher used: pkg+https
DBG(1)[25504]> (fetch) Request to fetch
pkg+https://pkg.FreeBSD.org/FreeBSD:15:amd64/quarterly/data.pkg
DBG(1)[25504]> (fetch) Fetch: fetcher used: pkg+https
FreeBSD-ports repository is up to date.
Updating FreeBSD-ports-kmods repository catalogue...
DBG(1)[25504]> PkgRepo: verifying update for FreeBSD-ports-kmods
DBG(1)[25504]> Pkgrepo, begin update of
'/var/db/pkg/repos/FreeBSD-ports-kmods/db'
DBG(1)[25504]> (fetch) Request to fetch
pkg+https://pkg.FreeBSD.org/FreeBSD:15:amd64/kmods_quarterly_0/meta.conf
DBG(1)[25504]> (fetch) Fetch: fetcher used: pkg+https
DBG(1)[25504]> (fetch) Request to fetch
pkg+https://pkg.FreeBSD.org/FreeBSD:15:amd64/kmods_quarterly_0/data.pkg
DBG(1)[25504]> (fetch) Fetch: fetcher used: pkg+https
FreeBSD-ports-kmods repository is up to date.
Updating FreeBSD-base repository catalogue...
DBG(1)[25504]> PkgRepo: verifying update for FreeBSD-base
DBG(1)[25504]> Pkgrepo, begin update of '/var/db/pkg/repos/FreeBSD-base/db'
DBG(1)[25504]> (fetch) Request to fetch
pkg+https://pkgbase.FreeBSD.org/FreeBSD:15:amd64/base_release_0/meta.conf
DBG(1)[25504]> (fetch) Fetch: fetcher used: pkg+https
DBG(1)[25504]> (fetch) Request to fetch
pkg+https://pkgbase.FreeBSD.org/FreeBSD:15:amd64/base_release_0/data.pkg
DBG(1)[25504]> (fetch) Fetch: fetcher used: pkg+https
FreeBSD-base repository is up to date.
All repositories are up to date.
DBG(1)[25504]> (solver) for package: lsof cannot find provide for requirement:
libc.so.7
DBG(1)[25504]> (solver) for package: lsof cannot find provide for requirement:
libkvm.so.7
DBG(1)[25504]> (solver) for package: lsof cannot find provide for requirement:
libutil.so.10
DBG(1)[25504]> (solver) problem has no requests
The following packages will be fetched:

New packages to be FETCHED:
        lsof: 4.99.5,8 (117 KiB: 100.00% of the 117 KiB to download)

Number of packages to be fetched: 1

117 KiB to be downloaded.

Proceed with fetching packages? [y/N]: y
DBG(1)[25504]> (fetch) Request to fetch
pkg+https://pkg.FreeBSD.org/FreeBSD:15:amd64/quarterly/All/Hashed/lsof-4.99.5,8~0fd62fb353.pkg
DBG(1)[25504]> (fetch) Fetch: fetcher used: pkg+https
Fetching lsof-4.99.5,8~0fd62fb353.pkg: 100%  117 KiB 119.8kB/s    00:01
[4-0] # ls -l All/Hashed/lsof*
-rw-r--r--  1 root wheel 119745 Dec  4 02:21
All/Hashed/lsof-4.99.5,8~0fd62fb353.pkg
[5-0] #

-- 
You are receiving this mail because:
You are on the CC list for the bug.