pbs_gpumode(3B)

💅 pbs_gpumode(3B) — NAME 💅

okay so welcome to pbs_gpumode(3B), the PBS manual page, bestie. This one is literally pbs_gpumode — change GPU mode. That's the name and the whole assignment. 🫶

✨ SYNOPSIS ✨

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

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

🌸 DESCRIPTION 🌸

okay so what this function does: it issues a batch request for pbs_mom to change the mode on one of its Nvidia GPUs. The GPU's mode is changed by sending a GPU Control batch request to the batch server. no cap, that's the pipeline. 🔥

bestie, heads up: this call requires PBS Operator or Manager privilege. It also requires that Torque be configured with --enable-nvidia-gpu. so like, don't skip that config, fr fr. 🚨

• mom_node — specifies the host within the cluster on which the GPU is located. This argument is the name of a host that is a member of the cluster of hosts managed by the server. 📍
• gpu_id — specifies the ID of the GPU on the MOM node. 🔢
• gpu_mode — specifies the new mode of the GPU. 🎛️

Valid Nvidia GPU modes are:

• 0 — Normal mode. 😌
• 1 — COMPUTE exclusive thread mode (only one COMPUTE thread is allowed to run on the GPU). 🧵
• 2 — COMPUTE prohibited mode (no COMPUTE contexts are allowed to run on the GPU). 🚫
• 3 — COMPUTE exclusive process mode (only one COMPUTE process is allowed to run on the GPU). This mode is new with Nvidia driver version 270. 👑

🦋 SEE ALSO 🦋

• qgpumode(1B) — that's the other page you should peek at, iykyk. 💖

💀 DIAGNOSTICS 💀

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. 😭✅

Cute sign-off time: source/version is Local, the page is pbs_gpumode(3B), and that footer has no date on it, so we're not gonna invent one. Bye bestie, go change that GPU mode responsibly 💅✨🫶