Man page - lc_syncfilelocal(3)

Packages contains this manual

Package: liblibrecast-dev
apt-get install liblibrecast-dev

Manuals in package:

Documentations in package:

liblibrecast-dev

Manual

LC_SYNCFILELOCAL

NAME
LIBRARY
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO

NAME

lc_syncfilelocal - synchronize two local files

LIBRARY

Librecast library ( liblibrecast , -llibrecast )

SYNOPSIS

#include <librecast/sync.h>

int lc_syncfilelocal(const char *dst , const char *src , q_t *q
lc_stat_t *stats , lc_sync_options_t *opt , int flags );

Compile and link with -llibrecast .

DESCRIPTION

The lc_syncfilelocal () function synchronizes the file at dst with the file at src by overwriting dst with bytes from src . If dst does not exist, it is created.

If q is not NULL, it must point to a queue q_t structure previously initialized with q_init (3). This queue will have jobs enqueued to build the tree. This is normally used in conjunction with a threadpool created with q_pool_create (3) with threads all calling q_job_seek (3).

If q is NULL, the creation and destruction of a queue and threadpool will be handled automatically.

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.

The flags argument is the bitwise OR of zero of more of the following flags:
MDEX_RECURSE

recursively index directories.

RETURN VALUE

The lc_syncfilelocal () function returns zero on success, 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).

lc_syncfilelocal () can also fail with any of the errors for mmap (2) or chmod (2).