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. > > 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 >> ============== >
