Sets the maximum quota for a read/write DCE LFS fileset
Synopsis
fts setquota {-path {filename | directory_name} | -fileset {name | ID}} -size kbytes
[-cell
cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-path {filename | directory_name}
Names a directory or file located on the read/write fileset whose quota is to be set. Use this option or use
-fileset.
-fileset {name | ID}
Specifies the complete name or fileset ID number of the read/write fileset whose quota is to be set. Use this option or use
-path.
-size kbytes
Specifies the maximum amount of disk space that all of the files and directories in the read/write fileset can occupy. This includes files and directories
in the read/write version of the fileset that are actually pointers to disk blocks in the backup or read-only version of the fileset. Specify the value in 1-kilobyte blocks. (A value of 1024
kilobytes is 1 megabyte.) By default, every newly created fileset has a quota of 5000 kilobytes.
-cell cellname
Specifies the cell where the command is to be run. The default is the local cell of the issuer of the command.
-noauth
Directs fts to use the unprivileged identity nobody as the identity of the issuer of the command. If you use this option, do not use the
-localauth option.
-localauth
Directs fts to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the
command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to
work. If you use this option, do not use the -noauth option.
-verbose
Directs fts to provide detailed information about its actions as it executes the command.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The fts setquota command sets the quota limit for a read/write DCE LFS fileset. (It cannot be used to set the quota for a non-LFS fileset or for a
read-only or backup DCE LFS fileset.) The fileset whose quota is to be set can be indicated by specifying the name of a file or directory in the fileset with the -path option or by
indicating the fileset directly with the -fileset option.
Quota refers to the amount of disk space occupied by all of the files and directories in the read/write version of the fileset. This includes files and directories in the read/write version of the fileset that are actually pointers to disk blocks in the backup or read-only version of the fileset. Do not confuse quota with allocation; the latter identifies the amount of disk space occupied by the data that a fileset actually houses, excluding those files and directories that are pointers to disk blocks in another version of the fileset.
By default, every newly created fileset has a quota of 5000 kilobytes. This command increases or decreases a fileset's quota to the number of kilobytes specified with the -size option. Because it does not represent the amount of physical data the fileset contains, a fileset's quota can be larger than the size of the aggregate it resides on. Similarly, the sum of the quotas of all filesets on an aggregate can exceed the size of the aggregate.
The fts lsft, fts lsheader, and fts lsquota commands display, among other things, the current quota for a fileset.
Privilege Required
The issuer must be listed in the admin.ft file on the machine on which the fileset is stored.
Examples
The following command sets the quota for the fileset that contains the directory named /usr/terry to 15,000 kilobytes:
$ fts setq /usr/terry 15000
Related Information
Commands: fts lsft(8dfs)