pkgadd(1M) pkgadd(1M)
NAME
pkgadd - transfer software package to the system
SYNOPSIS
/usr/sbin/pkgadd [-d device] [-r response] [-l|-q] [-n|-O|-c[h]]
[-a admin] [pkginst1 [pkginst2[ ...]]]
/usr/sbin/pkgadd -s spool [-d device] [pkginst1 [pkginst2[ ...]]]
DESCRIPTION
pkgadd transfers the contents of a software package from the distribu-
tion medium or directory to install it onto the system. Used without
the -d option, pkgadd looks in the default spool directory for the
package (/var/spool/pkg). Used with the -s option, it reads the pack-
age to a spool directory instead of installing it. If pkginst is not
specified, all packages available under device are offered for selec-
tion in a menu.
OPTIONS
-d Installs or copies a package from device. device can be a full
path name to a directory or the identifier for tape (for example
/var/tmp). It can also be the device alias.
-r Identifies a file or directory, response, which contains output
from a previous pkgask session. This file supplies the interac-
tion responses that would be requested by the package in interac-
tive mode. response must be a full pathname.
-l Log error messages in /var/sadm/install/logs.
-q No messages (quiet mode).
-n Non-interactive mode. The command is aborted should interaction
be required. Interactive input should only occur in request
scripts. A request script without a response will likewise cause
an abort. pkgadd cannot recognize interactive input in installa-
tion scripts, though the situation should not arise.
-O The menu for pkginst's is only displayed once.
-c Check mode (virtual install). The packages are not actually
added, rather a check is run to see whether an installation could
be carried out successfully (dependencies, disk space etc.).
-ch Records the information from a virtual install for other virtual
installations.
-a Defines an installation administration file, admin, to be used in
place of the default administration file. The token none over-
rides the use of any admin file, and thus forces interaction with
the user. Unless a full path name is given, pkgadd looks in the
/var/sadm/install/admin directory for the file.
Page 1 Reliant UNIX 5.44 Printed 11/98
pkgadd(1M) pkgadd(1M)
-s Reads the package into the directory spool instead of installing
it.
pkginst
Specifies the package instance or list of instances to be
installed. The token all may be used to refer to all packages
available on the source medium. The pkginst.* format can be used
to indicate all instances of a package.
When executed without options, pkgadd uses /var/spool/pkg (the default
spool directory).
DIAGNOSTICS
The following return codes exist:
Code Meaning
_____________________________________________________________________
0 Successful execution
1 Abort (usually a wrong call)
2 Warning (e.g. only partly installed)
3 User interrupt
4 Abort because of admin entry
5 Abort; interaction required
+10 Reboot required when all packages are installed
+20 Reboot required immediately
NOSET (77) No package selected (for Set Installation Packages only)
>=79 Aborted by pkg-internal error:
Device errors:
79 Device not available
80 Device not in device table
Data stream errors:
81 No archive in data stream
82 Cannot initialize data stream device
83 Error in dsnext()
84 Data stream expected
Package errors:
85 Package list empty
86 pkgmap or pkginfo missing
87 Response file cannot be created/deleted
88 Error opening pkgmap|pkginfo|depend|admin
89 Error opening the response file
90 Package sections <1
91 Faulty processing of pkgmap
92 Corrupted file in package
Page 2 Reliant UNIX 5.44 Printed 11/98
pkgadd(1M) pkgadd(1M)
93 Directory structure corrupted
94 EXISTINGVERSION of the package has not been installed
95 EXISTINGLOAD of the package has not been installed
96 pkgmap entries and contents entries are not consistent
97 CLASSES parameter not defined
System errors:
99 No more memory
100 ulimit error
101 Working directory cannot be identified
102 Pipe error
103 System run state cannot be determined
104 pkginfo error
105 uncompress error
106 Lock error
107 umount impossible
108 fseek() error
contents file errors:
110 Error opening the contents file
111 Incorrect entry in the contents file
112 Incorrect status of an entry in the contents file
113 Error writing to the contents file
Directory errors:
116 Cannot create directory
117 Cannot switch to directory
118 Cannot copy to directory
119 Cannot delete directory
120 Cannot create temporary file
Pyramid functions errors:
121 Error in pyrsavecp
122 Error in pyrcopyfiles
123 Error in pyrarm
If more than one package is installed, the return code applies to the
package installed last.
NOTES
When transferring a package to a spool directory, the -r, -n, and -a
options cannot be used.
The -r option can be used to indicate a directory name as well as a
filename. The directory can contain numerous response files, each
sharing the name of the package with which it should be associated.
This would be used, for example, when adding multiple interactive
packages with one invocation of pkgadd. Each package would need a
response file. If you create response files with the same name as the
package (i.e. package1 and package2), then name the directory in which
these files reside after the -r.
Page 3 Reliant UNIX 5.44 Printed 11/98
pkgadd(1M) pkgadd(1M)
The -n option will cause the installation to halt if any interaction
is needed to complete it.
Packages compressed using pkgmk -c are decompressed automatically.
SEE ALSO
pkginfo(1M), pkgmk(1M), pkgrm(1M).
Page 4 Reliant UNIX 5.44 Printed 11/98