1cachefspack(1M)         System Administration Commands         cachefspack(1M)
2
3
4

NAME

6       cachefspack - pack files and file systems in the cache
7

SYNOPSIS

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

DESCRIPTION

14       The  cachefspack  utility  is  used to set up and maintain files in the
15       cache. This utility affords greater control over  the  cache,  ensuring
16       that the specified files are in the cache whenever possible.
17
18
19       cachefspack  does  not  pack  files when the backfileystem type for the
20       cachefs mount is NFSv4. This is because only  pass-through  support  is
21       available for cachefs with NFSv4.
22

OPTIONS

24       The following options are supported:
25
26       -f packing-list       Specify  a  file  containing  a list of files and
27                             directories to be packed. Options  within  subdi‐
28                             rectories  and  files  can also be specified. The
29                             format  and  rules  governing  packing-list   are
30                             described  on  the  packingrules(4)  manual page.
31                             Directories are packed recursively. Symlinks that
32                             match  a regular expression on a LIST command are
33                             followed. Symlinks encountered while  recursively
34                             processing directories are not followed.
35
36
37       -h                    Help. Print a brief summary of all the options.
38
39
40       -i                    View information about the packed files.
41
42
43       -p                    Pack the file or files specified by file. This is
44                             the default behavior.
45
46
47       -u                    Unpack the file or files specified by file.
48
49
50       -U cache-directory    Unpack all files in the  specified  cache  direc‐
51                             tory.
52
53

OPERANDS

55       The following operands are supported:
56
57       file    A path name of a file to be packed or unpacked.
58
59

USAGE

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

EXAMPLES

65       Example 1 Packing a File in the Cache
66
67
68       The following example packs the file projects in the cache:
69
70
71         % cachefspack -p projects
72
73
74
75       Example 2 Packint Files in the Cache
76
77
78       The following example packs  the  files  projects,  updates,  and  mas‐
79       ter_plan in the cache:
80
81
82         % cachefspack -p projects updates master_plan
83
84
85
86       Example 3 Unpacking a File From the Cache
87
88
89       The following example unpacks the file projects from the cache:
90
91
92         % cachefspack -u projects
93
94
95
96       Example 4 Unpacking Files From the Cache
97
98
99       The  following  example  unpacks  the files projects, updates, and mas‐
100       ter_plan from the cache:
101
102
103         % cachefspack -u projects updates master_plan
104
105
106
107       Example 5 Unpacking All Files From in a Cache Directory
108
109
110       The following example unpacks all files in the cache directory cache1:
111
112
113         % cachefspack -U /cache/cache1
114
115
116
117       Example 6 Using a Packing List
118
119
120       The following example illustrates the use of a packing list to  specify
121       files to be packed in the cache.
122
123
124
125       The contents of lists.pkg are as follows:
126
127
128         IGNORE SCCS BASE /src/junk LIST *.c LIST *.h
129
130
131
132
133       The  following command packs all files in the /src/junk directory which
134       have .c and .h extensions, and do contain the string SCCS in the file's
135       path name:
136
137
138         % cachefspack -f lists.pkg
139
140
141

EXIT STATUS

143       0     Successful completion.
144
145
146       >0    An error occurred.
147
148

ATTRIBUTES

150       See attributes(5) for descriptions of the following attributes:
151
152
153
154
155       ┌─────────────────────────────┬─────────────────────────────┐
156       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
157       ├─────────────────────────────┼─────────────────────────────┤
158       │Availability                 │SUNWcsu                      │
159       └─────────────────────────────┴─────────────────────────────┘
160

SEE ALSO

162       cfsadmin(1M), mount_cachefs(1M), packingrules(4), attributes(5), large‐
163       file(5)
164
165
166
167SunOS 5.11                        18 Mar 2004                  cachefspack(1M)
Impressum