GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ABORT2 (2)

NAME

abort2 - abort process with diagnostics

CONTENTS

Library
Synopsis
Description
Return Values
Examples
See Also
History
Authors

LIBRARY


.Lb libc

SYNOPSIS


.In 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 continuation of a process is impossible or for other definitive reasons is unwanted, 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 invalid, 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
.Fx 7.0 .

AUTHORS


.An -nosplit The abort2 system call was designed by
.An Poul-Henning Kamp Aq phk@FreeBSD.org . It was implemented by
.An Wojciech A. Koszek Aq dunstan@freebsd.czest.pl .
Search for    or go to Top of page |  Section 2 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.