Manual Pages for UNIX Operating System command usage for man cachefspack

System Administration Commands                    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 are  in  the  cache
     whenever possible.


     cachefspack does not pack files when the backfileystem  type
     for  the  cachefs mount is NFSv4. This is because only pass-
     through support is available for cachefs with NFSv4.

OPTIONS
     The following options are supported:

     -f packing-list       Specify a file containing  a  list  of
                           files  and  directories  to be packed.
                           Options  within   subdirectories   and
                           files  can also be specified. The for-
                           mat and rules  governing  packing-list
                           are  described  on the packingrules(4)
                           manual page.  Directories  are  packed
                           recursively.  Symlinks  that  match  a
                           regular expression on a  LIST  command
                           are   followed.  Symlinks  encountered
                           while  recursively  processing  direc-
                           tories 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.





SunOS 5.11          Last change: 18 Mar 2004                    1






System Administration Commands                    cachefspack(1M)



     -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 Packing a File in the Cache


     The following example packs the file projects in the cache:


       % cachefspack -p projects



     Example 2 Packint Files in the Cache


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


       % cachefspack -p projects updates master_plan



     Example 3 Unpacking a File From the Cache


     The following example unpacks the  file  projects  from  the
     cache:


       % cachefspack -u projects



     Example 4 Unpacking Files From the Cache






SunOS 5.11          Last change: 18 Mar 2004                    2






System Administration Commands                    cachefspack(1M)



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


       % cachefspack -u projects updates master_plan



     Example 5 Unpacking All Files From in a Cache Directory


     The following example unpacks all files in the cache  direc-
     tory cache1:


       % cachefspack -U /cache/cache1



     Example 6 Using a Packing List


     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




     The following command  packs  all  files  in  the  /src/junk
     directory  which  have  .c and .h extensions, and do contain
     the string SCCS in the file's path name:


       % cachefspack -f lists.pkg



EXIT STATUS
     0     Successful completion.


     >0    An error occurred.






SunOS 5.11          Last change: 18 Mar 2004                    3






System Administration Commands                    cachefspack(1M)



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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


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







































SunOS 5.11          Last change: 18 Mar 2004                    4