NAME¶

ksmbd.addshare - configure shares for ksmbd.conf of ksmbd.mountd

SYNOPSIS¶

ksmbd.addshare [-v] [-C CONF] [-P PWDDB] [-a | -u | -d] [-o OPT]... SHARE

DESCRIPTION¶

ksmbd.addshare configures shares for ksmbd.conf(5) configuration file of ksmbd.mountd(8) user mode daemon. ksmbd.addshare modifies ksmbd.conf such that its existing formatting is not retained. ksmbd.addshare can parse ksmbdpwd.db(5) user database so as to provide completions when prompting. ksmbd.addshare notifies ksmbd.mountd of changes if it had made any. ksmbd.addshare will only make changes that do not require restarting ksmbd.mountd and ksmbd to take effect.

OPTIONS¶

If neither -a, -u, nor -d is given, either add or update SHARE. SHARE must be UTF-8 and [1, 64) bytes. SHARE is case-insensitive.

-a, --add

Add SHARE to configuration file.

-u, --update

Update SHARE in configuration file.

-d, --delete

Delete SHARE from configuration file.

-o, --option=OPT

Use OPT as share parameter instead of prompting. This option can be given multiple times.

-C, --config=CONF

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

-P, --pwddb=PWDDB

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

-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¶

Configuration File

ksmbd.conf(5)

User Database

ksmbdpwd.db(5)

Utilities

ksmbd.adduser(8), ksmbd.control(8), ksmbd.mountd(8)