]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
fallocate: introduce an option -c to support COLLAPSE_RANGE
authorDongsu Park <dongsu.park@profitbricks.com>
Thu, 27 Feb 2014 10:35:07 +0000 (11:35 +0100)
committerKarel Zak <kzak@redhat.com>
Fri, 18 Apr 2014 10:49:39 +0000 (12:49 +0200)
Introduce a new option -c (or --collapse-range) to support a new flag
FALLOC_FL_COLLAPSE_RANGE for fallocate(2). It will nullify a particular
range [offset, offset+len] by shifting extents beyond the range to the
beginning of the hole.

Cc: Lukas Czerner <lczerner@redhat.com>
Cc: Namjae Jeon <namjae.jeon@samsung.com>
Cc: Ashish Sangwan <a.sangwan@samsung.com>
Signed-off-by: Dongsu Park <dongsu.park@profitbricks.com>
sys-utils/fallocate.1
sys-utils/fallocate.c

index 8a3aa4fbe8e2c628a8e31a1959772f7333376c23..634c595b40de4fcd79573b013dbc479920d8403a 100644 (file)
@@ -6,6 +6,7 @@ fallocate \- preallocate or deallocate space to a file
 .B fallocate
 .RB [ \-n ]
 .RB [ \-p ]
+.RB [ \-c ]
 .RB [ \-o
 .IR offset ]
 .B \-l
@@ -54,6 +55,12 @@ implied.
 .IP
 You can think of this as doing a "\fBcp --sparse\fP" and
 renaming the dest file as the original, without the need for extra disk space.
+.IP "\fB\-c, \-\-collapse-range\fP"
+Collapse a particular file range to nullify the hole. Extents beyond the range
+[offset, offset+length] will be shifted to the beginning of hole. Hence this
+command does not leave a hole, while \fI\-\-punch-hole\fP leaves a hole
+instead of shifting extents. Both offset and length should be aligned to
+the block size of filesystem.
 .IP "\fB\-o, \-\-offset\fP \fIoffset\fP
 Specifies the beginning offset of the allocation, in bytes.
 .IP "\fB\-l, \-\-length\fP \fIlength\fP
index d8a74bf9181f2046e558bd10b385d488d3f8fb6a..f9c00e0060a0f1b605c6663fd3089a935f7e8699 100644 (file)
@@ -39,7 +39,8 @@
 #endif
 
 #if defined(HAVE_LINUX_FALLOC_H) && \
-    (!defined(FALLOC_FL_KEEP_SIZE) || !defined(FALLOC_FL_PUNCH_HOLE))
+    (!defined(FALLOC_FL_KEEP_SIZE) || !defined(FALLOC_FL_PUNCH_HOLE) || \
+     !defined(FALLOC_FL_COLLAPSE_RANGE))
 # include <linux/falloc.h>     /* non-libc fallback for FALLOC_FL_* flags */
 #endif
 
 # define FALLOC_FL_PUNCH_HOLE 2
 #endif
 
+#ifndef FALLOC_FL_COLLAPSE_RANGE
+# define FALLOC_FL_COLLAPSE_RANGE 8
+#endif
+
 #include "nls.h"
 #include "strutils.h"
 #include "c.h"
@@ -66,12 +71,13 @@ static void __attribute__((__noreturn__)) usage(FILE *out)
        fprintf(out,
              _(" %s [options] <filename>\n"), program_invocation_short_name);
        fputs(USAGE_OPTIONS, out);
-       fputs(_(" -d, --dig-holes     detect and dig holes\n"), out);
-       fputs(_(" -l, --length <num>  length of the (de)allocation, in bytes\n"), out);
-       fputs(_(" -n, --keep-size     don't modify the length of the file\n"), out);
-       fputs(_(" -o, --offset <num>  offset of the (de)allocation, in bytes\n"), out);
-       fputs(_(" -p, --punch-hole    punch holes in the file\n"), out);
-       fputs(_(" -v, --verbose       verbose mode\n"), out);
+       fputs(_(" -c, --collapse-range collapse space in the file\n"), out);
+       fputs(_(" -d, --dig-holes      detect and dig holes\n"), out);
+       fputs(_(" -l, --length <num>   length of the (de)allocation, in bytes\n"), out);
+       fputs(_(" -n, --keep-size      don't modify the length of the file\n"), out);
+       fputs(_(" -o, --offset <num>   offset of the (de)allocation, in bytes\n"), out);
+       fputs(_(" -p, --punch-hole     punch holes in the file\n"), out);
+       fputs(_(" -v, --verbose        verbose mode\n"), out);
 
        fputs(USAGE_SEPARATOR, out);
        fputs(USAGE_HELP, out);
@@ -258,15 +264,16 @@ int main(int argc, char **argv)
        loff_t  offset = 0;
 
        static const struct option longopts[] = {
-           { "help",       0, 0, 'h' },
-           { "version",    0, 0, 'V' },
-           { "keep-size",  0, 0, 'n' },
-           { "punch-hole", 0, 0, 'p' },
-           { "dig-holes",  0, 0, 'd' },
-           { "offset",     1, 0, 'o' },
-           { "length",     1, 0, 'l' },
-           { "verbose",    0, 0, 'v' },
-           { NULL,         0, 0, 0 }
+           { "help",           0, 0, 'h' },
+           { "version",        0, 0, 'V' },
+           { "keep-size",      0, 0, 'n' },
+           { "punch-hole",     0, 0, 'p' },
+           { "collapse-range", 0, 0, 'c' },
+           { "dig-holes",      0, 0, 'd' },
+           { "offset",         1, 0, 'o' },
+           { "length",         1, 0, 'l' },
+           { "verbose",        0, 0, 'v' },
+           { NULL,             0, 0, 0 }
        };
 
        setlocale(LC_ALL, "");
@@ -274,7 +281,8 @@ int main(int argc, char **argv)
        textdomain(PACKAGE);
        atexit(close_stdout);
 
-       while ((c = getopt_long(argc, argv, "hvVnpdl:o:", longopts, NULL)) != -1) {
+       while ((c = getopt_long(argc, argv, "hvVncpdl:o:", longopts, NULL))
+                       != -1) {
                switch(c) {
                case 'h':
                        usage(stdout);
@@ -282,6 +290,9 @@ int main(int argc, char **argv)
                case 'V':
                        printf(UTIL_LINUX_VERSION);
                        return EXIT_SUCCESS;
+               case 'c':
+                       mode |= FALLOC_FL_COLLAPSE_RANGE;
+                       break;
                case 'p':
                        mode |= FALLOC_FL_PUNCH_HOLE;
                        /* fall through */