Index for Section 3

Alphabetical listing for N

Bottom of page

nsg_get_pids(3)
NAME
  nsg_get_pids - Return a list of a NUMA Scheduling Group's process
  identifiers (libnuma library)

SYNOPSIS
  #include <numa.h>

  int nsg_get_pids(
	  nsgid_t nsg,
	  pid_t *pidlist,
	  int numpids );

PARAMETERS
  nsg Specifies the NUMA Scheduling Group (NSG).

  pidlist
      Specifies an array receiving the process identifiers of the specified
      NSG.

  numpids
      Specifies the maximum number of pid_t entries in pidlist.

DESCRIPTION
  The nsg_get_pids() function returns a list of process IDs of processes
  attached to the NSG in the buffer pointed to by pidlist. The argument
  numpids specifies the number of process IDs that can be accommodated in the
  buffer. The list is terminated by a NULL entry. The required size of the
  buffer can be obtained from the nsg_nattach member of the nsgid_ds
  structure returned by the nsg_get() function. As always, on a dynamically
  changing system, the number of entries may be different by the time
  nsg_get_pids() is called.

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
  0   Success. However, if errno is set to E2BIG on a successful return, more
      processes than numpids were available.

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

ERRORS
  If the nsg_get_pids() 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 pidlist argument specifies an invalid address.

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

SEE ALSO
  Functions: nsg_attach_pid(3), nsg_get(3), nsg_get_nsgs(3), numa_intro(3)

  Files: numa_types(4)

Index for Section 3

Alphabetical listing for N

Top of page