1cachefspack(1M) System Administration Commands cachefspack(1M)
2
3
4
6 cachefspack - pack files and file systems in the cache
7
9 cachefspack [-h] [-i | -p | -u] [-f packing-list]
10 [-U cache-directory] [file]...
11
12
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
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
55 The following operands are supported:
56
57 file A path name of a file to be packed or unpacked.
58
59
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
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
143 0 Successful completion.
144
145
146 >0 An error occurred.
147
148
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
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)