| cpuset.1 (183464) | cpuset.1 (185435) |
|---|---|
| 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/usr.bin/cpuset/cpuset.1 183464 2008-09-29 15:44:48Z jhb $ | 26.\" $FreeBSD: head/usr.bin/cpuset/cpuset.1 185435 2008-11-29 14:32:14Z bz $ |
| 27.\" | 27.\" |
| 28.Dd March 11, 2008 | 28.Dd November 29, 2008 |
| 29.Dt CPUSET 1 30.Os 31.Sh NAME 32.Nm cpuset 33.Nd "configure processor sets" 34.Sh SYNOPSIS 35.Nm 36.Op Fl l Ar cpu-list 37.Op Fl s Ar setid 38.Ar cmd 39.Nm 40.Op Fl l Ar cpu-list 41.Op Fl s Ar setid 42.Fl p Ar pid 43.Nm 44.Op Fl cr 45.Op Fl l Ar cpu-list | 29.Dt CPUSET 1 30.Os 31.Sh NAME 32.Nm cpuset 33.Nd "configure processor sets" 34.Sh SYNOPSIS 35.Nm 36.Op Fl l Ar cpu-list 37.Op Fl s Ar setid 38.Ar cmd 39.Nm 40.Op Fl l Ar cpu-list 41.Op Fl s Ar setid 42.Fl p Ar pid 43.Nm 44.Op Fl cr 45.Op Fl l Ar cpu-list |
| 46.Op Fl p Ar pid | Fl r Ar tid | Fl s Ar setid | 46.Op Fl j Ar jailid | Fl p Ar pid | Fl r Ar tid | Fl s Ar setid | Fl x Ar irq |
| 47.Nm 48.Op Fl cgir | 47.Nm 48.Op Fl cgir |
| 49.Op Fl p Ar pid | Fl r Ar tid | Fl s Ar setid | 49.Op Fl j Ar jailid | Fl p Ar pid | Fl r Ar tid | Fl s Ar setid | Fl x Ar irq |
| 50.Sh DESCRIPTION 51The 52.Nm 53command can be used to assign processor sets to processes, run commands 54constrained to a given set or list of processors, and query information 55about processor binding, sets, and available processors in the system. 56.Pp 57.Nm 58requires a target to modify or query. | 50.Sh DESCRIPTION 51The 52.Nm 53command can be used to assign processor sets to processes, run commands 54constrained to a given set or list of processors, and query information 55about processor binding, sets, and available processors in the system. 56.Pp 57.Nm 58requires a target to modify or query. |
| 59The target may be specified as a command, process id, thread id, or a 60cpuset id. | 59The target may be specified as a command, process id, thread id, a 60cpuset id, an irq or a jail id. |
| 61Using 62.Fl g 63the target's set id or mask may be queried. 64Using 65.Fl l 66or 67.Fl s 68the target's CPU mask or set id may be set. --- 37 unchanged lines hidden (view full) --- 106.Nm 107to print either a list of valid CPUs or, using 108.Fl i , 109the id of the target. 110.It Fl i 111When used with the 112.Fl g 113option print the id rather than the valid mask of the target. | 61Using 62.Fl g 63the target's set id or mask may be queried. 64Using 65.Fl l 66or 67.Fl s 68the target's CPU mask or set id may be set. --- 37 unchanged lines hidden (view full) --- 106.Nm 107to print either a list of valid CPUs or, using 108.Fl i , 109the id of the target. 110.It Fl i 111When used with the 112.Fl g 113option print the id rather than the valid mask of the target. |
| 114.It Fl j Ar jailid 115Specifies a jail id as the target of the operation. |
|
| 114.It Fl l Ar cpu-list 115Specifies a list of CPUs to apply to a target. 116Specification may include 117numbers separated by '-' for ranges and commas separating individual numbers. 118.It Fl p Ar pid 119Specifies a pid as the target of the operation. 120.It Fl s Ar setid 121Specifies a set id as the target of the operation. 122.It Fl r 123The requested operation should reference the root set available via the 124target specifier. 125.It Fl t Ar tid 126Specifies a thread id as the target of the operation. | 116.It Fl l Ar cpu-list 117Specifies a list of CPUs to apply to a target. 118Specification may include 119numbers separated by '-' for ranges and commas separating individual numbers. 120.It Fl p Ar pid 121Specifies a pid as the target of the operation. 122.It Fl s Ar setid 123Specifies a set id as the target of the operation. 124.It Fl r 125The requested operation should reference the root set available via the 126target specifier. 127.It Fl t Ar tid 128Specifies a thread id as the target of the operation. |
| 129.It Fl x Ar irq 130Specifies an irq as the target of the operation. |
|
| 127.El 128.Sh EXIT STATUS 129.Ex -std 130.Sh EXAMPLES 131Create a new group with CPUs 0-4 inclusive and run 132.Pa /bin/sh 133on it: 134.Dl cpuset -c -l 0-4 /bin/sh --- 41 unchanged lines hidden --- | 131.El 132.Sh EXIT STATUS 133.Ex -std 134.Sh EXAMPLES 135Create a new group with CPUs 0-4 inclusive and run 136.Pa /bin/sh 137on it: 138.Dl cpuset -c -l 0-4 /bin/sh --- 41 unchanged lines hidden --- |