llapi_changelog_deregister(3)

NAME

llapi_changelog_deregister - Deregister changelog user on specific MDT device

SYNOPSIS

#include <lustre/lustreapi.h>

int llapi_changelog_deregister(const char *mdtname, const char *regname);

DESCRIPTION

The function llapi_changelog_deregister() deregisters changelog regname on specific MDT device mdtname (e.g. lustrefs-MDT0000). It must be run on the MDS node where the MDT is currently mounted.

The regname argument preferably uses the username specified during llapi_changelog_register(3) (e.g. 'audit') as this allows an application to deregister its changelog user by the preferred name regardless of which changelog user number was assigned, but it can also be the changelog user number (e.g. 'cl4' or '4'), or both (e.g. 'cl4-audit').

RETURN VALUES

Return 0 on success or a negative errno value on failure.

ERRORS

-EINVAL

MDT device is invalid or not found.

-ENOENT

Username is not found.

EXAMPLE

To deregister a previously-registered changelog user:

#include <lustre/lustreapi.h>
int main(int argc, char *argv[])
{
	char *mdtname = argv[1]; /* e.g. "testfs-MDT0000" */
	char *username = argv[2]; /* e.g. "cl4-audit" */
	int rc;
	rc = llapi_changelog_deregister(mdtname, username);
}

AVAILABILITY

llapi_changelog_deregister() is part of the lustre(7) user application interface library since release 2.18.0

SEE ALSO

llapi_changelog_register(3), lustreapi(7), lctl-changelog_deregister(8)