FreeBSD Manual Pages
ABORT2(2) System Calls Manual ABORT2(2) NAME abort2 -- abort process with diagnostics LIBRARY Standard C Library (libc, -lc) SYNOPSIS #include <stdlib.h> void abort2(const char *why, int nargs, void **args); DESCRIPTION The abort2() system call causes the process to be killed and the specified diagnostic message (with arguments) to be delivered by the kernel to the syslogd(8) daemon. The why argument points to a NUL-terminated string specifying a reason of the program's termination (maximum 128 characters long). The args array contains pointers which will be logged numerically (with the kernel's `%p' printf(9) format). The nargs argument specifies the number of pointers in args (maximum 16). The abort2() system call is intended for use in situations where continua- tion of a process is impossible or for other definitive reasons is un- wanted, and normal diagnostic channels cannot be trusted to deliver the message. RETURN VALUES The abort2() function never returns. The process is killed with SIGABRT unless the arguments to abort2() are in- valid, in which case SIGKILL is used. EXAMPLES #include <stdlib.h> if (weight_kg > max_load) { void *ptrs[3]; ptrs[0] = (void *)(intptr_t)weight_kg; ptrs[1] = (void *)(intptr_t)max_load; ptrs[2] = haystack; abort2("Camel overloaded", 3, ptrs); } SEE ALSO abort(3), exit(3) HISTORY The abort2() system call first appeared in FreeBSD 7.0. AUTHORS The abort2() system call was designed by Poul-Henning Kamp <phk@FreeBSD.org>. It was implemented by Wojciech A. Koszek <dun- stan@freebsd.czest.pl>. FreeBSD ports 15.quarterly September 30, 2006 ABORT2(2)
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | EXAMPLES | SEE ALSO | HISTORY | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=abort2&sektion=2&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>