KSMBD.ADDUSER(8)

📦
version 3.5.7 · 5 versions
, in nixpkgs unstable, ubuntu stonking

💖 KSMBD.ADDUSER — the manual, but make it cute 💖

okay so bestie, you're reading KSMBD.ADDUSER(8), a System Administration page, and honestly? it's giving "I manage users for a living and I'm thriving." let's get into it 🎀

✨ NAME ✨

ksmbd.adduser — configure users for ksmbdpwd.db of ksmbd.mountd

like that's literally the whole job. user management. slay. 💅

🌸 SYNOPSIS 🌸

ksmbd.adduser [-v] [-P PWDDB] [-C CONF] [-a | -u | -d] [-p PWD] USER

look at her. so structured. so iconic. ✨

🦋 DESCRIPTION 🦋

okay so ksmbd.adduser configures users for the ksmbdpwd.db(5) user database that belongs to the ksmbd.mountd(8) user mode daemon. that's the whole vibe 🫶

here's the smart part, no cap: ksmbd.adduser can parse the ksmbd.conf(5) configuration file so it can guard against deletion of users that are depended on. meaning it's not gonna let you delete somebody the config still needs. protective king behavior fr fr 👑

and when it actually makes changes, ksmbd.adduser notifies ksmbd.mountd about them. communication! healthy relationship! we love to see it 💖

💅 OPTIONS 💅

okay so first things first, if you don't give it neither -a, -u, nor -d — like none of them at all — it'll either add or update USER. dealer's choice, she decides. 😌

and some rules about USER, because there are always rules:

  • USER must be UTF-8 and [1, 48) bytes. yes that's a half-open interval bestie, the 48 is NOT included. 💀
  • USER cannot contain a colon (:). just don't.

now the actual flags, one by one, no skipping:

  • -a, --add — add USER to the user database. new friend acquired ✨
  • -u, --update — update USER in the user database. glow-up time 💅
  • -d, --delete — delete USER from the user database. we don't talk about them anymore 🚫
  • -p, --password=PWD — use PWD as the user password instead of prompting. PWD must be UTF-8 and [0, 129) bytes — yeah, 129 not included, and yes it can be zero bytes, that's a whole thing 🙈
  • -P, --pwddb=PWDDB — use PWDDB as the user database instead of /etc/ksmbd/ksmbdpwd.db. custom location, main character energy 👑
  • -C, --config=CONF — use CONF as the configuration file instead of /etc/ksmbd/ksmbd.conf. yep, another path swap 🦋
  • -v, --verbose — be verbose. she will yap (affectionately) 🗣️
  • -V, --version — output version information and exit. bye! 👋
  • -h, --help — display this help and exit. also bye! 👋

🔥 EXIT STATUS 🔥

the exit status is 0 on success and 1 on failure. simple. binary. she doesn't do nuance ✨

and here's the lowkey important bit: failure to notify ksmbd.mountd of changes has no effect on exit status. so like, if the notifying part flops, the exit status does not care. it's unbothered. 💅

Copyright © 2015-2022 ksmbd-tools contributors.

License GPLv2: GNU GPL version 2 <https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

(read that last one again bestie, NO WARRANTY, capital letters, they meant it 😭)

🐛 REPORTING BUGS 🐛

found a bug? for bug reports, use the issue tracker at <https://github.com/cifsd-team/ksmbd-tools/issues>.

go tell them, they wanna know, fr fr 🫶

🌈 SEE ALSO 🌈

User Database

Configuration File

Utilities

and that's the whole page bestie!! this was ksmbd-tools 3.5.7, manual page KSMBD.ADDUSER(8), and yes the date and version live down here at the bottom like a little signature. go add some users, you're gonna ate 💖✨🎀

📦 where this page comes from