latch_open(S-osr5)

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-osr5), latch_trywait(S-osr5) and latch_post(S-osr5). The latch remains usable by this process until the latch is closed by a successful call to latch_close(S-osr5), _exit(S-osr5), or exec(S-osr5).

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

Return values

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

Diagnostics

Errors returned are as for sem_open(S-osr5).

Standards conformance