LCTL-CHANGELOG_REGISTER(8)

NAME
lctl-changelog_register - register changelog user for device

SYNOPSIS
lctl --device MDT_NAME changelog_register [--help|-h] [--mask|-m MASK] [--nameonly|-n] [--user|-u USERNAME]

DESCRIPTION
This command is used to register a new changelog user on selected device. New user may set specific MASK and/or specific unique username. Changelog entries will not be purged beyond any registered users' set point. See also lfs changelog_clear.

OPTIONS

-h, --help
    Output brief command usage help.

-m, --maskMASK
    Sets per-user changelog MASK. Mask is specified as set of keywords in form [+|-]MASK1[<,|+|->MASK2...]. Masks are separated by comma or '+' to indicate a mask to be added and by '-' to indicate mask to be removed. If mask list is started with '+' or '-' then masks are relative to the default changelog mask, otherwise mask is absolute. Possible mask keywords are: mark, creat, mkdir, hlink, slink, mknod, unlnk, rmdir, renme, rnmto, open, close, lyout, trunc, sattr, xattr, hsm, mtime, ctime, atime, migrt, flrw, resync, gxatr, nopen. The default changelog mask consists of all masks excluding: ``atime, open, gxatr, nopen''. Both uppercase and lowercase are accepted for keywords.

-n, --nameonly
    The output format modifier. If set then command outputs just changelog user name in format ID[-USERNAME]. Where ID stands for assigned changelog user ID.

-u, --userUSERNAME
    Specific username assigment. Unique name can be assigned to a new changelog user. Name must start with a letter and consist of letters, digits, '-' and '_' symbols with total length limited by 15 symbols.

EXAMPLES
Simple changelog user register on device testfs-MDT0000:
        # lctl --device testfs-MDT0000 changelog_register
        testfs-MDT0000: Registered changelog userid 'cl1'

Register changelog user with specific name testname:
        # lctl --device testfs-MDT0000 changelog_register -u testname
        lustre-MDT0000: Registered changelog userid 'cl1-testname'

Register changelog user with specific mask:
        # lctl --device testfs-MDT0000 changelog_register -m +open,atime,-hlink
        lustre-MDT0000: Registered changelog userid 'cl1'

Register changelog user with terse output:
        # lctl --device testfs-MDT0000 changelog_register -n
        cl1

AVAILABILITY
lctl changelog_register is a subcommand of lctl(8) and is distributed as part of the lustre(7) filesystem package since release 1.7.0

SEE ALSO
lctl(8), lctl-changelog_deregister(8)