NAME

       lc_recvtree, lc_recvchunk - receive data over multicast

LIBRARY

       Librecast library (liblibrecast, -llibrecast)

SYNOPSIS

       #include <librecast/sync.h>

       ssize_t lc_recvtree(lc_ctx_t *lctx, unsigned char *hash, mtree_t *tree,
                           lc_stat_t *stats, lc_sync_options_t *opt, int flags);
       ssize_t lc_recvchunk(lc_ctx_t *lctx, unsigned char *hash, void *data, const size_t len,
                           lc_stat_t *stats, lc_sync_options_t *opt, int flags);
       ssize_t lc_recvdir(lc_ctx_t *lctx, unsigned char *hash, net_tree_t **dir,
                           lc_stat_t *stats, lc_sync_options_t *opt, int flags);

       Compile and link with -llibrecast.

DESCRIPTION

       Each  of  these  functions  receives data over multicast by joining the librecast channel formed from the
       supplied hash.

       The lc_recvtree function receives the merkle tree structure from channel hash into tree.

       The lc_recvchunk function receives a chunk of data of length len (which can be  fragmented  over  several
       packets) from channel hash, writing it into the memory pointed to by data.

       The lc_recvdir function is a wrapper for lc_recvtree(3) which returns -1 and sets errno to ENOTDIR if the
       object received is not a directory.

       If stats is not NULL, transfer statistics will be returned in this structure.

       opt is not used, at present, and must be NULL for compatibility with future versions.

       flags is not used, at present, and must be zero for compatibility with future versions.

RETURN VALUE

       These  calls  return the number of bytes received, or -1 if an error occurred.  In the event of an error,
       errno is set to indicate the error.

ERRORS

       EINVAL Invalid argument.

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

       ENOTDIR Not a directory.

SEE ALSO

       lc_ctx_new(3), lc_share(3), lc_sendtree(3), lc_sendchunk(3)

LIBRECAST                                          2025-06-09                                         LC_RECV(3)