Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

pkg-repositories(8) in ports-mgmt/pkg 2.⋯: 2025 documentation #2411

Open
grahamperrin opened this issue Jan 29, 2025 · 2 comments
Open

pkg-repositories(8) in ports-mgmt/pkg 2.⋯: 2025 documentation #2411

grahamperrin opened this issue Jan 29, 2025 · 2 comments

Comments

@grahamperrin
Copy link
Contributor

grahamperrin commented Jan 29, 2025

NEWS on 2024-11-20:

pkg/NEWS

Lines 11 to 12 in 32d62ae

- repositories: new pkg repositories command to list configured
repositories

To the best of my knowledge:

pkg repositories repositoryname

  • prints the configuration of the specified repositoryname.

pkg repositories

  • prints the configurations of all repositories that are known to the system.

pkg repos

  • is the short form of pkg repositories.

-d

  • disabled repositories.

-e

  • enabled repositories.

-l

  • list repository names, without configurations.
@grahamperrin
Copy link
Contributor Author

Background

docs/pkg-repos.8 existed in 2017, I have not attempted to discover what happened to it:

grahamperrin:~ % man -K pkg\ repositories | grep man8
grahamperrin:~ % ls -hln /usr/local/share/man/man8/pkg-*
-rw-r--r--  1 0 0  1.6K 28 Jan 21:52 /usr/local/share/man/man8/pkg-add.8.gz
-rw-r--r--  1 0 0  915B 28 Jan 21:52 /usr/local/share/man/man8/pkg-alias.8.gz
-rw-r--r--  1 0 0  1.9K 28 Jan 21:52 /usr/local/share/man/man8/pkg-annotate.8.gz
-rw-r--r--  1 0 0  1.5K 28 Jan 21:52 /usr/local/share/man/man8/pkg-audit.8.gz
-rw-r--r--  1 0 0  1.0K 28 Jan 21:52 /usr/local/share/man/man8/pkg-autoremove.8.gz
-rw-r--r--  1 0 0  1.5K 28 Jan 21:52 /usr/local/share/man/man8/pkg-check.8.gz
-rw-r--r--  1 0 0  1.2K 28 Jan 21:52 /usr/local/share/man/man8/pkg-clean.8.gz
-rw-r--r--  1 0 0  781B 28 Jan 21:52 /usr/local/share/man/man8/pkg-config.8.gz
-rw-r--r--  1 0 0  4.5K 28 Jan 21:52 /usr/local/share/man/man8/pkg-create.8.gz
-rw-r--r--  1 0 0  1.8K 28 Jan 21:52 /usr/local/share/man/man8/pkg-delete.8.gz
-rw-r--r--  1 0 0  1.7K 28 Jan 21:52 /usr/local/share/man/man8/pkg-fetch.8.gz
-rw-r--r--  1 0 0  1.9K 28 Jan 21:52 /usr/local/share/man/man8/pkg-info.8.gz
-rw-r--r--  1 0 0  2.6K 28 Jan 21:52 /usr/local/share/man/man8/pkg-install.8.gz
-rw-r--r--  1 0 0  1.7K 28 Jan 21:52 /usr/local/share/man/man8/pkg-key.8.gz
-rw-r--r--  1 0 0  1.7K 28 Jan 21:52 /usr/local/share/man/man8/pkg-lock.8.gz
-r--r--r--  1 0 0  1.4K  7 Oct 17:37 /usr/local/share/man/man8/pkg-provides.8.gz
-rw-r--r--  1 0 0  3.0K 28 Jan 21:52 /usr/local/share/man/man8/pkg-query.8.gz
-rw-r--r--  1 0 0  2.2K 28 Jan 21:52 /usr/local/share/man/man8/pkg-register.8.gz
lrwxr-xr-x  1 0 0   15B 28 Jan 21:52 /usr/local/share/man/man8/pkg-remove.8.gz -> pkg-delete.8.gz
-rw-r--r--  1 0 0  3.5K 28 Jan 21:52 /usr/local/share/man/man8/pkg-repo.8.gz
-rw-r--r--  1 0 0  2.7K 28 Jan 21:52 /usr/local/share/man/man8/pkg-rquery.8.gz
-rw-r--r--  1 0 0  4.3K 28 Jan 21:52 /usr/local/share/man/man8/pkg-search.8.gz
-rw-r--r--  1 0 0  1.7K 28 Jan 21:52 /usr/local/share/man/man8/pkg-set.8.gz
-rw-r--r--  1 0 0  948B 28 Jan 21:52 /usr/local/share/man/man8/pkg-shell.8.gz
-rw-r--r--  1 0 0  1.0K 28 Jan 21:52 /usr/local/share/man/man8/pkg-shlib.8.gz
-rw-r--r--  1 0 0  905B 28 Jan 21:52 /usr/local/share/man/man8/pkg-ssh.8.gz
lrwxr-xr-x  1 0 0    8B 28 Jan 21:52 /usr/local/share/man/man8/pkg-static.8.gz -> pkg.8.gz
-rw-r--r--  1 0 0  918B 28 Jan 21:52 /usr/local/share/man/man8/pkg-stats.8.gz
-rw-r--r--  1 0 0  772B 28 Jan 21:52 /usr/local/share/man/man8/pkg-triggers.8.gz
lrwxr-xr-x  1 0 0   13B 28 Jan 21:52 /usr/local/share/man/man8/pkg-unlock.8.gz -> pkg-lock.8.gz
-rw-r--r--  1 0 0  1.4K 28 Jan 21:52 /usr/local/share/man/man8/pkg-update.8.gz
-rw-r--r--  1 0 0  1.1K 28 Jan 21:52 /usr/local/share/man/man8/pkg-updating.8.gz
-rw-r--r--  1 0 0  2.7K 28 Jan 21:52 /usr/local/share/man/man8/pkg-upgrade.8.gz
-rw-r--r--  1 0 0  3.0K 28 Jan 21:52 /usr/local/share/man/man8/pkg-version.8.gz
-rw-r--r--  1 0 0  994B 28 Jan 21:52 /usr/local/share/man/man8/pkg-which.8.gz
grahamperrin:~ % pkg iinfo ^pkg$
pkg-2.0.5
grahamperrin:~ % uname -aKU
FreeBSD mowa219-gjp4-zbook-freebsd 15.0-CURRENT FreeBSD 15.0-CURRENT main-n275061-c64b3f32a570 GENERIC-NODEBUG amd64 1500030 1500030
grahamperrin:~ % pkg query '%o %v %At:%Av' ports-mgmt/pkg
ports-mgmt/pkg 2.0.5 FreeBSD_version:1500018
ports-mgmt/pkg 2.0.5 build_timestamp:2025-01-28T21:50:03+00:00
ports-mgmt/pkg 2.0.5 built_by:poudriere-git-3.4.99.20250115
ports-mgmt/pkg 2.0.5 port_checkout_unclean:no
ports-mgmt/pkg 2.0.5 port_git_hash:8516fca970c
ports-mgmt/pkg 2.0.5 ports_top_checkout_unclean:yes
ports-mgmt/pkg 2.0.5 ports_top_git_hash:4bad05fdbbe
ports-mgmt/pkg 2.0.5 repo_type:binary
ports-mgmt/pkg 2.0.5 repository:local-poudriere
grahamperrin:~ % 

@grahamperrin
Copy link
Contributor Author

grahamperrin commented Jan 29, 2025

Examples

Specifying a single repo name:

$ pkg repos FreeBSD-ports
FreeBSD-ports: { 
    url             : "pkg+https://pkg.freebsd.org/FreeBSD:15:amd64/latest",
    enabled         : yes,
    priority        : 4,
    mirror_type     : "SRV",
    signature_type  : "FINGERPRINTS",
    fingerprints    : "/usr/share/keys/pkg"
  }
$ 

All known repos:

$ pkg repositories
FreeBSD-ports: { 
    url             : "pkg+https://pkg.freebsd.org/FreeBSD:15:amd64/latest",
    enabled         : yes,
    priority        : 4,
    mirror_type     : "SRV",
    signature_type  : "FINGERPRINTS",
    fingerprints    : "/usr/share/keys/pkg"
  }
FreeBSD-base: { 
    url             : "pkg+https://pkg.freebsd.org/FreeBSD:15:amd64/base_latest",
    enabled         : yes,
    priority        : 0,
    mirror_type     : "SRV",
    signature_type  : "FINGERPRINTS",
    fingerprints    : "/usr/share/keys/pkg"
  }
FreeBSD-ports-i386: { 
    url             : "pkg+https://pkg.freebsd.org/FreeBSD:15:i386/latest",
    enabled         : no,
    priority        : 0,
    mirror_type     : "SRV",
    signature_type  : "FINGERPRINTS",
    fingerprints    : "/usr/share/keys/pkg"
  }
aninstaller: { 
    url             : "file:////media/aninstaller/packages/FreeBSD:14:amd64",
    enabled         : no,
    priority        : 0
  }
local-poudriere: { 
    url             : "file:///usr/local/poudriere/data/packages/main-default",
    enabled         : yes,
    priority        : 3
  }
$ 

Names of disabled repos:

$ pkg repos -dl
FreeBSD-ports-i386
aninstaller
$ 

Names of enabled repos, sorted:

$ pkg repos -el | sort
FreeBSD-base
FreeBSD-ports
local-poudriere
$ 

I wondered whether pkg repos -r FreeBSD-base -r FreeBSD-ports would print information for two of the five, it does not – option -r is illegal:

$ pkg repos -r FreeBSD-base -r FreeBSD-ports
pkg: illegal option -- r
Usage: pkg repositories [-edl] [repository]

$ 

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant