From b1b1ba38793a6596ea807e436e93fba16438aa14 Mon Sep 17 00:00:00 2001 From: Jeremy Allison Date: Mon, 8 May 2006 23:21:03 +0000 Subject: [PATCH] Add section describing usershares. Let me know if the XML here is not valid (or looks bad). Jeremy. --- docs/manpages-3/smb.conf.5.xml | 88 ++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) diff --git a/docs/manpages-3/smb.conf.5.xml b/docs/manpages-3/smb.conf.5.xml index b9e092bf57c..5376b74c23b 100644 --- a/docs/manpages-3/smb.conf.5.xml +++ b/docs/manpages-3/smb.conf.5.xml @@ -294,6 +294,94 @@ alias|alias|alias|alias... + + USERSHARES + + Starting with Samba version 3.0.23 the capability for non-root users to add, modify, and delete + their own share definitions has been added. This capability is called usershares and + is controlled by a set of parameters in the [global] section of the smb.conf. + The relevent parameters are : + + + + + usershare allow guests + Controls if usershares can permit guest access. + + + + usershare max shares + Maximum number of user defined shares allowed. + + + + usershare owner only + If set only directories owned by the sharing user can be shared. + + + + usershare path + Points to the directory containing the user defined share definitions. + The filesystem permissions on this directory control who can create user defined shares. + + + + usershare prefix allow list + Comma-separated list of abolute pathnames restricting what directories + can be shared. Only directories below the pathnames in this list are permitted. + + + + usershare prefix deny list + Comma-separated list of abolute pathnames restricting what directories + can be shared. Directories below the pathnames in this list are prohibited. + + + + usershare template share + Names a pre-existing share used as a template for creating new usershares. + All other share parameters not specified in the user defined share definition + are copied from this named share. + + + + To allow members of the UNIX group foo to create user defined + shares, create the directory to contain the share definitions as follows: + + Become root: + + mkdir /usr/local/samba/lib/usershares + chgrp foo /usr/local/samba/lib/usershares + chmod 1770 /usr/local/samba/lib/usershares + + Then add the parameters usershare path = /usr/local/samba/lib/usershares, + usershare max shares = 10 (or the desired number of shares) to the global + section of your smb.conf. Members of the group foo may then manipulate the user defined shares + using the following commands. + + + + net usershare add sharename path [comment] [acl] [guest_ok=[y|n]] + To create or modify (overwrite) a user defined share. + + + + net usershare delete sharename + To delete a user defined share. + + + + net usershare list wildcard-sharename + To list user defined shares. + + + + net usershare info wildcard-sharename + To print information about user defined shares. + + + + PARAMETERS -- 2.34.1