cachefspack(1M)

NAME

     cachefspack - pack files and file systems in the cache

SYNOPSIS

     cachefspack [-h]  [-i  |  -p  |  -u]   [-f packing-list]  [-
     U cache-directory] [file...]

DESCRIPTION

     The cachefspack utility is used to set up and maintain files
     in  the cache. This utility affords greater control over the
     cache, ensuring that  the specified files  will  be  in  the
     cache whenever possible.

OPTIONS

     The following options are supported:

     -f packing-list
           Specify a file containing a list of files  and  direc-
           tories  to  be  packed.  Options within subdirectories
           and files can also be specified. The format and  rules
           governing  packing-list  are  described  on  the pack-
           ingrules(4) manual page. Directories are packed recur-
           sively.  Symlinks that match a regular expression on a
           LIST command are followed.  Symlinks encountered while
           recursively processing directories are not followed.

     -h    Help.  Print a brief summary of all the options.

     -i    View information about the packed files.

     -p    Pack the file or files specified by file. This is  the
           default behavior.

     -u    Unpack the file or files specified by file.

     -U cache-directory
           Unpack all files in the specified cache directory.

OPERANDS

     The following operands are supported:

     file  A path name of a file to be packed or unpacked.

USAGE

     See largefile(5) for the  description  of  the  behavior  of
     cachefspack when encountering files greater than or equal to
     2 Gbyte ( 2**31 bytes).

EXAMPLES

     Example 1: The following example packs the file  projects in
     the cache.

     % cachefspack -p projects

     Example 2: The following example packs the  files  projects,
     updates, and master_plan in the cache.

     % cachefspack -p projects updates master_plan

     Example 3: The following example unpacks the  file  projects
     from the cache.

     % cachefspack -u projects

     Example 4: The following example unpacks the files projects,
     updates, and master_plan from the cache.

     % cachefspack -u projects updates master_plan

     Example 5: The following example unpacks all  files  in  the
     cache directory cache1.

     % cachefspack -U /cache/cache1

     Example 6: The following example illustrates the  use  of  a
     packing list to specify files to be packed in the cache. The
     contents of lists.pkg are as follows:

     IGNORE SCCS BASE /src/junk LIST *.c LIST *.h

     This example will pack all files in the directory  /src/junk
     with  .c  and .h extensions that do not contained the string
     SCCS in  the file's path name.

     % cachefspack -f lists.pkg

EXIT STATUS

     0     Successful completion.

     >0    An error occurred.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

     cfsadmin(1M),  mount_cachefs(1M),  packingrules(4),   attri-
     butes(5), largefile(5)