forked from thkala/fuseflt
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
206 lines (129 loc) · 5.99 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
fuseflt - A FUSE filesystem with file conversion filter support
Contents:
1. Introduction
2. Platforms
3. Setup
3.1. Compilation
3.2. Installation
3.3. Configuration
3.3.1. Extension filter example
3.3.2. File conversion filter example
3.4. Running
4. Internals
5. License
6. Authors
1. Introduction
fuseflt is a FUSE filesystem that allows the user to define file conversion
filters that will be applied when requested. It relies on filename extensions
to determine file types.
2. Platforms
Currently only the following platforms are supported:
* Linux 2.6.x
It may work on other platforms with a FUSE port. You need the libcfg+ library,
which can be found at http://platon.sk/projects/libcfg+/.
3. Setup
3.1. Compilation
First of all you need the FUSE library and headers (http://fuse.sourceforge.net)
as well as the libcfg+ library (http://platon.sk/projects/libcfg+/). Afterwards,
a simple call to `make' is normally all you will need to compile fuseflt:
$ make
You can override the CFLAGS variable to provide optimisation flags e.t.c. The
DEBUG variable can be used to enable debugging - if you are using gcc, setting
DEBUG to "-g" would probably do.
3.2. Installation
First verify with `make -n install' the installation paths. By default, the
installation prefix is /usr/local and the fuseflt binary is installed in
$(prefix)/bin. You can set the prefix and bindir variables to override these
defaults. Then run `make install' as root to perform the actual installation:
# make install
3.3. Configuration
The configuration resides in a plain text file, which is parsed using the
libcfg+ library. It contains variables in the following form:
<variable> = <value>
The supported variables are:
cache_chk_int: an integer that indicates the number of seconds to elapse before
each cache entry expiry check. It can be specified only once.
cache_max_age: an integer that indicates the maximum allowed age of a cache
entry in seconds, after which the entry is removed. It can be specified
only once.
cache_max_nr: an integer that indicates the maximum number of cache entries.
Since each cache entry contains an open file descriptor, setting this
may be necessary to keep fuseflt from running out of file descriptors.
The cache tree will be pruned each time this limit is reached.
temp_dir: the directory where the temporary files will be created.
ghost_temp: By default fuseflt uses "ghost" temporary files, files that have
been created and then unlinked. While this method has the advantage of
not leaving files around, it does require an open file descriptor for
each temporary file. By setting ghost_temp to 0, the total usage of file
descriptors is much saner, but the temporary files become visible and if
fuseflt is killed abruptly (kill -9, segmentation faults, the end of the
universe as we know it e.t.c.) they will have to be removed manually.
ext_in: along with a corresponding ext_out variable, it creates a filename
filter, where filenames that end in the string supplied in ext_in will
be changed to end in the one supplied in ext_out instead. Both variables
are strings and can be left empty if needed. Each ext_in should have
_exactly_ one corresponding ext_out entry. Multiple ext_in/ext_out sets
can be used to specify multiple filename filters.
ext_out: see ext_in above.
flt_cmd: a filter shell command. It is parsed using /bin/sh -c, so mind your
quotation.
flt_in: the input file extension for this filter.
flt_out: the output file extension for this filter.
All three flt_* entries are required to set a file conversion filter. Multiple
flt_* sets can be used to create multiple filters.
3.3.1. Extension filter example
Suppose that you already have a filter that decompresses .gz files, and you want
to use it transparently. All you have to do is add the following to your fuseflt
configuration:
ext_in = .gz
ext_out =
Each *.gz file will have the .gz suffix removed and then the empty string added,
essentially stripping the .gz extension.
3.3.2. File conversion filter example
Suppose that you want to convert all bzip2-compressed files to gzip-compressed
ones. The following should do:
flt_in = .bz2
flt_out = .gz
flt_cmd = bzip2 -dc | gzip -9c
A usage example:
$ ls
a.bz2 b.bz2
$ zcat a.gz
A A A A A
$ zcat b.gz
B B B B B
You may add the following in your configuration:
ext_in = .bz2
ext_out = .gz
to be more transparent about the whole process:
$ ls
a.gz b.gz
3.4. Running
Please read the FUSE documentation before using fuseflt.
Run `fuseflt -h' to see the various command line options. You need a prepared
configuration file beforehand and an existing mountpoint. Then all you have to
do in most cases is:
$ fuseflt file.conf source_directory/ mountpoint/
If you want to use fuseflt from /etc/fstab, a different syntax can be used. The
following example shows its use:
fuseflt##/etc/fuseflt.doc.conf##/usr/share/doc /fs/vfs/doc fuse defaults 0 0
To allow this, fuseflt supports an alternative command line syntax:
$ fuseflt '#file.conf##source_directory/' mountpoint/
If you do use fuseflt in your /etc/fstab, you will probably want to add the
allow_other and default_permissions options. The first option allows non-root
users to access fuseflt, while the second one activates the in-kernel permission
checking, since fuseflt does no access control on its own.
WARNING: _NEVER_ USE allow_other WITHOUT default_permissions, OR YOU RISK
ALLOWING UNPRIVILEDGED PROCESSES TO ACCESS FILES THEY SHOULD NOT BE ABLE TO.
Should you need to discard the file cache (e.g. when the source filesystem has
been altered, or if you want to free the open file descriptors), you can send
the USR1 signal to fuseflt to do so.
4. Internals
Some people say the most accurate documentation is the source code itself, no?
5. License
fuseflt is released under the GNU General Public License version 2. The full
text of the license can be found in the COPYING file that should be included in
the fuseflt distribution.
6. Authors
Original author:
Theodoros V. Kalamatianos <[email protected]>