NAME¶
nilfs-clean - run garbage collector on NILFS file system
SYNOPSIS¶
nilfs-clean [
options] [
device]
DESCRIPTION¶
The
nilfs-clean program communicates with
nilfs_cleanerd(8)
program and controls execution of garbage collection (GC) on NILFS2 file
systems. It can be used to manually run garbage collection of a file system
mounted on
device to increase the free space.
If a GC command is specified by one of the following options (i.e.
´-c´,´-s´,´-r´, and ´-l´ options), the
command is sent to and performed on the
nilfs_cleanerd(8) program. If
no commands are specified,
nilfs-clean just triggers a one-pass
cleaning.
When
device is ommitted,
nilfs-clean selects an active NILFS2 file
system in the system.
This command is valid only for mounted NILFS2 file systems, and will fail if the
device has no active mounts.
OPTIONS¶
- -b, --break, --stop
- Stop garbage collection.
- -c, --reload[=conffile]
- Request reloading config file to cleaner process. If an
optional configuration file is given, the file is read by
nilfs_cleanerd(8) program and cleaner configuration is reset to the
information. If no argument is given, a configuration file selected by
nilfs_cleanerd(8) will be reloaded.
- -l, --status
- Display cleaner status.
- -h, --help
- Display help message and exit.
- -p, --protection-period=interval
- Set protection period for a cleaner run. The
interval parameter is an integer value and specifies the minimum
time that deleted or overrode data will be preserved in the file system.
Smaller values will increase free space made by garbage collection.
Optionally, the interval parameter may be suffixed by one of the
following units designators: ´s´, ´m´, ´h´,
´d´,´w´,´M´, or ´Y´, for seconds,
minutes, hours, days, weeks, months, or years, respectively.
- -q, --quit
- Shutdown cleaner daemon.
- -r, --resume
- Resume garbage collection.
- -s, --suspend
- Suspend garbage collection. Note that if users manually
suspend garbage collection with this option, it will not restart
automatically until user resumes the garbage collection.
- -S, --speed=COUNT[/SECONDS]
- Set garbage collection speed for a cleaner run.
- -v, --verbose
- Verbose mode.
- -V, --version
- Display version and exit.
AUTHOR¶
Ryusuke Konishi <konishi.ryusuke@lab.ntt.co.jp>
AVAILABILITY¶
nilfs-clean is part of the nilfs-utils package and is available from
http://www.nilfs.org.
SEE ALSO¶
nilfs(8),
nilfs_cleanerd(8).