Mercurial > molko
annotate libmlk-core/mlk/core/panic.c @ 564:e91f37da2992
core: doxygenize window
author | David Demelier <markand@malikania.fr> |
---|---|
date | Wed, 08 Mar 2023 20:09:21 +0100 |
parents | c7664b679a95 |
children | 4349b591c3ac |
rev | line source |
---|---|
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
1 /* |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
2 * panic.c -- unrecoverable error handling |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
3 * |
445
773a082f0b91
misc: update copyright years
David Demelier <markand@malikania.fr>
parents:
431
diff
changeset
|
4 * Copyright (c) 2020-2023 David Demelier <markand@malikania.fr> |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
5 * |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
6 * Permission to use, copy, modify, and/or distribute this software for any |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
7 * purpose with or without fee is hereby granted, provided that the above |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
8 * copyright notice and this permission notice appear in all copies. |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
9 * |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
17 */ |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
18 |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
19 #include <assert.h> |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
20 #include <stdio.h> |
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
21 #include <stdlib.h> |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
22 |
486 | 23 #include "err.h" |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
24 #include "panic.h" |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
25 |
229
e71039d820a7
doc: improve documentation
David Demelier <markand@malikania.fr>
parents:
168
diff
changeset
|
26 static void |
486 | 27 terminate(const char *what) |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
28 { |
486 | 29 fprintf(stderr, "abort: %s\n", what); |
162 | 30 abort(); |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
31 exit(1); |
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
32 } |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
33 |
486 | 34 void (*mlk_panic_handler)(const char *) = terminate; |
35 | |
36 static void | |
37 alive(void) | |
38 { | |
39 /* | |
40 * This should not happen, if it does it means the user did not fully | |
41 * satisfied the constraint of mlk_panic_handler. | |
42 */ | |
43 fprintf(stderr, "abort: panic handler returned\n"); | |
44 exit(1); | |
45 } | |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
46 |
229
e71039d820a7
doc: improve documentation
David Demelier <markand@malikania.fr>
parents:
168
diff
changeset
|
47 void |
465
01f5580e43d1
core: panic -> mlk_panic
David Demelier <markand@malikania.fr>
parents:
445
diff
changeset
|
48 mlk_panicf(const char *fmt, ...) |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
49 { |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
50 assert(fmt); |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
51 |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
52 va_list ap; |
486 | 53 char buf[PANIC_LINE_MAX]; |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
54 |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
55 /* |
486 | 56 * We can't use mlk_panicva directly because we won't be able to call |
57 * va_end then. | |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
58 */ |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
59 va_start(ap, fmt); |
486 | 60 vsnprintf(buf, sizeof (buf), fmt, ap); |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
61 va_end(ap); |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
62 |
486 | 63 mlk_panic_handler(buf); |
64 alive(); | |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
65 } |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
66 |
229
e71039d820a7
doc: improve documentation
David Demelier <markand@malikania.fr>
parents:
168
diff
changeset
|
67 void |
465
01f5580e43d1
core: panic -> mlk_panic
David Demelier <markand@malikania.fr>
parents:
445
diff
changeset
|
68 mlk_panicva(const char *fmt, va_list ap) |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
69 { |
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
70 assert(fmt); |
475
1a1265445157
core: forgot panic_handler
David Demelier <markand@malikania.fr>
parents:
465
diff
changeset
|
71 assert(mlk_panic_handler); |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
72 |
486 | 73 char buf[PANIC_LINE_MAX]; |
74 | |
75 vsnprintf(buf, sizeof (buf), fmt, ap); | |
76 mlk_panic_handler(buf); | |
77 alive(); | |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
78 } |
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
79 |
229
e71039d820a7
doc: improve documentation
David Demelier <markand@malikania.fr>
parents:
168
diff
changeset
|
80 void |
547
c7664b679a95
misc: remove error codes for now
David Demelier <markand@malikania.fr>
parents:
486
diff
changeset
|
81 mlk_panic(void) |
95
e82eca4f8606
core: simplify error/panic routines
David Demelier <markand@malikania.fr>
parents:
88
diff
changeset
|
82 { |
547
c7664b679a95
misc: remove error codes for now
David Demelier <markand@malikania.fr>
parents:
486
diff
changeset
|
83 mlk_panicf("%s", mlk_err()); |
88
44de3c528b63
core: implement basic panic mechanism, continue #2484 @1h
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
84 } |