Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.

EXTATTR_COPY_FILE(3)       Library Functions Manual       EXTATTR_COPY_FILE(3)

NAME
     extattr_copy_file, extattr_copy_fd, extattr_copy_link, cpxattr, fcpxattr,
     lcpxattr - copy extended attributes from a file to another one

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <sys/extattr.h>

     int
     extattr_copy_file(const char *from, const char *to, int namespace);

     int
     extattr_copy_fd(int from_fd, int to_fd, int namespace);

     int
     extattr_copy_link(const char *from, const char *to, int namespace);

     int
     cpxattr(const char *from, const char *to);

     int
     fcpxattr(int from_fd, int to_fd);

     int
     lcpxattr(const char *from, const char *to);

DESCRIPTION
     extattr_copy_file() copies extended attributes of namespace namespace
     from a file to another one.  extattr_copy_fd() does the same using open
     file descriptors, and extattr_copy_link() does the same as
     extattr_copy_file() but operates on symbolic links themselves instead of
     their targets.

     cpxattr(), fcpxattr(), and lcpxattr() respectively work the same was as
     extattr_copy_file(), extattr_copy_fd(), and extattr_copy_link(), but will
     copy extended attributes from all namespaces accessible to the user,
     silently skipping inaccessible namespaces.

     Please note that none of the extended attribute copying functions are
     atomic.

RETURN VALUES
     If any of the calls are unsuccessful, the value -1 is returned and the
     global variable errno is set to indicate the error.

ERRORS
     Extended attribute copying functions may raise errors produced by
     extattr_list_file(2) and extattr_get_file(2).

SEE ALSO
     getextattr(1), extattr_get_file(2), extattr_namespace_to_string(3),
     extattr(9)

HISTORY
     Extended attribute support was developed as part of the TrustedBSD
     Project, and introduced in FreeBSD 5.0 and NetBSD 3.0.  It was developed
     to support security extensions requiring additional labels to be
     associated with each file or directory.

NetBSD 10.99                   December 16, 2011                  NetBSD 10.99