PKG_REPOS(3)

🎀 NAME 🎀

ok so <pink>pkg_repos</pink> and her whole friend group — 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 💖 — all of them manipulate repositories. that's the whole vibe, bestie.

this is section 3 of the manual, PKG_REPOS(3), from the Library Functions Manual ✨

📚 LIBRARY 📚

it lives in the library libpkg. iconic of her honestly 🫶

✨ SYNOPSIS ✨

okay here's the whole cast list, no cap:

#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);;

💅 not me pointing out that the synopsis says pkg_repos_url but DESCRIPTION says pkg_repo_url — and the last two have a lil double ;; situation. i'm literally just the messenger, copy them exactly as they are, mwah 😘

💅 DESCRIPTION 💅

pkg_repos() — okay so she takes the address of a pointer to the repository. lowkey important: the pointer should be initialised to NULL before you pass it to her. on each iteration the pointer will point to the new repository 🦋. she returns EPKG_FATAL if an error happened, otherwise she returns EPKG_OK until the very last repository is found, and in that case EPKG_END comes back. so like, you loop until you get EPKG_END, iykyk 🌈

pkg_repos_total_count() — returns the total number of defined repositories. all of them. the whole roster 🔥

pkg_repos_activated_count() — returns the total number of "enabled" repositories. only the ones who showed up 💖

pkg_repo_url() — takes a pointer to a repository as argument and gives you the "url" defined for that repository. slay.

pkg_repo_ident() — takes a pointer to a repository as argument and returns the internal identification string of the repository. her legal name, basically 👑

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

pkg_repo_key() — takes a pointer to a repository as argument and returns the path to the public key 🔑. but listen — if the repository is not signed by a public key, NULL gets returned. it's giving "no key, no entry" 😭

pkg_repo_fingerprints() — takes a pointer to a repository as argument and returns the path to the fingerprints. and same deal: if the repository is not signed using the "FINGERPRINT" method, NULL will be returned. read the room 🫶

pkg_repo_signature_type() — takes a pointer to a repository as argument and returns the type of signature it uses. the options are:

• 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 she returns false. simple as 💅

pkg_repo_priority() — takes a pointer to a repository as argument and returns the priority of the repository as an unsigned integer. and this part matters fr fr: packages are chosen preferentially from the repository with the highest priority value and which has that package available. so the high-priority repo is the main character here 👑🔥

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

• SRV — the repository is using an 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() — takes an internal identification string as argument and returns a pointer to a repository. if no repository matches, NULL is returned. no match, no vibes 😭

pkg_repo_find_name() — takes a repository "name" as argument and returns a pointer to a repository. and again: if no repository matches, NULL is returned. same energy, different search bar 🔍

---

and that's the whole page bestie, go loop over some repos responsibly 🦋✨

this page is from Debian, dated December 12, 2025, and it's PKG_REPOS(3) — mwah, love u, bye 💜