Index for Section 3

Alphabetical listing for N

Bottom of page

numa_query_pid(3)
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
  pid Specifies 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
  0   Success.

  -1  Failure. 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.

SEE ALSO
  Functions: nsg_attach_pid(3), rad_attach_pid(3), rad_bind_pid(3)

  Files: numa_types(4)

Index for Section 3

Alphabetical listing for N

Top of page