NAME

nsg_get − Query status of a NUMA Scheduling Group (libnuma library)

SYNOPSIS

#include <numa.h>
int nsg_get(
        nsgid_t nsg,
        nsgid_ds_t ∗result );

PARAMETERS

nsgSpecifies the NUMA Scheduling Group (NSG)

result
Points to a structure that returns the result of the status query.

DESCRIPTION

The nsg_get() function queries the status of the NSG by copying its associated nsgid_ds structure into a buffer pointed to by result. 

RESTRICTIONS

The effective user ID of the calling process must be equal to the value of nsg_perm.cuid or nsg_perm.uid in the associated nsgid_ds structure, or the calling process must have read permissions to the NSG. 

RETURN VALUES

0Success. 

−1Failure. In this case, errno is set to indicate the error. 

ERRORS

If the nsg_get() function fails, it sets errno to one of the following values for the specified condition:

[EACCES]
The calling process does not have read permission.

[EFAULT]
The result argument specifies an invalid address. 

[EINVAL]
The nsg argument does not specify a valid NSG ID. 

SEE ALSO

Functions: nsg_attach_pid(3), nsg_get(3), numa_intro(3)

Files: numa_types(4)