Proxmox VE exit codes meaning

[TheAncientMariner]

Hello everyone, since I recently had to do some troubleshooting involving an error when trying to access the shell through management GUI and this error message included at the end "exit code 1" but I was unable to find any official documentation regarding these exit codes and their meaning, I wanted to ask here:
does anyone have knowledge of some official (or even unofficial) resource (like a list of all possible codes) detailing their meaning?

Example of a full error message with exit code:
proxmox failed waiting for client: timed out
TASK ERROR: command /usr/bin/termproxy 5900 --path /nodes --perm Sys.Console --vncticket-endpoint -- bin login -f root failed: exit code 1

Additionally, it would be interesting to hear some opinions on the usefulness of these codes. We all know of extremely vague and badly documented error codes in MS products, that really don't offer much help when troubleshooting. Maybe these codes here are similar and can basically be ignored when investigating issues? If that is the case, what would be the best ways to dig deeper into an error such as this one?

Any help would be greatly appreaciated, thanks!

 

[psalkiewicz]

You won't get any specific information from the exit code. It's either 0 (success) or 1 (error). Any value >0 is considered error and the purpose of that is to control the flow of the scripts (by simple logic) not the detailed troubleshooting. You have to read the error messages and dig into logs for more.

 

[bbgeek17]

Hi @TheAncientMariner ,

Exit code 1 is a generic non-success return value. Any non-zero exit code usually indicates a failure. Some applications use a range of exit codes to represent specific error conditions, but as far as I am aware, PVE typically uses 1 for most failure cases, and that is perfectly acceptable.

The real diagnostic value lies in the log output, if available.
Cheers

---

Blockbridge : Ultra low latency all-NVME shared storage for Proxmox - https://www.blockbridge.com/proxmox

 

[TheAncientMariner]

You won't get any specific information from the exit code. It's either 0 (success) or 1 (error). Any value >0 is considered error and the purpose of that is to control the flow of the scripts (by simple logic) not the detailed troubleshooting. You have to read the error messages and dig into logs for more.

Hi @TheAncientMariner ,

Exit code 1 is a generic non-success return value. Any non-zero exit code usually indicates a failure. Some applications use a range of exit codes to represent specific error conditions, but as far as I am aware, PVE typically uses 1 for most failure cases, and that is perfectly acceptable.

The real diagnostic value lies in the log output, if available.
Cheers

---

Blockbridge : Ultra low latency all-NVME shared storage for Proxmox - https://www.blockbridge.com/proxmox

Ah, I see now. Thank you both very much for you quick help!