pkgrepo - 手册页部分 1：用户命令

语言：

pkgrepo(1)

名称

pkgrepo - 映像包管理系统的系统信息库管理实用程序

用法概要

/usr/bin/pkgrepo create [--version ver] uri_or_path

/usr/bin/pkgrepo add-publisher -s repo_uri_or_path
    publisher ...

/usr/bin/pkgrepo remove-publisher [-n] [--synchronous]
    -s repo_uri_or_path publisher ...

/usr/bin/pkgrepo get [-F format] [-H] [-p publisher]...
    -s repo_uri_or_path [--key ssl_key --cert ssl_cert]...
    [section/property ...]

/usr/bin/pkgrepo info [-F format] [-H] [-p publisher]...
    -s repo_uri_or_path [--key ssl_key --cert ssl_cert]...

/usr/bin/pkgrepo list [-F format] [-H] [-p publisher]...
    -s repo_uri_or_path [--key ssl_key --cert ssl_cert]...
    [pkg_fmri_pattern ...]

/usr/bin/pkgrepo contents [-m]
    [-t action_name[,action_name]...]... -s repo_uri_or_path
    [--key ssl_key --cert ssl_cert]... [pkg_fmri_pattern...]

/usr/bin/pkgrepo rebuild [-p publisher]...
    -s repo_uri_or_path [--key ssl_key --cert ssl_cert]...
    [--no-catalog] [--no-index]

/usr/bin/pkgrepo refresh [-p publisher]...
    -s repo_uri_or_path [--key ssl_key --cert ssl_cert]...
    [--no-catalog] [--no-index]

/usr/bin/pkgrepo remove [-n] [-p publisher]...
    -s repo_uri_or_path pkg_fmri_pattern ...

/usr/bin/pkgrepo set [-p publisher]... -s repo_uri_or_path
    section/property=[value] ...

/usr/bin/pkgrepo set [-p publisher]... -s repo_uri_or_path
    section/property=([value]) ...

/usr/bin/pkgrepo verify [-p publisher]...
    -s repo_uri_or_path

/usr/bin/pkgrepo fix [-v] [-p publisher]...
    -s repo_uri_or_path

/usr/bin/pkgrepo help

/usr/bin/pkgrepo version

描述

通过 pkgrepo 可以创建和管理 pkg(5) 软件包系统信息库。软件包系统信息库是一组预定义的目录和文件，允许 pkg 和发布客户机（例如 pkgsend 或 pkgrecv）存储和检索软件包数据。此外，当需要对软件包系统信息库进行基于网络的访问时，pkg.depotd 可以提供对该系统信息库的客户机访问权限，以存储和/或检索软件包数据。

选项

支持以下选项：

–?
–-help: 显示用法消息。

子命令

支持以下子命令：

pkgrepo create [–-version ver] uri_or_path

在指定的位置创建 pkg(5) 系统信息库。

该子命令仅可以与基于文件系统的系统信息库一起使用。

–-version

使用与指定版本兼容的格式创建系统信息库。缺省情况下，会创建版本为 4 的系统信息库。支持的版本包括：

3: 支持为单个发布者存储软件包，目录版本为 1 ，搜索版本为 1。
4: 支持为多个发布者存储软件包，目录版本为 1 ，搜索版本为 1。

pkgrepo add-publisher –s repo_uri_or_path publisher ...

将指定的发布者添加到系统信息库中。新的发布者没有软件包或内容。

该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。

–s repo_uri_or_path: 对位于给定 URI 或文件系统路径的系统信息库进行操作。

pkgrepo remove-publisher [–n] [–-synchronous] –s repo_uri_or_path publisher ...

从系统信息库中删除指定的发布者。删除指定发布者的所有软件包和其他所有数据。

如果删除了缺省发布者，并且系统信息库中只剩余了一个发布者，则剩余的发布者将成为缺省发布者。系统信息库的 publisher/prefix 属性将设置为该剩余发布者。

如果删除了缺省发布者，但系统信息库中剩余多个发布者，或者从系统信息库中删除了最后一个发布者，则将取消设置 publisher/prefix 属性。

该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。

–n: 试运行操作而不更改发布者。在退出之前，会显示要删除的每个发布者的软件包个数。
–s repo_uri_or_path: 对位于给定 URI 或文件系统路径的系统信息库进行操作。
–-synchronous: 等待操作完成，然后返回。如果未指定此选项，命令将立即返回并在后台异步删除发布者。

pkgrepo get [–F format] [–H] [–p publisher]... –s repo_uri_or_path [–-key ssl_key –-cert ssl_cert]... [section/property ...]

显示系统信息库或其发布者的属性信息。

缺省情况下，会在单独的行中显示每个属性及其值。空的 ASCII 字符串值用一对双引号 ("") 表示。ASCII 字符串值中的以下 Bourne shell 元字符以及换行符、空格符和制表符都必须使用反斜杠 (\) 进行转义：

; & ( ) | ^ < > \ " ' `

有关显示发布者和系统信息库属性的示例，请参见“示例”部分。

有关属性列表以及每个属性的用途和值，请参见下文的 set 子命令。

–F format: 指定备用输出格式。format 的值可以是 tsv（以制表符分隔的值）、json（单行 JavaScript 对象表示法）或 json-formatted（格式易于阅读的 JavaScript 对象表示法）。
–H: 在列出时省略标题。
–p publisher: 显示给定发布者的属性信息。特殊值 all 显示所有发布者的属性。可以多次指定此选项。
–s repo_uri_or_path: 对位于给定 URI 或文件系统路径的系统信息库进行操作。
–-key ssl_key –-cert ssl_cert: 使用 –-key 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 密钥文件。使用 –-cert 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 证书文件。可以多次指定此选项对。
section/property: 仅显示指定属性的值，例如 publisher/prefix 或 repository/version。有关完整的属性列表，请参见 set 子命令。

pkgrepo info [–F format] [–H] [–p publisher]... –s repo_uri_or_path [–-key ssl_key –-cert ssl_cert]...

显示系统信息库已知的软件包发布者的列表。该列表包括每个发布者的软件包数量、最后一次更新发布者的软件包数据的时间以及发布者的软件包数据的状态（例如当前是否处于正在处理状态）。

–p publisher: 仅显示给定发布者的数据。如果没有提供该选项，将显示所有发布者的数据。可以多次指定此选项。