latch_open(S)

latch_open -- open a latch

Syntax

cc . . . -lsuds

#include <latch.h>

latch_t *latch_open(const char *name, int oflag, mode_t mode,
                      unsigned int value);

Description

The latch_open function establishes a connection between a named latch and a process. Following a call to latch_open with latch name, the process may reference the latch using the address returned from the call. This latch may be used in subsequent calls to latch_wait(S), latch_trywait(S) and latch_post(S). The latch remains usable by this process until the latch is closed by a successful call to latch_close(S), _exit(S), or exec(S).

The use of the oflag, mode and value parameters is as for sem_open(S).

Return values

Upon successful completion, the function returns the address of the latch.

Diagnostics

Errors returned are as for sem_open(S).

Standards conformance