[Pkg-samba-maint] r1839 - branches/samba/experimental/debian/patches
bubulle at alioth.debian.org
bubulle at alioth.debian.org
Sat Apr 26 10:13:28 UTC 2008
Author: bubulle
Date: 2008-04-26 10:13:27 +0000 (Sat, 26 Apr 2008)
New Revision: 1839
Modified:
branches/samba/experimental/debian/patches/usershare.patch
Log:
Adapted for 3.2.0pre3
Modified: branches/samba/experimental/debian/patches/usershare.patch
===================================================================
--- branches/samba/experimental/debian/patches/usershare.patch 2008-04-26 10:13:02 UTC (rev 1838)
+++ branches/samba/experimental/debian/patches/usershare.patch 2008-04-26 10:13:27 UTC (rev 1839)
@@ -8,21 +8,21 @@
Status wrt upstream: Debian-specific
-Index: samba-3.2.0pre2/docs/manpages/smb.conf.5
+Index: samba-3.2.0pre3/docs/manpages/smb.conf.5
===================================================================
---- samba-3.2.0pre2.orig/docs/manpages/smb.conf.5
-+++ samba-3.2.0pre2/docs/manpages/smb.conf.5
-@@ -252,7 +252,7 @@
+--- samba-3.2.0pre3.orig/docs/manpages/smb.conf.5
++++ samba-3.2.0pre3/docs/manpages/smb.conf.5
+@@ -269,7 +269,7 @@
.PP
usershare path
.RS 4
--Points to the directory containing the user defined share definitions. The filesystem permissions on this directory control who can create user defined shares.
+-Points to the directory containing the user defined share definitions\. The filesystem permissions on this directory control who can create user defined shares\.
+Points to the directory containing the user-defined share definitions. The filesystem permissions on this directory control who can create user-defined shares.
.RE
.PP
usershare prefix allow list
-@@ -270,32 +270,7 @@
- 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.
+@@ -287,31 +287,7 @@
+ 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\.
.RE
.PP
-To allow members of the UNIX group
@@ -30,85 +30,83 @@
-to create user defined shares, create the directory to contain the share definitions as follows:
-.PP
-Become root:
--
+-.sp
+-.RS 4
-.nf
--
-mkdir /usr/local/samba/lib/usershares
-chgrp foo /usr/local/samba/lib/usershares
-chmod 1770 /usr/local/samba/lib/usershares
--
-.fi
+-.RE
-.PP
-Then add the parameters
--
-.sp
--
+-.RS 4
-.nf
--
-- usershare path = /usr/local/samba/lib/usershares
-- usershare max shares = 10 # (or the desired number of shares)
--
+- \fIusershare path = /usr/local/samba/lib/usershares\fR
+- \fIusershare max shares = 10\fR # (or the desired number of shares)
-.fi
+-.RE
+-.sp
-to the global section of your
--\fIsmb.conf\fR. Members of the group foo may then manipulate the user defined shares using the following commands.
+-\fIsmb\.conf\fR\. Members of the group foo may then manipulate the user defined shares using the following commands\.
+Members of the \fBsambashare\fR group can manipulate the user-defined shares using the following commands:
.PP
net usershare add sharename path [comment] [acl] [guest_ok=[y|n]]
.RS 4
-@@ -7083,9 +7058,9 @@
- .PP
+@@ -8723,25 +8699,25 @@
usershare path (G)
+ .PP
.RS 4
--This parameter specifies the absolute path of the directory on the filesystem used to store the user defined share definition files. This directory must be owned by root, and have no access for other, and be writable only by the group owner. In addition the "sticky" bit must also be set, restricting rename and delete to owners of a file (in the same way the /tmp directory is usually configured). Members of the group owner of this directory are the users allowed to create usershares. If this parameter is undefined then no user defined shares are allowed.
+-This parameter specifies the absolute path of the directory on the filesystem used to store the user defined share definition files\. This directory must be owned by root, and have no access for other, and be writable only by the group owner\. In addition the "sticky" bit must also be set, restricting rename and delete to owners of a file (in the same way the /tmp directory is usually configured)\. Members of the group owner of this directory are the users allowed to create usershares\. If this parameter is undefined then no user defined shares are allowed\.
+This parameter specifies the absolute path of the directory on the filesystem used to store the user-defined share definition files. This directory must be owned by root, and have no access for other, and be writable only by the group owner. In addition the "sticky" bit must also be set, restricting rename and delete to owners of a file (in the same way the /tmp directory is usually configured). Members of the group owner of this directory are the users allowed to create usershares. If this parameter is undefined then no user-defined shares are allowed.
.sp
--For example, a valid usershare directory might be /usr/local/samba/lib/usershares, set up as follows.
+-For example, a valid usershare directory might be /usr/local/samba/lib/usershares, set up as follows\.
+For example, on Debian the default usershare directory of /var/lib/samba/usershares is set up as follows.
.sp
-
-@@ -7093,16 +7068,16 @@
-
+ .sp
+ .RS 4
.nf
-
-- ls -ld /usr/local/samba/lib/usershares/
-- drwxrwx--T 2 root power_users 4096 2006-05-05 12:27 /usr/local/samba/lib/usershares/
+- ls \-ld /usr/local/samba/lib/usershares/
+- drwxrwx\-\-T 2 root power_users 4096 2006\-05\-05 12:27 /usr/local/samba/lib/usershares/
+ ls -ld /var/lib/samba/usershares/
+ drwxrwx--T 2 root sambashare 4096 2006-05-05 12:27 /var/lib/samba/usershares/
.fi
-
+ .RE
.sp
--In this case, only members of the group "power_users" can create user defined shares.
+ .sp
+-In this case, only members of the group "power_users" can create user defined shares\.
+In this case, only members of the group "sambashare" can create user defined shares.
.sp
Default:
--\fB\fIusershare path\fR = NULL \fR
+-\fI\fIusershare path\fR\fR\fI = \fR\fINULL\fR\fI \fR
+\fB\fIusershare path\fR = /var/lib/samba/usershares \fR
.RE
- .PP
+
usershare prefix allow list (G)
-Index: samba-3.2.0pre2/docs/manpages/net.8
+Index: samba-3.2.0pre3/docs/manpages/net.8
===================================================================
---- samba-3.2.0pre2.orig/docs/manpages/net.8
-+++ samba-3.2.0pre2/docs/manpages/net.8
-@@ -677,9 +677,9 @@
- Store a secret for the specified domain, used primarily for domains that use idmap_ldap as a backend. In this case the secret is used as the password for the user DN used to bind to the ldap server.
+--- samba-3.2.0pre3.orig/docs/manpages/net.8
++++ samba-3.2.0pre3/docs/manpages/net.8
+@@ -660,9 +660,9 @@
+ Store a secret for the specified domain, used primarily for domains that use idmap_ldap as a backend\. In this case the secret is used as the password for the user DN used to bind to the ldap server\.
.SS "USERSHARE"
.PP
--Starting with version 3.0.23, a Samba server now supports the ability for non-root users to add user defined shares to be exported using the "net usershare" commands.
-+Starting with version 3.0.23, a Samba server now supports the ability for non-root users to add user-defined shares to be exported using the "net usershare" commands.
+-Starting with version 3\.0\.23, a Samba server now supports the ability for non\-root users to add user defined shares to be exported using the "net usershare" commands\.
++Starting with version 3\.0\.23, a Samba server now supports the ability for non\-root users to add user-defined shares to be exported using the "net usershare" commands\.
.PP
--To set this up, first set up your smb.conf by adding to the [global] section: usershare path = /usr/local/samba/lib/usershares Next create the directory /usr/local/samba/lib/usershares, change the owner to root and set the group owner to the UNIX group who should have the ability to create usershares, for example a group called "serverops". Set the permissions on /usr/local/samba/lib/usershares to 01770. (Owner and group all access, no access for others, plus the sticky bit, which means that a file in that directory can be renamed or deleted only by the owner of the file). Finally, tell smbd how many usershares you will allow by adding to the [global] section of smb.conf a line such as : usershare max shares = 100. To allow 100 usershare definitions. Now, members of the UNIX group "serverops" can create user defined shares on demand using the commands below.
+-To set this up, first set up your smb\.conf by adding to the [global] section: usershare path = /usr/local/samba/lib/usershares Next create the directory /usr/local/samba/lib/usershares, change the owner to root and set the group owner to the UNIX group who should have the ability to create usershares, for example a group called "serverops"\. Set the permissions on /usr/local/samba/lib/usershares to 01770\. (Owner and group all access, no access for others, plus the sticky bit, which means that a file in that directory can be renamed or deleted only by the owner of the file)\. Finally, tell smbd how many usershares you will allow by adding to the [global] section of smb\.conf a line such as : usershare max shares = 100\. To allow 100 usershare definitions\. Now, members of the UNIX group "serverops" can create user defined shares on demand using the commands below\.
+Members of the UNIX group "sambashare" can create user-defined shares on demand using the commands below.
.PP
The usershare commands are:
.IP "" 4
-Index: samba-3.2.0pre2/source/param/loadparm.c
+Index: samba-3.2.0pre3/source/param/loadparm.c
===================================================================
---- samba-3.2.0pre2.orig/source/param/loadparm.c
-+++ samba-3.2.0pre2/source/param/loadparm.c
-@@ -1745,7 +1745,7 @@
+--- samba-3.2.0pre3.orig/source/param/loadparm.c
++++ samba-3.2.0pre3/source/param/loadparm.c
+@@ -4868,7 +4868,7 @@
string_set(&Globals.szUsersharePath, s);
SAFE_FREE(s);
string_set(&Globals.szUsershareTemplateShare, "");
@@ -117,89 +115,3 @@
/* By default disallow sharing of directories not owned by the sharer. */
Globals.bUsershareOwnerOnly = True;
/* By default disallow guest access to usershares. */
-Index: samba-3.2.0pre2/docs/htmldocs/manpages/smb.conf.5.html
-===================================================================
---- samba-3.2.0pre2.orig/docs/htmldocs/manpages/smb.conf.5.html
-+++ samba-3.2.0pre2/docs/htmldocs/manpages/smb.conf.5.html
-@@ -164,8 +164,8 @@
- their own share definitions has been added. This capability is called <span class="emphasis"><em>usershares</em></span> and
- is controlled by a set of parameters in the [global] section of the smb.conf.
- The relevant parameters are :
-- </p><div class="variablelist"><dl><dt><span class="term">usershare allow guests</span></dt><dd><p>Controls if usershares can permit guest access.</p></dd><dt><span class="term">usershare max shares</span></dt><dd><p>Maximum number of user defined shares allowed.</p></dd><dt><span class="term">usershare owner only</span></dt><dd><p>If set only directories owned by the sharing user can be shared.</p></dd><dt><span class="term">usershare path</span></dt><dd><p>Points to the directory containing the user defined share definitions.
-- The filesystem permissions on this directory control who can create user defined shares.</p></dd><dt><span class="term">usershare prefix allow list</span></dt><dd><p>Comma-separated list of absolute pathnames restricting what directories
-+ </p><div class="variablelist"><dl><dt><span class="term">usershare allow guests</span></dt><dd><p>Controls if usershares can permit guest access.</p></dd><dt><span class="term">usershare max shares</span></dt><dd><p>Maximum number of user defined shares allowed.</p></dd><dt><span class="term">usershare owner only</span></dt><dd><p>If set only directories owned by the sharing user can be shared.</p></dd><dt><span class="term">usershare path</span></dt><dd><p>Points to the directory containing the user-defined share definitions.
-+ The filesystem permissions on this directory control who can create user-defined shares.</p></dd><dt><span class="term">usershare prefix allow list</span></dt><dd><p>Comma-separated list of absolute pathnames restricting what directories
- can be shared. Only directories below the pathnames in this list are permitted.</p></dd><dt><span class="term">usershare prefix deny list</span></dt><dd><p>Comma-separated list of absolute pathnames restricting what directories
- can be shared. Directories below the pathnames in this list are prohibited.</p></dd><dt><span class="term">usershare template share</span></dt><dd><p>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
-@@ -4654,25 +4654,25 @@
- </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare owner only</code></em> = <code class="literal">True</code>
- </em></span>
- </p></dd><dt><span class="term"><a name="USERSHAREPATH"></a>usershare path (G)</span></dt><dd><p>This parameter specifies the absolute path of the directory on the
-- filesystem used to store the user defined share definition files.
-+ filesystem used to store the user-defined share definition files.
- This directory must be owned by root, and have no access for
- other, and be writable only by the group owner. In addition the
- "sticky" bit must also be set, restricting rename and delete to
- owners of a file (in the same way the /tmp directory is usually configured).
- Members of the group owner of this directory are the users allowed to create
-- usershares. If this parameter is undefined then no user defined
-+ usershares. If this parameter is undefined then no user-defined
- shares are allowed.
- </p><p>
-- For example, a valid usershare directory might be /usr/local/samba/lib/usershares,
-- set up as follows.
-+ For example, on Debian the default usershare directory of
-+ /var/lib/samba/usershares is set up as follows.
- </p><p>
- </p><pre class="programlisting">
-- ls -ld /usr/local/samba/lib/usershares/
-- drwxrwx--T 2 root power_users 4096 2006-05-05 12:27 /usr/local/samba/lib/usershares/
-+ ls -ld /var/lib/samba/usershares/
-+ drwxrwx--T 2 root sambashare 4096 2006-05-05 12:27 /var/lib/samba/usershares/
- </pre><p>
- </p><p>
-- In this case, only members of the group "power_users" can create user defined shares.
-- </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare path</code></em> = <code class="literal">NULL</code>
-+ In this case, only members of the group "sambashare" can create user defined shares.
-+ </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare path</code></em> = <code class="literal">/var/lib/samba/usershares</code>
- </em></span>
- </p></dd><dt><span class="term"><a name="USERSHAREPREFIXALLOWLIST"></a>usershare prefix allow list (G)</span></dt><dd><p>This parameter specifies a list of absolute pathnames
- the root of which are allowed to be exported by user defined share definitions.
-Index: samba-3.2.0pre2/docs/htmldocs/manpages/net.8.html
-===================================================================
---- samba-3.2.0pre2.orig/docs/htmldocs/manpages/net.8.html
-+++ samba-3.2.0pre2/docs/htmldocs/manpages/net.8.html
-@@ -260,30 +260,10 @@
- that use idmap_ldap as a backend. In this case the secret is used
- as the password for the user DN used to bind to the ldap server.
- </p></div><div class="refsect2" lang="en"><a name="id309566"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
--non-root users to add user defined shares to be exported using the "net usershare"
-+non-root users to add user-defined shares to be exported using the "net usershare"
- commands.
- </p><p>
--To set this up, first set up your smb.conf by adding to the [global] section:
--
--usershare path = /usr/local/samba/lib/usershares
--
--Next create the directory /usr/local/samba/lib/usershares, change the owner to root and
--set the group owner to the UNIX group who should have the ability to create usershares,
--for example a group called "serverops".
--
--Set the permissions on /usr/local/samba/lib/usershares to 01770.
--
--(Owner and group all access, no access for others, plus the sticky bit,
--which means that a file in that directory can be renamed or deleted only
--by the owner of the file).
--
--Finally, tell smbd how many usershares you will allow by adding to the [global]
--section of smb.conf a line such as :
--
--usershare max shares = 100.
--
--To allow 100 usershare definitions. Now, members of the UNIX group "serverops"
--can create user defined shares on demand using the commands below.
-+Members of the UNIX group "sambashare" can create user-defined shares on demand using the commands below.
- </p><p>The usershare commands are:
-
- </p><table class="simplelist" border="0" summary="Simple list"><tr><td>net usershare add sharename path [comment] [acl] [guest_ok=[y|n]] - to add or change a user defined share.</td></tr><tr><td>net usershare delete sharename - to delete a user defined share.</td></tr><tr><td>net usershare info [-l|--long] [wildcard sharename] - to print info about a user defined share.</td></tr><tr><td>net usershare list [-l|--long] [wildcard sharename] - to list user defined shares.</td></tr></table><p>
More information about the Pkg-samba-maint
mailing list