/cifsd-tools

Userspace Utility for cifsd kernel server on Linux kernel

Primary LanguageCGNU General Public License v2.0GPL-2.0

________________________
BUILDING CIFSD TOOLS
________________________

Install preprequisite packages:
	For Ubuntu:
	sudo apt-get install autoconf libtool pkg-config libnl-3-dev \
	libnl-genl-3-dev libglib2.0-dev

	For Fedora, RHEL:
	sudo yum install autoconf automake libtool glib2-devl libnl3-devl

	For CentOS:
	sudo yum install glib2-devel libnl3-devel

Build steps:
        - cd into the cifsd-tools directory
        - ./autogen.sh
        - ./configure
        - make
        - make install

_____________________
USING CIFSD TOOLS
_____________________

Setup steps:
	- install smbd kernel driver
		modprobe ksmbd
	- create user/password for SMB share
		mkdir /etc/ksmbd/
		ksmbd.adduser -a <Enter USERNAME for SMB share access>
		Enter password for SMB share access
	- create /etc/ksmbd/smb.conf file, add SMB share in smb.conf file
		Refer smb.conf.example
	- start smbd user space daemon
		ksmbd.mountd
	- access share from Windows or Linux using CIFS

_____________________
RESTART CIFSD
_____________________

steps:
	- kill user space daemon
		killall ksmbd.mountd
	- kill kernel space daemon
		echo hard > /sys/class/ksmbd-control/kill_server
	- restart user space daemon
		ksmbd.mountd


--------------------
ADMIN TOOLS
--------------------

- ksmbd.adduser
	Adds, updates or removes (-a/-u/-d) a user from ksmbd pwd file.

- ksmbd.addshare
	Adds, updates or removes (-a/-u/-d) a net share from smb.conf file.

Usage example:

Creating a new share:

ksmbd.addshare -a files -o "\
		     path=/home/users/files \
		     comment=exported files \
		     writeable=yes \
		     read only = no \
		     "

Note that share options (-o) must always be enquoted ("...").

ksmbd.addshare tool does not modify [global] smb.conf section; only net
share configs are supported at the moment.