packingrules.4 (2010 09)

p
packingrules(4) packingrules(4)
NAME
packingrules - packing rules file for cachefs
DESCRIPTION
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 pack-
ingrules (using any editor) to permanently change the packingrules file, or to gain access to more power-
ful 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 per-
mitted.
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 direc-
tory. 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 argu-
ment 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 combina-
tions. The order is not important.
EXAMPLES
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
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1