GPFS: Administration and Programming Reference - IRA Home

gpfs_quotactl() Subroutine
Name
gpfs_quotactl() – Manipulates disk quotas on file systems.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_quotactl(char *pathname, int cmd, int id, void *bufferP);
Description
The gpfs_quotactl() subroutine manipulates disk quotas. It enables, disables, and manipulates disk
quotas for file systems on which quotas have been enabled.
Notes:
1. Compile any program that uses this subroutine with the -lgpfs flag from the following library:
v libgpfs.a for AIX
v libgpfs.so for Linux
Parameters
pathname Specifies the path name of any file within the mounted file system to which the quota
control command is to applied.
cmd Specifies the quota control command to be applied and whether it is applied to a user,
group, or fileset quota.
The cmd parameter can be constructed through use of the QCMD(qcmd, Type) contained
in gpfs.h. The qcmd parameter specifies the quota control command. The Type
parameter specifies one of the following quota types:
v user (GPFS_USRQUOTA)
v group (GPFS_GRPQUOTA)
v fileset (GPFS_FILESETQUOTA)
The valid values for the qcmd parameter specified in gpfs.h are:
Q_QUOTAON Enables quotas.
Q_QUOTAOFF Disables quotas.
Enables disk quotas for the file system specified by the
pathname parameter and type specified in Type. The id
and bufferP parameters are unused. Root user authority
is required to enable quotas.
Disables disk quotas for the file system specified by the
pathname parameter and type specified in Type. The id
and bufferP parameters are unused. Root user authority
is required to disable quotas.
Q_GETQUOTA Gets quota limits and usage information.
Retrieves quota limits and current usage for a user, group,
or fileset specified by the id parameter. The bufferP
Chapter 9. GPFS programming interfaces 337