'\" t
.\"     Title: switcherooctl
.\"    Author: Bastien Nocera <hadess@hadess.net>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 01/30/2023
.\"    Manual: User Commands
.\"    Source: switcherooctl
.\"  Language: English
.\"
.TH "SWITCHEROOCTL" "1" "" "switcherooctl" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
switcherooctl \- Launch a command on a specific GPU
.SH "SYNOPSIS"
.HP \w'\fBswitcherooctl\fR\ 'u
\fBswitcherooctl\fR help [\fICOMMAND\fR]
.HP \w'\fBswitcherooctl\fR\ 'u
\fBswitcherooctl\fR version
.HP \w'\fBswitcherooctl\fR\ 'u
\fBswitcherooctl\fR list
.HP \w'\fBswitcherooctl\fR\ 'u
\fBswitcherooctl\fR launch [\fIOPTION\fR] \fICOMMAND\fR...
.SH "DESCRIPTION"
.PP
\fBswitcherooctl\fR
is a utility to launch a specific command on a specific GPU\&.
.SH "COMMANDS"
.PP
\fBhelp\fR [\fICOMMAND\fR]
.RS 4
Displays a short synopsis of the available commands or provides detailed help on a specific command\&.
.RE
.PP
\fBversion\fR
.RS 4
Prints the switcheroo\-control version to which
\fBswitcherooctl\fR
belongs\&.
.RE
.PP
\fBlist\fR
.RS 4
List the known GPUs\&. The device number can be used to specify the GPU to launch on for the
launch
command\&. This is the default command if no commands are passed to
switcherooctl\&.
.RE
.PP
\fBlaunch\fR [\fIOPTION\fR] \fICOMMAND\fR...
.RS 4
Launch
\fICOMMAND\fR
on a specific GPU\&. If no GPU are specified the first discrete (non\-default) GPU is used, or the default GPU if there\*(Aqs no discrete GPU\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBOptions\fR
.RS 4
.PP
\fB\-g\fR \fB\-\-gpu=\fR\fB\fIGPU\fR\fR
.RS 4
The GPU to launch on\&. The GPU identifier can be gathered using the
list
command\&.
.RE
.RE
.RE
.SH "EXIT STATUS"
.PP
On success 0 is returned, a non\-zero failure code otherwise\&.