.TH KSMBD.ADDSHARE "8" "" "ksmbd-tools 3.4.8" "System Administration"
.SH NAME
ksmbd.addshare \- configure shares for ksmbd.conf of ksmbd.mountd
.SH SYNOPSIS
.B ksmbd.addshare
[-v] {-a \fI\,SHARE\/\fR | -u \fI\,SHARE\/\fR} {-o \fI\,OPTIONS\/\fR} [-c \fI\,SMBCONF\/\fR]
.br
.B ksmbd.addshare
[-v] {-d \fI\,SHARE\/\fR} [-c \fI\,SMBCONF\/\fR]
.br
.B ksmbd.addshare
{-V | -h}
.SH DESCRIPTION
\fBksmbd.addshare\fR configures shares for \fBksmbd.conf\fP(5) configuration file of \fBksmbd.mountd\fP(8) user mode daemon.
\fBksmbd.addshare\fR modifies \fBksmbd.conf\fR such that its existing formatting is not retained.
\fBksmbd.addshare\fR notifies \fBksmbd.mountd\fR of changes if it had made any.
.SH OPTIONS
.TP
\fB\-a\fR, \fB\-\-add-share\fR=\fI\,SHARE\/\fR
Add \fI\,SHARE\/\fR to configuration file.
\fI\,SHARE\/\fR must be UTF-8 and [1, 64) bytes. \" KSMBD_REQ_MAX_SHARE_NAME
\fI\,SHARE\/\fR is case-insensitive.
\fI\,SHARE\/\fR cannot be \fBglobal\fR.
Initial parameters must be given with \fB\-\-options\fR.
.TP
\fB\-d\fR, \fB\-\-del-share\fR=\fI\,SHARE\/\fR
Delete \fI\,SHARE\/\fR from configuration file.
.TP
\fB\-u\fR, \fB\-\-update-share\fR=\fI\,SHARE\/\fR
Update \fI\,SHARE\/\fR in configuration file.
Updated parameters must be given with \fB\-\-options\fR.
.TP
\fB\-o\fR, \fB\-\-options\fR=\fI\,OPTIONS\/\fR
Use \fI\,OPTIONS\/\fR as parameters.
\fI\,OPTIONS\/\fR is one argument and follows format \fB1st par = 1st val<newline>2nd par = 2nd val...\fR.
Separators other than newline create ambiguity.
Global parameters cannot be given.
.TP
\fB\-c\fR, \fB\-\-config\fR=\fI\,SMBCONF\/\fR
Use \fI\,SMBCONF\/\fR as configuration file instead of \fB/etc/ksmbd/ksmbd.conf\fR. \" PATH_SMBCONF
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Be verbose.
.TP
\fB\-V\fR, \fB\-\-version\fR
Output version information and exit.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display this help and exit.
.SH "EXIT STATUS"
The exit status is 0 on success and 1 on failure.
Failure to notify \fBksmbd.mountd\fR of changes has no effect on exit status.
.SH COPYRIGHT
Copyright \(co 2015-2022 ksmbd-tools contributors.
License GPLv2: GNU GPL version 2 <https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "REPORTING BUGS"
For bug reports, use the issue tracker at https://github.com/cifsd-team/ksmbd-tools/issues.
.SH "SEE ALSO"
.TP
\fBConfiguration File\fR
\fBksmbd.conf\fP(5)
.TP
\fBUtilities\fR
\fBksmbd.adduser\fP(8),
\fBksmbd.control\fP(8),
\fBksmbd.mountd\fP(8)