summaryrefslogtreecommitdiffstats
path: root/man/man3const/EXIT_SUCCESS.3const
blob: 02b89be2fa327ceaa58f930f6f1b8fb5ded1ea36 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
.\" Copyright (c) 2022 by Thomas Voss <mail@thomasvoss.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"
.TH EXIT_SUCCESS 3const (date) "Linux man-pages (unreleased)"
.SH NAME
EXIT_SUCCESS, EXIT_FAILURE \- termination status constants
.SH LIBRARY
Standard C library
.RI ( libc )
.SH SYNOPSIS
.nf
.B #include <stdlib.h>
.P
.BR "#define EXIT_SUCCESS  "  0
.BR "#define EXIT_FAILURE  "  "/* nonzero */"
.fi
.SH DESCRIPTION
.B EXIT_SUCCESS
and
.B EXIT_FAILURE
represent a successful and unsuccessful exit status respectively,
and can be used as arguments to the
.BR exit (3)
function.
.SH STANDARDS
C11, POSIX.1-2008.
.SH HISTORY
C89, POSIX.1-2001.
.SH EXAMPLES
.\" SRC BEGIN (EXIT_SUCCESS.c)
.EX
#include <stdio.h>
#include <stdlib.h>
\&
int
main(int argc, char *argv[])
{
    FILE *fp;
\&
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <file>\en", argv[0]);
        exit(EXIT_FAILURE);
    }
\&
    fp = fopen(argv[1], "r");
    if (fp == NULL) {
        perror(argv[1]);
        exit(EXIT_FAILURE);
    }
\&
    /* Other code omitted */
\&
    fclose(fp);
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH SEE ALSO
.BR exit (3),
.BR sysexits.h (3head)