LCTL-CHA..._REGISTER(8)

📦 version 2.17.58, in ubuntu stonking

💖 LCTL-CHA..._REGISTER(8) 💖

okay bestie, you found the manual page for lctl-changelog_register, straight outta the Lustre Configuration Utilities family. pull up a chair, grab a strawberry 🍓, and let's get you registered.

✨ NAME ✨

lctl-changelog_register — register changelog user for device

like, it makes you a whole new changelog user. that's the vibe. 🫶

🦋 SYNOPSIS 🦋

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

that's the whole shape of it. --device MDT_NAME first, then the subcommand, then whatever lil extras you want. slay.

🌸 DESCRIPTION 🌸

This command is used to register a new changelog user on the selected device. no cap. 💅

A new user may set a specific MASK and/or a specific unique username — your call, both are optional. and here's the part you actually need to remember: changelog entries will not be purged beyond any registered users' set point. so the second you register, you're holding the line on those entries. iconic protective behaviour honestly. 👑

See also lfs changelog_clear — that's your other half, iykyk.

🎀 OPTIONS 🎀

  • -h, --help — outputs brief command usage help. the "help me pls" button. 🆘
  • -m, --maskMASK — sets the per-user changelog MASK. here's how the mask works, listen close bestie: it's specified as a set of keywords in the form [+|-]MASK1[<,|+|->MASK2...]. Masks are separated by comma or + to indicate a mask to be added, and by - to indicate a mask to be removed. If the mask list starts with + or - then the masks are relative to the default changelog mask, otherwise the 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. periodt.

  • -n, --nameonly — the output format modifier. If set, then the command outputs just the changelog user name in the format ID[-USERNAME]. Where ID stands for the assigned changelog user ID. terse queen behaviour, honestly. 🤏
  • -u, --userUSERNAME — specific username assignment. A unique name can be assigned to a new changelog user. The name must start with a letter and consist of letters, digits, - and _ symbols, with total length limited by 15 symbols. fifteen!! that's it!! don't push it!! 😭

💜 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

no notes. each one ate. 🔥

🌟 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. she's been around, she's established, she's a legacy icon. 👑

🌈 SEE ALSO 🌈

(that second one is literally the breakup button. when you're done, you deregister. growth. 🦋)

lowkey reminder: registering a user pins the changelog at their set point, so changelog entries will not be purged beyond it. don't register and then ghost it forever unless you want space to get spicy. 😭

okay that's the whole page bestie, you're fully caught up. this was Lustre, dated 2024-08-13, and it's the LCTL-CHA..._REGISTER(8) page — go forth and register responsibly. mwah. 💅🎀💖

📦 where this page comes from