Design and Implementation of a Documentation Tool for ... - MADOC

There is also a convenience function that writes a meta chunks header and
footer as well as the actual data:
23a 〈chunkwm 23a〉≡ (15c)
int chunkwm(unsigned char id, unsigned char *data, int count) {
int ret;
if (!chunkwh(id))
return -11;
if ((ret = chunkwd(data, count)) < 0)
return ret;
if (!chunkwf())
return -12;
return 1;
}
Defines:
chunkwm, used in chunks 17, 18, and 20b.
Uses chunkwd 21, chunkwf 22d, and chunkwh 22d.
A.6 Error Handling
If the program has to terminate abnormally, the function die() will be called.
After resetting the terminal attributes and telling a possible child process to
exit, it will output an error message and exit the software.
23b 〈die 23b〉≡ (15c)
void die(char *message, int chunk) {
if (TTSET)
tcsetattr(STDERR_FILENO, TCSADRAIN, &TT);
if (CHILD > 0)
kill(CHILD, SIGTERM);
fprintf(stderr, "%s: ", MYNAME);
if (chunk != 0) {
fprintf(stderr, "metadata chunk %02x failed", chunk);
if (message != NULL)
fprintf(stderr, ": ");
} else {
if (message == NULL)
fprintf(stderr, "unknown error");
}
if (message != NULL)
fprintf(stderr, "%s", message);
fprintf(stderr, "; exiting.\n");
exit(EXIT_FAILURE);
}
Defines:
die, used in chunks 8c, 24b, 27–34, 36b, and 38d.
Uses CHILD 8d, MYNAME 24a, and TTSET 28d.
exit() requires stdlib.h:
23c 〈includes 8b〉+≡ (15b) ⊳ 22c 25c ⊲
#include
23