Hallo, dies ist ein Test.
PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html
Running in File Mode
Relative path: ./../../../../../../usr/man/man3lgrp/lgrp_home.3lgrp
Real path: /usr/share/man/man3lgrp/lgrp_home.3lgrp
Zurück
'\" te .\" Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved. .TH lgrp_home 3LGRP "1 Jun 2003" "Oracle Solaris 11.4" "Locality Group Library Functions" .SH NAME lgrp_home \- get home lgroup .SH SYNOPSIS .LP .nf cc [ \fIflag\fR... ] \fIfile\fR... \fB-llgrp\fR [ \fIlibrary\fR... ] #include <sys/lgrp_user.h> \fBlgrp_id_t\fR \fBlgrp_home\fR(\fBidtype_t\fR \fIidtype\fR, \fBid_t\fR \fIid\fR); .fi .SH DESCRIPTION .sp .LP The \fBlgrp_home()\fR function returns the ID of the home lgroup for the given process or thread. A thread can have an affinity for an lgroup in the system such that the thread will tend to be scheduled to run on that lgroup and allocate memory from there whenever possible. The lgroup with the strongest affinity that the thread can run on is known as the "home lgroup" of the thread. If the thread has no affinity for any lgroup that it can run on, the operating system will choose a home for it. .sp .LP The \fIidtype\fR argument should be \fBP_PID\fR to specify a process and the \fIid\fR argument should be its process ID. Otherwise, the \fIidtype\fR argument should be \fBP_LWPID\fR to specify a thread and the \fIid\fR argument should be its LWP ID. The value \fBP_MYID\fR can be used for the \fIid\fR argument to specify the current process or thread. .SH RETURN VALUES .sp .LP Upon successful completion, \fBlgrp_home()\fR returns the ID of the home lgroup of the specified process or thread. Otherwise, \(mi1 is returned and \fBerrno\fR is set to indicate the error. .SH ERRORS .sp .LP The \fBlgrp_home()\fR function will fail if: .sp .ne 2 .mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n .rt The ID type is not valid. .RE .sp .ne 2 .mk .na \fB\fBEPERM\fR\fR .ad .RS 10n .rt The effective user of the calling process does not have appropriate privileges, and its real or effective user ID does not match the real or effective user ID of one of the threads. .RE .sp .ne 2 .mk .na \fB\fBESRCH\fR\fR .ad .RS 10n .rt The specified process or thread was not found. .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed _ MT-Level MT-Safe .TE .sp .SH SEE ALSO .sp .LP \fBlgrp_affinity_get\fR(3LGRP), \fBlgrp_init\fR(3LGRP), \fBattributes\fR(7)