PKG-REPOSITORIES(8)

NAME
pkg repositories - display and manage package repositories

SYNOPSIS
pkg repositories [-d] [-e] [-l] [repository]
pkg repositories repository enable | disable | reset

DESCRIPTION
pkg repositories displays configured software repositories for the package manager, pkg(8).

If given the name of an existing repository as an argument, only print its configuration. Without arguments all repositories are printed.

When a repository name is followed by an action (enable, disable, or reset), pkg repositories manages a persistent override for the repository's enabled state. The override is stored as a file under $PKG_DBDIR/repos_state/enable/ or $PKG_DBDIR/repos_state/disable/ and takes precedence over the configuration files regardless of the override chain.

The reset action removes the override, reverting to the value from the configuration files.

When a repository's state is overridden, the pkg repositories and pkg -vv commands display “(overridden by pkg)” next to the enabled status.

OPTIONS
The following options are supported by pkg repositories:

-d, --disabled
    Print disabled repositories only.

-e, --enabled
    Print enabled repositories only.

-l, --list
    Print the list of repository names.

ACTIONS

enable
    Force the repository to be enabled, overriding the configuration files.

disable
    Force the repository to be disabled, overriding the configuration files.

reset
    Remove a previous override, reverting to the configuration file value.

FILES

/etc/pkg/FreeBSD.conf
    default system repository

/usr/local/etc/pkg/pkg.conf
    pkg(8) configuration, including system repository

/usr/local/etc/pkg/pkg.conf.sample
    example pkg(8) monolithic configuration, including default repository

/usr/local/etc/pkg/repos/
    location for site specific repositories

/var/db/pkg/repos_state/enable/
    directory containing override files for enabled repositories

/var/db/pkg/repos_state/disable/
    directory containing override files for disabled repositories

EXAMPLES
Display all repositories:

    pkg repositories -l

Display all repositories configurations:

    pkg repositories

Disable a repository:

    pkg repositories FreeBSD-ports disable

Re-enable it:

    pkg repositories FreeBSD-ports enable

Remove the override (revert to configuration):

    pkg repositories FreeBSD-ports reset

SEE ALSO
pkg_checksum(3), pkg_create(3), pkg_printf(3), pkg_repo_create(3), pkg_repos(3), pkg-keywords(5), pkg-lua-script(5), pkg-repository(5), pkg-script(5), pkg-triggers(5), pkg.conf(5), pkg(8), pkg-add(8), pkg-alias(8), pkg-annotate(8), pkg-audit(8), pkg-autoremove(8), pkg-check(8), pkg-checksum(8), pkg-clean(8), pkg-config(8), pkg-create(8), pkg-delete(8), pkg-fetch(8), pkg-help(8), pkg-info(8), pkg-install(8), pkg-key(8), pkg-lock(8), pkg-plugins(8), pkg-query(8), pkg-register(8), pkg-repo(8), pkg-rquery(8), pkg-rwhich(8), pkg-search(8), pkg-set(8), pkg-shell(8), pkg-shlib(8), pkg-ssh(8), pkg-stats(8), pkg-triggers(8), pkg-unregister(8), pkg-update(8), pkg-updating(8), pkg-upgrade(8), pkg-version(8), pkg-which(8)