PKG_REPOS(3)           FreeBSD Library Functions Manual           PKG_REPOS(3)

NAME
     pkg_repos, pkg_repos_total_count, pkg_repos_activated_count,
     pkg_repo_url, pkg_repo_ident, pkg_repo_name, pkg_repo_ident_from_name,
     pkg_repo_key, pkg_repo_fingerprints, pkg_repo_signature_type,
     pkg_repo_mirror_type, pkg_repo_enabled, pkg_repo_priority,
     pkg_repo_find_ident, pkg_repo_find_name - manipulate repositories

LIBRARY
     library "libpkg"

SYNOPSIS
     #include <pkg.h>

     int
     pkg_repos(struct pkg_repo **r);

     int
     pkg_repos_total_count(void);

     int
     pkg_repos_activated_count(void);

     const char *
     pkg_repos_url(struct pkg_repo *);

     const char *
     pkg_repo_ident(struct pkg_repo *);

     const char *
     pkg_repo_name(struct pkg_repo *);

     const char *
     pkg_repo_ident_from_name(const char *);

     const char *
     pkg_repo_key(struct pkg_repo *);

     const char *
     pkg_repo_fingerprints(struct pkg_repo *);

     signature_t
     pkg_repo_signature_type(struct pkg_repo *);

     bool
     pkg_repo_enabled(struct pkg_repo *);

     unsigned int
     pkg_repo_priority(struct pkg_repo *);

     mirror_t
     pkg_repo_mirror_type(struct pkg_repo *);

     struct pkg_repo *
     pkg_repo_find_ident(const char *ident);
     ;
     struct pkg_repo *
     pkg_repo_find_name(const char *name);
     ;

DESCRIPTION
     pkg_repos() Takes the address of a pointer to the repository.  The
     pointer should be initialised to NULL before being passed to the
     function, on each iteration the r will point to the new repository.
     Returns EPKG_FATAL if an error occurred, otherwise return EPKG_OK until
     the last repository is found in that case EPKG_END is returned.

     pkg_repos_total_count() returns the total number of defined repositories.

     pkg_repos_activated_count() returns the total number of "enabled"
     repositories.

     pkg_repo_url() takes a pointer to a repository as argument and returns
     the "url" defined for this repository.

     pkg_repo_ident() takes a pointer to a repository as argument and returns
     the internal identification string of the repository.

     pkg_repo_name() takes a pointer to a repository as argument and returns
     the "name" of the repository.

     pkg_repo_key() takes a pointer to a repository as argument and returns
     the path to the public key.  If the repository is not signed by a public
     key, NULL will be returned.

     pkg_repo_fingerprints() takes a pointer to a repository as argument and
     returns the path to the fingerprints.  If the repository is not signed
     using the "FINGERPRINT" method, NULL will be returned.

     pkg_repo_signature_type() Take a pointer to a repository as argument and
     return the type of signature it uses.

     SIG_NONE         The repository is not signed

     SIG_PUBKEY       The repository is signed using the PUBKEY method

     SIG_FINGERPRINT  The repository is signed using the FINGERPRINT method

     pkg_repo_enabled() takes a pointer to a repository as argument and
     returns true if the repository is "enabled".  Otherwise, return false.

     pkg_repo_priority() takes a pointer to a repository as argument and
     returns the priority of the repository as an unsigned integer.  Packages
     ae chosed preferentially from the repository with the highest priority
     value and which has that package available.

     pkg_repo_mirror_type() takes a pointer to a repository as argument and
     returns the type of mirroring it uses.

     SRV       The repository is using SRV record query to get the mirrors.

     HTTP      The repository is using the HTTP query method to get the
               mirrors.

     NOMIRROR  The repository does not have any mirror.

     pkg_repo_find_ident() Take an internal indentification string as argument
     and return a pointer to a repository.  If no repository matches, NULL is
     returned.

     pkg_repo_find_name() Take a repository "name" as argument and return a
     pointer to a repository.  If no repository matches, NULL is returned.

FreeBSD 13.1-RELEASE-p6        February 8, 2015        FreeBSD 13.1-RELEASE-p6