'\" te
.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
.TH pkgrecv 1 "2013 年 11 月 21 日" "SunOS 5.11" "用户命令"
.SH 名称
pkgrecv \- 映像包管理系统内容检索实用程序

.SH 用法概要


.LP
.nf
/usr/bin/pkgrecv [-aknrv] [-s (\fIsrc_path\fR|\fIsrc_uri\fR)]
    [-d (\fIdest_path\fR|\fIdest_uri\fR)] [-c \fIcache_dir\fR]
    [-m \fImatch\fR] [--raw]
    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR]
    [--dkey \fIdest_key\fR --dcert \fIdest_cert\fR]
    (\fIfmri\fR|\fIpattern\fR) \&.\&.\&.
.fi


.LP
.nf
/usr/bin/pkgrecv [-s (\fIsrc_path\fR|\fIsrc_uri\fR)] --newest
.fi


.LP
.nf
/usr/bin/pkgrecv [-nv] [-s (\fIsrc_path\fR|\fIsrc_uri\fR)]
    [-d (\fIdest_path\fR|\fIdest_uri\fR)] [-p \fIpublisher\fR]\&.\&.\&.
    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR] --clone
.fi

.SH 描述

.sp
.LP
\fBpkgrecv\fR 从 \fB-s\fR 选项指定的 \fBpkg\fR(5) 系统信息库或软件包归档文件检索每个匹配 \fIfmri\fR 或 \fIpattern\fR 的软件包的所有版本，并且可以将检索到的软件包重新发布到 \fB-d\fR 选项指定的软件包系统信息库或软件包归档文件。缺省情况下，会以 \fBpkg\fR、\fBpkg\&.depotd\fR 以及软件包发布工具可使用的软件包系统信息库格式检索软件包。

.sp
.LP
不重新发布未更改的软件包。因此，更新现有系统信息库的时间取决于新的和已更改软件包的数量。

.sp
.LP
使用 \fB-m\fR 选项可指定是检索每个匹配软件包的所有版本还是每个匹配软件包的最新版本。

.sp
.LP
如果未指定要检索的 \fB\'*\'\fR，则可以指定 \fB-r\fR 选项来确保检索指定软件包的所有依赖项。

.LP
注 -
.sp
.RS 2
.sp
.LP
不要同时使用 \fBpkgrecv\fR 的多个实例来将软件包重新发布到同一目标系统信息库或归档文件。在这种情况下，新检索的软件包可以包含重复操作。

.RE

.sp
.LP
在将软件包检索到 \fIdest_uri\fR 中的 \fBpkgrecv\fR 操作后，如果 \fIdest_uri\fR 系统信息库必须支持 \fBpkg search\fR 操作，则在该系统信息库上运行 \fBpkgrepo refresh\fR 以更新搜索索引。

.SH 选项

.sp
.LP
支持以下选项：

.sp
.ne 2
.mk
.na
\fB\fB-h\fR\fR
.ad
.br
.sp .6
.RS 4n
显示用法消息。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-a\fR\fR
.ad
.br
.sp .6
.RS 4n
将检索的软件包数据存储在 \fB-d\fR 选项指定的位置中的 \fBpkg\fR(5) 归档文件中。\fB-d\fR 指定的文件不能已经存在。\fB-a\fR 选项仅可以与基于文件系统的目标一起使用。尽管不要求，但还是强烈建议使用文件扩展名 \fB\&.p5p\fR（例如：\fB archive\&.p5p\fR）。\fB-a\fR 选项不能与 \fB--raw\fR 选项一起使用。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-c\fR \fIcache_dir\fR\fR
.ad
.br
.sp .6
.RS 4n
指定将用于缓存已下载内容的目录的路径。如果没有提供此目录，客户机将自动选择一个高速缓存目录。如果下载中断并且已自动选择了一个高速缓存目录，可使用该选项继续执行下载。有关如何设置用于存储临时数据的位置的详细信息，请参见下文的“环境变量”部分。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-d\fR (\fIdest_path\fR|\fIdest_uri\fR)\fR
.ad
.br
.sp .6
.RS 4n
指定应重新发布检索的软件包的文件系统路径或 URI。如果指定 \fB-a\fR，此目标必须是尚未存在的软件包归档文件。如果未指定 \fB-a\fR，此目标必须是已经存在的软件包系统信息库。使用 \fBpkgrepo\fR 命令创建新软件包系统信息库。如果未指定 \fB-d\fR，则使用值 \fBPKG_DEST\fR。请参见下面的“环境变量”。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-k\fR\fR
.ad
.br
.sp .6
.RS 4n
使检索的软件包内容保持压缩状态。重新发布时会忽略该选项。压缩的软件包内容不得与 \fBpkgsend\fR 一起使用。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-m\fR \fImatch\fR\fR
.ad
.br
.sp .6
.RS 4n
在指定 \fIpattern\fR 或未充分指定 \fIfmri\fR 时控制要检索哪些软件包版本。在下面的说明中，\fB-s\fR 选项所指定的源中存在下面的四个示例软件包。在这些 FMRI 中，\fB@\fR 与 \fB:\fR 之间的字符表示已编号的软件包版本，\fB:\fR 至结尾的字符表示版本字符串的时间戳部分。
.sp
.in +2
.nf
pkg://solaris/package/pkg@0\&.5\&.11,5\&.11-0\&.175\&.1\&.0\&.0\&.24\&.0:20120904T180335Z
pkg://solaris/package/pkg@0\&.5\&.11,5\&.11-0\&.175\&.1\&.0\&.0\&.24\&.0:20120903T170234Z
pkg://solaris/package/pkg@0\&.5\&.11,5\&.11-0\&.175\&.1\&.0\&.0\&.23\&.0:20120820T165108Z
pkg://solaris/package/pkg@0\&.5\&.11,5\&.11-0\&.175\&.1\&.0\&.0\&.23\&.0:20120819T155007Z
.fi
.in -2
.sp
.sp
.ne 2
.mk
.na
\fB\fBall-timestamps\fR\fR
.ad
.br
.sp .6
.RS 4n
检索匹配 \fIfmri\fR 或\fI pattern\fR 的每个软件包的所有版本（隐式的 \fBall-versions\fR）。如果未指定 \fB-m\fR 选项，这将是缺省行为。在上面的例子中，将检索到全部四个软件包。
.RE

.sp
.ne 2
.mk
.na
\fB\fBall-versions\fR\fR
.ad
.br
.sp .6
.RS 4n
检索匹配 \fIfmri\fR 或 \fIpattern\fR 的每个软件包的每个版本的最新时间戳。在上面的例子中，将检索到下面两个软件包：
.sp
.in +2
.nf
pkg://solaris/package/pkg@0\&.5\&.11,5\&.11-0\&.175\&.1\&.0\&.0\&.24\&.0:20120904T180335Z
pkg://solaris/package/pkg@0\&.5\&.11,5\&.11-0\&.175\&.1\&.0\&.0\&.23\&.0:20120820T165108Z
.fi
.in -2
.sp
.RE

.sp
.ne 2
.mk
.na
\fB\fBlatest\fR\fR
.ad
.br
.sp .6
.RS 4n
只检索匹配 \fIfmri\fR 或 \fIpattern\fR 的每个软件包的最新版本。在上面的例子中，将检索到下面的软件包：
.sp
.in +2
.nf
pkg://solaris/package/pkg@0\&.5\&.11,5\&.11-0\&.175\&.1\&.0\&.0\&.24\&.0:20120904T180335Z

.fi
.in -2
.sp
.RE

.RE

.sp
.ne 2
.mk
.na
\fB\fB-n\fR\fR
.ad
.br
.sp .6
.RS 4n
执行试运行，不进行任何更改。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
只克隆指定的发布者。可以多次指定此选项。\fB-p\fR 选项只有在与 \fB--clone\fR 选项一起使用时才有效。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-r\fR\fR
.ad
.br
.sp .6
.RS 4n
递归检索每个匹配的 \fIfmri\fR 或 \fIpattern\fR 的所有依赖项。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-s\fR (\fIsrc_path\fR|\fIsrc_uri\fR)\fR
.ad
.br
.sp .6
.RS 4n
指定要从中接收软件包数据的 \fBpkg\fR(5) 系统信息库或软件包归档文件的文件系统路径或 URI。如果未指定 \fB-s\fR，则使用值 \fBPKG_SRC\fR。请参见下面的“环境变量”。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-v\fR\fR
.ad
.br
.sp .6
.RS 4n
显示详细输出，包括检索到的软件包个数及其完整 FMRI、检索到的文件个数以及估计的传输大小。
.RE

.sp
.ne 2
.mk
.na
\fB\fB--key\fR \fIsrc_key\fR\fR
.ad
.br
.sp .6
.RS 4n
指定用于从源 HTTPS 系统信息库进行软件包检索的客户机 SSL 密钥文件。
.RE

.sp
.ne 2
.mk
.na
\fB\fB--cert\fR \fIsrc_cert\fR\fR
.ad
.br
.sp .6
.RS 4n
指定用于从源 HTTPS 系统信息库进行软件包检索的客户机 SSL 证书文件。
.RE

.sp
.ne 2
.mk
.na
\fB\fB--dkey\fR \fIdest_key\fR\fR
.ad
.br
.sp .6
.RS 4n
指定用于向目标 HTTPS 系统信息库发布软件包的客户机 SSL 密钥文件。
.RE

.sp
.ne 2
.mk
.na
\fB\fB--dcert\fR \fIdest_cert\fR\fR
.ad
.br
.sp .6
.RS 4n
指定用于向目标 HTTPS 系统信息库发布软件包的客户机 SSL 证书文件。
.RE

.sp
.ne 2
.mk
.na
\fB\fB--clone\fR\fR
.ad
.br
.sp .6
.RS 4n
为源系统信息库创建完全一致的副本。缺省情况下，仅当源系统信息库中的发布者也存在于目标中时，克隆操作才会成功。要限制仅对指定的发布者使用克隆操作，请使用 \fB-p\fR 选项。使用 \fB-p\fR 选项指定的发布者如果不在目标系统信息库中，则会将其添加到其中。存在于目标系统信息库中但不在源系统信息库中的软件包将被删除。如果发生错误，克隆操作会导致目标系统信息库更改。因此，目标系统信息库应位于自己的 ZFS 数据集中，并且在执行克隆操作之前应创建一个快照。
.RE

.sp
.ne 2
.mk
.na
\fB\fB--newest\fR\fR
.ad
.br
.sp .6
.RS 4n
列出 \fB-s\fR 选项指定的系统信息库中提供的最新版本的软件包。将忽略所有其他选项。
.RE

.sp
.ne 2
.mk
.na
\fB\fB--raw\fR\fR
.ad
.br
.sp .6
.RS 4n
按主干和版本，检索一组目录结构中的原始软件包数据并将其存储在 \fB-d\fR 指定的位置中。\fB--raw\fR 选项仅可以与基于文件系统的目标一起使用。此软件包数据可用于方便地修改和重新发布软件包，也许通过更正文件内容，也许通过提供附加的软件包元数据。\fB--raw\fR 选项不能与 \fB-a\fR 一起使用。
.RE


.SH 示例

.LP
\fB示例 1\fR 列出最新的软件包

.sp
.LP
列出名为 \fBtest\fR 的系统上的系统信息库中的最新软件包。

.sp
.in +2
.nf
$ \fBpkgrecv -s http://test --newest\fR
pkg://solaris/system/library/c++-runtime@0\&.5\&.11,5\&.11-0\&.175\&.0\&.0\&.0\&.2\&.1:20120921T190358Z
pkg://solaris/system/library/freetype-2@2\&.4\&.8,5\&.11-0\&.175\&.1\&.0\&.0\&.7\&.1234:20120109T215840Z
pkg://solaris/system/library/math@0\&.5\&.11,5\&.11-0\&.175\&.0\&.0\&.0\&.2\&.1:20120921T190432Z
.fi
.in -2
.sp

.LP
\fB示例 2\fR 检索原始软件包数据

.sp
.LP
以能够与 \fBpkgsend publish\fR 结合使用的合适格式从示例 1 中接收 \fBc++-runtime\fR 软件包。

.sp
.in +2
.nf
$ \fBpkgrecv -s http://test \e\fR
\fB-d /local/repo --raw \e\fR
\fBc++-runtime@0\&.5\&.11,5\&.11-0\&.175\&.0\&.0\&.0\&.2\&.1:20120921T190358Z\fR
Processing packages for publisher solaris \&.\&.\&.
Retrieving and evaluating 1 package(s)\&.\&.\&.
PROCESS       ITEMS     GET (MB)    SEND (MB)
Completed       1/1      3\&.5/3\&.5      0\&.0/0\&.0
$ \fBls /local/repo\fR
pkg5\&.repository  publisher  system%2Flibrary%2Fc%2B%2B-runtime
.fi
.in -2
.sp

.LP
\fB示例 3\fR 从系统中检索依赖项

.sp
.LP
从名为 \fBtest\fR 的系统中接收软件包 \fBeditor/vim\fR 及其所有依赖项。

.sp
.in +2
.nf
$ \fBpkgrecv -s http://test -d /local/repo -r editor/vim\fR
.fi
.in -2
.sp

.LP
\fB示例 4\fR 仅检索最新版本

.sp
.LP
仅从名为 \fBtest\fR 的系统中接收软件包 \fBeditor/vim\fR 的最新版本。

.sp
.in +2
.nf
$ \fBpkgrecv -s http://test -d /local/repo -m latest -v \e\fR
\fBeditor/vim\fR
Processing packages for publisher solaris \&.\&.\&.
Retrieving and evaluating 1 package(s)\&.\&.\&.

Retrieving packages \&.\&.\&.
        Packages to add:       1
      Files to retrieve:    1557
Estimated transfer size: 9\&.21 MB

Packages to transfer:
editor/vim@7\&.3\&.600,5\&.11-0\&.175\&.1\&.0\&.0\&.24\&.0:20120904T172128Z

PROCESS                                     ITEMS    GET (MB) SEND (MB)
Completed                                     1/1     9\&.2/9\&.2 25\&.4/25\&.4
.fi
.in -2
.sp

.LP
\fB示例 5\fR 检索所有版本并远程重新发布

.sp
.LP
从名为 \fBtest\fR 的系统中接收软件包 \fBlibrary/zlib\fR 的所有版本，然后将其重新发布到名为 \fBremote\fR 的系统上的远程系统信息库中。

.sp
.in +2
.nf
$ \fBpkgrecv -s http://test -d http://remote:10000 \e\fR
\fB-m all-versions library/zlib\fR
.fi
.in -2
.sp

.LP
\fB示例 6\fR 从系统信息库中检索依赖项

.sp
.LP
从位于 \fB/export/repo\fR 的系统信息库中接收软件包 \fBeditor/gnu-emacs\fR 及其所有依赖项。

.sp
.in +2
.nf
$ \fBpkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs\fR
.fi
.in -2
.sp

.LP
\fB示例 7\fR 检索其他软件包和更改的内容

.sp
.LP
从位于 \fBhttp://pkg\&.oracle\&.com/solaris/release/\fR 的系统信息库中将并非已存在的所有软件包和所有已更改内容接收到位于 \fB/export/repoSolaris11\fR 的系统信息库。

.sp
.in +2
.nf
$ \fBpkgrecv -s http://pkg\&.oracle\&.com/solaris/release/ \e\fR
\fB-d /export/repoSolaris11 -m all-timestamps \'*\'\fR
.fi
.in -2
.sp

.sp
.LP
将位于 \fBhttps://pkg\&.oracle\&.com/solaris/support/\fR的安全系统信息库中的所有尚不存在的软件包和所有更改内容接收到位于 \fB/export/repoSolaris11\fR 的系统信息库。 

.sp
.in +2
.nf
$ \fBpkgrecv -s https://pkg\&.oracle\&.com/solaris/support/ \e\fR
\fB-d /export/repoSolaris11 -m all-timestamps \e\fR
\fB--key /var/pkg/ssl/Oracle_Solaris_11_Support\&.key\&.pem \e\fR
\fB--cert /var/pkg/ssl/Oracle_Solaris_11_Support\&.certificate\&.pem \'*\'\fR
.fi
.in -2
.sp

.LP
\fB示例 8\fR 创建软件包归档文件

.sp
.LP
根据位于 \fBhttp://example\&.com:10000 \fR 的系统信息库创建包含软件包 \fBeditor/gnu-emacs\fR 及其所有依赖项的软件包归档文件。

.sp
.in +2
.nf
$ \fBpkgrecv -s http://example\&.com:10000 -d /my/emacs\&.p5p -a \e\fR
\fB-r editor/gnu-emacs\fR
.fi
.in -2
.sp

.LP
\fB示例 9\fR 将软件包从归档文件复制到系统信息库中

.sp
.LP
将软件包归档文件中的所有软件包复制到位于 \fB/export/repo\fR 中的现有系统信息库。

.sp
.in +2
.nf
$ \fBpkgrecv -s /my/archive\&.p5p -d /export/repo \'*\'\fR
.fi
.in -2
.sp

.SH 环境变量

.sp
.LP
支持以下环境变量：

.sp
.ne 2
.mk
.na
\fB\fBPKG_DEST\fR\fR
.ad
.RS 12n
.rt
要将检索到的软件包保存到的目录的路径，或者要复制软件包的系统信息库或软件包归档文件的文件系统路径或 URI。
.RE

.sp
.ne 2
.mk
.na
\fB\fBPKG_SRC\fR\fR
.ad
.RS 12n
.rt
URI 或文件系统路径代表要从中检索软件包的 \fB pkg\fR(5) 系统信息库或软件包归档文件的位置。
.RE

.sp
.ne 2
.mk
.na
\fB\fBTMPDIR\fR\fR
.ad
.RS 12n
.rt
在程序执行期间用于存储临时数据的目录的绝对路径。如果未设置，则存储临时数据的缺省路径为 \fB/var/tmp\fR。
.RE


.SH 退出状态

.sp
.LP
将返回以下退出值：

.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 6n
.rt
命令成功。
.RE

.sp
.ne 2
.mk
.na
\fB\fB1\fR\fR
.ad
.RS 6n
.rt
出现错误。
.RE

.sp
.ne 2
.mk
.na
\fB\fB2\fR\fR
.ad
.RS 6n
.rt
指定的命令行选项无效。
.RE

.sp
.ne 2
.mk
.na
\fB\fB3\fR\fR
.ad
.RS 6n
.rt
请求了多项操作，但只有一部分操作成功。
.RE

.sp
.ne 2
.mk
.na
\fB\fB99\fR\fR
.ad
.RS 6n
.rt
发生了意外的异常。
.RE


.SH 属性

.sp
.LP
有关下列属性的说明，请参见 \fBattributes\fR(5)：

.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
属性类型
属性值
_
可用性
\fBpackage/pkg\fR
_
接口稳定性
Uncommitted（未确定）
.TE

.SH 另请参见

.sp
.LP
\fBpkgrepo\fR(1)、\fBpkgsend\fR(1)、\fBpkg\fR(5)

.sp
.LP
《\fICopying and Creating Package Repositories in Oracle Solaris 11\&.3\fR》

.sp
.LP
\fBhttps://java\&.net/projects/ips/pages/Home\fR

.SH 附注

.sp
.LP
当使用基于文件系统的目标系统信息库时，在完成软件包传输后必须重新启动提供该系统信息库服务的任何 \fBpkg\&.depotd\fR 进程，以便在其 Web 界面或搜索响应中反映更改。有关更多信息，请参见 \fBpkg\&.depotd\fR(1M)。