fcntl-linux.h: add new definitions and manual updates for open file description locks
PATCH RESEND 1/1 fcntl-linux.h: add new definitions and manual updates for open file description locks
From: Jeff Layton <[email protected]>
Open file description locks have been merged into the Linux kernel for v3.15. Add the appropriate command-value definitions and an update to the manual that describes their usage.
ChangeLog:
2014-04-24 Jeff Layton <[email protected]>
[BZ#16839]
* manual/llio.texi: add section about open file description locks
* manual/examples/ofdlocks.c:
example of open file description lock usage
* sysdeps/unix/sysv/linux/bits/fcntl-linux.h:
(F_OFD_GETLK, F_OFD_SETLK, F_OFD_SETLKW): New macros.
--- manual/examples/ofdlocks.c | 77 +++++++++ manual/llio.texi | 241 ++++++++++++++++++++++++++++- sysdeps/unix/sysv/linux/bits/fcntl-linux.h | 17 ++ 3 files changed, 332 insertions(+), 3 deletions(-) create mode 100644 manual/examples/ofdlocks.c
manual/examples/ofdlocks.c new file +77 -0
@@ -0,0 +1,77 @@ +/* Open File Description Locks Usage Example +Copyright (C) 1991-2014 Free Software Foundation, Inc. + +This program is free software; you can redistribute it and/or +modify it under the terms of the GNU General Public License +as published by the Free Software Foundation; either version 2 +of the License, or (at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, see <http://www.gnu.org/licenses/>. +*/ + +#define _GNU_SOURCE +#include <stdio.h> +#include <sys/types.h> +#include <sys/stat.h> +#include <unistd.h> +#include <fcntl.h> +#include <pthread.h> + +#define FILENAME "/tmp/foo" +#define NUM_THREADS 3 +#define ITERATIONS 5 + +void * +thread_start (void *arg) +{ +int i, fd, len; +long tid = (long ) arg; +char buf[256 ]; +struct flock lck = { + .l_whence =SEEK_SET , + .l_start =0 , + .l_len =1 , + }; + + fd =open ("/tmp/foo" ,O_RDWR |O_CREAT ,0666 ); + +for (i =0 ; i <ITERATIONS ; i++) + { + lck.l_type =F_WRLCK ; +fcntl (fd,F_OFD_SETLKW , &lck); + + len =sprintf (buf,"%d: tid=%ld fd=%d\n" , i, tid, fd); + +lseek (fd,0 ,SEEK_END ); +write (fd, buf, len); +fsync (fd); + + lck.l_type =F_UNLCK ; +fcntl (fd,F_OFD_SETLK , &lck); + +/* sleep to ensure lock is yielded to another thread */ +usleep (1 ); + } +pthread_exit (NULL ); +} + +int +main (int argc,char **argv) +{ +long i; +pthread_t threads[NUM_THREADS ]; + +truncate (FILENAME ,0 ); + +for (i =0 ; i <NUM_THREADS ; i++) +pthread_create (&threads[i],NULL , thread_start, (void *) i); + +pthread_exit (NULL ); +return 0 ; +}
manual/llio.texi +238 -3
280 lines not on this page · raw message
sysdeps/unix/sysv/linux/bits/fcntl-linux.h +17 -0
@@ -117,6 +117,23 @@# define F_SETLKW64 14/* Set record locking info (blocking). */ #endif +/* open file description locks. + +Usually record locks held by a process are released on *any* close and are +not inherited across a fork. + +These cmd values will set locks that conflict with process-associated record +locks, but are "owned" by the opened file description, not the process. +This means that they are inherited across fork or clone with CLONE_FILES +like BSD (flock) locks, and they are only released automatically when the +last reference to the the file description against which they were acquired +is put. */ +#if __USE_GNU +# define F_OFD_GETLK 36 +# define F_OFD_SETLK 37 +# define F_OFD_SETLKW 38 +#endif +#ifdef __USE_LARGEFILE64# define O_LARGEFILE __O_LARGEFILE#endif
Signature · 1 line
1.9.3