| cpuset.2 (201892) | cpuset.2 (233648) |
|---|---|
| 1.\" Copyright (c) 2008 Christian Brueffer 2.\" Copyright (c) 2008 Jeffrey Roberson 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 9 unchanged lines hidden (view full) --- 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" | 1.\" Copyright (c) 2008 Christian Brueffer 2.\" Copyright (c) 2008 Jeffrey Roberson 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 9 unchanged lines hidden (view full) --- 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" |
| 26.\" $FreeBSD: head/lib/libc/sys/cpuset.2 201892 2010-01-09 12:31:11Z delphij $ | 26.\" $FreeBSD: head/lib/libc/sys/cpuset.2 233648 2012-03-29 05:02:12Z eadler $ |
| 27.\" 28.Dd January 8, 2010 29.Dt CPUSET 2 30.Os 31.Sh NAME 32.Nm cpuset , 33.Nm cpuset_getid , 34.Nm cpuset_setid --- 37 unchanged lines hidden (view full) --- 72It is intended that administrators will manipulate numbered sets using 73.Xr cpuset 1 74while application developers will manipulate anonymous sets using 75.Xr cpuset_setaffinity 2 . 76.Pp 77To select the correct set a value of type 78.Ft cpulevel_t 79is used. | 27.\" 28.Dd January 8, 2010 29.Dt CPUSET 2 30.Os 31.Sh NAME 32.Nm cpuset , 33.Nm cpuset_getid , 34.Nm cpuset_setid --- 37 unchanged lines hidden (view full) --- 72It is intended that administrators will manipulate numbered sets using 73.Xr cpuset 1 74while application developers will manipulate anonymous sets using 75.Xr cpuset_setaffinity 2 . 76.Pp 77To select the correct set a value of type 78.Ft cpulevel_t 79is used. |
| 80The following values for | 80The following values for |
| 81.Fa level 82are supported: 83.Bl -column CPU_LEVEL_CPUSET -offset indent 84.It Dv CPU_LEVEL_ROOT Ta "Root set" 85.It Dv CPU_LEVEL_CPUSET Ta "Assigned set" 86.It Dv CPU_LEVEL_WHICH Ta "Set specified by which argument" 87.El 88.Pp --- 43 unchanged lines hidden (view full) --- 132process and stores its id in the space provided by 133.Fa setid . 134On successful completion the calling process joins the set and is the 135only member. 136Children inherit this set after a call to 137.Xr fork 2 . 138.Pp 139.Fn cpuset_setid | 81.Fa level 82are supported: 83.Bl -column CPU_LEVEL_CPUSET -offset indent 84.It Dv CPU_LEVEL_ROOT Ta "Root set" 85.It Dv CPU_LEVEL_CPUSET Ta "Assigned set" 86.It Dv CPU_LEVEL_WHICH Ta "Set specified by which argument" 87.El 88.Pp --- 43 unchanged lines hidden (view full) --- 132process and stores its id in the space provided by 133.Fa setid . 134On successful completion the calling process joins the set and is the 135only member. 136Children inherit this set after a call to 137.Xr fork 2 . 138.Pp 139.Fn cpuset_setid |
| 140attempts to set the id of the object specified by the | 140attempts to set the id of the object specified by the |
| 141.Fa which 142argument. 143Currently 144.Dv CPU_WHICH_PID 145is the only acceptable value for which as 146threads do not have an id distinct from their process and the API does 147not permit changing the id of an existing set. 148Upon successful completion all of the threads in the target process will 149be running on CPUs permitted by the set. 150.Pp 151.Fn cpuset_getid | 141.Fa which 142argument. 143Currently 144.Dv CPU_WHICH_PID 145is the only acceptable value for which as 146threads do not have an id distinct from their process and the API does 147not permit changing the id of an existing set. 148Upon successful completion all of the threads in the target process will 149be running on CPUs permitted by the set. 150.Pp 151.Fn cpuset_getid |
| 152retrieves a set id from the object indicated by | 152retrieves a set id from the object indicated by |
| 153.Fa which 154and stores it in the space pointed to by 155.Fa setid . 156The retrieved id may be that of either the root or assigned set | 153.Fa which 154and stores it in the space pointed to by 155.Fa setid . 156The retrieved id may be that of either the root or assigned set |
| 157depending on the value of | 157depending on the value of |
| 158.Fa level . 159.Fa level 160should be 161.Dv CPU_LEVEL_CPUSET 162or 163.Dv CPU_LEVEL_ROOT 164to get the set id from 165the process or thread specified by the --- 63 unchanged lines hidden --- | 158.Fa level . 159.Fa level 160should be 161.Dv CPU_LEVEL_CPUSET 162or 163.Dv CPU_LEVEL_ROOT 164to get the set id from 165the process or thread specified by the --- 63 unchanged lines hidden --- |