flockfile(3S)                                          flockfile(3S)


       NAME
             flockfile - grant thread ownership of a file

       SYNOPSIS
             #include <stdio.h>
             void flockfile(FILE *file);

       DESCRIPTION
             This function provide for explicit application-level locking
             of standard I/O objects.  It can be used by a thread to begin
             a sequence of I/O statements that are to be executed as a
             unit.

             flockfile gives the calling thread ownership of file if file
             is not currently owned by another thread.  A thread keeps
             ownership of the file until it calls funlockfile.

             A thread that tries to get ownership of a file that is
             currently owned by another thread is suspended until the
             current owner relinquishes the file.

             A thread can do multiple calls to flockfile and ftrylockfile
             and not get suspended if it currently owns the file, but an
             equal number of funlockfile calls are necessary to relinquish
             the object completely.

       REFERENCES
             flock(3S), ftrylockfile(3S), funlockfile(3S), stdio(3S)




















                           Copyright 1994 Novell, Inc.               Page 1