NAME¶

lc_ctx_new, lc_ctx_free - create and free Librecast contexts

SYNOPSIS¶

#include <librecast/net.h>

lc_ctx_t *lc_ctx_new(void);
void lc_ctx_free(lc_ctx_t *ctx);

Compile and link with -llibrecast.

DESCRIPTION¶

lc_ctx_new() creates a new Librecast context and sets up the environment. Call lc_ctx_free(3) when done.

lc_ctx_free() invalidates and frees a Librecast context created with lc_ctx_new(3)

RETURN VALUE¶

lc_ctx_new() returns a pointer to a lc_ctx_t handle. On error returns NULL and sets errno to ENOMEM.

The lc_ctx_free() function returns no value.

ERRORS¶

lc_ctx_new() can fail with the following error:

ENOMEM

Out of memory. Possibly, the application hit the RLIMIT_AS or RLIMIT_DATA limit described in getrlimit(2).

EXAMPLE¶

lc_ctx_t *lctx;
lctx = lc_ctx_new();
/* your Librecast program here */
lc_ctx_free(lctx); /* free context when done */

SEE ALSO¶

lc_ctx_free(3)