LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
22,423 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

286 Commits

Author SHA1 Message Date
Michael Kerrisk 40ff9e27dc fcntl.2: Note an important detail of F_SETOWN permission rules for signals 
F_SETOWN records the caller's credentials at the time of
the fcntl() call, and it is these saved credentials that
are used for subsequent permission checks.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 8b4be846c7 fcntl.2: Make the description of the effect of close-on-exec a little clearer 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:00:04 +01:00
Michael Kerrisk f157f403de fcntl.2: Clarify that F_GETFD and F_GETFL return flags via the function result 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 05:48:47 +01:00
Michael Kerrisk 6a459f6fee fcntl.2: Minor wording fix for F_DUPFD 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-24 11:29:35 +12:00
Michael Kerrisk f62ddda8a4 fcntl.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-17 08:09:28 +12:00
Michael Kerrisk bf7bc8b898 arch_prctl.2, execveat.2, fanotify_mark.2, fcntl.2, fork.2, madvise.2, mknod.2, mmap.2, modify_ldt.2, mount.2, open.2, prctl.2, ptrace.2, restart_syscall.2, seccomp.2, semop.2, set_thread_area.2, symlink.2, umount.2, unlink.2, error.3, getnetent.3, getprotoent.3, getservent.3, getutent.3, glob.3, login.3, setjmp.3, setnetgrent.3, wordexp.3, epoll.7: Remove section number from page self reference 
Fix places where pages refer to the function that they describe
and include a section number in that reference. Such references
cause some HTML-rendering tools to create self-references in the
page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk 329ad27142 acct.2, chmod.2, fcntl.2, mmap.2, mprotect.2, rmdir.2, times.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-26 13:08:52 +02:00
Iustin Pop 42f194cf22 fnctl.2: tfix - remove duplicate paragraph in NOTES 
This paragraph already appears above, right before the "File Locking"
one.

Signed-off-by: Iustin Pop <iustin@k1024.org>
 2016-05-26 16:16:29 -05:00
Michael Kerrisk 7be43378e6 fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-03 21:27:01 +02:00
Michael Kerrisk e1124af0ba fcntl.2: Note that mandatory locking is now governed by a configuration option 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-18 13:31:17 +01:00
Michael Kerrisk 979867082b locale.1, localedef.1, _exit.2, accept.2, access.2, acct.2, adjtimex.2, bdflush.2, bind.2, bpf.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_ctl.2, eventfd.2, execve.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getpagesize.2, getpeername.2, getsid.2, getsockname.2, getsockopt.2, gettimeofday.2, init_module.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, kexec_load.2, kill.2, killpg.2, link.2, listen.2, llseek.2, lseek.2, madvise.2, memfd_create.2, mincore.2, mkdir.2, mknod.2, mmap.2, mount.2, nanosleep.2, nice.2, open.2, personality.2, pipe.2, poll.2, posix_fadvise.2, read.2, readahead.2, readlink.2, readv.2, recv.2, recvmmsg.2, rename.2, request_key.2, sched_setaffinity.2, sched_setattr.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendfile.2, sendmmsg.2, seteuid.2, setns.2, setpgid.2, setreuid.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigsuspend.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, symlink.2, sync.2, syscall.2, syscalls.2, times.2, truncate.2, unlink.2, unshare.2, uselib.2, utimensat.2, vfork.2, vhangup.2, wait.2, wait4.2, write.2, a64l.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_read.3, aio_write.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, backtrace.3, cbrt.3, ceil.3, cfree.3, clearenv.3, clock_getcpuclockid.3, clog10.3, cmsg.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, daemon.3, dirfd.3, div.3, dl_iterate_phdr.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, endian.3, erf.3, erfc.3, errno.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, ferror.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fopen.3, fpclassify.3, frexp.3, fseeko.3, fts.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getline.3, getloadavg.3, getmntent.3, getnameinfo.3, getnetent_r.3, getpass.3, getprotoent_r.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getservent_r.3, getspnam.3, getsubopt.3, getusershell.3, getutent.3, getw.3, gsignal.3, hypot.3, ilogb.3, inet.3, initgroups.3, insque.3, isalpha.3, isgreater.3, iswblank.3, j0.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, makedev.3, matherr.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_receive.3, mq_send.3, nan.3, nextafter.3, on_exit.3, open_memstream.3, opendir.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, printf.3, profil.3, psignal.3, pthread_attr_setstack.3, pthread_setaffinity_np.3, putenv.3, putpwent.3, qecvt.3, rand.3, random.3, random_r.3, rcmd.3, readdir.3, realpath.3, remainder.3, remquo.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, scalb.3, scalbln.3, scandir.3, scanf.3, seekdir.3, sem_wait.3, setbuf.3, setenv.3, setjmp.3, setnetgrent.3, siginterrupt.3, signbit.3, significand.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stpcpy.3, stpncpy.3, strdup.3, strerror.3, strftime.3, strlen.3, strnlen.3, strsep.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, system.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, unlocked_stdio.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wprintf.3, y0.3, pts.4, st.4, tty_ioctl.4, elf.5, gai.conf.5, group.5, locale.5, nsswitch.conf.5, proc.5, utmp.5, aio.7, capabilities.7, credentials.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, inotify.7, ip.7, mq_overview.7, namespaces.7, pipe.7, signal.7, socket.7, standards.7, svipc.7, symlink.7, time.7, unicode.7, unix.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-15 17:30:43 +13:00
Michael Kerrisk 7255c7c0df fcntl.2: Rework description of F_SETOWN 
As suggested by Jason, make it clearer that I/O signalling
requires the use of both F_SETOWN and O_ASYNC. While we're at,
make a few other cleanups to the text.

Reported-by: Jason Vas Dias <jason.vas.dias@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 07:49:11 +01:00
Michael Kerrisk 6b0f5f5c4c fcntl.2: Remove mention of _BSD_SOURCE to get definition of F_SETOQN/F_GETOWN 
This usage went away in glibc 2.20, and the simplest remedy
is just to omit mention of it.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk 0d7ae27d85 fcntl.2, flock.2: SEE ALSO: add lslocks(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-15 15:32:52 +01:00
Michael Kerrisk d9cb0d7d3f Various pages: Word "descriptor" more precisely 
Use either "file descriptor" or message queue descriptor".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-01 12:29:37 +01:00
Jakub Wilk 835b2b2c27 fcntl.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-30 20:36:19 +01:00
Michael Kerrisk 29b41e747f accept.2, acct.2, bind.2, clock_getres.2, connect.2, dup.2, epoll_create.2, eventfd.2, execve.2, fanotify_init.2, fcntl.2, fork.2, futex.2, get_robust_list.2, getcpu.2, getpeername.2, getrlimit.2, getsockname.2, getsockopt.2, gettimeofday.2, inotify_init.2, listen.2, membarrier.2, memfd_create.2, mlock.2, mmap.2, personality.2, pipe.2, poll.2, recv.2, send.2, sendfile.2, shmget.2, shutdown.2, sigreturn.2, socket.2, socketcall.2, socketpair.2, spu_create.2, swapon.2, time.2, timerfd_create.2, uselib.2, dlerror.3, dlopen.3, drand48.3, errno.3, fnmatch.3, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, iconv.3, mq_open.3, opendir.3, random_r.3, sem_open.3, shm_open.3, tmpfile.3, tzset.3, random.4, fanotify.7, futex.7, vdso.7, ld.so.8: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-29 13:48:42 +01:00
Michael Kerrisk 26c32fabec accept.2, dup.2, eventfd.2, execve.2, fcntl.2, memfd_create.2, open.2, perf_event_open.2, pipe.2, signalfd.2, socket.2, socketpair.2, spu_create.2, timerfd_create.2, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, mq_open.3, opendir.3, sem_open.3, shm_open.3, tmpfile.3: ERRORS: standardize text for EMFILE error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-27 16:37:03 +01:00
Jakub Wilk ae6bc11cdd fcntl.2: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-07 08:09:23 +01:00
Michael Kerrisk ccc357f7c6 fcntl.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-07-03 12:40:48 +02:00
Michael Kerrisk 728aff57dd fcntl.2: OFD locks are proposed for inclusion in the next POSIX revision 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-05-20 16:38:09 +02:00
Michael Kerrisk 67d2c6873c add_key.2, chown.2, epoll_ctl.2, epoll_wait.2, execve.2, fcntl.2, get_mempolicy.2, getxattr.2, ioctl.2, keyctl.2, listxattr.2, mkdir.2, mknod.2, mmap.2, msync.2, nfsservctl.2, open.2, prctl.2, removexattr.2, request_key.2, sendfile.2, set_mempolicy.2, setxattr.2, shmget.2, shutdown.2, sigaction.2, syslog.2, truncate.2, umask.2, CPU_SET.3, atexit.3, bsearch.3, cmsg.3, err.3, gethostid.3, getmntent.3, getopt.3, iconv_close.3, inet_ntop.3, longjmp.3, lsearch.3, mcheck.3, on_exit.3, putpwent.3, regex.3, resolver.3, setbuf.3, setjmp.3, setlocale.3, setlogmask.3, sleep.3, strsignal.3, sysconf.3, undocumented.3, tty_ioctl.4, proc.5, resolv.conf.5, tzfile.5, aio.7, bootparam.7, capabilities.7, fanotify.7, inotify.7, ip.7, packet.7, pthreads.7, raw.7, signal.7, socket.7, unix.7, ld.so.8, nscd.8: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-05-07 08:26:32 +02:00
Michael Kerrisk caf997afa0 fcntl.2: Note an F_SETSIG corner case 
Reported-by: Vegard Nossum <vegard.nossum@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-05-04 13:48:39 +02:00
Michael Kerrisk 9a06730f49 fcntl.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-05-04 13:08:51 +02:00
Michael Kerrisk 6f7b566c55 fcntl.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-05-04 13:07:18 +02:00
Dmitry Deshevoy 146740934e fcntl.2: tfix 
Signed-off-by: Dmitry Deshevoy <mityada@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-03-02 17:22:25 +01:00
Michael Kerrisk 6d322d5fc7 time.1, access.2, arch_prctl.2, cacheflush.2, capget.2, clone.2, execve.2, fcntl.2, fork.2, getpid.2, getxattr.2, ioctl.2, ioctl_fat.2, killpg.2, listxattr.2, madvise.2, migrate_pages.2, modify_ldt.2, mprotect.2, msgget.2, msgop.2, perf_event_open.2, ptrace.2, sched_setattr.2, semget.2, semop.2, sendfile.2, set_thread_area.2, setxattr.2, stat.2, statfs.2, wait.2, wait4.2, encrypt.3, mktemp.3, pthread_attr_setschedparam.3, resolver.3, statvfs.3, syslog.3, tzset.3, core.5, host.conf.5, intro.5, proc.5, resolv.conf.5, pthreads.7, socket.7, unix.7, ld.so.8, ldconfig.8: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-02-21 09:26:52 +01:00
Michael Kerrisk ee6627733a fcntl.2: Clarify cases of conflict between traditional record and OFD locks 
Verified by experiment on Linux 3.15 and 3.19rc4.

Acked-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-02-21 07:58:27 +01:00
Michael Kerrisk 771e13d4b3 Removed trailing white space at end of lines 2015-01-22 23:36:33 +01:00
Michael Kerrisk 8392a3b33f _exit.2, dup.2, execve.2, execveat.2, fallocate.2, fcntl.2, get_robust_list.2, getrlimit.2, mbind.2, memfd_create.2, mmap.2, open.2, ptrace.2, readv.2, select.2, sigaction.2, syscall.2, syscalls.2, truncate.2, utimensat.2, write.2, errno.3, exec.3, fclose.3, fexecve.3, fmemopen.3, fopencookie.3, getgrent_r.3, getline.3, getmntent.3, getpw.3, getpwent_r.3, getspnam.3, malloc_info.3, posix_fallocate.3, putgrent.3, shm_open.3, locale.5, proc.5: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-22 23:29:25 +01:00
Michael Kerrisk c733b64158 fcntl.2: ERRORS: add EBUSY case for F_SETPIPE_SZ 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 7570f8afad fcntl.2: ERRORS: add open file description lock error cases 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 3edddb9e32 fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 1030085696 fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk bb38aaab17 fcntl.2: ERRORS: add various file-sealing error cases 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 158439352c fcntl.2: Edits and additions after review by David Herrmann 
Reviewed-by: David Herrmann <dh.herrmann@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 7481dc7b58 fcntl.2: Minor rewording 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 6858599eeb fcntl.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 55481aa6ef fcntl.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 6d91128f87 fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 30139aec41 fcntl.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 882532485f fcntl.2: Document EPERM for case where file already has F_SEAL_SEAL seal 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:33 +01:00
Michael Kerrisk 0ec4b9d721 fcntl.2: F_ADD_SEALS requires that 'fd' be writable 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk 5c87e70efb fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk 4e89ca063c fcntl.2: srcfix: Add some FIXMEs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk 69d33b44c4 fcntl.2: Reorder text describing sealing 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk 9f97f3fa1c fcntl.2: Add statement about F_ADD_SEALS and F_GET_SEALS under CONFORMING TO 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk 4d04b15efd fcntl.2: Add EINVAL error F_ADD_SEALS 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk aee553ccd9 fcntl.2: Reformat EINVAL error text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk 6bdad35b13 fcntl.2: Various edits; add some FIXMEs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk d8943ac8c5 fcntl.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk 12cfd6227c fcntl.2: srcfix: start new sentences on new lines; rewrap source lines 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
David Herrmann a25d701d19 fcntl.2: Document F_ADD_SEALS and F_GET_SEALS commands 
Signed-off-by: David Herrmann <dh.herrmann@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-19 10:35:32 +01:00
Michael Kerrisk 7ef5b2cd0a fcntl.2: Add reference to RLIMIT_NOFILE for F_DUPFD EINVAL error on 'arg'. 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-13 10:17:50 +01:00
David Prévot b7a3dc84e7 fcntl.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-15 11:10:26 +02:00
Michael Kerrisk 62c76ace78 memusage.1, memusagestat.1, connect.2, fcntl.2, poll.2, errno.3, rtnetlink.3, inotify.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-07 05:03:19 -07:00
Michael Kerrisk 9bcc9e428c fcntl.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-08-21 13:48:32 -05:00
Michael Kerrisk 37c240d14c fcntl.2: One must define _GNU_SOURCE to get the F_OFD_* definitions 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-08-21 13:47:25 -05:00
Michael Kerrisk c77eace5b1 iconv.1, ldd.1, connect.2, dup.2, epoll_ctl.2, eventfd.2, fallocate.2, fcntl.2, getitimer.2, inotify_add_watch.2, open.2, pipe.2, poll.2, sendmmsg.2, set_tid_address.2, shmop.2, signalfd.2, splice.2, syscalls.2, syslog.2, tee.2, vmsplice.2, ether_aton.3, mallopt.3, printf.3, profil.3, charmap.5, proc.5, epoll.7, inotify.7, libc.7, pipe.7, sched.7, socket.7, udplite.7, iconvconfig.8, ld.so.8: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-08 16:14:48 +02:00
Michael Kerrisk d2b6be9a2d fcntl.2: Suggest the use of real-time signals with F_NOTIFY 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-08 12:22:25 +02:00
Michael Kerrisk 1ce579fc39 fcntl.2: ERRORS: Document ENOTDIR error for F_NOTIFY 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-08 12:07:15 +02:00
Michael Kerrisk 8be6f4e1cd fcntl.2: Use proper page cross-references in F_NOTIFY discussion 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-05 08:54:58 +02:00
Michael Kerrisk 5c4d5f9715 fcntl.2: The return value for F_SETPIPE_SZ is the pipe capacity 
Reported-by: Tomi Salminen <tlsalmin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-01 11:40:36 +02:00
Michael Kerrisk 91085d8525 Removed trailing white space at end of lines 2014-06-14 08:03:45 +02:00
Michael Kerrisk ad5b45abe5 localedef.1, execve.2, fcntl.2, flock.2, lseek.2, open.2, open_by_handle_at.2, recvmmsg.2, sendmmsg.2, seteuid.2, setresuid.2, setreuid.2, setuid.2, statfs.2, syscalls.2, basename.3, catgets.3, getdate.3, getdirentries.3, getdtablesize.3, iconv.3, lockf.3, malloc_get_state.3, malloc_usable_size.3, matherr.3, mkdtemp.3, mkstemp.3, mq_close.3, mq_unlink.3, siginterrupt.3, system.3, locale.5, bootparam.7, environ.7, man-pages.7, signal.7, unicode.7, utf-8.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-13 17:15:44 +02:00
Michael Kerrisk 864eb97814 fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-12 15:29:19 +02:00
Michael Kerrisk 76868835e7 fcntl.2: Add notes on F_SETLKW deadlock detection and its limitations 
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk 241e02302d fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk d2e429c1a8 fcntl.2: The kernel does not perform deadlock detection for OFD locks 
See kernel commit 57b65325fe34ec4c917bc4e555144b4a94d9e1f7
And this mail thread:

    http://thread.gmane.org/gmane.linux.file-systems/81318/focus=81327
    From: Jeff Layton <jlayton <at> redhat.com>
    Subject: [PATCH v5 13/14] locks: skip deadlock detection on FL_FILE_PVT locks
    Date: 2014-01-09 14:19:46 GMT

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk 6451570257 fcntl.2: Under OFD locks add a reference to open(2) for explanation of OFDs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk d068eb3b73 fcntl.2: Explain POSIX background to EACCES/EAGAIN error for F_GETLK 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 9c26bc8c20 fcntl.2: F_OFD_GETLK fails with EAGAIN when there is a lock conflict 
For F_GETLK, POSIX allows EACCES or EAGAIN because different
implementations of traditional record locks returned one of
these errors, and portable applications had to handle either
possibility. However, that argument doesn't apply for OFD
locks, since Linux is the only implementation and it returns
EAGAIN.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 6024e7332f fcntl.2: Describe how to check whether the kernel supports a particular command 
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 102b34d811 fcntl.2: ERRORS: add EINVAL for invalid 'cmd' 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk d9312ec7c0 fcntl.2: Minor wording improvement 
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 9044058e60 fcntl.2: Add an explicit note that mandatory locking is not in POSIX 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk f5cdb4b0fc fcntl.2: Make the warning that mandatory locks are unreliable more prominent 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 6799ba26c9 fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 9acee57885 fcntl.2: Rewrite introductory paragraphs on mandatory locking 
Make the structure more logical, and also explicitly mention
OFD locks.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 4b5c506a2c fcntl.2: Add EINVAL error for OFD locks where 'l_pid' is not 0 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk c11b47b3b1 fcntl.2: CONFORMING TO: note that OFD locks are Linux-specific 
But they make their way into the next POSIX release

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 97e03523e5 fcntl.2: Describe semantics for compatible and conflicting OFD locks 
And describe how threads can use OFD locks to ensure
exclusive access to a file.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 1a93af040c fcntl.2: Detail the limitations of traditional (process-associated) locks 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk bfb147160f fcntl.2: Minor fixes to introductory par on OFD locks 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 38702b6ccc fcntl.2: OFD locks are Linux-specific and available since Linux 3.15 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 99b5ab7933 fcntl.2: Tweaks and rewrites of pieces of Jeff Layton's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Jeff Layton 2d3e4b83a3 fcntl.2: Document open file description locks 
As provided by the fcntl() operations F_OFD_SETLK,
F_OFD_SETLKW, and F_OFD_GETLK

Signed-off-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 7562b10e23 fcntl.2: Add para introducing advisory locks and noting existence of OFD locks 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 86fbd8d849 fcntl.2: Minor change: move some NOTES text on record locking 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 15b4459067 fcntl.2: wfix + ffix: fine-tuning on NFSv4 client locking text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 70fd304581 fcntl.2: Add NOTES subhead for record locking and NFS 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk da0d60febb fcntl.2: nfsv4leasetime controls the "contact lost" interval for NFSv4 
Jeff Layton:
   The difference here is subtle. The gracetime is how long after a reboot
   should knfsd allow clients to reclaim state (and deny the creation of
   new locks and opens). The leasetime is how long the NFSv4 lease period
   is. There is a relationship between the two that's illustrated in the
   comments above write_gracetime:

     /**
      * write_gracetime - Set or report current NFSv4 grace period time
      *
      * As above, but sets the time of the NFSv4 grace period.
      *
      * Note this should never be set to less than the *previous*
      * lease-period time, but we don't try to enforce this.  (In the common
      * case (a new boot), we don't know what the previous lease time was
      * anyway.)
      */

   The value you're interested in here is the nfsv4leasetime. If the
   client doesn't renew its lease within that period, then it's subject to
   the server giving up on it and dropping any state that it holds on that
   clients' behalf.

   Note that this is not a firm timeout. The server runs a job
   periodically to clean out expired stateful objects, and it's likely
   that there is some time (maybe even up to another whole lease period)
   between when the timeout expires and the job actually runs. If the
   client gets a RENEW in there within that window, its lease will be
   renewed and its state preserved.

Reported-by: Jeff Layton <jlayton@poochiereds.net>
Cowritten-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk af8713605a fcntl.2: Refine discussion of locks when NFSv4 client loses contact with server 
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 6ca357f965 fcntl.2: Note treatment of locks when an NFS client loses contact with the server 
Based on text sent by Neil Brown.

Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 9584daf7f3 fcntl.2: Minor rewording 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk cf118c620f fcntl.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:47 +02:00
Michael Kerrisk 91ac17b2c7 fcntl.2: Reword discussion of mandatory lock bug a litte 
Jeff Layton confirmed that the bug remains even in modern kernels.

Reviewed-by: Jeff Layton <jlayton@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:47 +02:00
Michael Kerrisk 3d15531307 chown.2, fcntl.2, futex.2, recvmmsg.2, sched_setscheduler.2, semget.2, shmget.2, malloc.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_setaffinity_np.3, strcpy.3, capabilities.7, cpuset.7, credentials.7, pthreads.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-21 13:15:30 +02:00
Michael Kerrisk 381eddf1bc fcntl.2: Add "file locking" subheading under NOTES 
(No actual changes to the text.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-15 08:55:20 +02:00
Michael Kerrisk 2f4772d2d2 fcntl.2: Note the race when O_CLOEXEC is used at same time as fork()+execve() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-20 10:46:40 +02:00