summaryrefslogtreecommitdiffstats
path: root/docs-xml/manpages/vfs_default_quota.8.xml
blob: 7008f4e0332d03148b3d8905a6cbd170e933d661 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
<refentry id="vfs_default_quota.8">

<refmeta>
	<refentrytitle>vfs_default_quota</refentrytitle>
	<manvolnum>8</manvolnum>
	<refmiscinfo class="source">Samba</refmiscinfo>
	<refmiscinfo class="manual">System Administration tools</refmiscinfo>
	<refmiscinfo class="version">&doc.version;</refmiscinfo>
</refmeta>


<refnamediv>
	<refname>vfs_default_quota</refname>
	<refpurpose>store default quota records for Windows clients</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<cmdsynopsis>
		<command>vfs objects = default_quota</command>
	</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
	<title>DESCRIPTION</title>

	<para>This VFS module is part of the
	<citerefentry><refentrytitle>samba</refentrytitle>
	<manvolnum>7</manvolnum></citerefentry>
	suite.</para>

	<para>Many common quota implementations only store
	quotas for users and groups, but do not store a default quota. The
	<command>vfs_default_quota</command> module allows Samba to store
	default quota values which can be examined using the Windows
	Explorer interface.
	</para>

	<para>By default, Samba returns NO_LIMIT the default quota and
	refuses to update them. <command>vfs_default_quota</command> maps
	the default quota to the quota record of a user. By default the
	root user is taken because quota limits for root are typically
	not enforced.</para>

	<para>This module is stackable.</para>

</refsect1>


<refsect1>
	<title>OPTIONS</title>

	<variablelist>

		<varlistentry>
		<term>default_quota:uid = UID</term>
		<listitem>
		<para>UID specifies the user ID of the quota record where the
		default user quota values are stored.
		</para>

		</listitem>
		</varlistentry>

		<varlistentry>
		<term>default_quota:gid = GID</term>
		<listitem>
		<para>GID specifies the group ID of the quota record where the
		default group quota values are stored.
		</para>

		</listitem>
		</varlistentry>

		<varlistentry>
		<term>default_quota:uid nolimit = BOOL</term>
		<listitem>
		<para>If this parameter is True, then the user whose
		quota record is storing the default user quota will
		be reported as having a quota of NO_LIMIT. Otherwise,
		the stored values will be reported.
		</para>

		</listitem>
		</varlistentry>

		<varlistentry>
		<term>default_quota:gid nolimit = BOOL</term>
		<listitem>
		<para>If this parameter is True, then the group whose
		quota record is storing the default group quota will
		be reported as having a quota of NO_LIMIT. Otherwise,
		the stored values will be reported.
		</para>

		</listitem>
		</varlistentry>

	</variablelist>
</refsect1>

<refsect1>
	<title>EXAMPLES</title>

	<para>Store the default quota record in the quota record for
	the user with ID 65535 and report that user as having no quota
	limits:</para>

<programlisting>
        <smbconfsection name="[global]"/>
	<smbconfoption name="vfs objects">default_quota</smbconfoption>
	<smbconfoption name="default_quota:uid">65535</smbconfoption>
	<smbconfoption name="default_quota:uid nolimit">yes</smbconfoption>
</programlisting>

</refsect1>

<refsect1>
	<title>VERSION</title>

	<para>This man page is part of version &doc.version; of the Samba suite.
	</para>
</refsect1>

<refsect1>
	<title>AUTHOR</title>

	<para>The original Samba software and related utilities
	were created by Andrew Tridgell. Samba is now developed
	by the Samba Team as an Open Source project similar
	to the way the Linux kernel is developed.</para>

</refsect1>

</refentry>