-
Notifications
You must be signed in to change notification settings - Fork 19
/
Copy pathpkgrecv.1
468 lines (464 loc) · 25.3 KB
/
pkgrecv.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//Sun Microsystems//DTD SolBook-XML 3.7//EN" "xsolbook.dtd" [
<!ENTITY % ent SYSTEM "entities.ent">
%ent;
]>
<refentry id="pkgrecv-1">
<refmeta><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">3 May 2018</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, 2020, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
</refmeta>
<refnamediv>
<refname>pkgrecv</refname>
<refpurpose>Image Packaging System content retrieval utility</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis>/usr/bin/pkgrecv [-aknrv] [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)]
[-d (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)] [-c <replaceable>cache_dir</replaceable>]
[-m <replaceable>match</replaceable>] [--mog-file <replaceable>file_path</replaceable> ...] [--raw]
[--key <replaceable>src_key</replaceable> --cert <replaceable>src_cert</replaceable>]
[--dkey <replaceable>dest_key</replaceable> --dcert <replaceable>dest_cert</replaceable>]
(<replaceable>fmri</replaceable>|<replaceable>pattern</replaceable>) ...</synopsis>
<synopsis>/usr/bin/pkgrecv [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)] --newest</synopsis>
<synopsis>/usr/bin/pkgrecv [-nv] [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)]
[-d (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)] [-p <replaceable>publisher</replaceable>]...
[--key <replaceable>src_key</replaceable> --cert <replaceable>src_cert</replaceable>] --clone
</synopsis>
</refsynopsisdiv>
<refsect1 id="pkgrecv-1-desc" role="description"><title></title>
<para><command>pkgrecv</command> retrieves all versions of each matching
<replaceable>fmri</replaceable> or <replaceable>pattern</replaceable> from the
<olink targetdoc="refman" targetptr="pkg-7"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>7</manvolnum></citerefentry></olink> repository or package archive specified by the
<option>s</option> option and optionally republishes the retrieved packages to
the package repository or package archive specified by the <option>d</option>
option. This republication copies the package intact – including package
signatures – except for the time stamp. To preserve the same time stamp,
see the -<option>clone</option> option.</para>
<para>By default, packages are retrieved in package repository format suitable
for use with <command>pkg</command>, <command>pkg.depotd</command>, and package
publication tools.</para>
<para>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.</para>
<para>Use the <option>m</option> option to specify whether to retrieve all
versions of each matching package, or only the newest version of each matching
package.</para>
<para>If you do not specify <literal>'*'</literal> to be retrieved, you might
want to specify the <option>r</option> option to be sure to retrieve all the
dependencies of the specified packages.</para>
<note><para>Do not use multiple instances of <command>pkgrecv</command> simultaneously
to republish packages to the same destination repository or archive. In this
case, newly received packages could contain duplicate actions.</para></note>
<para>After a <command>pkgrecv</command> operation that retrieves packages
into a <replaceable>dest_uri</replaceable>, if the <replaceable>dest_uri</replaceable> repository
must support <command>pkg search</command> operations, run <command>pkgrepo refresh</command>
on that repository to update search indexes.</para>
</refsect1>
<refsect1 role="options"><title></title>
<para>The following options are supported:</para>
<variablelist termlength="wholeline">
<varlistentry><term><option>h</option></term>
<listitem><para>Display a usage message.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>a</option></term>
<listitem><para>Store the retrieved package data in a <olink targetdoc="refman" targetptr="pkg-7"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>7</manvolnum></citerefentry></olink>
archive at the location specified by the <option>d</option> option. The file
specified by <option>d</option> cannot already exist. The <option>a</option> option
can be used only with file system based destinations. Although not required,
using a file extension of <literal>.p5p</literal> (for example, <literal>archive.p5p
</literal>) is strongly suggested. The <option>a</option> option cannot be
combined with the <option>-raw</option> option.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
<listitem><para>Specify the path to a directory that will be used to cache
downloaded content. If this directory is not supplied, the client automatically
selects a cache directory. In the case where a download is interrupted, and
a cache directory was automatically chosen, use this option to resume the
download. See the “Environment Variables” section below for details
about how to set the location used for temporary data storage.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>d</option> (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)</term>
<listitem><para>Specify the file system path or URI where the retrieved packages
should be republished. If <option>a</option> is specified, this destination
must be a package archive that does not already exist. If <option>a</option>
is not specified, this destination must be a package repository that already
exists. Use the <command>pkgrepo</command> command to create a new package
repository. If <option>d</option> is not specified, the value of <envar>PKG_DEST</envar> is
used. See “Environment Variables” below.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>k</option></term>
<listitem><para>Keep the retrieved package content compressed. This option
is ignored when republishing. Compressed package content should not be used
with <command>pkgsend</command>.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>m</option> <replaceable>match</replaceable></term>
<listitem><para>Control which versions of packages are retrieved if
<replaceable>pattern</replaceable> is specified or if
<replaceable>fmri</replaceable> is not fully specified. For this description,
the following four example packages exist in the source specified by the
<option>s</option> option. In these FMRI, the characters between the
<literal>@</literal> and the <literal>:</literal> denote the numbered package
version, and the characters from the <literal>:</literal> to the end denote the
timestamp portion of the version string.</para>
<programlisting>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</programlisting>
<variablelist termlength="wholeline">
<varlistentry><term><literal>all-timestamps</literal></term>
<listitem><para>Retrieve all versions of each matching <replaceable>fmri</replaceable> or <replaceable>
pattern</replaceable> (implies <literal>all-versions</literal>). This is the
default behavior if the <option>m</option> option is not specified. In the
example above, all four packages are retrieved.</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>all-versions</literal></term>
<listitem><para>Retrieve the latest timestamp for each version of each matching
<replaceable>fmri</replaceable> or <replaceable>pattern</replaceable>. In the
example above, the following two packages are retrieved:</para>
<programlisting>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</programlisting>
</listitem>
</varlistentry>
<varlistentry><term><literal>latest</literal></term>
<listitem><para>Retrieve only the newest version of each matching <replaceable>fmri
</replaceable> or <replaceable>pattern</replaceable>. In the example above,
only the following package is retrieved:</para>
<programlisting>pkg://solaris/package/pkg@0.5.11,5.11-0.175.1.0.0.24.0:20120904T180335Z
</programlisting>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry><term><option>n</option></term>
<listitem><para>Perform a trial run with no changes made.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
<listitem><para>Only clone the specified publisher. This option can be specified multiple
times. The <option>p</option> option is valid only with the
<option>-clone</option> option.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>r</option></term>
<listitem><para>Recursively retrieve all dependencies for each matching
<replaceable>fmri</replaceable> or <replaceable>pattern</replaceable>.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>s</option> (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)</term>
<listitem><para>Specify the file system path or URI of a <olink targetdoc="refman" targetptr="pkg-7"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>7</manvolnum></citerefentry></olink>
repository or package archive from which to receive package data. If <option>s</option> is
not specified, the value of <envar>PKG_SRC</envar> is used. See “Environment
Variables” below.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>v</option></term>
<listitem><para>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.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-key</option> <replaceable>src_key</replaceable></term>
<listitem><para>Specify a client SSL key file to use for package retrieval
from the source HTTPS repository.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-cert</option> <replaceable>src_cert</replaceable></term>
<listitem><para>Specify a client SSL certificate file to use for package retrieval
from the source HTTPS repository.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-dkey</option> <replaceable>dest_key</replaceable></term>
<listitem><para>Specify a client SSL key file to use for package publication
to the destination HTTPS repository.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-dcert</option> <replaceable>dest_cert</replaceable></term>
<listitem><para>Specify a client SSL certificate file to use for package publication
to the destination HTTPS repository.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-clone</option></term>
<listitem><para>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 <option>p</option> option. Publishers specified by using the <option>p</option> 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.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-mog-file</option></term>
<listitem><para>Specifies a file containing <olink targetdoc="refman" targetptr="pkgmogrify-1"><citerefentry><refentrytitle>pkgmogrify</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink> transforms to be
applied to the manifest of each package before it is copied to the destination
package repository. '-' can be specified to use stdin as input. If both files
and '-' are specified together, '-' will be ignored and only files specified
are used. Use of this option will automatically cause any existing package
signatures to be dropped from the package. Adding new hashable actions
such as files and licenses is not allowed. This option can be specified
multiple times. This option may not be combined with --clone.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-newest</option></term>
<listitem><para>List the most recent versions of the packages available from
the repository specified by the <option>s</option> option. All other options
are ignored.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-raw</option></term>
<listitem><para>Retrieve and store the raw package data in a set of directory
structures by stem and version at the location specified by <option>d</option>.
The <option>-raw</option> option can be used only with file system based destinations.
This package data can be used to conveniently modify and republish packages,
perhaps by correcting file contents or providing additional package metadata.
The <option>-raw</option> option cannot be combined with <option>a</option>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>List Newest Packages</title>
<para>List the newest packages available from the repository on the system
named <literal>test</literal>.</para>
<screen>$ <userinput>pkgrecv -s http://test --newest</userinput>
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</screen>
</example>
<example><title>Retrieve Raw Package Data</title>
<para>Receive the <literal>c++-runtime</literal> package from Example 1 in
a format suitable for use with <command>pkgsend publish</command>.</para>
<screen>$ <userinput>pkgrecv -s http://test \</userinput>
<userinput>-d /local/repo --raw \</userinput>
<userinput>c++-runtime@0.5.11,5.11-0.175.0.0.0.2.1:20120921T190358Z</userinput>
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
$ <userinput>ls /local/repo</userinput>
pkg5.repository publisher system%2Flibrary%2Fc%2B%2B-runtime</screen>
<para>Because packages that have not changed are not republished, the MB to
SEND (republish) can be fewer than the MB to GET (examine). This example is
retrieving raw data, not republishing to a <option>d</option> repository.</para>
</example>
<example><title>Retrieve Dependencies From a System</title>
<para>Receive the package <literal>editor/vim</literal> and all of its dependencies
from the system named <literal>test</literal>.</para>
<screen>$ <userinput>pkgrecv -s http://test -d /local/repo -r editor/vim</userinput></screen>
</example>
<example><title>Retrieve Only the Latest Version</title>
<para>Receive only the latest version of the package <literal>editor/vim</literal> from the system named <literal>test</literal>.</para>
<screen>$ <userinput>pkgrecv -s http://test -d /local/repo -m latest -v \</userinput>
<userinput>editor/vim</userinput>
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</screen>
</example>
<example><title>Retrieve All Versions and Republish Remotely</title>
<para>Receive all versions of the package <literal>library/zlib</literal> from
the system named <literal>test</literal> and republish it to a remote repository
on the system named <literal>remote</literal>.</para>
<screen>$ <userinput>pkgrecv -s http://test -d http://remote:10000 \</userinput>
<userinput>-m all-versions library/zlib</userinput></screen>
</example>
<example><title>Retrieve Dependencies From a Repository</title>
<para>Receive the package <literal>editor/gnu-emacs</literal> and all of its
dependencies from the repository located at <filename>/export/repo</filename>.</para>
<screen>$ <userinput>pkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs</userinput></screen>
</example>
<example><title>Retrieve Additional Packages and Changed Content</title>
<para>Receive all packages that do not already exist and all changed content
from the repository located at <literal>http://pkg.oracle.com/solaris/release/</literal> to
the repository located at <literal>/export/repoSolaris11</literal>.</para>
<screen>$ <userinput>pkgrecv -s http://pkg.oracle.com/solaris/release/ \</userinput>
<userinput>-d /export/repoSolaris11 -m all-timestamps '*'</userinput></screen>
<para>Receive all packages that do not already exist and all changed content
from the secure repository located at
<literal>https://pkg.oracle.com/solaris/support/</literal> to the repository
located at <literal>/export/repoSolaris11</literal>. </para>
<screen>$ <userinput>pkgrecv -s https://pkg.oracle.com/solaris/support/ \</userinput>
<userinput>-d /export/repoSolaris11 -m all-timestamps \</userinput>
<userinput>--key /var/pkg/ssl/Oracle_Solaris_11_Support.key.pem \</userinput>
<userinput>--cert /var/pkg/ssl/Oracle_Solaris_11_Support.certificate.pem '*'</userinput></screen>
</example>
<example><title>Create a Package Archive</title>
<para>Create a package archive containing the package <literal>editor/gnu-emacs</literal> and
all of its dependencies from the repository located at <literal>http://example.com:10000
</literal>.</para>
<screen>$ <userinput>pkgrecv -s http://example.com:10000 -d /my/emacs.p5p -a \</userinput>
<userinput>-r editor/gnu-emacs</userinput></screen>
</example>
<example><title>Copy Packages From an Archive to a Repository</title>
<para>Copy all of the packages in a package archive to an existing repository
located at <filename>/export/repo</filename>.</para>
<screen>$ <userinput>pkgrecv -s /my/archive.p5p -d /export/repo '*'</userinput></screen>
</example>
<example><title>Change publisher name</title>
<para>Change the publisher name of the package 'foo' and all its
dependencies into 'extra' during republishing.</para>
<screen>$ <userinput>echo '<transform set name=pkg.fmri -> edit value
(pkg://).*?(/.*) \\\1extra\\\2>' | pkgrecv -s repo1 -d repo2 --mog-file - foo
</userinput></screen>
</example>
</refsect1>
<refsect1 role="environment-variables"><title></title>
<para>The following environment variables are supported:</para>
<variablelist termlength="wholeline">
<varlistentry><term><envar>PKG_CLIENT_CONNECT_TIMEOUT</envar></term>
<listitem><para>Seconds to wait trying to connect during transport operations
(for each attempt) before the client aborts the operation. A value of 0 means
wait indefinitely.</para>
<para>Default value: 60</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>PKG_CLIENT_LOWSPEED_TIMEOUT</envar></term>
<listitem><para>Seconds below the <literal>lowspeed</literal> limit (1024
bytes/second) during transport operations before the client aborts the operation.
A value of 0 means do not abort the operation.</para>
<para>Default value: 30</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>PKG_CLIENT_MAX_CONSECUTIVE_ERROR</envar></term>
<listitem><para>Maximum number of transient transport errors before the client
aborts the operation. A value of 0 means do not abort the operation.</para>
<para>Default value: 4</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>PKG_CLIENT_MAX_REDIRECT</envar></term>
<listitem><para>Maximum number of HTTP or HTTPS redirects allowed during transport
operations before a connection is aborted. A value of 0 means do not abort
the operation.</para>
<para>Default value: 5</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>PKG_CLIENT_MAX_TIMEOUT</envar></term>
<listitem><para>Maximum number of transport attempts per host before the client
aborts the operation. A value of 0 means do not abort the operation.</para>
<para>Default value: 4</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>PKG_DEST</envar></term>
<listitem><para>The path of a directory to save the retrieved package to,
or the file system path or URI of a repository or package archive where the
packages will be copied.</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>PKG_SRC</envar></term>
<listitem><para>A URI or file system path representing the location of a
<olink targetdoc="refman" targetptr="pkg-7"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>7</manvolnum></citerefentry></olink> repository or package archive from which to retrieve
packages.</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>TMPDIR</envar></term>
<listitem><para>The absolute path of the directory where temporary data should
be stored during program execution. If not set, the default is to store temporary
data in <filename>/var/tmp</filename>.</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>http_proxy</envar>, <envar>https_proxy</envar></term>
<listitem><para>HTTP or HTTPS proxy server. Use the following syntax to set
either <envar>http_proxy</envar> or <envar>https_proxy</envar>:</para>
<programlisting>http_proxy [<replaceable>protocol</replaceable>://]<replaceable>host</replaceable>[:<replaceable>port</replaceable>]</programlisting>
<para>See “Specifying a Proxy” in
<olink targetdoc="AUOSS"><citetitle remap="book">Updating Systems and Adding Software in Oracle Solaris 11.4</citetitle></olink>.</para>
</listitem>
</varlistentry>
<varlistentry><term><envar>no_proxy</envar></term>
<listitem><para>List of host names that should not go through any proxy. If set
to asterisk (*) only, all hosts are matched: no hosts will be proxied. Use the
following syntax to set <envar>no_proxy</envar>:</para>
<programlisting>no_proxy [* | <replaceable>host</replaceable>[,<replaceable>host</replaceable>]...]</programlisting>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="exit-status"><title></title>
<para>The following exit values are returned:</para>
<variablelist>
<varlistentry><term><returnvalue>0</returnvalue></term>
<listitem><para>Command succeeded.</para>
</listitem>
</varlistentry>
<varlistentry><term><returnvalue>1</returnvalue></term>
<listitem><para>An error occurred.</para>
</listitem>
</varlistentry>
<varlistentry><term><returnvalue>2</returnvalue></term>
<listitem><para>Invalid command line options were specified.</para>
</listitem>
</varlistentry>
<varlistentry><term><returnvalue>3</returnvalue></term>
<listitem><para>Multiple operations were requested, but only some of them
succeeded.</para>
</listitem>
</varlistentry>
<varlistentry><term><returnvalue>99</returnvalue></term>
<listitem><para>An unanticipated exception occurred.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="attributes"><title></title>
<para>See <olink targetdoc="refman" targetptr="attributes-7"><citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>7</manvolnum></citerefentry></olink> for descriptions of the following
attributes:</para>
<informaltable frame="all" orient="port">
<textobject>
<simpara>Table shows applicable attribute types and related values.</simpara>
</textobject>
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
<row>
<entry align="center">
<para>ATTRIBUTE TYPE</para>
</entry>
<entry align="center">
<para>ATTRIBUTE VALUE</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry align="left">
<para>Availability</para>
</entry>
<entry align="left">
<para><literal>package/pkg</literal></para>
</entry>
</row>
<row>
<entry align="left">
<para>Interface Stability</para>
</entry>
<entry align="left">
<para>Uncommitted</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable></refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-7"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>7</manvolnum></citerefentry></olink></para>
<para><olink targetdoc="CCOSP"><citetitle remap="book">Creating Package Repositories in Oracle Solaris 11.4</citetitle></olink></para>
<para><literal>https://github.com/oracle/solaris-ips</literal></para>
</refsect1>
<refsect1 role="notes"><title></title>
<para>When using a file system based destination repository, any <command>pkg.depotd</command> processes that are serving that repository must be restarted after package transfer is completed for the changes to be reflected in its web interface or search responses. See <olink targetdoc="refman" targetptr="pkg.depotd-8"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>8</manvolnum></citerefentry></olink> for more information.</para>
</refsect1>
</refentry>