diff options
Diffstat (limited to '')
| -rw-r--r-- | modules/pam_setquota/README | 80 | ||||
| -rw-r--r-- | modules/pam_setquota/README.xml | 41 |
2 files changed, 121 insertions, 0 deletions
diff --git a/modules/pam_setquota/README b/modules/pam_setquota/README new file mode 100644 index 0000000..fd00da7 --- /dev/null +++ b/modules/pam_setquota/README @@ -0,0 +1,80 @@ +pam_setquota — PAM module to set or modify disk quotas on session start + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +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 + +fs=/home + + The device file or mountpoint the policy applies to. Defaults to the + filesystem containing the users home directory. + +overwrite=0 + + 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) + +debug=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 fs be + unset. (Defaults to 0) + +startuid=1000 + + 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.) + +enduid=0 + + 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 startuid + are included). (Defaults to 0) + +bsoftlimit=19000 + + Soft limit for disk quota blocks, as defined by quotactl(2). Note: + bsoftlimit and bhardlimit must be set at the same time! + +bhardlimit=20000 + + Hard limit for disk quota blocks, as defined by quotactl(2). Note: + bsoftlimit and bhardlimit must be set at the same time! + +isoftlimit=3000 + + Soft limit for inodes, as defined by quotactl(2). Note: isoftlimit and + ihardlimit must be set at the same time! + +ihardlimit=4000 + + Hard limit for inodes, as defined by quotactl(2). Note: isoftlimit and + ihardlimit must be 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 + + +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>. + diff --git a/modules/pam_setquota/README.xml b/modules/pam_setquota/README.xml new file mode 100644 index 0000000..4eeddec --- /dev/null +++ b/modules/pam_setquota/README.xml @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding='UTF-8'?> +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" +"http://www.docbook.org/xml/4.3/docbookx.dtd" +[ +<!-- +<!ENTITY pamaccess SYSTEM "pam_setquota.8.xml"> +--> +]> + +<article> + + <articleinfo> + + <title> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_setquota.8.xml" xpointer='xpointer(//refnamediv[@id = "pam_setquota-name"]/*)'/> + </title> + + </articleinfo> + + <section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_setquota.8.xml" xpointer='xpointer(//refsect1[@id = "pam_setquota-description"]/*)'/> + </section> + + <section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_setquota.8.xml" xpointer='xpointer(//refsect1[@id = "pam_setquota-options"]/*)'/> + </section> + + <section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_setquota.8.xml" xpointer='xpointer(//refsect1[@id = "pam_setquota-examples"]/*)'/> + </section> + + <section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_setquota.8.xml" xpointer='xpointer(//refsect1[@id = "pam_setquota-author"]/*)'/> + </section> + +</article> |