pkgmk - produce an installable package
pkgmk [-o] [-a arch] [-b base_src_dir] [-d device] [-
f prototype] [-l limit] [-p pstamp] [-r root_path] [-
v version] [variable=value...] [pkginst]
The pkgmk utility produces an installable package to be used
as input to the pkgadd(1M) command. The package contents
will be in directory structure format.
The command uses the package prototype(4) file as input and
creates a pkgmap(4) file. The contents for each entry in the
prototype file is copied to the appropriate output location.
Information concerning the contents (checksum, file size,
modification date) is computed and stored in the pkgmap
file, along with attribute information specified in the pro-
pkgmk searches for the files listed in the prototype(4) file
as described in the following conditions. Note: If a proto-
type file contains the explicit location of the file to
include in the package, then the following search explana-
tions do not apply.
1. If neither -b nor -r options are specified, the file name
component of each file path listed in the prototype(4)
file is expected to be found in the same directory as the
2. If -b is specified as a relative path (without a leading
"/"), then base_src_dir is prepended to the relative file
paths from the prototype(4) file. The resulting path is
searched for in the root_path directories. If a
root_path is not specified, it defaults to "/".
3. If -b is specified as an absolute path (with a leading
"/"), then base_src_dir is prepended to the relative
paths from the prototype(4) file and the result is the
location of the file. root_path is not searched.
4. If -r is specified, then full file paths are used from
the prototype(4) file. Relative paths have base_src_dir
prepended. If base_src_dir is not specified, it defaults
to "". The resulting path is searched for in each direc-
tory of the root_path.
If you created your prototype file using "pkgproto
a/relative/path" or "pkgproto a/relative/path=install/path",
then you should use the -r root_path option to specify the
location of a/relative/path so that pkgmk can correctly
locate your source files.
The following options are supported:
Overrides the architecture information provided in the
pkginfo(4) file with arch.
Prepends the indicated base_src_dir to locate relocat-
able objects on the source machine. Use this option to
search for all objects in the prototype file. pkgmk
expects to find the objects in /base_src_dir or to
locate the objects by use of the -b and -r options,
Creates the package on device. device can be an abso-
lute directory pathname or the identifiers for a
floppy disk or removable disk (for example,
/dev/diskette). The default device is the installation
spool directory (/var/spool/pkg).
Uses the file prototype as input to the command. The
default prototype filename is [Pp]rototype.
Specifies the maximum size in 512 byte blocks of the
output device as limit. By default, if the output file
is a directory or a mountable device, pkgmk will
employ the df(1M) command to dynamically calculate the
amount of available space on the output device. This
option is useful in conjunction with pkgtrans(1) to
create a package with a datastream format.
-o Overwrites the same instance; package instance will be
overwritten if it already exists.
Overrides the production stamp definition in the
pkginfo(4) file with pstamp.
Uses the indicated root_path with the source pathname
appended to locate objects on the source machine,
using a comma (,) as the separator for the path ele-
ments. If this option is specified, look for the full
destination path in each of the directories specified.
If neither -b nor -r is specified, look for the leaf
filename in the current directory.
Overrides the version information provided in the
pkginfo(4) file with version.
Places the indicated variable in the packaging
environment. (See prototype(4) for definitions of
The following operand is supported:
A package designation by its instance. An instance can
be the package abbreviation or a specific instance
(for example, inst.1 or inst.2). All instances of a
package can be requested by inst.*. The asterisk char-
acter (*) is a special character to some shells and
may need to be escaped. In the C-Shell, "*" must be
surrounded by single quotes (') or preceded by a
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
See attributes(5) for descriptions of the following attri-
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWcsu |
pkgparam(1), pkgproto(1), pkgtrans(1), uname(1), df(1M),
pkgadd(1M), pkginfo(4), pkgmap(4), prototype(4), attri-
Application Packaging Developer's Guide
Architecture information is provided on the command line
with the -a option or in the prototype(4) file. If no
architecture information is supplied, pkgmk uses the output
of uname -m (see uname(1)).
Version information is provided on the command line with the
-v option or in the pkginfo(4) file. If no version informa-
tion is supplied, a default based on the current date will
Command line definitions for both architecture and version
override the prototype(4) definitions.
Man(1) output converted with