On 9/12/2022 4:54 PM, Namjae Jeon wrote:
2022-09-13 8:38 GMT+09:00, Tom Talpey <tom@xxxxxxxxxx>:
On 9/9/2022 5:25 AM, Namjae Jeon wrote:
configuration.txt in ksmbd-tools moved to ksmbd.conf manpage.
update it and more detailed ksmbd-tools build method.
Reviewed-by: Sergey Senozhatsky <senozhatsky@xxxxxxxxxxxx>
Signed-off-by: Namjae Jeon <linkinjeon@xxxxxxxxxx>
---
v3:
- replace CIFS with SMB3 clients.
- update ksmbd built-in case.
- replace smb.conf leftover with ksmbd.conf.
- use full name of utils in ksmbd-tools instead of <foo>.
- fix the warnings from make htlmdocs build reported by kernel test
robot.
v2:
- rename smb.conf to ksmbd.conf.
- add how to set ksmbd module in menuconfig
- remove --syscondir option for configure, instead change ksmbd
directory to /usr/local/etc/ksmbd.
- change the prompt to '$'.
Documentation/filesystems/cifs/ksmbd.rst | 40 +++++++++++++++++-------
1 file changed, 29 insertions(+), 11 deletions(-)
diff --git a/Documentation/filesystems/cifs/ksmbd.rst
b/Documentation/filesystems/cifs/ksmbd.rst
index 1af600db2e70..4284341c89f3 100644
--- a/Documentation/filesystems/cifs/ksmbd.rst
+++ b/Documentation/filesystems/cifs/ksmbd.rst
@@ -118,26 +118,44 @@ ksmbd/nfsd interoperability Planned for future.
The features that ksmbd
How to run
==========
-1. Download ksmbd-tools and compile them.
- - https://github.com/cifsd-team/ksmbd-tools
+1. Download
ksmbd-tools(https://github.com/cifsd-team/ksmbd-tools/releases) and
+ compile them.
+
+ - Refer
README(https://github.com/cifsd-team/ksmbd-tools/blob/master/README.md)
+ to know how to use ksmbd.mountd/adduser/addshare/control utils
+
+ $ ./autogen.sh
+ $ ./configure --with-rundir=/run
+ $ make && sudo make install
2. Create user/password for SMB share.
- # mkdir /etc/ksmbd/
- # ksmbd.adduser -a <Enter USERNAME for SMB share access>
+ - See ksmbd.adduser manpage.
+
+ $ man ksmbd.adduser
+ $ sudo ksmbd.adduser -a <Enter USERNAME for SMB share access>
+
+3. Create /usr/local/etc/ksmbd/ksmbd.conf file, add SMB share in
ksmbd.conf file.
I missed this in the v2 match - are you intentionally moving the
ksmbd.conf file to /usr/local/etc? That seems a very mysterious
location. Nothing on my vanilla installed system places anything
in there.
To avoid conflicts with the existing distribution package, the default
location as far as I know is /usr/local/etc. And it can be changed
with --sysconfdir. It is same with samba.
I totally disagree with this. The kernel server is part of, well,
the kernel, and loading the kernel should not depend on a path like
/usr/local/etc. Also, nothing I know, including Samba, is deployed
with such a directory in my experience. I find smb.conf in /etc/samba.
Where are the ksmbd.<foo> helpers installed by default? /usr/local/sbin?
On my standard Ubuntu install (and presumably Debian?) they are in
/sbin.
Tom.
Also, doesn't this file need to exist before step 2??
Ah, Yes. Will switch them.
Thanks for your review!
Tom.
-3. Create /etc/ksmbd/smb.conf file, add SMB share in smb.conf file
- - Refer smb.conf.example and
-
https://github.com/cifsd-team/ksmbd-tools/blob/master/Documentation/configuration.txt
+ - Refer ksmbd.conf.example in ksmbd-utils, See ksmbd.conf manpage
+ for details to configure shares.
-4. Insert ksmbd.ko module
+ $ man ksmbd.conf
- # insmod ksmbd.ko
+4. Insert ksmbd.ko module after build your kernel. No need to load
module
+ if ksmbd is built into the kernel.
+
+ - Set ksmbd in menuconfig(e.g. $ make menuconfig)
+ [*] Network File Systems --->
+ <M> SMB3 server support (EXPERIMENTAL)
+
+ $ sudo modprobe ksmbd.ko
5. Start ksmbd user space daemon
- # ksmbd.mountd
-6. Access share from Windows or Linux using CIFS
+ $ sudo ksmbd.mountd
+
+6. Access share from Windows or Linux SMB3 clients (cifs.ko or smbclient
of samba)
Shutdown KSMBD
==============
