svn commit: samba r10062 - in trunk/source/modules: .

[metze at samba.org]

Author: metze
Date: 2005-09-07 08:59:27 +0000 (Wed, 07 Sep 2005)
New Revision: 10062

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba&rev=10062

Log:
 r12017 at SERNOX (orig r10061):  metze | 2005-09-07 10:50:00 +0200
 add some description to the default_quota module
 
 jht: can you merge that to the howto, please?
 
 metze

Modified:
   trunk/source/modules/vfs_default_quota.c


Changeset:
Modified: trunk/source/modules/vfs_default_quota.c
===================================================================
--- trunk/source/modules/vfs_default_quota.c	2005-09-07 08:50:00 UTC (rev 10061)
+++ trunk/source/modules/vfs_default_quota.c	2005-09-07 08:59:27 UTC (rev 10062)
@@ -18,6 +18,56 @@
  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  */
 
+/*
+ * This module allows the default quota values,
+ * in the windows explorer GUI, to be stored on a samba server.
+ * The problem is that linux filesystems only store quotas
+ * for users and groups, but no default quotas.
+ *
+ * Samba returns NO_LIMIT as the default quotas by default
+ * and refuses to update them.
+ *
+ * With this module you can store the default quotas that are reported to
+ * a windows client, in the quota record of a user. By default the root user
+ * is taken because quota limits for root are typically not enforced.
+ *
+ * This module takes 2 parametric parameters in smb.conf:
+ * (the default prefix for them is 'default_quota',
+ *  it can be overwrittem when you load the module in
+ *  the 'vfs modules' parameter like this:
+ *  vfs modules = default_quota:myprefix)
+ * 
+ * "<prefix>:uid" parameter takes a integer argument,
+ *     it specifies the uid of the quota record, that will be taken for
+ *     storing the default USER-quotas.
+ *
+ *     - default value: '0' (for root user)
+ *     - e.g.: default_quota:uid = 65534
+ *
+ * "<prefix>:uid nolimit" parameter takes a boolean argument,
+ *     it specifies if we should report the stored default quota values,
+ *     also for the user record, or if you should just report NO_LIMIT
+ *     to the windows client for the user specified by the "<prefix>:uid" parameter.
+ *     
+ *     - default value: yes (that means to report NO_LIMIT)
+ *     - e.g.: default_quota:uid nolimit = no
+ * 
+ * "<prefix>:gid" parameter takes a integer argument,
+ *     it's just like "<prefix>:uid" but for group quotas.
+ *     (NOTE: group quotas are not supported from the windows explorer!)
+ *
+ *     - default value: '0' (for root group)
+ *     - e.g.: default_quota:gid = 65534
+ *
+ * "<prefix>:gid nolimit" parameter takes a boolean argument,
+ *     it's just like "<prefix>:uid nolimit" but for group quotas.
+ *     (NOTE: group quotas are not supported from the windows explorer!)
+ *     
+ *     - default value: yes (that means to report NO_LIMIT)
+ *     - e.g.: default_quota:uid nolimit = no
+ *
+ */
+
 #include "includes.h"
 
 #undef DBGC_CLASS