Skip to main content

Source code Changes To

pkg-gate / src / man / pkgrecv.1

From revision 2946 to 2948:

diff -r 8f63b36504ca -r 373070ea940e src/man/pkgrecv.1
--- a/src/man/pkgrecv.1	Wed Sep 18 09:25:03 2013 -0700
+++ b/src/man/pkgrecv.1	Tue Sep 17 09:39:41 2013 -0700
@@ -1,13 +1,14 @@
 '\" te
 .\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgrecv 1 "4 Mar 2013" "SunOS 5.12" "User Commands"
+.TH pkgrecv 1 "30 Aug 2013" "SunOS 5.12" "User Commands"
 .SH NAME
 pkgrecv \- Image Packaging System content retrieval utility
 .SH SYNOPSIS
 .LP
 .nf
-/usr/bin/pkgrecv [-s \fIsrc_uri\fR] [-a] [-d (\fIpath\fR|\fIdest_uri\fR)]
-    [-c \fIcache_dir\fR] [-kr] [-m \fImatch\fR] [-n] [--raw]
+/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) ...
@@ -15,19 +16,20 @@
 
 .LP
 .nf
-/usr/bin/pkgrecv [-s \fIsrc_uri\fR] --newest
+/usr/bin/pkgrecv [-s (\fIsrc_path\fR|\fIsrc_uri\fR)] --newest
 .fi
 
 .LP
 .nf
-/usr/bin/pkgrecv [-s \fIsrc_uri\fR] [-d \fIpath\fR] [-p \fIpublisher\fR ...] 
-    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR] [-n] --clone
+/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 DESCRIPTION
 .sp
 .LP
-\fBpkgrecv\fR retrieves all versions of each matching \fIfmri\fR or \fIpattern\fR from the \fIsrc_uri\fR \fBpkg\fR(5) repository or package archive and republishes the retrieved packages to the \fIdest_uri\fR package repository or package archive. By default, packages are retrieved in package repository format suitable for use with \fBpkg\fR, \fBpkg.depotd\fR, and package publication tools.
+\fBpkgrecv\fR retrieves all versions of each matching \fIfmri\fR or \fIpattern\fR from the \fBpkg\fR(5) repository or package archive specified by the \fB-s\fR option and optionally republishes the retrieved packages to the package repository or package archive specified by the \fB-d\fR option. By default, packages are retrieved in package repository format suitable for use with \fBpkg\fR, \fBpkg.depotd\fR, and package publication tools.
 .sp
 .LP
 Packages that have not changed are not republished. Therefore, the time to update an existing repository depends on the number of new and changed packages.
@@ -36,7 +38,7 @@
 Use the \fB-m\fR option to specify whether to retrieve all versions of each matching package, or only the newest version of each matching package.
 .sp
 .LP
-If you do not specify \fB\&'*'\fR to be retrieved, you might want to specify the \fB-r\fR option to be sure to retrieve all the dependencies of the specified packages.
+If you do not specify \fB'*'\fR to be retrieved, you might want to specify the \fB-r\fR option to be sure to retrieve all the dependencies of the specified packages.
 .LP
 Note - 
 .sp
@@ -69,7 +71,7 @@
 .ad
 .sp .6
 .RS 4n
-Store the retrieved package data in a \fBpkg\fR(5) archive at the location specified by \fB-d\fR. The file cannot already exist. This option can be used only with file system based destinations. Although not required, using a file extension of \fB\&.p5p\fR (for example, \fBarchive.p5p\fR) is strongly suggested. This option cannot be combined with \fB--raw\fR.
+Store the retrieved package data in a \fBpkg\fR(5) archive at the location specified by the \fB-d\fR option. The file specified by \fB-d\fR cannot already exist. The \fB-a\fR option can be used only with file system based destinations. Although not required, using a file extension of \fB\&.p5p\fR (for example, \fBarchive.p5p\fR) is strongly suggested. The \fB-a\fR option cannot be combined with the \fB--raw\fR option.
 .RE
 
 .sp
@@ -87,11 +89,11 @@
 .ne 2
 .mk
 .na
-\fB\fB-d\fR (\fIpath\fR|\fIdest_uri\fR)\fR
+\fB\fB-d\fR (\fIdest_path\fR|\fIdest_uri\fR)\fR
 .ad
 .sp .6
 .RS 4n
-Specify the file system path or URI where the retrieved packages should be republished. If \fB-a\fR  is specified, this destination is a new package archive that cannot already exist. If \fB-a\fR  is not specified, this destination must be a package repository that already exists. Use the \fBpkgrepo\fR command to create a new package repository. If \fB-d\fR is not specified, the value of \fBPKG_DEST\fR is used. See "Environment Variables" below.
+Specify the file system path or URI where the retrieved packages should be republished. If \fB-a\fR  is specified, this destination must be a package archive that does not already exist. If \fB-a\fR  is not specified, this destination must be a package repository that already exists. Use the \fBpkgrepo\fR command to create a new package repository. If \fB-d\fR is not specified, the value of \fBPKG_DEST\fR is used. See "Environment Variables" below.
 .RE
 
 .sp
@@ -193,7 +195,7 @@
 .ad
 .sp .6
 .RS 4n
-Only clone the given publisher. Can be specified multiple times. Only valid with --clone.
+Only clone the specified publisher. This option can be specified multiple times. The \fB-p\fR option is valid only with the \fB--clone\fR option.
 .RE
 
 .sp
@@ -211,11 +213,22 @@
 .ne 2
 .mk
 .na
-\fB\fB-s\fR \fIsrc_uri\fR\fR
+\fB\fB-s\fR (\fIsrc_path\fR|\fIsrc_uri\fR)\fR
 .ad
 .sp .6
 .RS 4n
-Specify a URI that represents the location of a \fBpkg\fR(5) repository or package archive from which to receive package data. If \fB-s\fR is not specified, the value of \fBPKG_SRC\fR is used. See "Environment Variables" below.
+Specify the file system path or URI of a \fBpkg\fR(5) repository or package archive from which to receive package data. If \fB-s\fR is not specified, the value of \fBPKG_SRC\fR is used. See "Environment Variables" below.
+.RE
+
+.sp
+.ne 2
+.mk
+.na
+\fB\fB-v\fR\fR
+.ad
+.sp .6
+.RS 4n
+Display verbose output, including the number of packages retrieved and their full FMRIs, the number of files retrieved, and the estimated size of the transfer.
 .RE
 
 .sp
@@ -270,7 +283,7 @@
 .ad
 .sp .6
 .RS 4n
-Make an exact copy of the source repository. By default, the clone operation will only succeed if publishers in the source repository are also present in the destination. By using \fB-p\fR, the operation can be limited to specific publishers which will be added to the destination repository if not already present. Packages in the destination repository which are not in the source will be removed. Cloning will leave the destination repository altered in case of an error. It is therefore strongly advised to have the destination repository in its own zfs dataset and to take a snapshot before cloning.
+Make an exact copy of the source repository. By default, the clone operation succeeds only if publishers in the source repository are also present in the destination. To limit the clone operation to specified publishers, use the \fB-p\fR option. Publishers specified by using the \fB-p\fR option are added to the destination repository if they are not already present. Packages that are in the destination repository but not in the source repository are removed. The clone operation leaves the destination repository altered if an error occurs. Therefore, the destination repository should be in its own ZFS dataset, and a snapshot should be created prior to performing the clone operation.
 .RE
 
 .sp
@@ -358,12 +371,20 @@
 .sp
 .in +2
 .nf
-$ \fBpkgrecv -s http://test -d /local/repo -m latest \e\fR
+$ \fBpkgrecv -s http://test -d /local/repo -m latest -v \e\fR
 \fBeditor/vim\fR
 Processing packages for publisher solaris ...
-Retrieving and evaluating 2 package(s)...
-PROCESS       ITEMS     GET (MB)    SEND(MB)
-Completed       2/2    16.7/16.7    44.9/44.9
+Retrieving and evaluating 1 package(s)...
+
+Adding packages ...
+        Packages to add:       1
+      Files to retrieve:    1557
+Estimated transfer size: 9.21 MB
+PROCESS                                     ITEMS    GET (MB) SEND (MB)
+Completed                                     1/1     9.2/9.2 25.4/25.4
+
+FMRI
+pkg://solaris/editor/vim@7.3.600,5.11-0.175.1.0.0.24.0:20121023T171531Z
 .fi
 .in -2
 .sp
@@ -414,12 +435,12 @@
 
 .sp
 .LP
-Receive all packages that do not already exist and all changed content from the secure repository located at \fBhttp://pkg.oracle.com/solaris/support/\fR to the repository located at \fB/export/repoSolaris11\fR.
+Receive all packages that do not already exist and all changed content from the secure repository located at \fBhttps://pkg.oracle.com/solaris/support/\fR to the repository located at \fB/export/repoSolaris11\fR. 
 
 .sp
 .in +2
 .nf
-$ \fBpkgrecv -s http://pkg.oracle.com/solaris/support/ \e\fR
+$ \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
@@ -577,7 +598,7 @@
 \fBpkgrepo\fR(1), \fBpkgsend\fR(1), \fBpkg\fR(5)
 .sp
 .LP
-\fICopying and Creating Oracle Solaris 11.1 Package Repositories\fR
+\fICopying and Creating Package Repositories in Oracle Solaris 11.2\fR
 .sp
 .LP
-\fBhttp://hub.opensolaris.org/bin/view/Project+pkg/\fR
+\fBhttps://java.net/projects/ips/pages/Home\fR

 
 
Close
loading
Please Confirm
Close