Reference › Packager and Installer Commands › pifproto - Create a Prototype File for a PIF Product

pifproto - Create a Prototype File for a PIF Product

The pifproto command creates a prototype file that describes the PIF product. The prototype file is used by the pifmk command to generate a PIF product. The prototype file is created in the current working directory. The name of the prototype file is:

prodname.platform.@prm

You can specify that the PIF product should be created immediately after the run of the pifproto command, or later. For individual configurations, you can modify the prototype file manually.

Note: A temporary subdirectory .pif* is created during the execution of the pifproto command. If the command is successfully terminated, this subdirectory will be automatically deleted. If the command fails, the subdirectory remains in the directory tree.

This command has the following format:

pifproto ­d proddir  ­a platform  ­n prodname  ­v version  ­b basedir

[­c comment] [­s vendorname] [­B buildID]
[­I preinstallprocedure]
[­i postinstallprocedure]
[­r preuninstallprocedure]
[­R postuninstallprocedure]
[­T template]
[­p  |  ­S]
[­o]

-d proddir

Specifies the name of the destination directory, where the item is stored. The current working directory must be outside of the specified proddir.

-a platform

Specifies the name of the operating system platform of the target computer where the PIF product shall be installed.

-n prodname

Specifies the name of the PIF product to package. Product names that differ by lowercase and uppercase letters cause different PIF products.

-v version

Specifies the version of the PIF product to create.

-b basedir

Specifies the directory where the PIF product should be relatively installed, for example, /usr/bin, or a variable name, for example, $SDPATH.

-c comment

Specifies a product-specific comment.

-s vendorname

Identifies the product supplier or product vendor.

-B buildID

Specifies the build, where buildID can consist of a maximum of 1024 alphanumeric characters, but must not contain any control characters like carriage return (CR) and line feed (LF).

-I preinstallprocedure

Specifies the shell script or executable file, which is called before the PIF product has been installed.

-i postinstallprocedure

Specifies the shell script or executable file, which is called after the PIF product has been installed.

-r preuninstallprocedure

Specifies the shell script or executable file, which is called before the PIF product is removed.

-R postuninstallprocedure

Specifies the shell script or executable file, which is called after the PIF product is removed.

-T template

Specifies a template used as a framework for the creation of an individual product setup. A template is formatted as a prototype file.

-p

Specifies that the PIF product is automatically created after the run of the pifproto command by internally executing the pifmk command. Symbols of binary files are discarded automatically.

-S

Specifies that a self-installing PIF product is automatically created after the run of the pifproto command by internally executing the pifmk and pifself commands.

-o

Specifies overwrite. If an item with the same name already exists in the destination directory, it is overwritten.

Exit status:

Displays the status of the command execution. The value zero (0) means OK, any non-zero value indicates Error.

Example: Create a prototype file

The following command creates a prototype file named test-pif.AIX.@prm, which contains the files located under the /home/bin directory.

pifproto -a AIX -d /home/bin -b /usr/bin -v 1.0.0.0 -n test-pif