diff options
Diffstat (limited to 'upstream/debian-bookworm/man8/edquota.8')
-rw-r--r-- | upstream/debian-bookworm/man8/edquota.8 | 192 |
1 files changed, 192 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man8/edquota.8 b/upstream/debian-bookworm/man8/edquota.8 new file mode 100644 index 00000000..97cb1ca9 --- /dev/null +++ b/upstream/debian-bookworm/man8/edquota.8 @@ -0,0 +1,192 @@ +.TH EDQUOTA 8 +.SH NAME +edquota \- edit user quotas +.SH SYNOPSIS +.B edquota +[ +.B \-p +.I protoname +] [ +.BR \-u \ | +.BR \-g \ | +.B \-P +] [ +.B \-rm +] [ +.B \-F +.I format-name +] [ +.B \-f +.I filesystem +] +.IR username \ | +.IR groupname \ | +.IR projectname .\|.\|. +.LP +.B edquota +[ +.BR \-u \ | +.BR \-g \ | +.B \-P +] [ +.B \-F +.I format-name +] [ +.B \-f +.I filesystem +] +.B \-t +.LP +.B edquota +[ +.BR \-u \ | +.BR \-g \ | +.B \-P +] [ +.B \-F +.I format-name +] [ +.B \-f +.I filesystem +] +.B \-T +.IR username \ | +.IR groupname \ | +.IR projectname .\|.\|. +.SH DESCRIPTION +.IX "edquota command" "" "\fLedquota\fP \(em edit user quotas" +.IX edit "user quotas \(em \fLedquota\fP" +.IX "user quotas" "edquota command" "" "\fLedquota\fP \(em edit user quotas" +.IX "disk quotas" "edquota command" "" "\fLedquota\fP \(em edit user quotas" +.IX "quotas" "edquota command" "" "\fLedquota\fP \(em edit user quotas" +.IX "filesystem" "edquota command" "" "\fLedquota\fP \(em edit user quotas" +.B edquota +is a quota editor. One or more users, groups, or projects may be specified +on the command line. If a number is given in the place of user/group/project +name it is treated as an UID/GID/Project ID. For each user, group, or project +a temporary file is created with an +.SM ASCII +representation of the current disk quotas for that user, group, or project and +an editor is then invoked on the file. The quotas may then be modified, new +quotas added, etc. +Setting a quota to zero indicates that no quota should be imposed. +.PP +Block usage and limits are reported and interpreted as multiples of kibibyte +(1024 bytes) blocks by default. Symbols K, M, G, and T can be appended to +numeric value to express kibibytes, mebibytes, gibibytes, and tebibytes. +.PP +Inode usage and limits are interpreted literally. Symbols k, m, g, and t can +be appended to numeric value to express multiples of 10^3, 10^6, 10^9, and +10^12 inodes. +.PP +Users are permitted to exceed their soft limits for a grace period that +may be specified per filesystem. Once the grace period has expired, the +soft limit is enforced as a hard limit. +.PP +The current usage information in the file is for informational purposes; +only the hard and soft limits can be changed. +.PP +Upon leaving the editor, +.B edquota +reads the temporary file and modifies the binary quota files to reflect +the changes made. +.LP +The editor invoked is +.BR editor (1) +unless either the +.SB EDITOR +or the +.SB VISUAL +environment variable specifies otherwise. +.LP +Only the super-user may edit quotas. +.SH OPTIONS +.TP +.B -r, --remote +Edit also non-local quota use rpc.rquotad on remote server to set quota. +This option is available only if quota tools were compiled with enabled +support for setting quotas over RPC. +The +.B -n +option is equivalent, and is maintained for backward compatibility. +.TP +.B -m, --no-mixed-pathnames +Currently, pathnames of NFSv4 mountpoints are sent without leading slash in the path. +.BR rpc.rquotad +uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem +to the path. If you specify this option, +.BR edquota +will always send paths with a leading slash. This can be useful for legacy reasons but +be aware that quota over RPC will stop working if you are using new +.BR rpc.rquotad . +.TP +.B -u, --user +Edit the user quota. This is the default. +.TP +.B -g, --group +Edit the group quota. +.TP +.B -P, --project +Edit the project quota. +.TP +.B -p, --prototype=\f2protoname\f1 +Duplicate the quotas of the prototypical user +specified for each user specified. This is the normal +mechanism used to initialize quotas for groups of users. +.TP +.B --always-resolve +Always try to translate user / group name to uid / gid even if the name +is composed of digits only. +.TP +.B -F, --format=\f2format-name\f1 +Edit quota for specified format (ie. don't perform format autodetection). +Possible format names are: +.B vfsold +Original quota format with 16-bit UIDs / GIDs, +.B vfsv0 +Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits, +.B vfsv1 +Quota format with 64-bit quota limits and usage, +.B rpc +(quota over NFS), +.B xfs +(quota on XFS filesystem) +.TP +.B \-f, --filesystem \f2filesystem\f1 +Perform specified operations only for given filesystem (default is to perform +operations for all filesystems with quota). +.TP +.B \-t, --edit-period +Edit the soft time limits for each filesystem. +In old quota format if the time limits are zero, the default time limits in +.B <linux/quota.h> +are used. In new quota format time limits must be specified (there is no default +value set in kernel). Time units of 'seconds', 'minutes', 'hours', and 'days' +are understood. Time limits are printed in the greatest possible time unit such that +the value is greater than or equal to one. +.TP +.B \-T, --edit-times +Edit time for the user/group/project when softlimit is enforced. Possible values +are 'unset' or number and unit. Units are the same as in +.B \-t +option. +.SH FILES +.PD 0 +.TP 20 +.BR aquota.user " or " aquota.group +quota file at the filesystem root (version 2 quota, non-XFS filesystems) +.TP +.BR quota.user " or " quota.group +quota file at the filesystem root (version 1 quota, non-XFS filesystems) +.TP +.B /etc/mtab +mounted filesystems table +.PD +.SH SEE ALSO +.BR quota (1), +.BR editor (1), +.BR quotactl (2), +.BR quotacheck (8), +.BR quotaon (8), +.BR repquota (8), +.BR setquota (8) |