Print this page
10057 Man page misspellings ouput particuliar overriden
Reviewed by: Gergő Mihály Doma <domag02@gmail.com>

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man3lgrp/lgrp_affinity_get.3lgrp
          +++ new/usr/src/man/man3lgrp/lgrp_affinity_get.3lgrp
↓ open down ↓ 15 lines elided ↑ open up ↑
  16   16       \fBlgrp_id_t\fR \fIlgrp\fR);
  17   17  .fi
  18   18  
  19   19  .LP
  20   20  .nf
  21   21  \fBint\fR \fBlgrp_affinity_set\fR(\fBidtype_t\fR \fIidtype\fR, \fBid_t\fR \fIid\fR, \fBlgrp_id_t\fR \fIlgrp\fR,
  22   22       \fBlgrp_affinity_t\fR \fIaffinity\fR);
  23   23  .fi
  24   24  
  25   25  .SH DESCRIPTION
  26      -.sp
  27   26  .LP
  28   27  The \fBlgrp_affinity_get()\fR function returns the affinity that the LWP or set
  29   28  of LWPs specified by the \fIidtype\fR and \fIid\fR arguments have for the given
  30   29  lgroup.
  31   30  .sp
  32   31  .LP
  33   32  The \fBlgrp_affinity_set()\fR function sets the affinity that the LWP or set of
  34   33  LWPs specified by \fIidtype\fR and \fIid\fR have for the given lgroup.  The
  35   34  lgroup affinity can be set to \fBLGRP_AFF_STRONG\fR, \fBLGRP_AFF_WEAK\fR, or
  36   35  \fBLGRP_AFF_NONE\fR.
↓ open down ↓ 18 lines elided ↑ open up ↑
  55   54  the operating system will try to run the thread and allocate its memory on the
  56   55  lgroup for which it has the strongest affinity, then the next strongest, and so
  57   56  on up through some small, system-dependent number of these lgroup affinities.
  58   57  When multiple lgroups have the same affinity, the order of preference among
  59   58  them is unspecified and up to the operating system to choose.  The lgroup with
  60   59  the strongest affinity that the thread can run on is known as its "home lgroup"
  61   60  (see \fBlgrp_home\fR(3LGRP)) and is usually the operating system's first choice
  62   61  of where to run the thread and allocate its memory.
  63   62  .sp
  64   63  .LP
  65      - There are different levels of affinity that can be specified by a thread for a
  66      -particuliar lgroup.  The levels of affinity are the following from strongest to
       64 +There are different levels of affinity that can be specified by a thread for a
       65 +particular lgroup.  The levels of affinity are the following from strongest to
  67   66  weakest:
  68   67  .sp
  69   68  .in +2
  70   69  .nf
  71   70  LGRP_AFF_STRONG         /* strong affinity */
  72   71  LGRP_AFF_WEAK           /* weak affinity */
  73   72  LGRP_AFF_NONE           /* no affinity */
  74   73  .fi
  75   74  .in -2
  76   75  
↓ open down ↓ 11 lines elided ↑ open up ↑
  88   87  The \fBLGRP_AFF_WEAK\fR affinity is a hint to the operating system that the
  89   88  calling thread has a weak affinity for the given lgroup.  If a thread has a
  90   89  weak affinity for its home lgroup, the operating system interpets this to mean
  91   90  that thread does not mind whether it is rehomed, unlike \fBLGRP_AFF_STRONG\fR.
  92   91  Load balancing, dynamic reconfiguration, processor binding, or processor set
  93   92  binding and manipulation are examples of events that can cause the operating
  94   93  system to change a thread's home lgroup for which it has a weak affinity.
  95   94  .sp
  96   95  .LP
  97   96  The \fBLGRP_AFF_NONE\fR affinity signifies no affinity and can be used to
  98      -remove a thread's affinity for a particuliar lgroup.  Initially, each thread
       97 +remove a thread's affinity for a particular lgroup.  Initially, each thread
  99   98  has no affinity to any lgroup.  If a thread has no lgroup affinities set, the
 100   99  operating system chooses a home lgroup for the thread with no affinity set.
 101  100  .SH RETURN VALUES
 102      -.sp
 103  101  .LP
 104  102  Upon successful completion, \fBlgrp_affinity_get()\fR returns the affinity for
 105  103  the given lgroup.
 106  104  .sp
 107  105  .LP
 108  106  Upon successful completion, \fBlgrp_affinity_set()\fR return 0.
 109  107  .sp
 110  108  .LP
 111  109  Otherwise, both functions return \(mi1 and set \fBerrno\fR to indicate the
 112  110  error.
 113  111  .SH ERRORS
 114      -.sp
 115  112  .LP
 116  113  The \fBlgrp_affinity_get()\fR and \fBlgrp_affinity_set()\fR functions will fail
 117  114  if:
 118  115  .sp
 119  116  .ne 2
 120  117  .na
 121  118  \fB\fBEINVAL\fR\fR
 122  119  .ad
 123  120  .RS 10n
 124  121  The specified lgroup, affinity, or ID type is not valid.
↓ open down ↓ 13 lines elided ↑ open up ↑
 138  135  .sp
 139  136  .ne 2
 140  137  .na
 141  138  \fB\fBESRCH\fR\fR
 142  139  .ad
 143  140  .RS 10n
 144  141  The specified lgroup or LWP(s) was not found.
 145  142  .RE
 146  143  
 147  144  .SH ATTRIBUTES
 148      -.sp
 149  145  .LP
 150  146  See \fBattributes\fR(5) for descriptions of the following attributes:
 151  147  .sp
 152  148  
 153  149  .sp
 154  150  .TS
 155  151  box;
 156  152  c | c
 157  153  l | l .
 158  154  ATTRIBUTE TYPE  ATTRIBUTE VALUE
 159  155  _
 160  156  Interface Stability     Evolving
 161  157  _
 162  158  MT-Level        MT-Safe
 163  159  .TE
 164  160  
 165  161  .SH SEE ALSO
 166      -.sp
 167  162  .LP
 168  163  \fBlgrp_home\fR(3LGRP), \fBliblgrp\fR(3LIB), \fBattributes\fR(5)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX