From 9ada0093e92388590c7368600ca4e9e3e376f0d0 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 16:22:51 +0200 Subject: Adding upstream version 1.5.2. Signed-off-by: Daniel Baumann --- modules/pam_setquota/pam_setquota.8.xml | 301 ++++++++++++++++++++++++++++++++ 1 file changed, 301 insertions(+) create mode 100644 modules/pam_setquota/pam_setquota.8.xml (limited to 'modules/pam_setquota/pam_setquota.8.xml') diff --git a/modules/pam_setquota/pam_setquota.8.xml b/modules/pam_setquota/pam_setquota.8.xml new file mode 100644 index 0000000..fe83c80 --- /dev/null +++ b/modules/pam_setquota/pam_setquota.8.xml @@ -0,0 +1,301 @@ + + + + + + + pam_setquota + 8 + Linux-PAM Manual + + + + pam_setquota + PAM module to set or modify disk quotas on session start + + + + + pam_setquota.so + + fs=/home + + + overwrite=0 + + + debug=0 + + + startuid=1000 + + + enduid=0 + + + bsoftlimit=19000 + + + bhardlimit=20000 + + + isoftlimit=3000 + + + ihardlimit=4000 + + + + + + + DESCRIPTION + + + pam_setquota is a PAM module to set or modify a disk quota at session start + + + This makes quotas usable with central user databases, such as MySQL or LDAP. + + + + + + + OPTIONS + + + + + + + + + The device file or mountpoint the policy applies to. Defaults to the + filesystem containing the users home directory. + + + + + + + + + + Overwrite an existing quota. Note: Enabling this will remove the ability + for the admin to manually configure different quotas for users for a + filesystem with edquota + 8. (Defaults to 0) + + + + + + + + + + Enable debugging. A value of 1 outputs the old and new quota on a device. + A value of 2 also prints out the matched and found filesystems should + be unset. (Defaults to 0) + + + + + + + + + + Describe the start of the UID range the policy is applied to. + (Defaults to UID_MIN from login.defs or the uidmin value defined + at compile-time if UID_MIN is undefined.) + + + + + + + + + + Describe the end of the UID range the policy is applied to. Setting + enduid=0 results in an open-ended UID + range (i.e. all uids greater than are + included). (Defaults to 0) + + + + + + + + + + Soft limit for disk quota blocks, as defined by + quotactl2 + . + Note: and + must be set at the same time! + + + + + + + + + + Hard limit for disk quota blocks, as defined by + quotactl2 + . + Note: and + must be set at the same time! + + + + + + + + + + Soft limit for inodes, as defined by + quotactl2. + Note: and + must be set at the same time! + + + + + + + + + + Hard limit for inodes, as defined by + quotactl2. + Note: and + must be set at the same time! + + + + + + + + + MODULE TYPES PROVIDED + + Only the module type is provided. + + + + + RETURN VALUES + + + + + PAM_SUCCESS + + + The quota was set successfully. + + + + + + PAM_IGNORE + + + No action was taken because either the UID of the user was outside + of the specified range, a quota already existed and + was not configured or no limits were + configured at all. + + + + + + PAM_USER_UNKNOWN + + + The user was not found. + + + + + + PAM_PERM_DENIED + + + /proc/mounts could not be opened. + + + The filesystem or device specified was not found. + + + The limits for the user could not be retrieved. See syslog for + more information. + + + The limits for the user could not be set. See syslog for + more information. + + + Either / + or / were + not set at the same time. + + + + + + + + + + EXAMPLES + + A single invocation of `pam_setquota` applies a specific policy to a UID + range. Applying different policies to specific UID ranges is done by + invoking pam_setquota more than once. The last matching entry + defines the resulting quota. + + session required pam_setquota.so bsoftlimit=1000 bhardlimit=2000 isoftlimit=1000 ihardlimit=2000 startuid=1000 enduid=0 fs=/home + session required pam_setquota.so bsoftlimit=19000 bhardlimit=20000 isoftlimit=3000 ihardlimit=4000 startuid=2001 enduid=3000 fs=/dev/sda1 + session required pam_setquota.so bsoftlimit=19000 bhardlimit=20000 isoftlimit=3000 ihardlimit=4000 startuid=3001 enduid=4000 fs=/dev/sda1 overwrite=1 + + + + + + SEE ALSO + + + pam.conf5 + , + + pam.d5 + , + + pam8 + + + + + + AUTHOR + + pam_setquota was originally written by + Ruslan Savchenko <savrus@mexmat.net>. + + + Further modifications were made by Shane Tzen <shane@ict.usc.edu>, + Sven Hartge <sven@svenhartge.de> + and Keller Fuchs <kellerfuchs@hashbang.sh>. + + + + -- cgit v1.2.3