mirror of
https://github.com/samba-team/samba.git
synced 2025-02-23 09:57:40 +03:00
391 lines
7.7 KiB
HTML
391 lines
7.7 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<HTML
|
||
|
|
><HEAD
|
||
|
|
><TITLE
|
||
|
|
>smbcquotas</TITLE
|
||
|
|
><META
|
||
|
|
NAME="GENERATOR"
|
||
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
|
||
|
|
><BODY
|
||
|
|
CLASS="REFENTRY"
|
||
|
|
BGCOLOR="#FFFFFF"
|
||
|
|
TEXT="#000000"
|
||
|
|
LINK="#0000FF"
|
||
|
|
VLINK="#840084"
|
||
|
|
ALINK="#0000FF"
|
||
|
|
><H1
|
||
|
|
><A
|
||
|
|
NAME="SMBCQUOTAS.1"
|
||
|
|
></A
|
||
|
|
>smbcquotas</H1
|
||
|
|
><DIV
|
||
|
|
CLASS="REFNAMEDIV"
|
||
|
|
><A
|
||
|
|
NAME="AEN5"
|
||
|
|
></A
|
||
|
|
><H2
|
||
|
|
>Name</H2
|
||
|
|
>smbcquotas -- Set or get QUOTAs of NTFS 5 shares</DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="REFSYNOPSISDIV"
|
||
|
|
><A
|
||
|
|
NAME="AEN8"
|
||
|
|
></A
|
||
|
|
><H2
|
||
|
|
>Synopsis</H2
|
||
|
|
><P
|
||
|
|
><B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>smbcquotas</B
|
||
|
|
> {//server/share} [-u user] [-L] [-F] [-S QUOTA_SET_COMMAND] [-n] [-t] [-v] [-d debuglevel] [-s configfile] [-l logfilebase] [-V] [-U username] [-N] [-k] [-A]</P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="REFSECT1"
|
||
|
|
><A
|
||
|
|
NAME="AEN27"
|
||
|
|
></A
|
||
|
|
><H2
|
||
|
|
>DESCRIPTION</H2
|
||
|
|
><P
|
||
|
|
>This tool is part of the <SPAN
|
||
|
|
CLASS="CITEREFENTRY"
|
||
|
|
><SPAN
|
||
|
|
CLASS="REFENTRYTITLE"
|
||
|
|
>Samba</SPAN
|
||
|
|
>(7)</SPAN
|
||
|
|
> suite.</P
|
||
|
|
><P
|
||
|
|
>The <B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>smbcquotas</B
|
||
|
|
> program manipulates NT Quotas on SMB file shares. </P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="REFSECT1"
|
||
|
|
><A
|
||
|
|
NAME="AEN35"
|
||
|
|
></A
|
||
|
|
><H2
|
||
|
|
>OPTIONS</H2
|
||
|
|
><P
|
||
|
|
>The following options are available to the <B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>smbcquotas</B
|
||
|
|
> program. </P
|
||
|
|
><P
|
||
|
|
></P
|
||
|
|
><DIV
|
||
|
|
CLASS="VARIABLELIST"
|
||
|
|
><DL
|
||
|
|
><DT
|
||
|
|
>-u user</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
> Specifies the user of whom the quotas are get or set.
|
||
|
|
By default the current user's username will be used.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-L</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>Lists all quota records of the share.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-F</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>Show the share quota status and default limits.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-S QUOTA_SET_COMMAND</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>This command set/modify quotas for a user or on the share,
|
||
|
|
depending on the QUOTA_SET_COMMAND parameter witch is described later</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-n</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>This option displays all QUOTA information in numeric
|
||
|
|
format. The default is to convert SIDs to names and QUOTA limits
|
||
|
|
to a readable string format. </P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-t</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
> Don't actually do anything, only validate the correctness of
|
||
|
|
the arguments.
|
||
|
|
</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-v</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
> Be verbose.
|
||
|
|
</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-h|--help</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>Print a summary of command line options.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-V</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>Prints the version number for
|
||
|
|
<B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>smbd</B
|
||
|
|
>.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-s <configuration file></DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>The file specified contains the
|
||
|
|
configuration details required by the server. The
|
||
|
|
information in this file includes server-specific
|
||
|
|
information such as what printcap file to use, as well
|
||
|
|
as descriptions of all the services that the server is
|
||
|
|
to provide. See <A
|
||
|
|
HREF="smb.conf.5.html"
|
||
|
|
TARGET="_top"
|
||
|
|
><TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>smb.conf(5)</TT
|
||
|
|
></A
|
||
|
|
> for more information.
|
||
|
|
The default configuration file name is determined at
|
||
|
|
compile time.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-d|--debug=debuglevel</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
><VAR
|
||
|
|
CLASS="REPLACEABLE"
|
||
|
|
>debuglevel</VAR
|
||
|
|
> is an integer
|
||
|
|
from 0 to 10. The default value if this parameter is
|
||
|
|
not specified is zero.</P
|
||
|
|
><P
|
||
|
|
>The higher this value, the more detail will be
|
||
|
|
logged to the log files about the activities of the
|
||
|
|
server. At level 0, only critical errors and serious
|
||
|
|
warnings will be logged. Level 1 is a reasonable level for
|
||
|
|
day to day running - it generates a small amount of
|
||
|
|
information about operations carried out.</P
|
||
|
|
><P
|
||
|
|
>Levels above 1 will generate considerable
|
||
|
|
amounts of log data, and should only be used when
|
||
|
|
investigating a problem. Levels above 3 are designed for
|
||
|
|
use only by developers and generate HUGE amounts of log
|
||
|
|
data, most of which is extremely cryptic.</P
|
||
|
|
><P
|
||
|
|
>Note that specifying this parameter here will
|
||
|
|
override the <A
|
||
|
|
HREF="smb.conf.5.html#loglevel"
|
||
|
|
TARGET="_top"
|
||
|
|
>log
|
||
|
|
level</A
|
||
|
|
> parameter in the <A
|
||
|
|
HREF="smb.conf.5.html"
|
||
|
|
TARGET="_top"
|
||
|
|
><TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>smb.conf(5)</TT
|
||
|
|
></A
|
||
|
|
> file.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-l|--logfile=logbasename</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>File name for log/debug files. The extension
|
||
|
|
<CODE
|
||
|
|
CLASS="CONSTANT"
|
||
|
|
>".client"</CODE
|
||
|
|
> will be appended. The log file is
|
||
|
|
never removed by the client.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-N</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>If specified, this parameter suppresses the normal
|
||
|
|
password prompt from the client to the user. This is useful when
|
||
|
|
accessing a service that does not require a password. </P
|
||
|
|
><P
|
||
|
|
>Unless a password is specified on the command line or
|
||
|
|
this parameter is specified, the client will request a
|
||
|
|
password.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-k</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>Try to authenticate with kerberos. Only useful in
|
||
|
|
an Active Directory environment.</P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-A|--authfile=filename</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>This option allows
|
||
|
|
you to specify a file from which to read the username and
|
||
|
|
password used in the connection. The format of the file is</P
|
||
|
|
><P
|
||
|
|
><PRE
|
||
|
|
CLASS="PROGRAMLISTING"
|
||
|
|
>username = <value>
|
||
|
|
password = <value>
|
||
|
|
domain = <value></PRE
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
>Make certain that the permissions on the file restrict
|
||
|
|
access from unwanted users. </P
|
||
|
|
></DD
|
||
|
|
><DT
|
||
|
|
>-U|--user=username[%password]</DT
|
||
|
|
><DD
|
||
|
|
><P
|
||
|
|
>Sets the SMB username or username and password. </P
|
||
|
|
><P
|
||
|
|
>If %password is not specified, the user will be prompted. The
|
||
|
|
client will first check the <VAR
|
||
|
|
CLASS="ENVAR"
|
||
|
|
>USER</VAR
|
||
|
|
> environment variable, then the
|
||
|
|
<VAR
|
||
|
|
CLASS="ENVAR"
|
||
|
|
>LOGNAME</VAR
|
||
|
|
> variable and if either exists, the
|
||
|
|
string is uppercased. If these environmental variables are not
|
||
|
|
found, the username <CODE
|
||
|
|
CLASS="CONSTANT"
|
||
|
|
>GUEST</CODE
|
||
|
|
> is used. </P
|
||
|
|
><P
|
||
|
|
>A third option is to use a credentials file which
|
||
|
|
contains the plaintext of the username and password. This
|
||
|
|
option is mainly provided for scripts where the admin does not
|
||
|
|
wish to pass the credentials on the command line or via environment
|
||
|
|
variables. If this method is used, make certain that the permissions
|
||
|
|
on the file restrict access from unwanted users. See the
|
||
|
|
<VAR
|
||
|
|
CLASS="PARAMETER"
|
||
|
|
>-A</VAR
|
||
|
|
> for more details. </P
|
||
|
|
><P
|
||
|
|
>Be cautious about including passwords in scripts. Also, on
|
||
|
|
many systems the command line of a running process may be seen
|
||
|
|
via the <B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>ps</B
|
||
|
|
> command. To be safe always allow
|
||
|
|
<B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>rpcclient</B
|
||
|
|
> to prompt for a password and type
|
||
|
|
it in directly. </P
|
||
|
|
></DD
|
||
|
|
></DL
|
||
|
|
></DIV
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="REFSECT1"
|
||
|
|
><A
|
||
|
|
NAME="AEN128"
|
||
|
|
></A
|
||
|
|
><H2
|
||
|
|
>QUOTA_SET_COMAND</H2
|
||
|
|
><P
|
||
|
|
>The format of an ACL is one or more ACL entries separated by
|
||
|
|
either commas or newlines. An ACL entry is one of the following: </P
|
||
|
|
><P
|
||
|
|
> for user setting quotas for the specified by -u or the current username:
|
||
|
|
</P
|
||
|
|
><P
|
||
|
|
><KBD
|
||
|
|
CLASS="USERINPUT"
|
||
|
|
> UQLIM:<username><softlimit><hardlimit>
|
||
|
|
</KBD
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
> for setting the share quota defaults limits:
|
||
|
|
</P
|
||
|
|
><P
|
||
|
|
><KBD
|
||
|
|
CLASS="USERINPUT"
|
||
|
|
> FSQLIM:<softlimit><hardlimit>
|
||
|
|
</KBD
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
> for changing the share quota settings:
|
||
|
|
</P
|
||
|
|
><P
|
||
|
|
><KBD
|
||
|
|
CLASS="USERINPUT"
|
||
|
|
> FSQFLAGS:QUOTA_ENABLED/DENY_DISK/LOG_SOFTLIMIT/LOG_HARD_LIMIT
|
||
|
|
</KBD
|
||
|
|
></P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="REFSECT1"
|
||
|
|
><A
|
||
|
|
NAME="AEN140"
|
||
|
|
></A
|
||
|
|
><H2
|
||
|
|
>EXIT STATUS</H2
|
||
|
|
><P
|
||
|
|
>The <B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>smbcquotas</B
|
||
|
|
> program sets the exit status
|
||
|
|
depending on the success or otherwise of the operations performed.
|
||
|
|
The exit status may be one of the following values. </P
|
||
|
|
><P
|
||
|
|
>If the operation succeeded, smbcquotas returns an exit
|
||
|
|
status of 0. If <B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>smbcquotas</B
|
||
|
|
> couldn't connect to the specified server,
|
||
|
|
or when there was an error getting or setting the quota(s), an exit status
|
||
|
|
of 1 is returned. If there was an error parsing any command line
|
||
|
|
arguments, an exit status of 2 is returned. </P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="REFSECT1"
|
||
|
|
><A
|
||
|
|
NAME="AEN146"
|
||
|
|
></A
|
||
|
|
><H2
|
||
|
|
>VERSION</H2
|
||
|
|
><P
|
||
|
|
>This man page is correct for version 3.0 of the Samba suite.</P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="REFSECT1"
|
||
|
|
><A
|
||
|
|
NAME="AEN149"
|
||
|
|
></A
|
||
|
|
><H2
|
||
|
|
>AUTHOR</H2
|
||
|
|
><P
|
||
|
|
>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.</P
|
||
|
|
><P
|
||
|
|
><B
|
||
|
|
CLASS="COMMAND"
|
||
|
|
>smbcacls</B
|
||
|
|
> was written by Stefan Metzmacher.</P
|
||
|
|
></DIV
|
||
|
|
></BODY
|
||
|
|
></HTML
|
||
|
|
>
|