Changeset View
Changeset View
Standalone View
Standalone View
usr.bin/cpuset/cpuset.1
Show All 19 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd July 29, 2016 | .Dd July 7, 2017 | ||||
.Dt CPUSET 1 | .Dt CPUSET 1 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm cpuset | .Nm cpuset | ||||
.Nd "configure processor sets" | .Nd "configure processor sets" | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl l Ar cpu-list | .Op Fl l Ar cpu-list | ||||
.Op Fl s Ar setid | .Op Fl s Ar setid | ||||
.Ar cmd ... | .Ar cmd ... | ||||
.Nm | .Nm | ||||
.Op Fl l Ar cpu-list | .Op Fl l Ar cpu-list | ||||
.Op Fl s Ar setid | .Op Fl s Ar setid | ||||
.Fl p Ar pid | .Fl p Ar pid | ||||
.Nm | .Nm | ||||
.Op Fl c | .Op Fl c | ||||
.Op Fl l Ar cpu-list | .Op Fl l Ar cpu-list | ||||
.Fl C | .Fl C | ||||
.Fl p Ar pid | .Fl p Ar pid | ||||
.Nm | .Nm | ||||
.Op Fl c | .Op Fl c | ||||
.Op Fl l Ar cpu-list | .Op Fl l Ar cpu-list | ||||
.Op Fl j Ar jailid | Fl p Ar pid | Fl t Ar tid | Fl s Ar setid | Fl x Ar irq | .Op Fl j Ar jailid | Fl p Ar pid | Fl t Ar tid | Fl s Ar setid | Fl IXx Ar irq | ||||
jhb: Might want to ask a doc person like @wblock if this is the right way to format this (same for… | |||||
Not Done Inline ActionsThe best I've done with this is like so: .Op .Fl j Ar jailid | .Fl p Ar pid | .Fl t Ar tid | .Fl s Ar setid | .Fl x Ar irq | .Fl I Ar irq | .Fl X Ar irq .Oc This puts the additional options on the same line as [-l cpu-list]. Maybe not a big deal. wblock: The best I've done with this is like so:
```.Op
.Fl j Ar jailid |
.Fl p Ar pid |
.Fl t Ar tid |… | |||||
.Nm | .Nm | ||||
.Fl g | .Fl g | ||||
.Op Fl cir | .Op Fl cir | ||||
.Op Fl d Ar domain | Fl j Ar jailid | Fl p Ar pid | Fl t Ar tid | Fl s Ar setid | Fl x Ar irq | .Op Fl d Ar domain | Fl j Ar jailid | Fl p Ar pid | Fl t Ar tid | Fl s Ar setid | Fl IXx Ar irq | ||||
wblockUnsubmitted Not Done Inline Actions.Oo .Fl d Ar domain | .Fl j Ar jailid | .Fl p Ar pid | .Fl t Ar tid | .Fl s Ar setid | .Fl x Ar irq | .Fl I Ar irq | .Fl X Ar irq .Oc wblock: ```.Oo
.Fl d Ar domain |
.Fl j Ar jailid |
.Fl p Ar pid |
.Fl t Ar tid |
.Fl s Ar setid |
.Fl x… | |||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm | .Nm | ||||
command can be used to assign processor sets to processes, run commands | command can be used to assign processor sets to processes, run commands | ||||
constrained to a given set or list of processors, and query information | constrained to a given set or list of processors, and query information | ||||
about processor binding, sets, and available processors in the system. | about processor binding, sets, and available processors in the system. | ||||
.Pp | .Pp | ||||
.Nm | .Nm | ||||
▲ Show 20 Lines • Show All 71 Lines • ▼ Show 20 Lines | |||||
.It Fl s Ar setid | .It Fl s Ar setid | ||||
Specifies a set id as the target of the operation. | Specifies a set id as the target of the operation. | ||||
.It Fl r | .It Fl r | ||||
The requested operation should reference the root set available via the | The requested operation should reference the root set available via the | ||||
target specifier. | target specifier. | ||||
.It Fl t Ar tid | .It Fl t Ar tid | ||||
Specifies a thread id as the target of the operation. | Specifies a thread id as the target of the operation. | ||||
.It Fl x Ar irq | .It Fl x Ar irq | ||||
Specifies an irq as the target of the operation. | Specifies all resources associated with an interrupt as the target of the operation. | ||||
.It Fl X Ar irq | |||||
Specifies the hardware interrupt vector as the target of the operation. | |||||
.It Fl I Ar irq | |||||
Specifies dedicated threads associated with an interrupt as the target of the operation. | |||||
Done Inline ActionsMaybe tweak the descriptions like so: -x: Specifies all resources associated with an interrupt as the target of an operation. (I would maybe say "uses" instead of "specifies" here, but the rest of the manpage uses "specifies") jhb: Maybe tweak the descriptions like so:
-x: Specifies all resources associated with an interrupt… | |||||
.El | .El | ||||
.Sh EXIT STATUS | .Sh EXIT STATUS | ||||
.Ex -std | .Ex -std | ||||
.Sh EXAMPLES | .Sh EXAMPLES | ||||
Create a new group with CPUs 0-4 inclusive and run | Create a new group with CPUs 0-4 inclusive and run | ||||
.Pa /bin/sh | .Pa /bin/sh | ||||
on it: | on it: | ||||
.Dl cpuset -c -l 0-4 /bin/sh | .Dl cpuset -c -l 0-4 /bin/sh | ||||
▲ Show 20 Lines • Show All 46 Lines • Show Last 20 Lines |
Might want to ask a doc person like @wblock if this is the right way to format this (same for usage())