QUOTACTL
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 1er juin 2007
Index
Menu principal
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);
DESCRIPTION
Le système de quotas permet de définir pour chaque utilisateur et/ou
groupe une limite souple et une limite impérative à
la quantité 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'en suivront.
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)
où
type
vaut soit
USRQUOTA
soit
GRPQUOTA
(respectivement pour les quotas d'utilisateur et de groupe),
et où
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'utilisateur 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
-
Activer 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 (définie dans
<sys/quota.h>).
- Q_SETQUOTA
-
Fixer 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
- EACCES
-
Le fichier de quotas n'est pas un fichier ordinaire.
- EBUSY
-
Q_QUOTAON
a été requis mais les quotas sont déjà actifs.
- EFAULT
-
Mauvaise valeur pour
addr.
- EINVAL
-
type
n'est pas un type de quota supporté.
Ou bien
special
n'as pas pu être trouvé.
- EIO
-
Impossible de lire ou d'écrire le fichier de quotas.
- EMFILE
-
Trop de fichiers ouverts, impossible d'ouvrir le
fichier des quotas.
- ENODEV
-
special
n'est pas dans la table de montage.
- ENOPKG
-
Le noyau n'a pas été compilé avec le support de quotas.
- ENOTBLK
-
special
n'est pas un périphérique bloc.
- 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.
- 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.
CONFORMITÉ
BSD.
VOIR AUSSI
quota(1),
getrlimit(2),
setrlimit(2),
ulimit(3),
quotacheck(8),
quotaon(8)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 14 octobre 1996
et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 2 quotactl ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 17 juillet 2008