[unix-history] / usr / src / include / sysexits.h

/*
 * Copyright (c) 1987 Regents of the University of California.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms are permitted
 * provided that the above copyright notice and this paragraph are
 * duplicated in all such forms and that any documentation,
 * advertising materials, and other materials related to such
 * distribution and use acknowledge that the software was developed
 * by the University of California, Berkeley.  The name of the
 * University may not be used to endorse or promote products derived
 * from this software without specific prior written permission.
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
 * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 *
 *	@(#)sysexits.h	4.5 (Berkeley) %G%
 */

/*
**  SYSEXITS.H -- Exit status codes for system programs.
**
**	This include file attempts to categorize possible error
**	exit statuses for system programs, notably delivermail
**	and the Berkeley network.
**
**	Error numbers begin at EX__BASE to reduce the possibility of
**	clashing with other exit statuses that random programs may
**	already return.  The meaning of the codes is approximately
**	as follows:
**
**	EX_USAGE -- The command was used incorrectly, e.g., with
**		the wrong number of arguments, a bad flag, a bad
**		syntax in a parameter, or whatever.
**	EX_DATAERR -- The input data was incorrect in some way.
**		This should only be used for user's data & not
**		system files.
**	EX_NOINPUT -- An input file (not a system file) did not
**		exist or was not readable.  This could also include
**		errors like "No message" to a mailer (if it cared
**		to catch it).
**	EX_NOUSER -- The user specified did not exist.  This might
**		be used for mail addresses or remote logins.
**	EX_NOHOST -- The host specified did not exist.  This is used
**		in mail addresses or network requests.
**	EX_UNAVAILABLE -- A service is unavailable.  This can occur
**		if a support program or file does not exist.  This
**		can also be used as a catchall message when something
**		you wanted to do doesn't work, but you don't know
**		why.
**	EX_SOFTWARE -- An internal software error has been detected.
**		This should be limited to non-operating system related
**		errors as possible.
**	EX_OSERR -- An operating system error has been detected.
**		This is intended to be used for such things as "cannot
**		fork", "cannot create pipe", or the like.  It includes
**		things like getuid returning a user that does not
**		exist in the passwd file.
**	EX_OSFILE -- Some system file (e.g., /etc/passwd, /etc/utmp,
**		etc.) does not exist, cannot be opened, or has some
**		sort of error (e.g., syntax error).
**	EX_CANTCREAT -- A (user specified) output file cannot be
**		created.
**	EX_IOERR -- An error occurred while doing I/O on some file.
**	EX_TEMPFAIL -- temporary failure, indicating something that
**		is not really an error.  In sendmail, this means
**		that a mailer (e.g.) could not create a connection,
**		and the request should be reattempted later.
**	EX_PROTOCOL -- the remote system returned something that
**		was "not possible" during a protocol exchange.
**	EX_NOPERM -- You did not have sufficient permission to
**		perform the operation.  This is not intended for
**		file system problems, which should use NOINPUT or
**		CANTCREAT, but rather for higher level permissions.
**		For example, kre uses this to restrict who students
**		can send mail to.
**
**	Maintained by Eric Allman (eric@berkeley, ucbvax!eric) --
**		please mail changes to me.
**
**			@(#)sysexits.h	4.5		%G%
*/

# define EX_OK		0	/* successful termination */

# define EX__BASE	64	/* base value for error messages */

# define EX_USAGE	64	/* command line usage error */
# define EX_DATAERR	65	/* data format error */
# define EX_NOINPUT	66	/* cannot open input */
# define EX_NOUSER	67	/* addressee unknown */
# define EX_NOHOST	68	/* host name unknown */
# define EX_UNAVAILABLE	69	/* service unavailable */
# define EX_SOFTWARE	70	/* internal software error */
# define EX_OSERR	71	/* system error (e.g., can't fork) */
# define EX_OSFILE	72	/* critical OS file missing */
# define EX_CANTCREAT	73	/* can't create (user) output file */
# define EX_IOERR	74	/* input/output error */
# define EX_TEMPFAIL	75	/* temp failure; user is invited to retry */
# define EX_PROTOCOL	76	/* remote error in protocol */
# define EX_NOPERM	77	/* permission denied */
# define EX_CONFIG	78	/* configuration error */
Commit	Line	Data
48be8583 KB	1	/*
	2	* Copyright (c) 1987 Regents of the University of California.
	3	* All rights reserved.
	4	*
	5	* Redistribution and use in source and binary forms are permitted
47ae2e1a KB	6	* provided that the above copyright notice and this paragraph are
	7	* duplicated in all such forms and that any documentation,
	8	* advertising materials, and other materials related to such
	9	* distribution and use acknowledge that the software was developed
	10	* by the University of California, Berkeley. The name of the
	11	* University may not be used to endorse or promote products derived
	12	* from this software without specific prior written permission.
	13	* THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
	14	* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
	15	* WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
48be8583	16	*
47ae2e1a	17	* @(#)sysexits.h 4.5 (Berkeley) %G%
48be8583 KB	18	*/
48be8583 KB	19
63f37ee4 EA	20	/*
	21	** SYSEXITS.H -- Exit status codes for system programs.
	22	**
	23	** This include file attempts to categorize possible error
	24	** exit statuses for system programs, notably delivermail
	25	** and the Berkeley network.
	26	**
	27	** Error numbers begin at EX__BASE to reduce the possibility of
	28	** clashing with other exit statuses that random programs may
	29	** already return. The meaning of the codes is approximately
	30	** as follows:
	31	**
	32	** EX_USAGE -- The command was used incorrectly, e.g., with
	33	** the wrong number of arguments, a bad flag, a bad
	34	** syntax in a parameter, or whatever.
	35	** EX_DATAERR -- The input data was incorrect in some way.
	36	** This should only be used for user's data & not
	37	** system files.
	38	** EX_NOINPUT -- An input file (not a system file) did not
	39	** exist or was not readable. This could also include
	40	** errors like "No message" to a mailer (if it cared
	41	** to catch it).
	42	** EX_NOUSER -- The user specified did not exist. This might
	43	** be used for mail addresses or remote logins.
	44	** EX_NOHOST -- The host specified did not exist. This is used
	45	** in mail addresses or network requests.
	46	** EX_UNAVAILABLE -- A service is unavailable. This can occur
	47	** if a support program or file does not exist. This
	48	** can also be used as a catchall message when something
	49	** you wanted to do doesn't work, but you don't know
	50	** why.
	51	** EX_SOFTWARE -- An internal software error has been detected.
	52	** This should be limited to non-operating system related
	53	** errors as possible.
	54	** EX_OSERR -- An operating system error has been detected.
	55	** This is intended to be used for such things as "cannot
	56	** fork", "cannot create pipe", or the like. It includes
	57	** things like getuid returning a user that does not
	58	** exist in the passwd file.
	59	** EX_OSFILE -- Some system file (e.g., /etc/passwd, /etc/utmp,
	60	** etc.) does not exist, cannot be opened, or has some
	61	** sort of error (e.g., syntax error).
	62	** EX_CANTCREAT -- A (user specified) output file cannot be
	63	** created.
	64	** EX_IOERR -- An error occurred while doing I/O on some file.
8476145b EA	65	** EX_TEMPFAIL -- temporary failure, indicating something that
	66	** is not really an error. In sendmail, this means
	67	** that a mailer (e.g.) could not create a connection,
	68	** and the request should be reattempted later.
977ccbaf EA	69	** EX_PROTOCOL -- the remote system returned something that
977ccbaf EA	70	** was "not possible" during a protocol exchange.
10c03b41 EA	71	** EX_NOPERM -- You did not have sufficient permission to
	72	** perform the operation. This is not intended for
	73	** file system problems, which should use NOINPUT or
	74	** CANTCREAT, but rather for higher level permissions.
	75	** For example, kre uses this to restrict who students
	76	** can send mail to.
8476145b	77	**
977ccbaf	78	** Maintained by Eric Allman (eric@berkeley, ucbvax!eric) --
8476145b	79	** please mail changes to me.
1e27e2a9	80	**
47ae2e1a	81	** @(#)sysexits.h 4.5 %G%
63f37ee4 EA	82	*/
	83
	84	# define EX_OK 0 /* successful termination */
	85
	86	# define EX__BASE 64 /* base value for error messages */
	87
	88	# define EX_USAGE 64 /* command line usage error */
	89	# define EX_DATAERR 65 /* data format error */
	90	# define EX_NOINPUT 66 /* cannot open input */
	91	# define EX_NOUSER 67 /* addressee unknown */
	92	# define EX_NOHOST 68 /* host name unknown */
	93	# define EX_UNAVAILABLE 69 /* service unavailable */
	94	# define EX_SOFTWARE 70 /* internal software error */
	95	# define EX_OSERR 71 /* system error (e.g., can't fork) */
	96	# define EX_OSFILE 72 /* critical OS file missing */
	97	# define EX_CANTCREAT 73 /* can't create (user) output file */
	98	# define EX_IOERR 74 /* input/output error */
8476145b	99	# define EX_TEMPFAIL 75 /* temp failure; user is invited to retry */
977ccbaf	100	# define EX_PROTOCOL 76 /* remote error in protocol */
10c03b41	101	# define EX_NOPERM 77 /* permission denied */
6c60a8d5	102	# define EX_CONFIG 78 /* configuration error */