ftrylockfile(3STDC)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | STANDARDS

NAME

flockfile, ftrylockfile, funlockfile- stream lock management

SYNOPSIS

$(OS_DIR)/lib/libc.a
#include <stdio.h>

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

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

The flockfile() , ftrylockfile() and funlockfile() functions provide for explicit application-level locking of stdio ( FILE * ) objects.

The flockfile() function is used to acquire ownership of a ( FILE * ) object.

The ftrylockfile() function is used to acquire ownership of a ( FILE * ) object if the object is available; ftrylockfile() is a non-blocking version of flockfile() .

The funlockfile() function is used to relinquish the ownership of a ( FILE * ) object.

RETURN VALUES

The ftrylockfile() function returns 0 on success or 1 to indicate that the lock cannot be acquired.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

getc_unlocked(3STDC)

STANDARDS

These routines conform to the POSIX.1c standards.

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | STANDARDS