Commands Reference, Volume 2

gen_toc_entry Command

Purpose

Generates a toc (table of contents) for a bff or tar PTF image.

Syntax

gen_toc_entry -r TarFile -b BffFile -t OutputTocFile [ -h ]

The gen_toc_entry command generates a toc file for a bff (backup format file) or tar update image. This command extracts the lpp_name file from the image, determines the toc format from the lpp_name file, and creates a toc in the appropriate format. If the format field of the lpp_name file is 4, the gen_toc_entry command creates a AIX Version 4 toc file. If the format field is 3, the gen_toc_entry command creates a AIX Version 3 toc file. Otherwise, the gen_toc_entry command creates a AIX 3.1 toc file.

Flags

-b BffFile	Specifies the location of the bff file.
-h	Generates help or usage information.
-r TarFile	Specifies the location of the tar file. Note: The ptfpkg command can only be used to generate backup format file PTFs. It does not generate tar images.
- t OutputTocFile	Specifies the location for the output toc file.

Note: The -b and -r flags are mutually exclusive.

Example

To generate a toc file for the bff image U493211.bff and place the output file in U493211.toc, type:

gen_toc_entry -b $TOP/UPDATE/$OPTION/U493211/U493211.bff -t U43211.toc

Input Files

bff file	The bff image for the PTF. This image is generated using either the Itanium-based backup command for AIX Version 3 or the adepackage command (without the -t flag) for AIX Version 4.
tar file	The tar image for the PTF. This image is generated using either the Itanium-based tar command for AIX Version 3 or the adepackage command with the -t flag for AIX Version 4.

Output File

toc

The output toc file is based on the format of the PTF. If the format field of the lpp_name file is type 3 (for AIX 3.2 PTF) or 4 (for AIX Version 4 PTF), the output toc is a copy of the lpp_name file from the PTF image. A AIX 3.1 type toc is generated for any other type of PTF.

Related Information

The adepackage command, backup command, ptfpkg command, tar command.