HP-UX 11i Version 2 Release Notes (October 2003)

Other Functionality
ccNUMA
Chapter 11
247
• shmget()
These new memory locality flags have been added to shmget():
IPC_MEM_INTERLEAVED, IPC_MEM_LOCAL, IPC_MEM_FIRST_TOUCH.
• pstat_getlocality(), pstat_getproclocality()
These are two new pstat functions which return information about aspects of a
ccNUMA system.
• sysconf()
The sysconf() system call with existing flag _SC_CCNUMA_SUPPORT will return a
positive value if it is running on a ccNUMA system with an operating system that
can take advantage of this ccNUMA capability; otherwise it returns -1.
• mpctl(2)
This syscall supports user binding, system query, and launch policy operations.
These operations are NUMA sensitive. The syscall now supports two variants of
round-robin and fill-first launch policies for processes and threads. These launch
policies can now be tree-based or breadth-first.
• pset_ctl()
This system call provides processor set configuration query operations, and now it
can return NUMA configuration information for a pset. There is no change in API
definition.
• pset_assign(), pset_destroy()
These system calls change processor set configuration, and they need to perform
some additional tasks on NUMA systems. The system administrator should be
aware of NUMA boundaries when configuring processor sets with processors; they
should attempt to select processors from as few locality domains as possible.
• pstat_getpset()
This system call now contains number of ldoms for the processor set.
• mpsched(1)
The mpsched command provides following capabilities:
— Display system's topology information (ldoms, processors),
— Display current bindings for a specified process,
— Assign locality binding or launch policy to a running process, and
— Execute a command with specified comm locality binding or launch policy.
Two new launch policy options, RR_TREE and FILL_TREE, are now supported.
• pthread library
The pthread_num_ldoms_np(3t), pthread_ldom_id_np(3t),
pthread_num_ldomprocs_np(3t), and pthread_spu_to_ldom_np(3t) interfaces
provide a way to retrieve information about locality domains for the thread.
The pthread_ldom_bind_np(3t) provides a way to bind a thread to a specified
locality domain.