NAME

       gpu-pac - program and control compatible GPUs

SYNOPSIS

       gpu-pac [--help | --about]
       gpu-pac [--execute_pac] [--no_fan] [--force_write] [--debug]

DESCRIPTION

       gpu-pac provides capability for Program and Control compatible GPUs with this utility.  By
       default, the commands to be written to a GPU are written to a bash file for  the  user  to
       inspect  and run.  If you have confidence, the --execute_pac option can be used to execute
       and then delete the saved bash file.  Since the GPU device  files  are  writable  only  by
       root, sudo is used to execute commands in the bash file, as a result, you will be prompted
       for credentials in the terminal where you executed gpu-pac. The  --no_fan  option  can  be
       used  to  eliminate  fan details from the utility. The --force_write option can be used to
       force all configuration parameters to be written to the GPU.  The default behavior  is  to
       only write changes.

OPTIONS

        --about
              Will display details about gpu-pac.

        --execute_pac
              Will  execute  a  bash  file  created  with commands written to the driver files to
              modify the operating conditions of the selected GPU/GPUs.  The default behavior  is
              to only create the bash files for the user to execute.

        --no_fan
              Will  exclude fan information from the display and will not include fans in writing
              or resetting GPU operating conditions.

        --force_write
              Will result in all parameters being writen to the selected GPU/GPUs instead of  the
              default behavior of only writing changes.

        --debug
              Will output additional useful debug/troubleshooting details to a log file.

       -h, --help
              Display help text and exit.

EXAMPLES

       gpu-pac

       Will  open  a  Gtk  based  user interface which will display current or default values for
       modifiable GPU operating parameters.  The interface supports entry of new values  for  all
       compatible  GPUs.  The user can select to save or reset values for individual or all GPUs.
       It is suggested that gpu-mon be used to make sure the changes are made as expected.

       gpu-pac --execute_pac

       To simplify this process, the --execute_pac option can be specified to automate  execution
       of  the  bash  files.   A  message  in the user interface will indicate if credentials are
       required in the original terminal window.

       gpu-pac --force_write

       With this option, all parameters will be written to  the  bash  file,  even  if  they  are
       unchanged.   This  is  useful  in creating bash files used to put GPU's into a known state
       which is convenient for use in start up routines.

CONFIGURATION

       In order to get maximum capability of these utilities, you should be running with a kernel
       that  provides  support of the GPUs you have installed.  If using AMD GPUs, installing the
       latest  amdgpu  driver  package  or  the  latest  ROCm  release,  may  provide  additional
       capabilities.  If  you  have  Nvidia  GPUs installed, nvidia-smi must also be installed in
       order for the utility reading of the cards to be possible.  Writing to GPUs  is  currently
       only  possible  for  AMD  GPUs,  and  only  with  compatible  cards  and  with the the AMD
       ppfeaturemask   set   to   0xfffd7fff.   This    can    be    accomplished    by    adding
       amdgpu.ppfeaturemask=0xfffd7fff     to    the    GRUB_CMDLINE_LINUX_DEFAULT    value    in
       /etc/default/grub and executing sudo update-grub.

FILES

       /usr/share/misc/pci.ids
              The system list of all known PCI ID's (vendors, devices, classes  and  subclasses).
              It can be updated with the update-pciids command.

       /sys/class/drm/card*/device/pp_od_clk_voltage
              Special driver file for each AMD GPU required by some rickslab-gpu-utils.

       /etc/default/grub
              The grub defaults file where amdgpu.ppfeaturemask needs to be set.

BUGS

       Known  to  not  work  well with Fiji ProDuo cards and will issue warning messages for Fiji
       Nano cards.  The display of P-state masks is always the defaults, not the  actual  values.
       Please report any additional bugs/issues at https://github.com/Ricks-Lab/gpu-utils

SEE ALSO

       gpu-mon(1), amdgpu(4), update-grub(8), update-pciids(8), lspci(8)

AVAILABILITY

       The  gpu-pac  command  is  part  of  the  rickslab-gpu-utils package and is available from
       https://github.com/Ricks-Lab/gpu-utils