Commit Graph

89 Commits

Author SHA1 Message Date
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
Michael Kerrisk d9a0b2a566 Describes the fallocate() system call, new in 2.6.23. 2007-09-10 04:30:43 +00:00