Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ././../../../../../../usr/man/man2/pset_create.2
Real path: /usr/share/man/man2/pset_create.2
Zurück

'\" te .\" Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved. .TH pset_create 2 "20 Jan 2015" "Oracle Solaris 11.4" "System Calls" .SH NAME pset_create, pset_destroy, pset_assign \- manage sets of processors .SH SYNOPSIS .LP .nf #include <sys/pset.h> \fBint\fR \fBpset_create\fR(\fBpsetid_t *\fR\fInewpset\fR); .fi .LP .nf \fBint\fR \fBpset_destroy\fR(\fBpsetid_t\fR \fIpset\fR); .fi .LP .nf \fBint\fR \fBpset_assign\fR(\fBpsetid_t\fR \fIpset\fR, \fBprocessorid_t\fR \fIcpu\fR, \fBpsetid_t *\fR\fIopset\fR); .fi .SH DESCRIPTION .sp .LP These functions control the creation and management of sets of processors. \fIPsets\fR allow a subset of the system's processors to be set aside for exclusive use by specified \fBLWP\fRs and processes. The binding of \fBLWP\fRs and processes to \fIpsets\fR is controlled by \fBpset_bind\fR(2). .sp .LP The \fBpset_create()\fR function creates an empty \fIpset\fR that contains no processors. On successful return, \fInewpset\fR will contain the \fBID\fR of the new \fIpset\fR. .sp .LP The \fBpset_destroy()\fR function destroys the \fIpset\fR, releasing its constituent processors and processes. If \fIpset\fR is \fBPS_MYID\fR, the \fIpset\fR to which the caller is bound is destroyed. .sp .LP The \fBpset_assign()\fR function assigns the processor \fIcpu\fR to the \fIpset\fR. A processor that has been assigned to a \fIpset\fR will run only \fBLWP\fRs and processes that have been explicitly bound to that \fIpset\fR, unless another \fBLWP\fR requires a physical resource that is only available on that processor. .sp .LP On successful return, if \fIopset\fR is non-null, \fIopset\fR will contain the \fIpset\fR \fBID\fR of the former \fIpset\fR of the processor. .sp .LP If \fIpset\fR is \fBPS_NONE\fR, \fBpset_assign()\fR releases processor \fIcpu\fR from its current \fIpset\fR. .sp .LP If \fIpset\fR is \fBPS_QUERY\fR, \fBpset_assign()\fR makes no change to processor sets, but returns the current \fIpset\fR \fBID\fR of processor \fIcpu\fR in \fIopset\fR. .sp .LP If \fIpset\fR is \fBPS_MYID\fR, processor \fIcpu\fR is assigned to the \fIpset\fR to which the caller belongs. If the caller does not belong to a \fIpset\fR, processor \fIcpu\fR is released from its current \fIpset\fR. .sp .LP These functions are restricted to privileged processes, except for \fBpset_assign()\fR when \fIpset\fR is \fBPS_QUERY\fR. .SH RETURN VALUES .sp .LP Upon successful completion, these functions return \fB0\fR. Otherwise, \fB\(mi1\fR is returned and \fBerrno\fR is set to indicate the error. .SH ERRORS .sp .LP These functions will fail if: .sp .ne 2 .mk .na \fB\fBEBUSY\fR\fR .ad .RS 11n .rt The processor could not be moved to the specified \fIpset\fR. .RE .sp .ne 2 .mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n .rt The location pointed to by \fInewpset\fR was not writable by the user, or the location pointed to by \fIopset\fR was not \fINULL\fR and not writable by the user. .RE .sp .ne 2 .mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n .rt The specified processor does not exist, the specified processor is not on-line, or an invalid \fIpset\fR was specified. .RE .sp .ne 2 .mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n .rt There was insufficient space for \fBpset_create\fR to create a new \fIpset\fR. .RE .sp .ne 2 .mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n .rt For \fBpset_destroy()\fR and \fBpset_assign()\fR, the target \fIpset\fR was created by the resource pools facility. For \fBpset_assign()\fR, this error can also be returned if the target \fIcpus\fR are currently assigned or allocated to a \fIpset\fR created by the resource pools facility. See \fBpool_resource_create\fR(3POOL), or \fBpoolcfg\fR(8) for a description of how to destroy and transfer \fIcpus\fR to such psets. .sp \fBpset_assign()\fR will fail if the target \fIcpu\fR is already transferred or assigned to a \fIpset\fR created by the resource pools facility. .RE .sp .ne 2 .mk .na \fB\fBEPERM\fR\fR .ad .RS 11n .rt The {\fBPRIV_SYS_RES_CONFIG\fR} privilege is not asserted in the effective set of the calling process. .RE .sp .ne 2 .mk .na \fB\fBEINTR\fR\fR .ad .RS 11n .rt The process received a signal while attempting the operation. .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 Async-Signal-Safe .TE .sp .SH SEE ALSO .sp .LP \fBp_online\fR(2), \fBprocessor_bind\fR(2), \fBpset_bind\fR(2), \fBpset_info\fR(2), \fBpset_getloadavg\fR(3C), \fBpool_resource_create\fR(3POOL), \fBattributes\fR(7), \fBprivileges\fR(7), \fBpooladm\fR(8), \fBpsradm\fR(8), \fBpsrinfo\fR(8), \fBpsrset\fR(8) .SH NOTES .sp .LP The \fIpset\fR type of \fBPS_SYSTEM\fR is no longer supported. .sp .LP Processors with \fBLWP\fRs bound to them using \fBprocessor_bind\fR(2) cannot be assigned to a new \fIpset\fR. If this is attempted, \fBpset_assign()\fR will fail and set \fBerrno\fR to \fBEBUSY\fR.