cpusetGetUnixPerm(3x)cpusetGetUnixPerm(3x)NAMEcpusetGetUnixPerm - get the Unix file permissions for a cpuset
SYNOPSIS
#include <cpuset.h>
int cpusetGetUnixPerm(char *qname, uid_t *owner, gid_t *group,
mode_t *mode);
DESCRIPTION
The cpusetGetUnixPerm function is used to obtain the standard Unix file
permissions of a cpuset. The permissions for a file that was specified
at cpuset creation time are used as the access permissions for the
cpuset. The user and group that owns the cpuset is the user and group
that owns the file used to specify the access permissions. The user ID
of the owner is returned in the memory location referenced by the owner
argument. The group ID of the group owner is returned in the memory
location referenced by the group argument. The mode of the access
permissions is returned in the memory location referenced by the mode
argument. The qname argument is the name of the specified cpuset.
The function returns a status to indicate success of failure.
EXAMPLES
This example obtains the list of CPUs asigned to the cpuset mpi_set and
prints out the CPU ID values.
char *qname = "mpi_set";
uid_t owner = 0;
gid_t group = 0;
mod_t mode = 0;
/* Get the Unix file permission for the cpuset */
if (!cpusetGetUnixPerm(qname, &owner, &group, &mode)) {
perror("cpusetGetUnixPerm");
exit(1);
}
printf("Owner ID: %d0, ACL_to_str(acc));
printf("Group ID: %d0, ACL_to_str(def));
printf("Permissions: %s0, mode_to_text(mode);
NOTEScpusetGetUnixPerm is found in the library "libcpuset.so", and will be
loaded if the option -lcpuset is used with cc(1) or ld(1).
SEE ALSOcpuset(1), cpusetSetUnixPerm(3x), cpuset(5).
Page 1
cpusetGetUnixPerm(3x)cpusetGetUnixPerm(3x)DIAGNOSTICS
If successful, cpusetGetUnixPerm returns 1. If cpusetGetUnixPerm fails,
it returns 0 and errno is set to indicate the error. The possible values
for errno include those values as set by sysmp(2) and sbrk(2).
Page 2
