NAME

mkpdf − create a Product Description File from an prototype PDF

SYNOPSIS

mkpdf [ −c comment_string ] [ −r alternate_root ] prototype_PDF new_PDF

DESCRIPTION

Mkpdf is a program that reads a prototype PDF and generates a new PDF (see pdf(4)) that reflects the current status of the file system files defined by pathnames in the prototype file.

If pathname is a directory, the version, checksum, size, and linked_to target fields are forced to be empty.  If the file is a device, the version, checksum, size, and linked_to fields are forced to be empty and the size field contains the major and minor device numbers.  If a pathname is prefaced with “?”, the file is assumed to be an optional file.  This file will be processed like all other files except that if the file does not exist, values provided in the prototype will be reproduced. 

If − is used for either the prototype_PDF or new_PDF, the command assumes that stdin and/or stdout is being used for the approprate value.

OPTIONS

−c comment_string A string that contains a comment about the product for which this PDF is being generated.  This is used as a second comment line of the PDF.  See pdf(4) for a description of the first comment line. If this option is not specified, no second comment line is produced.

−r alternate_root Alternate_root is a string that is prefixed to each pathname in the prototype (after removal of the optional ’?’) to form a modified pathname to be used to gather attributes for the entry. Default is NULL. 

EXAMPLES

Given a file "Proto" with contents:

/bin/basename
/bin/cat
/bin/cc
/bin/dirname
/bin/grep
/bin/ls
/bin/ll::::::::/bin/ls
/bin/su

The command:

mkpdf −c "fileset TEST, Release 1.0" Proto −

produces the PDF shown in the EXAMPLE section of pdf(4).

The following example creates a totally new PDF for the fileset UX_CORE.  The pathname and linked_to are taken from the prototype PDF.  All other fields are generated from the file system. 

mkpdf /tmp/UX_CORE /system/UX_CORE/new.pdf

The next example shows how to create a completely new PDF from just a list of files.  The PDF for the files under the PRODUCT directory is created by executing find(1) on all the files in the directory structure under /PRODUCT. A / is edited onto the beginning of each pathname to make it absolute.  The pathnames are then piped to mkpdf. The −r option specifies that a root of /PRODUCT should be prefixed to each pathname while the directory is being searched.  The − in the prototype PDF position specifies that stdin is being used for the prototype PDF file.  Note that with only a list of pathnames, the linked_to field of linked files will not conform to the convention explained in pdf(4).

cd /PRODUCT
find * −print | sed −e ’s:^:/:’ |
mkpdf −C −r /PRODUCT − PDF

WARNINGS

Sizes reported do not reflect blocks allocated to directories (including CDFs). 

AUTHOR

Mkpdf was developed by Hewlett-Packard Company. 

SEE ALSO

pdfck(1M), pdfdiff(1M), pdf(4). 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989