DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

ftrylockfile(S)


ftrylockfile -- grant thread ownership of a file

Syntax

cc . . . -lc

#include <stdio.h>

int ftrylockfile(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.

ftrylockfile gives the calling thread ownership of file if file is not currently owned by another thread. This function is similar to flockfile, except that it returns nonzero if the file is already locked. It returns zero on success.

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

Return values

On success, ftrylockfile returns zero and locks the stream file. If the stream is already locked by a different thread, it returns nonzero.

See also

flock(S), flockfile(S), funlockfile(S),
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003