QUOTACTL(2) Manuel du programmeur Linux QUOTACTL(2)
NOM
quotactl - Manipuler les quotas de disque.
SYNOPSIS
#include <sys/types.h>
#include <sys/quota.h>
int quotactl (int cmd, const char *special, int id ,
caddr_t addr);
#include <linux/unistd.h>
_syscall4(int, quotactl, int, cmd, const char *, special ,
int, id, caddr_t, addr);
DESCRIPTION
Le système de quotas permet de définir pour chaque util
isateur et/ou groupe une limite souple et une limite
impérative à la quantite d'espace disque utilisable sur un
système de fichiers donné.
La limite impérative ne peut pas être dépassée. La limite
souple peut être dépassée, mais des avertissements
s'ensuivront. De plus l'utilisateur ne peut pas dépasser
une limite souple pendant plus d'une semaine (par défaut)
d'affilée. Une fois la semaine écoulée, la limite souple
devient une limite impérative.
L'appel système quotactl manipule ces quotas. Son premier
argument est de la forme QCMD(subcmd,type) ou type vaut
soit USRQUOTA soit GRPQUOTA (respectivement pour les quo
tas d'utilisateur et de groupe), et ou subcmd est décrit
plus bas
Le second argument special est un périphérique par bloc
auquel les quotas s'appliquent. Il doit être monté.
Le troisième argument id est l'identifiant de l'utilisa
teur ou du groupe auquel s'appliquent les quotas.
La quatrième argument addr est l'adresse d'une structure
de données dépendant de la commande à utiliser.
La commande subcmd est dans la liste suivante :
Q_QUOTAON Valider les quotas. L'argument addr est le
chemin d'accès au fichier contenant les quotas
pour le système de fichiers.
Q_QUOTAOFF Désactiver les quotas.
Q_GETQUOTA Obtenir les limites actuelles et l'utilisation
courante de l'espace disque. L'argument addr
est un pointeur sur une structure dqblk
Linux 21 Septembre 1998 1
QUOTACTL(2) Manuel du programmeur Linux QUOTACTL(2)
(définie dans <sys/quota.h>).
Q_SETQUOTA Fixe la limite et l'utilisation actuelle. addr
est identique à Q_GETQUOTA
Q_SETQLIM Fixer les limites. addr est identique à
Q_GETQUOTA
Q_SETUSE Fixer l'utilisation.
Q_SYNC Synchroniser les quotas d'un système de
fichiers.
Q_GETSTATS Obtenir des statistiques
VALEUR RENVOYÉE
quotactl renvoie 0 quand il réussit. En cas d'échec, -1
est renvoyé et errno contient le code d'erreur.
ERREURS
ENOPKG Le noyau n'a pas été compilé avec le support de
quotas.
EFAULT Mauvaise valeur pour addr.
EINVAL type n'est pas un type de quota supporté. Ou bien
special n'a pas pu être trouvé.
ENOTBLK special n'est pas un périphérique bloc.
ENODEV special n'est pas dans la table de montage.
EACCES Le fichier de quotas n'est pas un fichier ordi
naire.
EIO Impossible de lire ou d'écrire le fichier de quo
tas.
EMFILE Trop de fichiers ouverts, impossible d'ouvrir le
fichier des quotas
EBUSY Q_QUOTAON a été requis mais les quotas sont déjà
actifs.
ESRCH Q_GETQUOTA ou Q_SETQUOTA ou Q_SETUSE ou Q_SETQLIM
ont été requis sur système de fichiers n'ayant
pas de quotas actifs.
EPERM Le processus n'est pas root (pour le système de
fichiers) et Q_GETQUOTA a été requis pour un
autre identifiant id que celui du processus, ou
une commande autre que Q_GETSTATS ou Q_SYNC a été
réclamée.
Linux 21 Septembre 1998 2
QUOTACTL(2) Manuel du programmeur Linux QUOTACTL(2)
CONFORMITÉ
BSD
VOIR AUSSI
quota(1), getrlimit(2), setrlimit(2), ulimit(2), quo
tacheck(8), quotaon(8)
TRADUCTION
Christophe Blaess, 1997.
Linux 21 Septembre 1998 3