mirror of
https://codeberg.org/Toasterson/ips.git
synced 2026-04-10 21:30:41 +00:00
106 lines
4.2 KiB
Text
106 lines
4.2 KiB
Text
|
pkg
|
||
|
|
REPOSITORIES
|
||
|
|
|
||
|
|
1. Summary
|
||
|
|
|
||
|
|
2. Discussion
|
||
|
|
|
||
|
|
2.1. Repository configuration
|
||
|
|
|
||
|
|
2.2.1. Configuration inheritance
|
||
|
|
|
||
|
|
The pkg.depotd(5) server may need to access repository configuration data when
|
||
|
|
smf(5) is unavailable. As such, a repository must have a cached
|
||
|
|
configuration state.
|
||
|
|
|
||
|
|
Roughly, these aspects are sufficient to constrain our configuration
|
||
|
|
behavior:
|
||
|
|
|
||
|
|
request properties from svc://application/pkg
|
||
|
|
if unavailable, examine configuration cache
|
||
|
|
if undefined or unavailable, use hard-coded defaults
|
||
|
|
|
||
|
|
2.2.2. Configuration components
|
||
|
|
|
||
|
|
Repository attributes. The repository has a collection of simple
|
||
|
|
attributes for providing various bits of metadata and configuration
|
||
|
|
information. Note that changing these values requires a restart
|
||
|
|
of any pkg.depotd processes referencing the repository so that
|
||
|
|
changes will be reflected in operations and output.
|
||
|
|
|
||
|
|
repository/ Property group of type "application"
|
||
|
|
/name A short, descriptive name for the repository.
|
||
|
|
|
||
|
|
Examples: "opensolaris.org base repository"
|
||
|
|
"opensolaris.org contrib repository"
|
||
|
|
|
||
|
|
/description A descriptive paragraph for the repository.
|
||
|
|
|
||
|
|
/maintainer A human readable string describing the entity
|
||
|
|
maintaining the repository. For an individual,
|
||
|
|
this string is expected to be their name, or
|
||
|
|
name and email.
|
||
|
|
|
||
|
|
Examples: "Project Indiana"
|
||
|
|
"Project Indiana <indiana-discuss@
|
||
|
|
opensolaris.org>"
|
||
|
|
|
||
|
|
/maintainer_url A URL associated with the entity maintaining the
|
||
|
|
repository.
|
||
|
|
|
||
|
|
Example:
|
||
|
|
"http://www.opensolaris.org/os/project/indiana/"
|
||
|
|
|
||
|
|
/detailed_url One or more URLs to pages or sites with further
|
||
|
|
information about the repository.
|
||
|
|
|
||
|
|
Example: "http://www.opensolaris.org/"
|
||
|
|
|
||
|
|
feed/ Property group of type "application"
|
||
|
|
/id A Universally Unique Identifier (UUID) used to
|
||
|
|
permanently, uniquely identify the feed.
|
||
|
|
Changing this value can have unexpected effects
|
||
|
|
on feed consumers. In addition, when serving
|
||
|
|
multiple copies of a repository, each copy's
|
||
|
|
cfg_cache must have the same value for this
|
||
|
|
attribute.
|
||
|
|
|
||
|
|
/name A short, descriptive name for RSS/Atom feeds
|
||
|
|
generated by the depot serving the repository.
|
||
|
|
|
||
|
|
Example: "opensolaris.org packaging feed"
|
||
|
|
|
||
|
|
/description A descriptive paragraph for the feed.
|
||
|
|
|
||
|
|
/authority A fully-qualified domain name or email address
|
||
|
|
that will be used to generate a unique
|
||
|
|
identifier for each entry in the feed. Changing
|
||
|
|
this value can have unexpected effects on feed
|
||
|
|
consumers.
|
||
|
|
|
||
|
|
Examples: "opensolaris.org"
|
||
|
|
"indiana-discuss@opensolaris.org"
|
||
|
|
|
||
|
|
/icon A filename of a small image that will be used to
|
||
|
|
visually represent the feed (e.g. web
|
||
|
|
links to the repository, or the icon shown in a
|
||
|
|
user agent's address bar). This file must be
|
||
|
|
located in the depot server's inst_root
|
||
|
|
directory.
|
||
|
|
|
||
|
|
/logo A filename of a large image that will be used by
|
||
|
|
user agents to visually brand or identify the
|
||
|
|
feed. This file must be located in the depot's
|
||
|
|
inst_root directory.
|
||
|
|
|
||
|
|
/window A numeric value representing the number of
|
||
|
|
hours, before the feed for the repository was
|
||
|
|
last generated, to include when creating the feed
|
||
|
|
for the repository updatelog. The default value
|
||
|
|
is "24".
|
||
|
|
|
||
|
|
Example: "48"
|
||
|
|
|
||
|
|
3. References
|
||
|
|
|