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)