llapi_pcc_detach_fid_fd(3)

NAME
llapi_pcc_detach_fid_fd, llapi_pcc_detach_fid, llapi_pcc_detach_fid_str, llapi_pcc_detach_file - detach the given file from PCC

SYNOPSIS
#include <lustre/lustreapi.h>

int llapi_pcc_detach_fid_fd(int dirfd, const struct lu_fid *fid);

int llapi_pcc_detach_fid(const char *mntpath, const struct lu_fid *fid);

int llapi_pcc_detach_fid_str(const char *mntpath, const char *fidstr);

int llapi_pcc_detach_file(const char *path);

DESCRIPTION

llapi_pcc_detach_fid_fd(), llapi_pcc_detach_fid(), llapi_pcc_detach_fid_str(), and llapi_pcc_detach_file() detaches a cached file from PCC by an ioctl on the dir. The file is referenced by fid, fidstr, or path. The dir, which usually a mount point dir that the copytool already has opened, is referenced by dirfd, mntpath, path.

RETURN VALUES

llapi_pcc_detach_fid_fd(), llapi_pcc_detach_fid(), llapi_pcc_detach_fid_str(), and llapi_pcc_detach_file() return 0 on success or a negative errno value on failure.

ERRORS

-ENOMEM
    Insufficient memory to complete operation.

-EFAULT
    Memory region is not properly mapped.

-EINVAL
    One or more invalid arguments are given.

-EOPNOTSUPP
    PCC state operation is not supported.

-ENOTTY
    File does not reside on a Lustre filesystem.

-ENOENT
    path does not exist.

SEE ALSO
llapi_pcc_attach(3), lustreapi(7)