= loc_new(3)

== Name

loc_new - Create a new libloc context

== Synopsis
[verse]

#include <libloc/libloc.h>

struct loc_ctx;

int loc_new(struct loc_ctx{empty}*{empty}* ctx);

struct loc_ctx{empty}* loc_ref(struct loc_ctx{empty}* ctx);

struct loc_ctx{empty}* loc_unref(struct loc_ctx{empty}* ctx);

== Description

Every operation in libloc requires to set up a context first.
This is done by calling loc_new(3).

Every time another part of your code is holding a reference to the context,
you will need to call loc_ref() to increase the reference counter.
If you no longer need the context, you will need to call loc_unref().

== See Also

link:libloc[3]

== Authors

Michael Tremer
