Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

pkg.sysrepo(8)

Name

pkg.sysrepo - Image Packaging System system repository configuration

Synopsis

/usr/lib/pkg.sysrepo -p port [-c 
cache_dir] [-s cache_size]
    [-w http_proxy] [-W https_proxy]

Description

pkg.sysrepo is used to generate the configuration files for the Image Packaging System (IPS) system repository. pkg.sysrepo is called by the svc:/application/pkg/system-repository Service Management Facility (SMF) service. Changes in configuration should be made to the properties in the SMF service.

The system repository is responsible for providing access to the package repositories configured in a reference image through a centralized proxy. Publisher configuration changes made to that reference image are seen immediately by any clients configured to use the system repository.

The system repository is primarily used in the global zone to allow non-global zones to access the repositories configured in the global zone. The SMF services svc:/application/pkg/zones-proxyd and svc:/application/pkg/zones-proxy-client are responsible for providing the transport between non-global zones and the global zone. This transport is only used by pkg(7).

The system repository can proxy http, https, file, and .p5p archive repositories. Only version 4 file system repositories are supported, which is the default format for the pkgrepo create command. See the pkgrepo(1) man page for more information about repository versions.

Options

The following options are supported:

–c cache_dir

Specify the absolute path to a directory that should be used by the system repository for caching responses from the publishers configured.

By default, a file-cache is used. However, the special value memory can be used to indicate the an in-memory cache should be used. The special value None can be used to indicate that the system repository should not perform any caching. This setting should be configured using the config/cache_dir SMF property.

–p port

Specify the port that the system repository should use to listen for requests. This setting should be configured using the config/port SMF property.

–s cache_size

An integer value in megabytes that defines the maximum cache size of the system repository. This setting should be configured using the config/cache_max SMF property.

–w http_proxy

A string of the form scheme:// hostname[:port] that defines a web proxy that the system repository can use to access http-based package repositories. This setting can be configured using the config/http_proxy SMF property.

–W https_proxy

A string of the form scheme:// hostname[:port] that defines a web proxy that the system repository can use to access https-based package repositories. This setting can be configured using the config/https_proxy SMF property.

Examples

Example 1 Enabling the System Repository
$ svcadm enable svc:/application/pkg/system-repository

Exit Status

The following exit values are returned:

0

Command succeeded.

1

Command failed to write a valid configuration.

2

Invalid command line options were specified.

99

An unanticipated exception occurred.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
package/pkg
Interface Stability
Uncommitted

See Also

pkg(1), pkg.depotd(8), pkg(7)

https://github.com/oracle/solaris-ips