Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > P


HP-UX 11i Version 3: February 2007

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index


packingrules — packing rules file for cachefs


packingrules is a packing rules file for cachefspack. packingrules contains a list of directories and files that are to be packed. It also contains a list of directories and files that are to be specifically excluded from packing. See cachefspack(1M).

Many users choose to manually create the packing rules file and edit it by hand. Users can edit the packingrules (using any editor) to permanently change the packingrules file, or to gain access to more powerful options that are not available from the command line (such as the IGNORE command). It is much easier to enter complex wildcard expressions by editing the packingrules file.

Following is a description of the lines in a packing rules file. Blank lines and lines that begin with a pound sign (#) are ignored. Lines can be continued by placing a backslash (\) immediately before the newline character. All other lines in the packingrules file have one of the following formats:

BASE directory-1 [directory-2]

This line identifies a directory (or pair of directories) under which files should be packed. At least one directory name must be specified. The arguments must be fully qualified path names and may include environment variables.

LIST name ...

This line enumerates a list of files and subdirectories beneath the current BASE directory to be packed. This specification is recursive. That is, specifying the name of a directory automatically includes all files and subdirectories it contains.

IGNORE name ...

This line enumerates a list of files that are not to be packed. Regular expressions are permitted.

There are important differences between the arguments to the LIST and the IGNORE statements. The arguments to LIST statements can contain slashes and are interpreted as file names relative to the BASE directories. The arguments to IGNORE statements are simpler names or expressions that cannot contain slashes. An IGNORE statement will not override a LIST statement. IGNORE statements only exclude files that are found beneath listed directories.

If the first name argument to a LIST or an IGNORE statement begins with an exclamation point (!), the remainder of the statement will be executed as a command that will be run in the current BASE directory. The output of the command will be treated as a list of newline separated file names to be packed (LIST command) or to be excluded from the packing list (IGNORE command). For the LIST command, the resulting file names will be interpreted relative to the enclosing BASE directory.

Blanks can be embedded in an argument by escaping them with a backslash (\) or enclosing the argument in double quotes (` " '). Double quotes can be passed in arguments by escaping the double quotes with a backslash (\).

LIST lines only apply to the BASE statement that precedes them. IGNORE lines can appear before any BASE statement (in which case they apply to all BASEs) or after a BASE statement (in which case they only apply to the BASE that precedes them). Any number of these statements can occur in any combinations. The order is not important.


The use of these statements is illustrated in the following packing rules file.

# # Ignore junk files. # IGNORE core *.o *.bak *% # # Pack everything in the work subdirectory and in a few # favorite mailboxes. # BASE /net/bigserver/export/home/myname LIST work LIST m/incoming LIST m/action LIST m/pending # # Pack two important project directories but skip # all postscript output. # BASE /net/bigserver/export/projects $HOME/projects LIST poindexter epiphany IGNORE *.ps # # Pack the foonly package. # BASE /net/bigserver/opt/foonly /opt/foonly LIST !cat .packinglist # # Also pack the latest executables for the standard # build environment. # BASE /net/bigserver/export/buildenv $HOME/buildenv LIST !find . -type f -a -perm -111 -a -print


packingrules was developed by Sun Microsystems, Inc.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.