---
name: "ksmbd.adduser"
section: "8"
platform: "linux"
package: "ksmbd-tools"
version: "3.5.3-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ksmbd.adduser"
---

# ksmbd.adduser(8)

configure users for ksmbdpwd.db of ksmbd.mountd

## NAME

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

## SYNOPSIS

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

## DESCRIPTION

**ksmbd.adduser** configures users for [**ksmbdpwd.db**(5)](/ksmbdpwd.db/5.md) user database of [**ksmbd.mountd**(8)](/ksmbd.mountd/8.md) user mode daemon. **ksmbd.adduser** can parse [**ksmbd.conf**(5)](/ksmbd.conf/5.md) configuration file so as to guard against deletion of users that are depended on. **ksmbd.adduser** notifies **ksmbd.mountd** of changes if it had made any.

## OPTIONS

If neither **-a**, **-u**, nor **-d** is given, either add or update *USER*. *USER* must be UTF-8 and \[1, 48) bytes.  *USER* cannot contain colon (**:**).

- **-a**, **--add**

  Add *USER* to user database.

- **-u**, **--update**

  Update *USER* in user database.

- **-d**, **--delete**

  Delete *USER* from user database.

- **-p**, **--password**=*PWD*

  Use *PWD* as user password instead of prompting. *PWD* must be UTF-8 and \[0, 129) bytes.

- **-P**, **--pwddb**=*PWDDB*

  Use *PWDDB* as user database instead of **/etc/ksmbd/ksmbdpwd.db**.

- **-C**, **--config**=*CONF*

  Use *CONF* as configuration file instead of **/etc/ksmbd/ksmbd.conf**.

- **-v**, **--verbose**

  Be verbose.

- **-V**, **--version**

  Output version information and exit.

- **-h**, **--help**

  Display this help and exit.

## EXIT STATUS

The exit status is 0 on success and 1 on failure. Failure to notify **ksmbd.mountd** of changes has no effect on exit status.

## COPYRIGHT

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.

## REPORTING BUGS

For bug reports, use the issue tracker at https://github.com/cifsd-team/ksmbd-tools/issues.

## SEE ALSO

- **User Database**

  [**ksmbdpwd.db**(5)](/ksmbdpwd.db/5.md)

- **Configuration File**

  [**ksmbd.conf**(5)](/ksmbd.conf/5.md)

- **Utilities**

  [**ksmbd.addshare**(8)](/ksmbd.addshare/8.md), [**ksmbd.control**(8)](/ksmbd.control/8.md), [**ksmbd.mountd**(8)](/ksmbd.mountd/8.md)