Commands Reference, Volume 1

adepackage command

Purpose

Creates an install image in bff (backup format file) or tar format.

Syntax

adepackage -s Ship_Path1:Ship_Path2:... -l LppName -f Output_Device -i Inslist [ -b Blocksize ] [ -F FileName ] [ -t ] [ -D ] [ -L ] [ -U V.R.M.F. ] [ -Y ]

Description

The adepackage command reads the Inslist file specified with the -i flag and produces an install image in the location specified by the -f flag. The default format of the install image is backup format. The -t flag overrides the default and produces a tar image.

adepackage searches for the files from the Inslist in consecutive order, first in the current directory and then in the ship trees. The first occurrence of a file in the ship tree list is backed up. adepackage looks for the Lpp_Name file in the current directory. It also looks for liblpp.a in the current directory unless the -D flag is specified.

Input Files

inslist

Required input file containing a list of file names as they should be found on the customer's system. The format of an Inslist file entry is:

type uid gid mode       fileName

For example:

F 2 2 555       /usr/bin/grep

The format of a symlink entry in the Inslist is:

type uid gid mode   linkName targetFile

For example:

S 2 2 777       /usr/bin/fgrep /usr/bin/grep

Hard link entries should immediately follow the Inslist entry of their target file. Hard links are considered attributes of the target file in the inventory database because they share the same inode as the target file. An example of an inslist entry with hard links is:

F 2 2 555 /usr/bin/awk 
H 2 2 555 /usr/bin/nawk /usr/bin/awk

firstFile

This file is specified with the -F flag and contains a list of filenames that should be included on the media first. These files are backed up before the lpp_name file and liblpp.a.

The format of this file is one file name per line. Comments should be denoted by a # in the first character of the line and are ignored. For example:

 
# Comments 
# 
# 
/bosinst.data 
/image.data

Flags

-s Ship_Path1:Ship_Path2:	Specifies the path(s) to the ship trees. Multiple paths are supported and must be separated by a colon (:), similar to the PATH environment variable.
-l LppName	Specifies the name of the package to be processed.
-i Inslist	Specifies the name of the Inslist file.
-f Output_Device	Specifies the location of the install image. This value can be a file name or a device name (/dev/rmt0)
-b Blocksize	Overrides the default blocksize of 10240. The value of the blocksize parameter may be one of the following: integerb Specifies that the positive integer argument be multiplied by 512 to determine the blocksize. integerk Specifies that the positive integer argument be multiplied by 1024 to determine the blocksize. integerm Specifies that the positive integer argument be multiplied by 1024*1024 to determine the blocksize. int+int Specifies that the blocksize should be determined by adding the 2 positive integers. Note: The m, k, and b conversion cannot be applied to the addition expression. This format is consistent with the pax command.
-F FileName	Specifies the name of a file containing a list of one or more files which should be placed first on the output image, before the Lpp_Name file and the liblpp.a file.
-t	Specifies that the output image should be in tar format.
-D	Specifies that adepackage is to process shared data. If this flag is specified, adepackage obtains the liblpp.a file from the data subdirectory (relative to the current directory). The liblpp.a file will be backed up in the /usr/share/lpp/<lppname> directory, where the LppName is specified with the -l flag.
-L	Specifies that the hardlinks and symlinks should be backed up onto the output media. Generally links are not shipped on the media. The sysck command creates links from the inventory information during the install process.
-U V.R.M.F	Indicates that this bff is for an update image and not for an install image. The V.R.M.F (version, release, modification and fix level) argument is used to calculate the inst_root directory for the install as follows: /usr/lpp/LppName/option/inst_v.r.m.f./inst_root where the LppName is specified with the -l flag.
-Y	Indicates that adepackage should not fatally exit if one or more of the files from the Inslist are not found in the ship trees. If this flag is specified, then missing files are ignored and adepackage continues to back up any file it is able to find in the ship trees. This flag is intended for development purposes only and should not be used for product level packages.

Exit Status

Warning messages may be displayed during execution of adepackage, but do not cause a non-zero return code. In the event of a fatal error, a message is displayed and adepackage exits with a non-zero return code.

Examples

To generate a backup image with a blocksize of 1024 blocks, where a block is 512 bytes. The output device is /dev/rmt0 and the Inslist file is bos.net.tcp.server.il. The ship trees are/project/ship1:/project/ship2. Type:
```
adepackage -b 1024b -i /project/src/bos.net.tcp.server.il -f /dev/rmt0 -s \
/project/ship1:/project/ship2 -l bos_net.tcp.server
```

To generate a tar image in /selfix/tmp/tar.image and a blocksize of (512+256=768) bytes, type:

adepackage -b 512+256 -i /project/src/bos.net.tcp.server.il -f \
/selfix/tmp/tar.image -t -l bos_net.tcp.server -s /project/ship1:/project/ship2