-
Notifications
You must be signed in to change notification settings - Fork 8
/
README
254 lines (194 loc) · 8.42 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
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
,ad8888ba, 88888888888 ad88888ba
d8"' `"8b 88 d8" "8b
d8' 88 Y8,
88 ,adPPYba, 8b,dPPYba, 8b d8 88aaaaa `Y8aaaaa,
88 a8" "8a 88P' "8a `8b d8' 88""""" `"""""8b,
Y8, 8b d8 88 d8 `8b d8' 88 `8b
Y8a. .a8P "8a, ,a8" 88b, ,a8" `8b,d8' 88 Y8a a8P
`"Y8888Y"' `"YbbdP"' 88`YbbdP"' Y88' 88 "Y88888P"
88 d8'
88 d8'
A copy-on-write, versionned filesystem
Version 1.3.1M
By
Nicolas Vigier
(boklm@mars-attacks.org)
and
Thomas Joubert
(widan@net-42.eu.org)
http://n0x.org/copyfs/
Contributions From:
Matthew Keller
CopyFS aims to solve a common problem : given a directory, especially one
full of configuration files, or other files that one can modify, and which
can affect the functionning of a system, or of programs, that may be important
to other users (or to the user himself), how to be sure that a person
modifying the files will do a backup of the working version first ?
This filesystem solves the problem by making the whole process transparent,
automatically keeping versionned copies of all the changes done to file under
its control.
It also allows a user to select an old version of the files, for example to
repair a mistake, and allows him/her to continue edition from this point.
CopyFS is distributed under the terms of the GNU GPL.
System requirements
-------------------
Filesystem in Userspace (FUSE) is required to use this filesystem. FUSE
was merged into the mainstream Linux kernel tree in kernel version 2.6.14,
so any version >= 2.6.14 should be fine, if the option was selected when
the kernel was compiled.
More informations about FUSE is available on http://fuse.sourceforge.net/
It might work on FreeBSD and OpenSolaris too, but we never tried yet.
How to install
--------------
Simply do :
copyfs-1.0 % ./configure
copyfs-1.0 % make all
copyfs-1.0 % su
Password:
copyfs-1.0 # make install
How to use
----------
To mount a CopyFS, you need to use the command 'copyfs-mount' : if you want to
mount a CopyFS at '/mnt/fs', whose version directory is at /var/versions, you
would use :
root # copyfs-mount /var/versions /mnt/fs
To unmount it, simply do :
root # umount /mnt/fs
As you would do for any filesystem.
Accessing old versions
----------------------
To know which versions are available, you can use the copyfs-fversion tool :
cpy-fs $ copyfs-fversion test
File test ('*' is active) :
v1.0 : -rw-r--r-- widan users 0 Fri Dec 10 14:17:47 2004
v2.0 : -rw-r--r-- widan users 21 Fri Dec 10 14:17:55 2004
v2.1 : -rwx------ widan users 21 Fri Dec 10 14:17:55 2004
v3.0 : -rwx------ widan users 29 Fri Dec 10 14:19:35 2004 [*]
You know there are 4 versions, with their associated information. In that state
you are viewing version 3.0 (ie the last one). If you want to see another one,
you can 'lock' it :
cpy-fs $ cat test
version 3.0
cpy-fs $ copyfs-fversion -l 2.0 test
cpy-fs $ cat test
version 2.0
If you want to remove the version lock, and return to the latest version
available, use :
cpy-fs $ copyfs-fversion -r test
Tagging files
-------------
Let's say you have the following file tree :
cpy-fs $ copyfs-fversion somedir/file-1
File file-1 ('*' is active) :
v1.0 : -rw-r--r-- widan users 3 Fri Dec 10 14:21:41 2004
v2.0 : -rw-r--r-- widan users 3 Fri Dec 10 14:21:43 2004 [*]
v3.0 : -rw-r--r-- widan users 3 Fri Dec 10 14:21:45 2004
cpy-fs $ copyfs-fversion somedir/file-2
File file-2 ('*' is active) :
v1.0 : -rw-r--r-- widan users 5 Fri Dec 10 14:21:51 2004 [*]
v2.0 : -rw-r--r-- widan users 5 Fri Dec 10 14:21:53 2004
cpy-fs $ copyfs-fversion somedir/file-3
File file-3 ('*' is active) :
v1.0 : -rw-r--r-- widan users 5 Fri Dec 10 14:21:58 2004
v2.0 : -rw-r--r-- widan users 5 Fri Dec 10 14:22:03 2004 [*]
You have :
cpy-fs $ cat somedir/file-1
v2
cpy-fs $ cat somedir/file-2
2 v1
cpy-fs $ cat somedir/file-3
3 v2
Suppose you want to save all the "current" versions for the directory
'somedir', you can create a tag file with :
cpy-fs $ copyfs-fversion -t tag-file somedir
Then you can edit the files as you want, and if you want to put all the files
back to the version they were at when you tagged them, simply do :
cpy-fs $ copyfs-fversion -u tag-file somedir
Example :
cpy-fs $ echo "new 1" > somedir/file-1
cpy-fs $ echo "new 2" > somedir/file-2
cpy-fs $ cat somedir/file-{1,2,3}
new 1
new 2
3 v2
cpy-fs $ copyfs-fversion -t tag-file-new somedir
cpy-fs $ copyfs-fversion -u tag-file somedir
Restored somedir/file-1 to version 2.0
Restored somedir/file-2 to version 1.0
Restored somedir/file-3 to version 2.0
cpy-fs $ cat somedir/file-{1,2,3}
v2
2 v1
3 v2
cpy-fs $ copyfs-fversion -u tag-file-new somedir
Restored somedir/file-1 to version 6.0
Restored somedir/file-2 to version 3.0
Restored somedir/file-3 to version 2.0
cpy-fs $ cat somedir/file-{1,2,3}
new 1
new 2
3 v2
Viewing the changes between version of text files
-------------------------------------------------
Example:
[workspace]$ echo "Hello world" > testfile
[workspace]$ echo "There's always room for JELLO" >> testfile
[workspace]$ copyfs-fversion testfile
File testfile ('*' is active) :
v1.0 : -rw-rw-r-- kellermg kellermg 12 Mon 13 Feb 2006 12:59:28 PM EST
v2.0 : -rw-rw-r-- kellermg kellermg 42 Mon 13 Feb 2006 12:59:55 PM EST [*]
[workspace]$ copyfs-fversion -d 1.0,2.0 testfile
2 -
2 + There's always room for JELLO
--------
[workspace]$ cat testfile
Hello world
There's always room for JELLO
We will balk if you try to diff a binary file:
[copyfs]$ copyfs-fversion -d 41.0,53.0 copyfs-daemon
I will not diff binary files
Searching (ala grep) for a pattern in all version of a text file
----------------------------------------------------------------
Example:
[workspace]$ echo "Hello world" > testfile
[workspace]$ echo "There's always room for JELLO" >> testfile
[workspace]$ echo "Thanks for all the fish" >> testfile
[workspace]$ echo "So long" >> testfile
[workspace]$ echo "Blah Blah Blah" >> testfile
[workspace]$ echo "Another fish" >> testfile
[workspace]$ copyfs-fversion -G fish testfile
Do not mess with this file... search in progress...
v3.0: Thanks for all the fish
v4.0: Thanks for all the fish
v5.0: Thanks for all the fish
v6.0: Thanks for all the fish
v6.0: Another fish
5 results.
You can also search for a regexp!:
[workspace]$ copyfs-fversion -G ^Blah testfile
Do not mess with this file... search in progress...
v5.0: Blah Blah Blah
v6.0: Blah Blah Blah
2 results.
Purging (Culling) old versions of files
---------------------------------------
Purging of folders not yet supported... maybe someday. The recursions necessary scares me.
Example:
[workspace]$ copyfs-fversion testfile
File testfile ('*' is active) :
v1.0 : -rw-rw-r-- kellermg kellermg 12 Mon 13 Feb 2006 12:59:28 PM EST
v2.0 : -rw-rw-r-- kellermg kellermg 42 Mon 13 Feb 2006 12:59:55 PM EST
v3.0 : -rw-rw-r-- kellermg kellermg 66 Mon 13 Feb 2006 01:03:24 PM EST
v4.0 : -rw-rw-r-- kellermg kellermg 74 Mon 13 Feb 2006 01:04:44 PM EST
v5.0 : -rw-rw-r-- kellermg kellermg 89 Mon 13 Feb 2006 01:04:56 PM EST
v6.0 : -rw-rw-r-- kellermg kellermg 102 Mon 13 Feb 2006 01:05:02 PM EST [*]
[workspace]$ copyfs-fversion -p 3 testfile
[workspace]$ copyfs-fversion testfile
File testfile ('*' is active) :
v4.0 : -rw-rw-r-- kellermg kellermg 74 Mon 13 Feb 2006 01:04:44 PM EST
v5.0 : -rw-rw-r-- kellermg kellermg 89 Mon 13 Feb 2006 01:04:56 PM EST
v6.0 : -rw-rw-r-- kellermg kellermg 102 Mon 13 Feb 2006 01:05:02 PM EST [*]
Or you can just kill the very existance of the file:
[workspace]$ copyfs-fversion -p A testfile
[workspace]$ copyfs-fversion testfile
fversion: testfile: No such file or directory