NVIDIA Data Center GPU Manager (DCGM)
Runs as a background process to manage GPUs on the node.
Provides interface to address queries from DCGMI tool.
USAGE:
nv-hostengine -t -p <PORT> -d <SOCKET_PATH> -n -b <IP_ADDRESS> -c <CID> --pid <FILENAME>
--log-level <LEVEL> -f <FILENAME> --log-rotate --denylist-modules <MODULEID[,
MODULEID...]> --service-account <USERNAME> --home-dir <Diagnostic home> --
--version -h
Where:
[-t | --term]: Terminates Host Engine [Best Effort]
[-p | --port]: Specify the port for the Host Engine
[-d | --domain-socket]: Specify the Unix domain socket path for host engine.
No TCP listening port is opened when this option is specified.
[-n | --no-daemon]: Tell the host engine not to daemonize on start-up
[-b | --bind-interface]: Specify the IP address of the network interface that the host engine should listen on.
ALL = bind to all interfaces.
Default: 127.0.0.1.
[-c | --vsock-cid]: Specify the Vsock CID that the host engine should listen on.
Default: bind to any CID.
[--pid]: Specify the PID filename nv-hostengine should use to ensure that only one instance
is running.
[--log-level]: Specify the logging level. Default: ERROR
NONE - Disable logging
FATAL - Set log level to FATAL only
ERROR - Set log level to ERROR and above
WARN - Set log level to WARNING and above
INFO - Set log level to INFO and above
DEBUG - Set log level to DEBUG and above
[-f | --log-filename]: Specify the filename nv-hostengine should use to dump logging information.
Default: /var/log/nv-hostengine.log
[--log-rotate]: Rotate the log file if the log file with the same name already exists.
[--denylist-modules]: DCGM modules that should be added to the Denylist so they aren't run by the hostengine.
Pass a comma-separated list of module IDs like 1,2,3.
Module IDs are available in dcgm_structs.h as DcgmModuleId constants.
[--service-account]: Service account that will be used for unprivileged processes.
Usually this should be set to the default nvidia-dcgm account
[--home-dir]: The full path to the directory that the DCGM diagnostic should be launched from. This
becomes the default output directory for DCGM diagnostic log and stats
files.
[-- | --ignore_rest]: Ignores the rest of the labeled arguments following this flag.
[--version]: Displays version information and exits.
[-h | --help]: Displays usage information and exits.
Please email cudatools@nvidia.com with any questions, bug reports, etc.
Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.