mirror of
https://github.com/nilfs-dev/nilfs-utils.git
synced 2026-01-26 13:43:15 +00:00
An issue exists where scrapped segments generated during recovery of dsync blocks are incorrectly determined to be protected due to comparisons using invalid segment summary sequence numbers on disk. Segments that are incorrectly determined to be protected will not be reclaimed for a long period of time, occupying disk space unnecessarily. In addition, it may prevent nilfs-resize from shrinking the file system. Fix these issues by using segment usage information to determine whether a segment has been scrapped, in which case it is considered unprotected without comparing sequence numbers. Signed-off-by: Ryusuke Konishi <konishi.ryusuke@gmail.com>
* Required packages
- libuuid-devel or uuid-dev
- libmount-devel or libmount-dev
- libblkid-devel or libblkid-dev
- libselinux-devel or libselinux1-dev (*1)
*1: required only if supporting selinux context mount options without
using libmount. By default, libmount is used and support of the
context mount depends on the libmount that distro provides.
* How to compile
$ ./configure
$ make
If your system is a 64-bit architecture and libraries are installed
into /usr/lib64 instead of /usr/lib, change the library directory with
--libdir option:
$ ./configure --libdir=/usr/lib64
If /etc/mtab is not a symlink to /proc/self/mounts but a regular file
in the target system, run the configure script with --without-libmount
option:
$ ./configure --without-libmount
This configures the build environment so as to make legacy
mount/umount helpers (mount.nilfs2 and umount.nilfs2), in which the
legacy mtab file is handled properly. For CentOS 6 (and other RHEL 6
clones), for instance, this options is needed.
* Trouble shooting
If the blkid library in your environment is old and unusable to this
package, you can use --without-blkid option:
$ ./configure --without-blkid
However, use of this option is normally not recommended because it
disables the safety check of mkfs.nilfs2 which prevents users from
unexpectedly overwriting an in-use device.
You can compile legacy mount.nilfs2 and umount.nilfs2 without support
of selinux context mount options (-o context=<context>, etc):
$ ./configure --without-libmount --without-selinux
For helpers built with mount library (libmount), support of the
context mount depends on the libmount that distro provides.
* How to get development sources
$ cd your-work-directory
$ git clone https://github.com/nilfs-dev/nilfs-utils.git
Before compiling the development sources, you need to run autogen.sh
script. This is not required for packaged sources unless you changed
the configuration.
$ cd nilfs-utils
$ ./autogen.sh
* Developer's notes
The central resource for nilfs-utils development is the mailing list
(linux-nilfs@vger.kernel.org).
First, please read the following documents (in short, follow Linux
kernel development rules):
https://docs.kernel.org/process/coding-style.html
https://docs.kernel.org/process/submitting-patches.html
Then, check your patches with the patch style checker prior to
submission (scripts/checkpatch.pl) like the following example:
$ ./scripts/checkpatch.pl <patch-file>
...
<patch-file> has no obvious style problems and is ready for submission.
Description
Languages
C
76.2%
Perl
21.1%
M4
1.6%
Makefile
1%