Commit Graph

51 Commits

Author SHA1 Message Date
Michael Kerrisk 44e4132a32 fallocate.2: Minor tweaks to Lukas Czerner's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-05 14:44:58 +02:00
Lukas Czerner 7dc489e34e fallocate.2: Document FALLOC_FL_ZERO_RANGE
FALLOC_FL_ZERO_RANGE was added in Linux 3.14,
for zeroing ranges in the allocated space in a file.

Signed-off-by: Lukas Czerner <lczerner@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-05 14:44:58 +02:00
Michael Kerrisk ce430f41fe fallocate.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-30 20:04:22 +02:00
Simon Paillard 718778adf8 fallocate.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 05:03:52 +02:00
Michael Kerrisk 2af4d967af fallocate.2: Document EINVAL for FALLOC_FL_COLLAPSE_RANGE on non-regular file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-19 10:44:22 +02:00
Michael Kerrisk 1ecfa5b30e fallocate.2: Greatly expanded description of FALLOC_FL_COLLAPSE_RANGE
Reviewed-by: Christoph Hellwig <hch@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-18 17:38:41 +02:00
Michael Kerrisk f78da076c9 fallocate.2: Minor fixes to Namjae Jeon's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:51 +02:00
Namjae Jeon ea56dddf25 fallocate.2: Document FALLOC_FL_COLLAPSE_RANGE
Signed-off-by: Namjae Jeon <namjae.jeon@samsung.com>
Signed-off-by: Ashish Sangwan <a.sangwan@samsung.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:51 +02:00
Michael Kerrisk ddacd02601 fallocate.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 09:08:43 +01:00
Yuri Kozlov a36b732ee0 fallocate.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 09:07:59 +01:00
Michael Kerrisk add5f3b10b epoll_wait.2, fallocate.2, gets.3, core.5, man-pages.7, netdevice.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 12:05:49 +01:00
Michael Kerrisk 4999554322 fallocate.2: Note filesystems that support FALLOC_FL_PUNCH_HOLE operation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-22 12:45:26 +01:00
Michael Kerrisk 4d4cecd6fa fallocate.2: tfix + tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-11-08 06:43:46 +13:00
Christoph Hellwig c166fac5cb fallocate.2: Clarify the zeroing behavior
fallocate() zeroes only space that did not previously contain
data, but leaves existing data untouched.

Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-11-08 06:43:39 +13:00
Michael Kerrisk 9ee4a2b6ec intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 10:07:57 +02:00
Yuri Kozlov 276939a6b2 fallocate.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-06-12 15:00:52 +02:00
Michael Kerrisk 47a979088f fallocate.2: RETURN VALUE: mention that 'errno' is set on error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-04-19 14:18:59 +02:00
Michael Kerrisk 8ff7380d6f epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, fallocate.2, futex.2, getcpu.2, getitimer.2, ioctl_list.2, ioprio_set.2, migrate_pages.2, move_pages.2, pciconfig_read.2, sendfile.2, setns.2, signalfd.2, spu_create.2, spu_run.2, sysinfo.2, timerfd_create.2, backtrace.3, cmsg.3, error.3, getpt.3, getrpcent.3, getrpcport.3, getsubopt.3, offsetof.3, program_invocation_name.3, rpc.3, rpmatch.3, rtnetlink.3, xdr.3, cciss.4, hpsa.4, pts.4, charmap.5, dir_colors.5, elf.5, gai.conf.5, locale.5, nscd.conf.5, nss.5, resolv.conf.5, rpc.5, arp.7, cpuset.7, ddp.7, epoll.7, fifo.7, futex.7, icmp.7, ip.7, ipv6.7, mailaddr.7, netdevice.7, packet.7, raw.7, regex.7, rtnetlink.7, socket.7, spufs.7, tcp.7, udp.7, unix.7, x25.7, ldconfig.8, nscd.8: Global fix: s/END_LICENSE/LICENSE_END/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-12 10:31:09 +01:00
Michael Kerrisk 2297bf0ef5 ldd.1, capget.2, clone.2, create_module.2, fallocate.2, futex.2, get_kernel_syms.2, get_thread_area.2, getcpu.2, getitimer.2, getpid.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl_list.2, mkdir.2, mknod.2, pciconfig_read.2, pivot_root.2, posix_fadvise.2, query_module.2, sendfile.2, set_thread_area.2, setns.2, unshare.2, __setfpucw.3, a64l.3, addseverity.3, argz_add.3, bindresvport.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, ccos.3, ccosh.3, cerf.3, cexp.3, cexp2.3, cimag.3, clog.3, clog10.3, clog2.3, cmsg.3, conj.3, cpow.3, cproj.3, creal.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, des_crypt.3, envz_add.3, fdim.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmtmsg.3, fpclassify.3, gamma.3, getpt.3, getrpcent.3, getrpcport.3, getttyent.3, isgreater.3, key_setsecret.3, lgamma.3, malloc_hook.3, mempcpy.3, nan.3, netlink.3, nextafter.3, putgrent.3, remove.3, remquo.3, rpc.3, rtime.3, rtnetlink.3, setaliasent.3, setnetgrent.3, signbit.3, significand.3, sincos.3, stdin.3, tgamma.3, xcrypt.3, xdr.3, cciss.4, hpsa.4, mouse.4, pts.4, sk98lin.4, tty_ioctl.4, wavelan.4, hosts.equiv.5, rpc.5, tzfile.5, boot.7, complex.7, ddp.7, fifo.7, futex.7, icmp.7, ip.7, ipv6.7, netdevice.7, netlink.7, packet.7, raw.7, rtnetlink.7, socket.7, tcp.7, udp.7, unix.7, x25.7, sync.8: Global fix: Put copyright info at top of page, followed by blank line and LICENSE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 10:57:11 +01:00
Michael Kerrisk c4a99c30b7 fallocate.2, setns.2, cciss.4, hpsa.4: Added LICENSE_START(GPLv2_ONELINE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 10:57:11 +01:00
Michael Kerrisk 1b9467416d fallocate.2: SEE ALSO: add fallocate(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 00:46:49 +01:00
Michael Kerrisk 3fc441b2b9 fallocate.2, kcmp.2, link.2, listxattr.2, mkdir.2, mknod.2, open.2, ptrace.2, query_module.2, rename.2, symlink.2, write.2, mkfifo.3, core.5: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-01-27 21:27:57 +01:00
Michael Kerrisk 7f26805b7e fallocate.2: FALLOC_FL_* flags are defined in glibc only since 2.18
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-01-10 23:39:00 +01:00
Michael Kerrisk ccc0a19554 fallocate.2: srcfix: Affed FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-18 20:33:26 +01:00
Michael Kerrisk 7cb4d005c6 fallocate.2: Fix description of ENOSYS and EOPNOTSUP errors
As reported in https://bugzilla.redhat.com/show_bug.cgi?id=680214
the descriptions of ENOSYS and EOPNOTSUP are not corrected

Reported-by: John Sullivan <jsrhbz@kanargh.force9.co.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-23 10:07:47 +12:00
David Prévot 381ee84e1a fallocate.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-20 07:44:29 +13:00
Michael Kerrisk 1901002c4a fallocate.2, fork.2, open.2, send.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 14:12:16 +13:00
Michael Kerrisk c0c3d0195d fallocate.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk 7eb92881ee fallocate.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk 54d25ecaec fallocate.2: ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk f52e0be8bb fallocate.2: Substantial restructuring of DESCRIPTION
The addition of a second class of operation ("hole punching")
to the man page made it clear that some significant restructuring
is required. So I substantially reworked the page, including the
preexisting material on the default "file allocation" operation.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk 96575bbc0e fallocate.2: Add further details for FALLOC_FL_PUNCH_HOLE
Reported-by: Josef Bacik <josef@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Lucian Adrian Grijincu 1c7857e9dd fallocate.2: Document FALLOC_FL_PUNCH_HOLE
FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38,
for punching holes in the allocated space in a file.

Signed-off-by: Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Denis Barbier 928b19706f fallocate.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-22 04:54:53 +02:00
Michael Kerrisk 45eb0d22b7 fallocate.2: ERRORS: Add EPERM and ESPIPE errors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-19 17:32:54 +02:00
Simon Paillard c3074d7061 fallocate.2, kexec_load.2, poll.2, spu_run.2, atan2.3, cbrt.3, clock_getcpuclockid.3, end.3, frexp.3, getgrouplist.3, getifaddrs.3, matherr.3, modf.3, pow.3, pthread_getattr_np.3, pthread_getcpuclockid.3, sched_getcpu.3, tgamma.3, mouse.4, proc.5, feature_test_macros.7, spufs.7: Global fix: properly escape minus sign
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Seonghun Lim 8c56fcecab fallocate.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Michael Kerrisk 171875791b fallocate.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:13:38 +02:00
Michael Kerrisk 86b91fdffb accept.2, clone.2, dup.2, fallocate.2, pipe.2, readahead.2, sched_setaffinity.2, unshare.2, CPU_SET.3, endian.3, euidaccess.3, fexecve.3, getpt.3, getpw.3, getumask.3, getutmp.3, gnu_get_libc_version.3, makedev.3, matherr.3, mbsnrtowcs.3, memfrob.3, pthread_attr_setaffinity_np.3, pthread_getattr_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, tcgetsid.3, wcscasecmp.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wcswidth.3, rtld-audit.7: SYNOPSIS: Add reference to feature_test_macros(7)
These pages specify feature test macros in the function
prototypes. Add a reference to feature_test_macros(7),
so that readers are pointed to the information that
feature test macros must be defined before including
*any* header file.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 07:06:22 +02:00
Michael Kerrisk d603cc27b6 execve.2, fallocate.2, futex.2, sched_rr_get_interval.2, select_tut.2, shmget.2, timer_getoverrun.2, times.2, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, sem_open.3, stdin.3, rtc.4, tty_ioctl.4, unix.7: Global fix: s/non-portable/nonportable/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:46:09 +01:00
Michael Kerrisk ff6db39993 fallocate.2: VERSIONS: glibc support is provided since version 2.10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-13 07:20:09 +13:00
Michael Kerrisk 7c1f78d417 fallocate.2: srcfix: Update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-12 15:03:32 +13:00
Michael Kerrisk 85a2d4588e fallocate.2: Note lack of glibc wrapper; caller must use syscall(2)
Glibc doesn't (and quite probably won't) include a wrapper for this
system call.  Therefore, point out that potential callers will need
to use syscall(2), and rewrite the RETURN VALUE text to show things
as they would be if syscall() is used.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 15:29:45 +02:00
Michael Kerrisk 01b7704fb6 fallocate: Refer reader to posix_fallocate(3) for portable interface
Add a para to start of page that points out that this is the
low-level, Linux-specific API, and point the reader to posix_fallocate(3)
for the portable API.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 15:08:21 +02:00
Michael Kerrisk f0c34053bc Put SEE ALSO section into alphabetical order. 2008-07-14 15:52:21 +00:00
Michael Kerrisk 8382f16db1 grfix 2007-12-25 21:28:09 +00:00
Michael Kerrisk c825020667 Fixed unbalanced .nf/fi pairs. 2007-12-23 21:05:57 +00:00
Michael Kerrisk 9ec0ea9000 ffix 2007-12-22 23:05:03 +00:00
Michael Kerrisk 90e261f2a3 wfix 2007-11-17 06:13:05 +00:00
Michael Kerrisk 40b89fc71a Removed old FIXMEs 2007-10-13 11:03:52 +00:00