gpumem [-r device] [-l] [-u] [-U] [-t] [-f mb_to_free]
Houdini uses one or more graphics cards (GPUs) in various ways - viewport display, GPU-accelerated simulations, COPs, and Karma XPU. Each GPU (or 'device') has a local amount of dedicated memory that is shared between these users (or 'clients'). This command can list those devices, show the amount of memory Houdini is using by device, and be used to release some of that memory, if possible.
Note
Other GPUs may exist in the system, but will not be listed if Houdini does not use them.
Options ¶
-l
List all GPU devices currently in use. If -r is also specified, list
the Houdini clients currently using that device.
-r ‹device›
Indicate the device resource to target with this command. device must be a string returned by gpumem -l.
-u
Display the memory used by all clients on the specified device (use with -r).
-U:
Break down the memory usage by client on the specified device (use with -r). The 'cached' portion is the amount of the total memory used that can be readily freed because it’s not actively in use.
-t:
Print the total memory available for the specified device (use with -r).
-f ‹mb_to_free›:
Attempt to free a certain amount of memory (in MB) on the specified device by requesting it from all the clients (based on their priority). Report the amount freed. Use with -r.
| See also |