HP UX Operating Systems 30

intro(1)		intro(1)
NETWORKING	FEATURES
		Information under this heading is applicable only if you are using the networking
		feature described there (such as NFS).
RETURN VALUE		Discusses various values returned upon completion of program calls.
DIAGNOSTICS		Discusses diagnostics indications that may be produced. Self-explanatory messages
		are not listed.
ERRORS		Lists error conditions and their corresponding error message or return value.
EXAMPLES		Provides examples of typical usage, where appropriate.
WARNINGS		Points out potential pitfalls.
DEPENDENCIES		Points out variations in HP-UX operation that are related to the user or speci®c
		hardware or hardware combinations.
AUTHOR		Indicate the origin of the software documented by the manual entry.
FILES		Lists ®le names that are built into the program or command.
SEE ALSO		Provides pointers to related topics.
BUGS		Discusses known bugs and de®ciencies, occasionally suggesting ®xes.
STANDARDS	CONFORMANCE
		This section lists the standard speci®cations to which the HP-UX component con-
		forms.

RETURN VALUE

Upon termination, each command returns two bytes of status, one supplied by the system giving the cause for termination, and (in the case of ``normal'' termination) one supplied by the program (for descriptions, see wait(2) and exit(2)). The system-supplied byte is 0 for normal termination. The byte provided by the program is customarily 0 for successful execution and non-zero to indicate errors or failure such as incorrect parameters in the command line, or bad or inaccessible data. Values returned are usually called variously ``exit code'', ``exit status'', ``return code'', or ``return value'', and are described only where special conventions are involved.

WARNINGS

Some commands produce unexpected results when processing ®les containing null characters. These commands often treat text input lines as strings, and therefore become confused when they encounter a null character (the string terminator) within a line.