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
firestring_set_error_handler(3) FreeBSD Library Functions Manual firestring_set_error_handler(3)

firestring_set_error_handler - set the function to be called on an allocation failure

#include <firestring.h>
-lfirestring

void firestring_set_error_handler(void (*e)())

firestring_set_error_handler() takes the name of a function that takes no parameters and returns void. This function will be called whenever firestring fails to allocate memory.

As memory allocation failures are fatal to most programs, firestring does not return errors when functions fail to allocate memory; it simply calls this function, which it expects to call exit() or abort() or in some way terminate execution of the program. It probably is not safe to pass a function that returns, unless you have a framework in place for passing the allocation failure information back to the code calling the firestring function.

The default function calls perror() and then exit().

None

Ian Gulliver <ian@penguinhosting.net>

libfirestring(3)
2003-07-21

Search for    or go to Top of page |  Section 3 |  Main Index

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