1 '\" te |
1 '\" te |
2 .\" Copyright (c) 2007, 2013, Oracle and/or its |
2 .\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved. |
3 .\" affiliates. All rights reserved. |
3 .TH pkgrecv 1 "4 Mar 2013" "SunOS 5.11" "User Commands" |
4 .TH pkgrecv 1 "20 May 2013" "SunOS 5.11" "User Commands" |
|
5 .SH NAME |
4 .SH NAME |
6 pkgrecv \- Image Packaging System content retrieval utility |
5 pkgrecv \- Image Packaging System content retrieval utility |
7 .SH SYNOPSIS |
6 .SH SYNOPSIS |
8 .LP |
7 .LP |
9 .nf |
8 .nf |
10 /usr/bin/pkgrecv [-s \fIsrc_uri\fR] [-a] [-d (\fIpath\fR|\fIdest_uri\fR)] |
9 /usr/bin/pkgrecv [-s \fIsrc_uri\fR] [-a] [-d (\fIpath\fR|\fIdest_uri\fR)] |
11 [-c \fIcache_dir\fR] [-kr] [-m \fImatch\fR] [-n] [--raw] |
10 [-c \fIcache_dir\fR] [-kr] [-m \fImatch\fR] [-n] [--raw] |
12 [--key \fIkeyfile\fR --cert \fIcertfile\fR] |
11 [--key \fIsrc_key\fR --cert \fIsrc_cert\fR] |
|
12 [--dkey \fIdest_key\fR --dcert \fIdest_cert\fR] |
13 (\fIfmri\fR|\fIpattern\fR) ... |
13 (\fIfmri\fR|\fIpattern\fR) ... |
14 .fi |
14 .fi |
15 |
15 |
16 .LP |
16 .LP |
17 .nf |
17 .nf |
18 /usr/bin/pkgrecv [-s \fIsrc_uri\fR] --newest |
18 /usr/bin/pkgrecv [-s \fIsrc_uri\fR] --newest |
19 .fi |
19 .fi |
20 |
20 |
|
21 .LP |
|
22 .nf |
|
23 /usr/bin/pkgrecv [-s \fIsrc_uri\fR] [-d \fIpath\fR] [-p \fIpublisher\fR ...] |
|
24 [--key \fIsrc_key\fR --cert \fIsrc_cert\fR] [-n] --clone |
|
25 .fi |
|
26 |
21 .SH DESCRIPTION |
27 .SH DESCRIPTION |
22 .sp |
28 .sp |
23 .LP |
29 .LP |
24 \fBpkgrecv\fR allows the user to retrieve packages from a \fBpkg\fR(5) repository or package archive. \fBpkgrecv\fR can also optionally republish the retrieved packages to a different package repository or archive them. By default, packages are retrieved in package repository format suitable for use with \fBpkg\fR, \fBpkg.depotd\fR, and package publication tools. |
30 \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. |
25 .sp |
31 .sp |
26 .LP |
32 .LP |
27 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. |
33 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. |
28 .sp |
34 .sp |
29 .LP |
35 .LP |
30 Use the \fB-m\fR option to specify whether to retrieve all timestamps or all versions of each matching package. By default, only the newest version of each matching package is retrieved. |
36 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. |
31 .sp |
37 .sp |
32 .LP |
38 .LP |
33 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. |
39 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. |
34 .LP |
40 .LP |
35 Note - |
41 Note - |
83 .na |
89 .na |
84 \fB\fB-d\fR (\fIpath\fR|\fIdest_uri\fR)\fR |
90 \fB\fB-d\fR (\fIpath\fR|\fIdest_uri\fR)\fR |
85 .ad |
91 .ad |
86 .sp .6 |
92 .sp .6 |
87 .RS 4n |
93 .RS 4n |
88 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. |
94 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. |
89 .RE |
95 .RE |
90 |
96 |
91 .sp |
97 .sp |
92 .ne 2 |
98 .ne 2 |
93 .mk |
99 .mk |
105 .na |
111 .na |
106 \fB\fB-m\fR \fImatch\fR\fR |
112 \fB\fB-m\fR \fImatch\fR\fR |
107 .ad |
113 .ad |
108 .sp .6 |
114 .sp .6 |
109 .RS 4n |
115 .RS 4n |
110 Control matching behavior using the following values: |
116 Control which versions of packages are retrieved if \fIpattern\fR is specified or if \fIfmri\fR is not fully specified. For this description, the following four example packages exist in the source specified by the \fB-s\fR option. In these FMRI, the characters between the \fB@\fR and the \fB:\fR denote the numbered package version, and the characters from the \fB:\fR to the end denote the timestamp portion of the version string. |
|
117 .sp |
|
118 .in +2 |
|
119 .nf |
|
120 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z |
|
121 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120903T170234Z |
|
122 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z |
|
123 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120819T155007Z |
|
124 .fi |
|
125 .in -2 |
|
126 |
111 .sp |
127 .sp |
112 .ne 2 |
128 .ne 2 |
113 .mk |
129 .mk |
114 .na |
130 .na |
115 \fB\fBall-timestamps\fR\fR |
131 \fB\fBall-timestamps\fR\fR |
116 .ad |
132 .ad |
117 .sp .6 |
133 .sp .6 |
118 .RS 4n |
134 .RS 4n |
119 Includes all matching timestamps, not just the latest (implies \fBall-versions\fR). |
135 Retrieve all versions of each matching \fIfmri\fR or \fIpattern\fR (implies \fBall-versions\fR). This is the default behavior if the \fB-m\fR option is not specified. In the example above, all four packages are retrieved. |
120 .RE |
136 .RE |
121 |
137 |
122 .sp |
138 .sp |
123 .ne 2 |
139 .ne 2 |
124 .mk |
140 .mk |
125 .na |
141 .na |
126 \fB\fBall-versions\fR\fR |
142 \fB\fBall-versions\fR\fR |
127 .ad |
143 .ad |
128 .sp .6 |
144 .sp .6 |
129 .RS 4n |
145 .RS 4n |
130 Includes all matching versions, not just the latest. |
146 Retrieve the latest timestamp for each version of each matching \fIfmri\fR or \fIpattern\fR. In the example above, the following two packages are retrieved: |
|
147 .sp |
|
148 .in +2 |
|
149 .nf |
|
150 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z |
|
151 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z |
|
152 .fi |
|
153 .in -2 |
|
154 |
|
155 .RE |
|
156 |
|
157 .sp |
|
158 .ne 2 |
|
159 .mk |
|
160 .na |
|
161 \fB\fBlatest\fR\fR |
|
162 .ad |
|
163 .sp .6 |
|
164 .RS 4n |
|
165 Retrieve only the newest version of each matching \fIfmri\fR or \fIpattern\fR. In the example above, only the following package is retrieved: |
|
166 .sp |
|
167 .in +2 |
|
168 .nf |
|
169 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z |
|
170 .fi |
|
171 .in -2 |
|
172 |
131 .RE |
173 .RE |
132 |
174 |
133 .RE |
175 .RE |
134 |
176 |
135 .sp |
177 .sp |
167 |
220 |
168 .sp |
221 .sp |
169 .ne 2 |
222 .ne 2 |
170 .mk |
223 .mk |
171 .na |
224 .na |
172 \fB\fB--cert\fR \fIcertfile\fR\fR |
225 \fB\fB--key\fR \fIsrc_key\fR\fR |
173 .ad |
226 .ad |
174 .sp .6 |
227 .sp .6 |
175 .RS 4n |
228 .RS 4n |
176 Specify a client SSL certificate file to use for package retrieval from an HTTPS repository. |
229 Specify a client SSL key file to use for package retrieval from the source HTTPS repository. |
177 .RE |
230 .RE |
178 |
231 |
179 .sp |
232 .sp |
180 .ne 2 |
233 .ne 2 |
181 .mk |
234 .mk |
182 .na |
235 .na |
183 \fB\fB--key\fR \fIkeyfile\fR\fR |
236 \fB\fB--cert\fR \fIsrc_cert\fR\fR |
184 .ad |
237 .ad |
185 .sp .6 |
238 .sp .6 |
186 .RS 4n |
239 .RS 4n |
187 Specify a client SSL key file to use for package retrieval from an HTTPS repository. |
240 Specify a client SSL certificate file to use for package retrieval from the source HTTPS repository. |
|
241 .RE |
|
242 |
|
243 .sp |
|
244 .ne 2 |
|
245 .mk |
|
246 .na |
|
247 \fB\fB--dkey\fR \fIdest_key\fR\fR |
|
248 .ad |
|
249 .sp .6 |
|
250 .RS 4n |
|
251 Specify a client SSL key file to use for package publication to the destination HTTPS repository. |
|
252 .RE |
|
253 |
|
254 .sp |
|
255 .ne 2 |
|
256 .mk |
|
257 .na |
|
258 \fB\fB--dcert\fR \fIdest_cert\fR\fR |
|
259 .ad |
|
260 .sp .6 |
|
261 .RS 4n |
|
262 Specify a client SSL certificate file to use for package publication to the destination HTTPS repository. |
|
263 .RE |
|
264 |
|
265 .sp |
|
266 .ne 2 |
|
267 .mk |
|
268 .na |
|
269 \fB\fB--clone\fR\fR |
|
270 .ad |
|
271 .sp .6 |
|
272 .RS 4n |
|
273 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. |
188 .RE |
274 .RE |
189 |
275 |
190 .sp |
276 .sp |
191 .ne 2 |
277 .ne 2 |
192 .mk |
278 .mk |