HTAR Exit Codes

HTAR returns a non-zero exit code if it detects error(s) while executing commands.


The current set of exit codes, originally adapted from the UC Berkeley            

    /usr/include/sysexits.h 

header file on un*x operating systems, are as follows:

ment

Error Code

Mnemonic

Comment

0

EX_OK

successful termination

0

EX_WARNING

warning error(s) issued

64

EX_USAGE

command line usage error

The command was used incorrectly, e.g., with the wrong number of arguments, a bad flag, a bad

syntax in a parameter, or whatever

65

EX_DATAERR

data format error

The input data was incorrect in some way.

66

EX_NOINPUT

cannot open input

An input file (not a system file) did not

exist or was not readable.  

67

EX_NOUSER

user is unknown

The user specified did not exist.

68

EX_NOHOST

host name unknown

The host specified did not exist. 

69

EX_UNAVAILABLE

service unavailable

A service is unavailable, or a support program or file does not exist, or something failed for an unknown reason

70

EX_SOFTWARE

internal software error

An internal software error has been detected.

71

EX_OSERR

system error (e.g., can't fork)

An operating system error has been detected. This

error exit is used for such things as “cannot fork”, “cannot create pipe”, “cannot find uid or gid in the passwd/group file”, etc.

72

EX_OSFILE

file missing or cant open

Some system file does not exist, cannot be opened, or has some sort of error (such as a syntax error).

73

EX_CANTCREAT

can't create (user) output file

A user specified output file cannot be created.

74

EX_IOERR

input/output error

An error occurred while doing I/O on some file

75

EX_TEMPFAIL

temp failure; user is invited to retry

A temporary failure, that is not really an error, has occurred. The user should retry later.

76

EX_PROTOCOL

remote error in protocol

An internal protocol error has occurred

77

EX_NOPERM

permission denied

You did not have sufficient permission to perform the operation.

78

EX_MEMORY

memory allocation problem

An out-of-memory condition was detected, because of a user limit restriction by the O.S., internal memory leak, etc.

79

EX_TIMEOUT

timeout error

A timeout error on some operation was detected