Lines Matching full:to

4 .\" The contents of this file are subject to the terms of the Common Development and Distribution L…
28 LWPs fall into distinct classes with a separate scheduling policy applied to
37 used to dynamically change the class and other scheduling parameters associated
48 set of processes, or an LWP to which the function applies. The
50 but allows a more general interface for specifying the set of LWPs to which the
51 function is to apply.
64 The \fBpriocntl()\fR function applies to all existing LWPs. The value of
76 applies to all LWPs in the specified class.
85 The \fIid\fR argument is a group ID. The \fBpriocntl()\fR function applies to
95 The \fIid\fR argument is an LWP ID. The \fIpriocntl\fR function applies to the
106 applies to all LWPs currently associated with processes in the specified
117 \fBpriocntl()\fR function applies to all LWPs currently associated with the
128 applies to all LWPs currently associated with processes with the specified
138 The \fIid\fR argument is a project ID. The \fBpriocntl()\fR function applies to
148 The \fIid\fR argument is a session ID. The \fBpriocntl()\fR function applies to
158 The \fIid\fR argument is a task ID. The \fBpriocntl()\fR function applies to
168 The \fIid\fR argument is a user ID. The \fBpriocntl()\fR function applies to
178 The \fIid\fR argument is a zone ID. The \fBpriocntl()\fR function applies to
189 applies to all LWPs with this process contract ID.
195 \fIidtype\fR value to specify the LWP ID, parent process ID, process group ID,
205 permissions requirements when setting LWPs to that class and/or when setting
211 is not possible to change the class of any LWP to \fBSYS\fR. In addition, any
219 The \fBinit\fR process is a special case. For a \fBpriocntl()\fR call to change
222 \fBinit\fR process can be assigned to any class configured on the system, but
228 The data type and value of \fIarg\fR are specific to the type of command
251 \fB<sys/priocntl.h>\fR, used to hold the class name: \fBRT\fR for realtime,
257 \fB<sys/priocntl.h>\fR, used to return data describing the attributes of a
279 assigned to \fIpc_cid\fR when using the \fBPC_GETPARMS\fR command as explained
296 always a pointer to a scheduling parameter. In contrast, when using
326 it sets the nice value of the LWP. The \fIarg\fR argument points to a structure
330 When \fIpc_op\fR is set to \fBPC_GETNICE\fR, \fBpriocntl()\fR sets the
331 \fIpc_val\fR to the highest priority (lowest numerical value) pertaining to any
334 When \fIpc_op\fR is set to \fBPC_SETNICE\fR, \fBpriocntl()\fR sets the nice
335 value of all LWPs in the specified set to the value specified in \fIpc_val\fR
338 The \fBpriocntl()\fR function returns \fB\(mi1\fR with \fBerrno\fR set to
339 \fBEPERM\fR if the calling LWP doesn't have appropriate permissions to set or
353 it points to a structure of type \fBpcinfo_t\fR. The \fIpc_clname\fR buffer
361 \fBerrno\fR set to \fBEINVAL\fR. The format of the attribute data returned for
379 points to a structure of type \fBpcinfo_t\fR. The \fIpc_cid\fR member is the
402 \fIarg\fR member points to a structure of type \fBpcparms_t\fR.
404 If \fIpc_cid\fR specifies a configured class and a single LWP belonging to that
408 does not belong to the specified class, the \fBpriocntl()\fR call returns
409 \fB\(mi1\fR with \fBerrno\fR set to \fBESRCH\fR.
412 the scheduling parameters of one of the specified LWP belonging to the
415 for selecting an LWP to return in this case is class-dependent. If none of the
416 specified LWPs exist or none of them belong to the specified class, the
417 \fBpriocntl()\fR call returns \fB\(mi1\fR with \fBerrno\fR set to \fBESRCH\fR.
432 value) pair sequence contains a pointer to the class-specific parameters. The
437 a single LWP belonging to that class is specified by the \fIidtype\fR and
440 specified does not exist or does not belong to the specified class,
441 \fBpriocntl()\fR returns \fB\(mi1\fR and \fBerrno\fR is set to \fBESRCH\fR.
444 scheduling parameters of one of the specified LWPs belonging to the specified
446 selected LWP. The criteria for selecting an LWP to return in this case is
447 class-dependent. If none of the specified LWPs exist or none of them belong to
449 set to \fBESRCH\fR.
453 the buffer pointed to by value with the class name of the specified process or
474 parameters of the LWP.  The \fIarg\fR argument points to a structure of type
486 related to permissions (\fBEPERM\fR), \fBpriocntl()\fR continues through the
489 \fB\(mi1\fR with \fBerrno\fR set to \fBEPERM\fR to indicate that the operation
505 \fBPC_SETXPARMS\fR) specifies the class to be changed and the following (key,
506 value) pair sequence contains the class-specific parameters to be changed. Only
507 those (key,value) pairs whose scheduling behavior is to change must be
517 related to permissions (\fBEPERM\fR), \fBpriocntl()\fR continues to reset the
520 is set to \fBEPERM\fR when the operation failed for one or more of the target
531 LWP is given CPU service before any LWP belonging to any other class.
535 can be assigned to an LWP within the class. Realtime priorities range from 0 to
543 request by the user/application to change the \fIrt_pri\fR value of the LWP.
547 purposes, equivalent to the scheduling priority of the LWP. The \fIrt_pri\fR
552 runnable realtime LWP with the highest \fIrt_pri\fR value is always selected to
556 In addition to providing control over priority, \fBpriocntl()\fR provides for
557 control over the length of the time quantum allotted to the LWP in the realtime
582 sleeping, LWPs that change to the realtime class from some other class, LWPs
588 function call by a realtime LWP, the parent LWP continues to run while the
611 priorities range from 0 to \fIx\fR.
615 \fB<sys/rtpriocntl.h>\fR, defines the format used to specify the realtime
633 These commands can be used to set the realtime priority to the specified value
635 that is currently running or runnable (not sleeping) causes the LWP to be
639 LWP. A running LWP can voluntarily release the CPU and go to the back of the
640 scheduling queue at the same priority by resetting its \fIrt_pri\fR value to
641 its current realtime priority value. To change the time quantum of an LWP
643 \fIrt_pri\fR member should be set to the special value \fBRT_NOCHANGE\fR,
645 the class of an LWP to realtime from some other class results in the realtime
646 priority being set to 0.
661 example, setting \fIrt_tqsecs\fR to 2 and \fBrt_tqnsecs\fR to 500,000,000
664 results in an error return with \fBerrno\fR set to \fBEINVAL\fR. Although the
666 quantum length is rounded up by the system to the next integral multiple of the
668 implementation-specific and equal to \fBINT_MAX\fR ticks. The \fBINT_MAX\fR
670 maximum results in an error return with \fBerrno\fR set to \fBERANGE\fR,
673 \fBrt_tqnsecs\fR to 0 results in an error return with \fBerrno\fR set to
677 The \fIrt_tqnsecs\fR member can also be set to one of the following special
695 Set the time quantum to the default for this priority (see \fBrt_dptbl\fR(5)).
704 Do not set the time quantum. This value is useful when you wish to change the
706 value when changing the class of an LWP to realtime from some other class is
707 equivalent to specifying \fBRT_TQDEF\fR.
717 same key results in an error return and \fBerrno\fR set to \fBEINVAL\fR.
738 associated with the key is always a pointer to a scheduling parameter of the
746 scheduling parameters of the target process(es) to their default values.
747 Changing the class of an LWP to realtime from some other class causes the
748 parameters to be set to their default values. The default realtime priority
750 assigned to each priority class (see \fBrt_dptbl\fR(5)). The default realtime
757 the number of nanoseconds results in an error return and \fBerrno\fR is set to
758 \fBEINVAL\fR. The specified time quantum is rounded up by the system to the
760 quantum that can be specified is implementation-specific and equal to
762 than this maximum results in an error return and \fBerrno\fR is set to
764 (\fBRT_KY_TQNSECS\fR) are supplied, the number of nanoseconds is set to
766 (\fBRT_KY_TQSECS\fR) are supplied, the number of seconds is set to \fB0\fR. A
768 error return with \fBerrno\fR set to \fBEINVAL\fR. Special values for
774 To change the class of an LWP to realtime from any other class, the LWP
775 invoking \fBpriocntl()\fR must have sufficient privileges. To change the
790 The objectives of the time-sharing policy are to provide good response time to
791 interactive LWPs and good throughput to CPU-bound jobs, while providing a
796 \fIts_upri\fR below) values that can be assigned to LWPs within the class. A
798 time-sharing class. User priorities range from \(mi\fIx\fR to +\fIx\fR where
804 The purpose of the user priority is to provide some degree of user/application
809 \fIts_upri\fR value, since the \fIts_upri\fR value is just one factor used to
815 In addition to the system-wide limits on user priority (returned by the
840 range for both user priorities and user priority limits is from \(mi\fIx\fR to
845 \fB<sys/tspriocntl.h>\fR, defines the format used to specify the time-sharing
872 raise a \fIts_uprilim\fR. When changing the class of an LWP to time-sharing
873 from some other class, sufficient privileges are required to set the initial
874 \fIts_uprilim\fR to a value greater than 0. Attempts by an unprivileged LWP to
876 with a return value of \(mi1 and \fBerrno\fR set to \fBEPERM\fR.
880 the same user ID) to any value less than or equal to the LWP's
881 \fIts_uprilim\fR. Attempts to set the \fIts_upri\fR above the \fIts_uprilim\fR
883 \fIts_upri\fR being set equal to the \fIts_uprilim\fR.
886 Either of the \fIts_uprilim\fR or \fIts_upri\fR members can be set to the
887 special value \fBTS_NOCHANGE\fR, defined in \fB<sys/tspriocntl.h>\fR, to set
889 the \fIts_upri\fR when the \fIts_uprilim\fR is being set to a value below the
890 current \fIts_upri\fR causes the \fIts_upri\fR to be set equal to the
892 changing the class of an LWP to time-sharing (from some other class) causes the
893 parameter to be set to a default value. The default value for the
894 \fIts_uprilim\fR is \fB0\fR and the default for the \fIts_upri\fR is to set it
895 equal to the \fIts_uprilim\fR that is being set.
903 specification of the same key results in an error return and \fBerrno\fR set to
921 associated with the key is always a pointer to a scheduling parameter of the
929 scheduling parameters of the target process(es) to their default values.
930 Changing the class of an LWP to time-sharing from some other class causes the
931 parameters to be set to their default values. The default value for the user
933 priority (\fBTS_KY_UPRI\fR) is equal to the user priority limit
947 interactive class with its \fIia_mode\fR value set to \fBIA_SET_INTERACTIVE\fR
969 range for both user priorities and user priority limits is from -x to +x.
973 \fB<sys/iapriocntl.h>\fR, defines the format used to specify the interactive
1000 manipulation of \fIts_uprilim\fR and \fIts_upri\fR applies equally to
1006 \fBIA_NOCHANGE\fR, defined in \fB<sys/iapriocntl.h>\fR, to set the interactive
1007 mode on or off or to make no change to the interactive mode.
1015 results in an error return and \fBerrno\fR set to \fBEINVAL\fR.
1031 associated with the key is always a pointer to a scheduling parameter of the
1039 scheduling parameters of the target process(es) to their default values.
1040 Changing the class of an LWP to interactive from some other class causes the
1041 parameters to be set to their default values. The default value for the user
1043 priority (\fBIA_KY_UPRI\fR) is equal to the user priority limit
1057 are given "shares" to control their quota of CPU resources. See \fBFSS\fR(4)
1058 for more information about how to configure shares.
1064 the fair-share class. User priorities range from -\fIx\fR to +\fIx\fR where the
1070 The purpose of the user priority is to provide some degree of user/application
1072 \fBfss_upri\fR value of an LWP in the fair-share class tells the scheduler to
1074 tells the scheduler to give it less CPU slices. It is not guaranteed, however,
1077 factor used to determine the scheduling priority of a fair-share LWP. The
1080 attempts to provide an evenly graded effect across the whole range of user
1090 In addition to the system-wide limits on user priority (returned by the
1115 user priorities and user priority limits is from -\fIx\fR to +\fIx\fR.
1119 \fB<sys/fsspriocntl.h>\fR, defines the format used to specify the fair-share
1146 raise an \fIfss_uprilim\fR. When changing the class of an LWP to fair-share
1147 from some other class, sufficient privileges are required to enter the FSS
1148 class or to set the initial \fIfss_uprilim\fR to a value greater than 0.
1149 Attempts by an unprivileged LWP to raise an \fIfss_uprilim\fR or set an initial
1151 set to \fBEPERM\fR.
1155 the same user ID) to any value less than or equal to the LWP's
1156 \fIfss_uprilim\fR. Attempts to set the \fBfss_upri\fR above the
1158 result in the \fIfss_upri\fR being set equal to the \fIfss_uprilim\fR.
1161 Either of the \fIfss_uprilim\fR or \fBfss_upri\fR members can be set to the
1162 special value \fBFSS_NOCHANGE\fR (defined in \fB<sys/fsspriocntl.h>\fR) to set
1164 for the \fIfss_upri\fR when the \fIfss_uprilim\fR is being set to a value below
1165 the current \fIfss_upri\fR causes the \fIfss_upri\fR to be set equal to the
1167 changing the class of an LWP to fair-share (from some other class) causes the
1168 parameter to be set to a default value. The default value for the
1169 \fBfss_uprilim\fR is 0 and the default for the \fBfss_upri\fR is to set it
1170 equal to the \fIfss_uprilim\fR which is being set.
1183 \fBfx_upri\fR below) values that can be assigned to LWPs within the class. A
1185 fixed-priority class. User priorities range from 0 to \fIx\fR where the value
1190 The purpose of the user priority is to provide user/application control over
1193 equivalent to the scheduling priority of the process. The \fIfx_upri\fR value
1195 relative to other processes within its class. Numerically higher \fIfx_upri\fR
1199 In addition to the system-wide limits on user priority (returned by the
1223 range for both user priorities and user priority limits is from 0 to \fIx\fR.
1227 defines the format used to specify the fixed-priority class-specific scheduling
1256 privileges can raise a \fIfx_uprilim\fR. When changing the class of an LWP to
1257 fixed-priority from some other class, sufficient privileges are required to set
1258 the initial \fIfx_uprilim\fR to a value greater than 0. Attempts by an
1259 unprivileged LWP to raise a \fIfx_uprilim\fR or set an initial \fBfx_uprilim\fR
1260 greater than 0 fail with a return value of -1 and errno set to \fBEPERM\fR.
1264 with the same user ID) to any value less than or equal to the LWP's
1265 \fIfx_uprilim\fR. Attempts to set the \fIfx_upri\fR above the \fBfx_uprilim\fR
1267 \fBfx_upri\fR being set equal to the \fIfx_uprilim\fR.
1270 Either of the \fIfx_uprilim\fR or \fIfx_upri\fR members can be set to the
1271 special value \fBFX_NOCHANGE\fR (defined in \fB<sys/fxpriocntl.h>\fR) to set
1273 the \fIfx_upri\fR when the \fIfx_uprilim\fR is being set to a value below the
1274 current \fIfx_upri\fR causes the \fIfx_upri\fR to be set equal to the
1276 changing the class of an LWP to fixed-priority (from some other class) causes
1277 the parameter to be set to a default value. The default value for the
1278 \fIfx_uprilim\fR is 0 and the default for the \fIfx_upri\fR is to set it equal
1288 example, setting \fIfx_tqsecs\fR to 2 and \fIfx_tqnsecs\fR to 500,000,000
1291 results in an error return with \fBerrno\fR set to \fBEINVAL\fR. Although the
1293 quantum length is rounded up by the system to the next integral multiple of the
1295 implementation-specific and equal to \fBINT_MAX\fR ticks (defined in
1297 error return with \fBerrno\fR set to \fBERANGE\fR, although infinite quantums
1299 quantum of 0 (setting both \fIfx_tqsecs\fR and \fIfx_tqnsecs\fR to 0) results
1300 in an error return with \fBerrno\fR set to \fBEINVAL\fR.
1303 The \fIfx_tqnsecs\fR member can also be set to one of the following special
1321 Set the time quantum to the default for this priority (see \fBfx_dptbl\fR(5)).
1332 changing the class of an LWP to fixed-priority from some other class is
1333 equivalent to specifying \fBFX_TQDEF\fR.
1343 same key results in an error return and \fBerrno\fR set to \fBEINVAL\fR.
1364 associated with the key is always a pointer to a scheduling parameter of the
1372 parameters of the target process(es) to their default values. Changing the
1373 class of an LWP to fixed-priority from some other class causes the parameters
1374 to be set to their default values. The default value for the user priority
1376 (\fBFX_KY_UPRI\fR) is equal to the user priority limit (\fBFX_KY_UPRILIM\fR)
1377 that is being set. A default time quantum (\fBFX_TQDEF\fR) is assigned to each
1384 the number of nanoseconds results in an error return and \fBerrno\fR is set to
1385 \fBEINVAL\fR. The specified time quantum is rounded up by the system to the
1387 quantum that can be specified is implementation-specific and equal to
1389 than this maximum results in an error return and \fBerrno\fR is set to
1391 (\fBFX_KY_TQNSECS\fR) are supplied, the number of nanoseconds is set to 0. If
1393 supplied, the number of seconds is set to 0. A time quantum of 0 (seconds and
1394 nanoseconds are 0) results in an error return with \fBerrno\fR set to
1404 failure, \fBpriocntl()\fR returns \fB\(mi1\fR and sets \fBerrno\fR to indicate
1414 An attempt to change the class of an LWP failed because of insufficient
1425 One of the arguments points to an illegal address.
1444 An attempt to change the class of an LWP failed because of insufficient memory.
1456 The calling LWP does not have sufficient privileges to affect the target LWP.