File: README

package info (click to toggle)
fl-cow 0.6-4.2
  • links: PTS
  • area: main
  • in suites: bullseye, buster, jessie, jessie-kfreebsd, sid, stretch
  • size: 1,276 kB
  • ctags: 121
  • sloc: sh: 9,783; ansic: 278; makefile: 59
file content (57 lines) | stat: -rw-r--r-- 1,595 bytes parent folder | download | duplicates (3)
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
*
*  FL-COW by Davide Libenzi ( File Links Copy On Write )
*  Copyright (C) 2003  Davide Libenzi
*
*  This program is free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  This program is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  You should have received a copy of the GNU General Public License
*  along with this program; if not, write to the Free Software
*  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*
*  Davide Libenzi <davidel@xmailserver.org>
*

The preload library perform Copy On Write on files having hard links.
The environment variable FLCOW_PATH tells the library which paths are
allowed to be FL-COWed. For example :

FLCOW_PATH=/home/davide/arch-projects/:/home/davide/test-flcow/

Anything that is inside :

/home/davide/arch-projects/*

and inside /home/davide/test-flcow/*

will be FL-COWed if its st_nlink > 1. To have the library effective
you simply set your FLCOW_PATH :

export FLCOW_PATH=...

and you also set :

export LD_PRELOAD=$LD_PRELOAD:/usr/lib/libflcow.so

I usually export this in my developer shell. To test the library after
a build you can use :

$ LD_PRELOAD=./fl-cow/.libs/libflcow.so ./test/flcow-test

Or simply :

$ make check



Enjoy,
		Davide