summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man8/edquota.8
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:43:11 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:43:11 +0000
commitfc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch)
treece1e3bce06471410239a6f41282e328770aa404a /upstream/fedora-rawhide/man8/edquota.8
parentInitial commit. (diff)
downloadmanpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz
manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/fedora-rawhide/man8/edquota.8')
-rw-r--r--upstream/fedora-rawhide/man8/edquota.8192
1 files changed, 192 insertions, 0 deletions
diff --git a/upstream/fedora-rawhide/man8/edquota.8 b/upstream/fedora-rawhide/man8/edquota.8
new file mode 100644
index 00000000..85ad762e
--- /dev/null
+++ b/upstream/fedora-rawhide/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 vi (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 vi (1),
+.BR quotactl (2),
+.BR quotacheck (8),
+.BR quotaon (8),
+.BR repquota (8),
+.BR setquota (8)