~ubuntu-branches/ubuntu/intrepid/samba/intrepid-updates

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/vfs/getquotacommand.xml

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2008-06-02 09:01:46 UTC
  • mfrom: (0.25.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20080602090146-92ur4nx39ccg708r
Tags: 2:3.0.30-2ubuntu1
* Merge from debian unstable, remaining changes:
  * debian/patches/VERSION.patch
    - set SAMABA_VERSION_VENDOR_SUFFIX to Ubuntu
  * debian/smb.conf
    - add "(Samba, Ubuntu)" to server string.
    - comment out the default [homes] shares, and a comment about
      "value users = %S to show users how to restrict access to 
      \\server\useranem to only username.
    - Add map to guest = Bad user, maps bad username to guest access.
      (LP: #32067)
  * debian/samba-common.postinst:
    - Fix upgrade from a first installation done with feisty, edgy, or dapper.
      (LP: #201059)
    - When populating the new sambashare group, it's not an error if the user
      simply doesn't exist; test for this case and the install continue 
      instead of aborting. (LP: #206036)
  * debian/smba-common.config:
    - do not change priority to HIGH if dhclient3 is installed
    - used priority medium instead of hight for the workgroup question
  * debian/winbind.files
    - insclude additional files
  * debian/patches/fix-documentation.patch:
    - fix typos in net(8) and smb.conf(5) man pages
  * debian/mksambapasswd.awk:
    - Don't add user with UID less than 1000 to smbpasswd.
  * debian/samba.init:
    - add 'status' option for LSB conformance.
  * Updated control version.
  * Dropped Changes:
    - Dropped debian/patches/fix-smbprinting-os2.patch. Accepted upstream.
    - Dropped debian/patches/fix-documentation.patch. Accepted upstream.
     

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<samba:parameter name="get quota command"
 
2
                 context="G"
 
3
                                 type="string"
 
4
                 advanced="1" developer="1"
 
5
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 
6
<description>
 
7
        <para>The <command>get quota command</command> should only be used 
 
8
        whenever there is no operating system API available from the OS that 
 
9
        samba can use.</para>
 
10
 
 
11
        <para>This option is only available with <command>./configure --with-sys-quotas</command>.
 
12
        Or on linux when <command>./configure --with-quotas</command> was used and a working quota api 
 
13
        was found in the system.</para>
 
14
 
 
15
        <para>This parameter should specify the path to a script that 
 
16
        queries the quota information for the specified 
 
17
        user/group for the partition that 
 
18
        the specified directory is on.</para>
 
19
 
 
20
        <para>Such a script should take 3 arguments:</para>
 
21
 
 
22
        <itemizedlist>
 
23
                <listitem><para>directory</para></listitem>
 
24
                <listitem><para>type of query</para></listitem>
 
25
                <listitem><para>uid of user or gid of group</para></listitem>
 
26
        </itemizedlist>
 
27
 
 
28
        <para>The type of query can be one of :</para>
 
29
 
 
30
        <itemizedlist>
 
31
                <listitem><para>1 - user quotas</para></listitem>
 
32
                <listitem><para>2 - user default quotas (uid = -1)</para></listitem>
 
33
                <listitem><para>3 - group quotas</para></listitem>
 
34
                <listitem><para>4 - group default quotas (gid = -1)</para></listitem>
 
35
        </itemizedlist>
 
36
 
 
37
        <para>This script should print one line as output with spaces between the arguments. The arguments are: 
 
38
              </para>
 
39
 
 
40
        <itemizedlist>
 
41
                <listitem><para>Arg 1 - quota flags (0 = no quotas, 1 = quotas enabled, 2 = quotas enabled and enforced)</para></listitem>
 
42
                <listitem><para>Arg 2 - number of currently used blocks</para></listitem>
 
43
                <listitem><para>Arg 3 - the softlimit number of blocks</para></listitem>
 
44
                <listitem><para>Arg 4 - the hardlimit number of blocks</para></listitem>
 
45
                <listitem><para>Arg 5 - currently used number of inodes</para></listitem>
 
46
                <listitem><para>Arg 6 - the softlimit number of inodes</para></listitem>
 
47
                <listitem><para>Arg 7 - the hardlimit number of inodes</para></listitem>
 
48
                <listitem><para>Arg 8(optional) - the number of bytes in a block(default is 1024)</para></listitem>
 
49
        </itemizedlist>
 
50
</description>
 
51
 
 
52
<related>set quote command</related>
 
53
<value type="default"></value>
 
54
<value type="example">/usr/local/sbin/query_quota</value>
 
55
</samba:parameter>