GPFS: Administration and Programming Reference - IRA Home

gpfs_quotactl() Subroutine
Q_SETQUOTA Sets quota limits
Q_SETUSE Sets quota usage
parameter points to a gpfs_quotaInfo_t structure to hold
the returned information. The gpfs_quotaInfo_t structure
is defined in gpfs.h.
Root authority is required if the id value is not the current
id (user id for GPFS_USRQUOTA, group id for
GPFS_GRPQUOTA) of the caller.
Sets disk quota limits for a user, group, or fileset specified
by the id parameter. The bufferP parameter points to a
gpfs_quotaInfo_t structure containing the new quota
limits. The gpfs_quotaInfo_t structure is defined in
gpfs.h. Root user authority is required to set quota limits.
Sets disk quota usage for a user, group, or fileset
specified by the id parameter. The bufferP parameter
points to a gpfs_quotaInfo_t structure containing the new
quota usage. The gpfs_quotaInfo_t structure is defined in
gpfs.h. Root user authority is required to set quota usage.
Q_SYNC Synchronizes the disk copy of a file system quota
Updates the on disk copy of quota usage information for a
file system. The id and bufferP parameters are unused.
Root user authority is required to synchronize a file
system quota.
id Specifies the user, group, or fileset ID to which the quota control command applies. The id
parameters is interpreted by the specified quota type.
bufferP Points to the address of an optional, command-specific data structure that is copied in or
out of the system.
Exit status
If the gpfs_quotactl() subroutine is successful, it returns a value of 0.
If the gpfs_quotactl() subroutine is unsuccessful, it returns a value of -1 and sets the global error variable
errno to indicate the nature of the error.
Exceptions
None.
Error status
EACCES Search permission is denied for a component of a path prefix.
EFAULT An invalid bufferP parameter is supplied. The associated structure could not be copied in
or out of the kernel.
EINVAL One of the following errors:
v The file system is not mounted.
v Invalid command or quota type.
v Invalid input limits: negative limits or soft limits are greater than hard limits.
ENOENT No such file or directory.
EPERM The quota control command is privileged and the caller did not have root user authority.
338 GPFS: Administration and Programming Reference