pthread_rad_attach man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

pthread_rad_attach(3)					 pthread_rad_attach(3)

NAME
       pthread_rad_attach,  pthread_rad_bind - Attaches or binds a thread to a
       NUMA Resource Affinity Domain (libpthread library)

SYNOPSIS
       #include <numa.h>

       int pthread_rad_attach(
	       pthread_t thread,
	       radset_t radset,
	       ulong_t flags ); int pthread_rad_bind(
	       pthread_t thread,
	       radset_t radset,
	       ulong_t flags );

PARAMETERS
       Identifies the thread to be attached or bound to the specified  set  of
       Resource	 Affinity Domains (RADs).  Identifies the RAD set to which the
       thread is to be attached or bound.

DESCRIPTION
       The pthread_rad_attach() function attaches the thread specified by  the
       thread argument to the RAD set specified by the radset argument.

       The pthread_rad_bind() function binds the specified thread to the spec‐
       ified RAD set.

       While both functions assign a home RAD for the thread, an attach opera‐
       tion  allows  remote  execution	on  other  RADs while a bind operation
       restricts execution to the home RAD. In the following  paragraphs,  the
       term  “assign”  is used when the description refers equally to both the
       attach and the bind operations.

       The home RAD for the thread will be selected by	the  system  scheduler
       from  among  the	 RADs  included in radset based on current system load
       balance and the flags argument. The overflow set (mattr_radset) for the
       thread will be set to radset.

       The  following  symbolic values are defined for the flags argument: The
       requested assignments are mandatory. If this option  is	not  set,  the
       system  will consider the request to be a “hint” and may take no action
       for the specified thread.  The thread has small memory requirements, so
       the  system  should  (for the home RAD) favor those RADs with light CPU
       loads, independent of their available memory.   The  thread  has	 large
       memory  requirements,  so  the  system  should (for the home RAD) favor
       those RADs with more available memory, independent of their CPU loads.

       If the caller does not have partition administration privilege  and  if
       the  radset  argument contains RADs that are not in the caller's parti‐
       tion, an error will be returned.

NOTES
       The value for the radset argument could be obtained from an nloc() call
       to  assign  or migrate the process to a RAD close (or closer) to a par‐
       ticular resource. When obtained in this manner, the radset  value  will
       identify	 RADs  that  were in the caller's partition at the time of the
       nloc() call. The partition configuration could change between the  call
       to  nloc()  and a subsequent call to pthread_rad_attach(), resulting in
       an error. An application should be prepared to handle this error,  even
       though it should not be a frequent occurrence.

RETURN VALUES
       Success.	  Failure.  In this case, the integer value indicates the type
       of error. Possible errors are as follows: The thread is	hard  attached
       (RAD_INSIST)  to	 RADs  or has memory wired (locked) on its current RAD
       such that it cannot be migrated to the specified RAD set.  One of  more
       of the RADs in the radset argument or options in the flags argument are
       invalid.	 RAD_INSIST and RAD_MIGRATE were  specified,  and  the	thread
       cannot  be  migrated  because insufficient memory exists on RADs in the
       specified RAD set.  The caller does not have appropriate privileges  to
       assign  threads to RADs in the specified RAD set.  The thread specified
       by thread does not exist.

ERRORS
       None.

SEE ALSO
       Functions: nloc(3), pthread_rad_detach(3)

							 pthread_rad_attach(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net