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"

                                  "[email protected]"

      /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