Commit | Line | Data |
---|---|---|
517c4acb KB |
1 | .\" Copyright (c) 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
bcca570a KB |
3 | .\" |
4 | .\" %sccs.include.redist.roff% | |
5 | .\" | |
653ba8b6 | 6 | .\" @(#)lfs_cleanerd.8 8.2 (Berkeley) %G% |
bcca570a KB |
7 | .\" |
8 | .Dd "" | |
9 | .Dt LFS_CLEANERD 8 | |
10 | .Os BSD 4.4 | |
11 | .Sh NAME | |
12 | .Nm lfs_cleanerd | |
13 | .Nd garbage collect a log-structured file system | |
14 | .Sh SYNOPSIS | |
15 | .Nm lfs_cleanerd | |
16 | .Op Fl ds | |
17 | .Pa node | |
18 | .Sh DESCRIPTION | |
19 | The | |
20 | .Nm lfs_cleanerd | |
21 | command starts a daemon process which garbage-collects | |
653ba8b6 | 22 | the log-structured file system residing at the point named by |
bcca570a KB |
23 | .Ar node |
24 | in the global file system namespace. | |
25 | This command is normally executed by | |
26 | .Xr mount_lfs 8 | |
27 | when the log-structured file system is mounted. | |
28 | The daemon will exit within a few minutes | |
29 | of when the file system it was cleaning is unmounted. | |
30 | .Pp | |
31 | Garbage collection on a log-structured file system is done by scanning | |
32 | the file system's segments for active, i.e. referenced, data and copying | |
33 | it to new segments. | |
34 | When all of the active data in a given segment has been copied to a new | |
35 | segment that segment can be marked as empty, thus reclaiming the space | |
36 | taken by the inactive data which was in it. | |
37 | .Pp | |
38 | The following options are available: | |
39 | .Bl -tag -width indent | |
40 | .It Fl d | |
41 | Run in debug mode. | |
42 | Do not become a daemon process, and print debugging information. | |
43 | .It Fl s | |
44 | When cleaning the file system, read data in small chunks. | |
45 | .El | |
46 | .Sh SEE ALSO | |
47 | .Xr mount_lfs 8 | |
48 | .Sh HISTORY | |
49 | The | |
50 | .Nm lfs_cleanerd | |
51 | utility first appeared in 4.4BSD. |