Mercurial > code

annotate C/port/err.h @ 422:f32aaed52c93

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Js: sort basic functions
author David Demelier <markand@malikania.fr>
date Thu, 08 Oct 2015 15:54:05 +0200
parents 0b576ee64d45
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
18
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 /*
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 * err.h -- formtted error messages (portable version)
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 *
98
b1a084c030c8 Happy new year
David Demelier <markand@malikania.fr>
parents: 88
diff changeset
4 * Copyright (c) 2011, 2012, David Demelier <markand@malikania.fr>
18
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 *
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 * Permission to use, copy, modify, and/or distribute this software for any
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 * purpose with or without fee is hereby granted, provided that the above
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 * copyright notice and this permission notice appear in all copies.
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 *
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 */
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
18
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 #ifndef _ERR_H_
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 #define _ERR_H_
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
21
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 #include <stdarg.h>
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
23
66
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
24 #ifdef __cplusplus
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
25 extern "C" {
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
26 #endif
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
27
18
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 /*
32
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
29 * Attribute noreturn may helps. This may produce a warning with GCC 4.5:
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
30 *
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
31 * int a;
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
32 *
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
33 * if ((a = getstate() < 0)
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
34 * errx(1, "State failed");
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
35 *
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
36 * Because compilator does not know that errx will call exit may produce
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
37 * a warning like `a may be used uninitialized'.
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
38 */
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
39
88
6a9ff80949f5 Noreturn exists on microsoft too
David Demelier <markand@malikania.fr>
parents: 66
diff changeset
40 #if defined(__GNUC__)
66
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
41 # define __at_noreturn __attribute__ ((noreturn))
88
6a9ff80949f5 Noreturn exists on microsoft too
David Demelier <markand@malikania.fr>
parents: 66
diff changeset
42 #elif defined(_MSC_VER)
6a9ff80949f5 Noreturn exists on microsoft too
David Demelier <markand@malikania.fr>
parents: 66
diff changeset
43 # define __at_noreturn __declspec(noreturn)
32
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
44 #endif
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
45
ed6ae3b865c9 Use __attribute__ ((noreturn)) on err(x) functions
David Demelier <markand@malikania.fr>
parents: 18
diff changeset
46 /*
18
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 * err() functions append the format message to the stderr FILE pointer. They
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 * also append the system error using strerror(errno). Then the functions exit
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
49 * with the error code given as first argument.
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 */
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
51
66
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
52 void err(int, const char *, ...) __at_noreturn;
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
53 void verr(int, const char *, va_list) __at_noreturn;
18
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
54
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 /*
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 * errx() functions are similar to err() except that they do not append the
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 * system error message.
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 */
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
59
66
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
60 void errx(int, const char *, ...) __at_noreturn;
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
61 void verrx(int, const char *, va_list) __at_noreturn;
18
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
62
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
63 /*
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 * warn() functions are similar to err() but they do not call exit().
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
65 */
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
66
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 void warn(const char *, ...);
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
68 void vwarn(const char *, va_list);
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
69
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 /*
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
71 * warnx() functions are similar to warn() except that they do not append the
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
72 * system error message.
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
73 */
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
74
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
75 void warnx(const char *, ...);
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 void vwarnx(const char *, va_list);
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
77
66
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
78 #ifdef __cplusplus
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
79 }
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
80 #endif
f773c76b1f3c Added extern C tests
David Demelier <markand@malikania.fr>
parents: 32
diff changeset
81
18
a3841b9c66a1 Import portable version of NetBSD functions err(3)
David Demelier <markand@malikania.fr>
parents:
diff changeset
82 #endif /* _ERR_H_ */