llapi_pcc_del(3)

NAME

llapi_pcc_del - Delete a PCC backend from a client

SYNOPSIS

#include <lustre/lustreapi.h>

int llapi_pcc_del(const char *mntpath, const char *pccpath,
                  enum lu_pcc_cleanup_flags flags);

DESCRIPTION

The function llapi_pcc_del() deletes a PCC backend referenced by pccpath on the client with the mount point of mntpath. By default, when removing a PCC backend from a client, the action is to scan the PCC backend fs, uncache (detach and remove) all scanned PCC copies from PCC by FIDs. The input parameter flags currently only has one value PCC_CLEANUP_FL_KEEP_DATA that means it removes the PCC backend from the Lustre client, but retains the data on the cache. In this case, the PCC-RW backend falls back as a traditional HSM storage solution and the file data is still accessible as long as the copytool is still running at this client.

RETURN VALUES

llapi_pcc_del() returns 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 backend operation is not supported.

AVAILABILITY

llapi_pcc_del() is part of the lustre(7) user application interface library since release 2.16.0

SEE ALSO

lustreapi(7)