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
Michael Kerrisk
621ab85e80
fcntl.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Michael Kerrisk
14e9f7cf4b
fcntl.2, strtol.3, strtoul.3, socket.7: ffix in feature test macro names
...
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 20:17:50 +01:00
Michael Kerrisk
7e2cb38315
fcntl.2: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 11:36:57 +01:00
Michael Kerrisk
eceaee4705
fcntl.2: Warn that F_GETLK info may already be out of date when the call returns
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-20 08:34:28 +01:00
Michael Kerrisk
dc45cae328
fcntl.2: Minor fix: reorder constants to match order of accompanying text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-20 08:32:14 +01:00
Michael Kerrisk
7a9d6ddece
Removed trailing white space at end of lines
2014-02-11 12:17:35 +01:00
Michael Kerrisk
a797afac4e
fcntl.2, msgget.2, ptrace.2, request_key.2, shmget.2, sigaction.2, syscalls.2, dbopen.3, euidaccess.3, getgrnam.3, getpwnam.3, strfmon.3, strtol.3, strtoul.3, cciss.4, hpsa.4, mouse.4, termcap.5, charsets.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, unicode.7, utf-8.7: Use Oxford comma
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-05 16:09:11 +01:00
Michael Kerrisk
93265f420c
fcntl.2: POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-22 04:46:48 +01:00
Michael Kerrisk
639b33d7b8
fcntl.2: BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-22 04:28:21 +01:00
Michael Kerrisk
7168d2f88b
fcntl.2: Add susbsections under BUGS
...
There's several bugs listed. It's helpful to mark
them separately.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-21 08:44:44 +01:00