pbs_gpumode (3) - Linux Man Pages

pbs_gpumode: change GPU mode


pbs_gpumode - change GPU mode


#include <pbs_error.h>
#include <pbs_ifl.h>

int pbs_gpumode(int connect, char *mom_node, int gpu_id, int gpu_mode)


Issue a batch request for the pbs_mom to change the mode on one of it's Nvidia GPUs. The GPU's mode is changed by sending a GPU Control batch request to the batch server.

This call requires PBS Operator or Manager privilege. It also requires that Torque be configured with --enable-nvidia-gpu.

The argument, specifies the host within the cluster on which the GPU is located. The argument is the name of a host that is a member of the cluster of hosts managed by the server.

The argument, specifies ID of the GPU on the MOM node.

The argument, specifies new mode of the GPU. Valid Nvidia GPU modes are:

- Normal mode.
- COMPUTE exclusive thread mode (only one COMPUTE thread is allowed to run on the GPU).
- COMPUTE prohibited mode (no COMPUTE contexts are allowed to run on the GPU).
- COMPUTE exclusive process mode (only one COMPUTE process is allowed to run on the GPU). This mode is new with Nvidia driver version 270.


When the batch request generated by the pbs_gpumode() function has been completed successfully by a batch server, the routine will return 0 (zero). Otherwise, a non zero error is returned. The error number is also set in pbs_errno.