LLAPI\_PCC\_DEL(3) Lustre Library Functions LLAPI\_PCC\_DEL(3)

# [NAME](#NAME)

llapi\_pcc\_del - Delete a PCC backend from a client

# [SYNOPSIS](#SYNOPSIS)

```
#include <lustre/lustreapi.h>
```

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

# [DESCRIPTION](#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](#RETURN_VALUES)

**llapi\_pcc\_del()** returns 0 on success or a negative errno value on failure.

# [ERRORS](#ERRORS)

[**-ENOMEM**](#ENOMEM)

Insufficient memory to complete operation.

[**-EFAULT**](#EFAULT)

Memory region is not properly mapped.

[**-EINVAL**](#EINVAL)

One or more invalid arguments are given.

[**-EOPNOTSUPP**](#EOPNOTSUPP)

PCC backend operation is not supported.

# [AVAILABILITY](#AVAILABILITY)

**llapi\_pcc\_del()** is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) user application interface library since release 2.16.0

# [SEE ALSO](#SEE_ALSO)

[**lustreapi**(7)](/man/enterprise-packages/lustre/lustreapi.7)

2024-08-28 Lustre User API

---

Document: llapi_pcc_del(3) from lustre 2.17.59-r2 (Chainguard OS)
Source: https://github.com/lustre/lustre-release