quotactl − Manipuler les quotas de disque.

#include <sys/types.h>
#include <sys/quota.h>

int quotactl(int cmd, const char *special, int id, caddr_t addr);

#include <linux/unistd.h>

#include <errno.h>

_syscall4(int, quotactl, int, cmd, const char *, special,
          int, id, caddr_t, addr)
        /* L’utilisation de syscall(2) est préférable ; voir intro(2) */

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

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 (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.

quotactl() renvoie 0 quand il réussit. En cas d’échec, −1 est renvoyé et errno contient le code d’erreur.

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

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. special n’a pas pu être trouvé.

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.

BSD

quota(1), getrlimit(2), setrlimit(2), ulimit(2), quotacheck(8), quotaon(8)

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 25 juillet 2006.

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=en man 2 quotactl ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.