flockfile, ftrylockfile, funlockfile - lock FILE for stdio


   #include <stdio.h>

   void flockfile(FILE *filehandle);
   int ftrylockfile(FILE *filehandle);
   void funlockfile(FILE *filehandle);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

   All functions shown above:
           || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE


   The  stdio functions are thread-safe.  This is achieved by assigning to
   each FILE object a lockcount and  (if  the  lockcount  is  nonzero)  an
   owning  thread.   For each library call, these functions wait until the
   FILE object is no longer locked by a different thread, then lock it, do
   the requested I/O, and unlock the object again.

   (Note:  this  locking  has  nothing to do with the file locking done by
   functions like flock(2) and lockf(3).)

   All this is invisible to the C-programmer, but there may be two reasons
   to  wish for more detailed control.  On the one hand, maybe a series of
   I/O  actions  by  one  thread  belongs  together,  and  should  not  be
   interrupted  by the I/O of some other thread.  On the other hand, maybe
   the locking overhead should be avoided for greater efficiency.

   To this end, a thread can explicitly lock the FILE object, then do  its
   series  of  I/O actions, then unlock.  This prevents other threads from
   coming in between.  If the reason for doing this was to achieve greater
   efficiency,  one does the I/O with the nonlocking versions of the stdio
   functions:  with  getc_unlocked(3)  and  putc_unlocked(3)  instead   of
   getc(3) and putc(3).

   The  flockfile()  function waits for *filehandle to be no longer locked
   by  a  different  thread,  then  makes  the  current  thread  owner  of
   *filehandle, and increments the lockcount.

   The funlockfile() function decrements the lock count.

   The  ftrylockfile()  function  is a nonblocking version of flockfile().
   It does nothing in case some other  thread  owns  *filehandle,  and  it
   obtains ownership and increments the lockcount otherwise.


   The  ftrylockfile()  function  returns  zero  for success (the lock was
   obtained), and nonzero for failure.




   For  an  explanation  of  the  terms  used   in   this   section,   see

   Interface                      Attribute      Value   
   flockfile(),  ftrylockfile(),  Thread safety  MT-Safe 


   POSIX.1-2001, POSIX.1-2008.


   These functions  are  available  when  _POSIX_THREAD_SAFE_FUNCTIONS  is




   This  page  is  part of release 4.09 of the Linux man-pages project.  A
   description of the project, information about reporting bugs,  and  the
   latest     version     of     this    page,    can    be    found    at

                              2016-03-15                      FLOCKFILE(3)

More Linux Commands

gnutls_x509_crq_get_key_purpose_oid(3) - API function.......
gnutls_x509_crq_get_key_purpose_oid.3 - This function will extract the key purpose OIDs of the Certificate specified by the given index. These are stored in the

mkfontscale(1) - create an index of scalable font files for
For each directory argument, mkfontscale reads all of the scalable font files in the directory. For every font file found, an X11 font name (XLFD) is generated,

setrpcent(3) - get RPC entry (Library - Linux man page).....
setrpcent.3 - The getrpcent(), getrpcbyname(), and getrpcbynumber() functions each return a pointer to an object with the following structure containing the bro

cargl(3) - calculate the complex argument - Linux man page
A complex number can be described by two real coordinates. One may use rectangular coordinates and gets z = x + I * y where x = creal(z) and y = cimag(z). Or on

XtInitialize(3) - initialize (Library - Linux man page).....
XtInitialize calls XtToolkitInitialize followed by XtOpenDisplay with display_string NULL and application_name NULL, and finally calls XtAppCreateShell with app

gpg(1) - OpenPGP encryption and signing tool (Man Page).....
gpg2 is the OpenPGP part of the GNU Privacy Guard (GnuPG). It is a tool to provide digital encryption and signing services using the OpenPGP standard. gpg2 feat

pano_modify(1) - Change output parameters of project file...
pano_modify modifies a single Hugin .pto project. OPTIONS -o, --output=file.pto Output Hugin PTO file. Default: &lt;filename&gt;_mod.pto -p, --projection=NUMBER Sets

XtVaCreatePopupShell(3) - create a popup shell (Man Page)...
The XtCreatePopupShell function ensures that the specified class is a subclass of Shell and, rather than using insert_child to attach the widget to the parents

gnutls_certificate_set_dh_params(3) - API function (ManPage)
This function will set the Diffie-Hellman parameters for a certificate server to use. These parameters will be used in Ephemeral Diffie-Hellman cipher suites. N

_tracechtype(3ncurses) - curses debugging routines (ManPage)
The trace routines are used for debugging the ncurses libraries, as well as applications which use the ncurses libraries. These functions are normally available

current_item(3menu) - set and get current_menu_item.........
The function set_current_item sets the current item (the item on which the menu cursor is positioned). current_item returns a pointer to the current item in the

This allows setting a preferred key id for the given certificate. This key will be used by functions that involve key handling. RETURNS On success, 0 is returne

We can't live, work or learn in freedom unless the software we use is free.