numa_query_pid(3) — Subroutines

NAME

numa_query_pid − Returns NUMA-related information for the specified process identifier (libnuma library)

SYNOPSIS

#include <numa.h>
int numa_query_pid(
pid_t pid,
numa_pid_info_t ∗npinfo );

PARAMETERS

pidSpecifies a process identifier (pid) to detach from a RAD set

npinfo
Specifies a pointer to the NUMA information associated with pid. See sys/numa_types.h for more information.

DESCRIPTION

The numa_query_pid() function returns NUMA-related information about a specified pid in the rpinfo structure, which contains the following information:

typedef struct __numa_pid_info {
        pid_t        npinfo_pid;     /∗ Process IDentifier ∗/
        radid_t      npinfo_radid;   /∗ Home RAD for rpinfo_pid ∗/
        nsgid_t      npinfo_nsgid;   /∗ rpinfo_pid NSG id (if any) ∗/
        u_long       npinfo_attrib; /∗ rpinfo_pid associated attributes ∗/
        u_long       npinfo_pad[10]; /∗ future development ∗/
    } numa_pid_info_t;
    /∗ rpinfo_attrib mask bits ∗/
    #define NPINFO_RAD_BIND         0x01    /∗ PID is bound to a RAD ∗/
    #define NPINFO_RAD_ATTACH       0x02    /∗ PID is attached to a RAD ∗/
    #define NPINFO_RAD_NO_INHERIT   0x04    /∗ PID children won’t inherit RAD ∗/
    #define NPINFO_NSG              0x08    /∗ PID is a member of an NSG ∗/
    #define NPINFO_NSG_NO_INHERIT   0x10    /∗ PID children won’t inherit NSG ∗/

RETURN VALUES

0Success.

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

ERRORS

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

[ESRCH]
The process specified by pid does not exist.

[EFAULT]
The address for the parameter npinfo is invalid.

Museum

Related Articles