NAME¶

mdex_del - delete an entry from a multicast index

LIBRARY¶

Librecast library (liblibrecast, -llibrecast)

SYNOPSIS¶

#include <librecast/mdex.h>

int mdex_del(mdex_t *mdex, unsigned char *hash, size_t hashlen);

Compile and link with -llibrecast.

DESCRIPTION¶

The mdex_del function deletes an entry from the multicast index mdex using hash (of length hashlen) as the key. If no matching entry is found in the index, -1 is returned and errno is set to ENOENT.

hashlen can be shorter than the full length of the hash stored with mdex_put(3) and will delete the first entry matching the truncated hash. This allows us to store the full 32 byte hash in the index, but still match against the truncated hash derived from, say, the 14 bytes of an IPv6 multicast group address.

RETURN VALUE¶

mdex_put() returns zero on success. On error, -1 is returned, and errno is set to indicate the error.

ERRORS¶

EINVAL

Invalid argument. Both mdex and hash are required (not NULL), and hashlen > 0.

ENOENT No entry found matching hash.

SEE ALSO¶

mdex_init(3), mdex_free(3), mdex_get(3), mdex_put(3), lc_share(3)