quota: documentation for sending "below quota" messages via netlink and tiny doc update

Signed-off-by: Jan Kara <jack@suse.cz>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
This commit is contained in:
Jan Kara 2008-08-12 15:08:39 -07:00 committed by Linus Torvalds
parent caff3a2c33
commit 866c36637f

View file

@ -3,14 +3,14 @@ Quota subsystem
=============== ===============
Quota subsystem allows system administrator to set limits on used space and Quota subsystem allows system administrator to set limits on used space and
number of used inodes (inode is a filesystem structure which is associated number of used inodes (inode is a filesystem structure which is associated with
with each file or directory) for users and/or groups. For both used space and each file or directory) for users and/or groups. For both used space and number
number of used inodes there are actually two limits. The first one is called of used inodes there are actually two limits. The first one is called softlimit
softlimit and the second one hardlimit. An user can never exceed a hardlimit and the second one hardlimit. An user can never exceed a hardlimit for any
for any resource. User is allowed to exceed softlimit but only for limited resource (unless he has CAP_SYS_RESOURCE capability). User is allowed to exceed
period of time. This period is called "grace period" or "grace time". When softlimit but only for limited period of time. This period is called "grace
grace time is over, user is not able to allocate more space/inodes until he period" or "grace time". When grace time is over, user is not able to allocate
frees enough of them to get below softlimit. more space/inodes until he frees enough of them to get below softlimit.
Quota limits (and amount of grace time) are set independently for each Quota limits (and amount of grace time) are set independently for each
filesystem. filesystem.
@ -53,6 +53,12 @@ in parentheses):
QUOTA_NL_BSOFTLONGWARN - space (block) softlimit is exceeded QUOTA_NL_BSOFTLONGWARN - space (block) softlimit is exceeded
longer than given grace period. longer than given grace period.
QUOTA_NL_BSOFTWARN - space (block) softlimit QUOTA_NL_BSOFTWARN - space (block) softlimit
- four warnings are also defined for the event when user stops
exceeding some limit:
QUOTA_NL_IHARDBELOW - inode hardlimit
QUOTA_NL_ISOFTBELOW - inode softlimit
QUOTA_NL_BHARDBELOW - space (block) hardlimit
QUOTA_NL_BSOFTBELOW - space (block) softlimit
QUOTA_NL_A_DEV_MAJOR (u32) QUOTA_NL_A_DEV_MAJOR (u32)
- major number of a device with the affected filesystem - major number of a device with the affected filesystem
QUOTA_NL_A_DEV_MINOR (u32) QUOTA_NL_A_DEV_MINOR (u32)