summaryrefslogtreecommitdiffstats
path: root/sys-utils/fallocate.1
Commit message (Collapse)AuthorAgeFilesLines
* fallocate: add man page note about --collapse-range granularityKarel Zak2018-07-031-0/+6
| | | | | Reported-by: Radka Skvarilova <rskvaril@redhat.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* sys-utils/fallocate.1: Some tidying of the manualBjarni Ingi Gislason2018-04-061-53/+98
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Test nr. 2: Enable and fix warnings from 'test-groff'. Input file is /tmp/fallocate.1 <fallocate.1>:10 (macro IR): only 1 argument, but more are expected <fallocate.1>:24 (macro RB): only 1 argument, but more are expected <fallocate.1>:25 (macro IR): only 1 argument, but more are expected chk_manuals: Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z and Test nr. 15: Change the name of a macro for two fonts (e.g., BR and IR) to one letter, if there is only one argument. Add the second argument if needed. It is sometimes part of the first one. 10:.IR length 24:.RB \-l 25:.IR length ##### Test nr. 12: Change -- in x--y to \(em (em-dash), or, if an option, to \-\- 65:You can think of this option as doing a "\fBcp --sparse\fP" and then renaming ##### Test nr. 20: Use a macro to change to the italic font, instead of \fI [1], if possible. The macros have the italic corrections, but "\c" removes them. [1] man-pages(7) 39:The \fIlength\fR and \fIoffset\fR 50:to be collapsed starts at \fIoffset\fP and continues 51:for \fIlength\fR bytes. At the completion of the operation, the contents of 52:the file starting at the location \fIoffset\fR+\fIlength\fR will be appended at the 53:location \fIoffset\fR, and the file will be \fIlength\fR bytes smaller. The option 71:Insert a hole of \fIlength\fR bytes from \fIoffset\fR, shifting existing data. 85:\fIoffset\fP and continuing for \fIlength\fR bytes. Within the 103:Zeroes space in the byte range starting at \fIoffset\fP and 104:continuing for \fIlength\fR bytes. Within the specified range, blocks are ##### Test nr. 27: Split lines longer than 80 characters into two or more lines. Apropriate break points are the end of a sentence and a subordinate clause. fallocate.1: line 45 length 86 fallocate.1: line 52 length 83 fallocate.1: line 53 length 83 fallocate.1: line 100 length 95 ##### Test nr. 28: Wrong distance between sentences or protect the indicator. 1) Separate the sentences and subordinate clauses; each begins on a new line. See man-pages(7) and "info groff". Or 2) Adjust space between sentences (two spaces), 3) or protect the indicator by adding "\&" after it. The "indicator" is an "end-of-sentence character" (.!?). 99:Enable POSIX operation mode. In that mode allocation operation always completes, ##### Test nr. 37: Have a space after a comma in an argument to an alternating fonts macro. The space belongs to the comma, so ', '. 48:.BR \-c , " \-\-collapse\-range" 58:.BR \-d , " \-\-dig\-holes" 70:.BR \-i , " \-\-insert\-range" 73:.BR \-l , " \-\-length " \fIlength 76:.BR \-n , " \-\-keep\-size" 80:.BR \-o , " \-\-offset " \fIoffset 83:.BR \-p , " \-\-punch\-hole" 95:.BR \-v , " \-\-verbose" 98:.BR \-x , " \-\-posix" 102:.BR \-z , " \-\-zero\-range" 119:.BR \-V , " \-\-version" 122:.BR \-h , " \-\-help" ##### Test nr. 38: Email addresses use the macro ".MT" and end with ".ME". 125:.UR sandeen@redhat.com 129:.UR kzak@redhat.com ##### Test nr. 40: Add a comma before "and", "or", or "nor" if a series contains three or more words 41:MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the "iB" is 43:KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB and YB. 45:The options \fB\-\-collapse\-range\fP, \fB\-\-dig\-holes\fP, \fB\-\-punch\-hole\fP and ##### Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
* fallocate: Added posix_fallocate() support.Denis Chaplygin2017-01-311-0/+11
| | | | | | | No all filesystems support Linux fallocate. The new option allow use posix implementation if necessary. Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: replace FTP by HTTPS in kernel.org URLsSébastien Helleu2016-12-191-1/+1
| | | | | | | The links to ftp://ftp.kernel.org/ are replaced by https://www.kernel.org/. Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: add insert range supportFabian Frederick2016-12-021-0/+3
| | | | | | | | | | | | Based on patch 83cc932d7412 ("fallocate: introduce an option -c to support COLLAPSE_RANGE") This patch includes FALLOC_FL_INSERT_RANGE flag added to Linux kernel v4.1 Thanks to Pádraig Brady for insert range definition Signed-off-by: Fabian Frederick <fabf@skynet.be>
* Place SEE ALSO entries in orderMichael Kerrisk (man-pages)2016-11-291-2/+2
| | | | | | | | | | | | This patch does only the following: * Order SEE ALSO entries first by section name, then alphabetically within section * Adds one or two missing commas in SEE ALSO lists * Removes one or two periods that were (inconsistently) used at the end of SEE ALSO lists. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* docs: miscellaneous tiny tweaks of man pagesBenno Schulenberg2016-03-171-2/+2
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* fallocate: improve synopsis and spelling in man pageBenno Schulenberg2016-03-141-6/+4Star
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* fallocate: restore man-page content that was deleted in commit 5b033bfdBenno Schulenberg2016-03-141-0/+120
| | | | | Reported-by: Andreas Henriksson <andreas@fatal.se> Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* chrt: make man page more structuredKarel Zak2016-01-201-120/+0Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: restore minus symbols in long optsJ William Piggott2015-01-211-11/+11
| | | | Signed-off-by: J William Piggott <elseifthen@gmx.com>
* docs: remove obsolete and unneeded comments from man-page filesBenno Schulenberg2015-01-121-1/+0Star
| | | | | | | Transform some of them into copyright lines. Also fix three header lines and snip some trailing whitespace. Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* docs: fix some things that were overlooked during the first passBenno Schulenberg2014-07-281-48/+56
| | | | | | | Mainly more option sorting, some formatting adjustments, and the adding of a missing --version here and there. Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* fallocate: use err_exclusive_options(), cleanup getopt_long() stuffKarel Zak2014-06-261-3/+7
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: make man page readable for humansKarel Zak2014-06-261-28/+41
| | | | | | | | Well, let's copy & past from fallocate(2) syscall man page rather than try to be creative with another description for the flags. Reported-by: Bernhard Voelker <mail@bernhard-voelker.de> Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: add FALLOC_FL_ZERO_RANGE supportLukas Czerner2014-04-181-0/+14
| | | | | | | | Recent Linux kernel supports FALLOC_FL_ZERO_RANGE in fallocate(2). This patch adds FALLOC_FL_ZERO_RANGE support to fallocate utility, by introducing a new option -z|--zero-range. Signed-off-by: Lukas Czerner <lczerner@redhat.com>
* fallocate: introduce an option -c to support COLLAPSE_RANGEDongsu Park2014-04-181-0/+7
| | | | | | | | | | | | 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>
* fallocate: fix man page synopsisKarel Zak2014-02-171-0/+2
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: improve --dig-holesKarel Zak2014-02-171-7/+6Star
| | | | | | | | | * don't use --length to specify hole size, always use stat.st_blksize * use --offset and --length to specify offset within the file (like another fallocate operations) Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: add --verbose, clean up usage()Karel Zak2014-02-141-0/+2
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: Add "--dig-holes" optionRodrigo Campos2014-02-141-1/+18
| | | | | | | | | | This option tries to detect chunk of '\0's and punch a hole, making the file sparse in-place. [kzak@redhat.com: - fix coding style, use xalloc.h and err.h] Signed-off-by: Rodrigo Campos <rodrigo@sdfg.com.ar> Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: Clarify that space can also be deallocatedRodrigo Campos2014-02-141-5/+6
| | | | | | | The functionality is already there, with --punch-hole, but the text was for the preallocation case only. Signed-off-by: Rodrigo Campos <rodrigo@sdfg.com.ar>
* docs: standardize the phrases for --help and --version in all man pagesBenno Schulenberg2013-10-151-2/+2
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* docs: add TB to list of supported suffixesKarel Zak2013-03-181-1/+1
| | | | | Reported-by: Lukas Czerner <lczerner@redhat.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: clarify KiB vs. KB in man pagesBernhard Voelker2012-03-301-3/+4
| | | | | | | | | Update the man pages of blkid, wipefs, fallocate, fstrim, losetup and hexdump to clarify the suffixes for the numerical values of the offset and size/length arguments regarding KiB=1024 vs KB=1000. Also mention the ZiB/YiB and ZB/YB suffixes supported by strtosize(). Signed-off-by: Bernhard Voelker <mail@bernhard-voelker.de>
* fallocate: add FALLOC_FL_PUNCH_HOLE supportCong Wang2011-11-231-0/+3
| | | | | | | | | | | | | Recent Linux kernel supports FALLOC_FL_PUNCH_HOLE in fallocate(2). This patch adds FALLOC_FL_PUNCH_HOLE support to fallocate utility, by introducing a new option -p|--punch-hole. [kzak@redhat.com: - fix merge conflict in fallocate.1] Cc: Karel Zak <kzak@redhat.com> Cc: Eric Sandeen <sandeen@redhat.com> Signed-off-by: Cong Wang <xiyou.wangcong@gmail.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: align fallocate.1 with howto-man-page.txtSami Kerola2011-09-291-10/+16
| | | | | | Add also earlierly missing --version to the manual. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: uniformize the header and footer lines in man pagesBenno Schulenberg2011-08-221-2/+2
| | | | | | | | | | Use dates without the day, use the full month name, put "util-linux" in the lower left corner, and "User Commands" or "System Administration" at the top center. Also improve here and there the one-line program description. Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* rename util-linux-ng back to util-linuxKarel Zak2010-11-301-2/+2
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: support suffixes for --offset and --lenghtKarel Zak2010-03-301-4/+5
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* fallocate: new commandKarel Zak2009-09-221-0/+51
The fallocate(1) utility is used to preallocate blocks to a file. This can be useful for virtual images, database files, testing, etc. Normally we'd hope that various tools will start using preallocation internally, but until then such a utility may be useful, and could be scripted as well. The original Eric's version is available at: http://thread.gmane.org/gmane.linux.utilities.util-linux-ng/2490 This version: - checks for fallocate glibc function and kernel syscall - does not provide a fallback and does not call posix_fallocate() - adds long options - uses err.h for errro messages - adds NLS support - cleanups man page Co-Author: Eric Sandeen <sandeen@redhat.com> Signed-off-by: Eric Sandeen <sandeen@redhat.com> Signed-off-by: Karel Zak <kzak@redhat.com>
generated by cgit v1.2.3-55-g7522 (git 2.39.0) at 2024-05-15 22:31:36 +0200