NAME

       mdex_init, mtree_free - initialize and free a multicast index

LIBRARY

       Librecast library (liblibrecast, -llibrecast)

SYNOPSIS

       #include <librecast/mdex.h>

       mdex_t *mdex_init(size_t entries);
       void mdex_free(mdex_t *mdex);

       Compile and link with -llibrecast.

DESCRIPTION

       The mdex_init function initializes a multicast index.

       entries  gives  the initial number of entries to allocate. This is just a hint for initial
       memory allocation, and the index will be resized as required.

RETURN VALUE

       mdex_init() returns a pointer to a mdex_t handle, which should  be  freed  by  passing  to
       mdex_free()  when  done.   On  error,  NULL  is returned, and errno is set to indicate the
       error.

       The mdex_free() function returns no value, and preserves errno.

ERRORS

       ENOMEM Not enough space/cannot allocate memory (POSIX.1-2001).

SEE ALSO

       mdex_get(3), mdex_put(3), mdex_del(3)