atcheckpoint(3C)					      atcheckpoint(3C)

NAME    [Toc]    [Back]

     atcheckpoint, atrestart - add checkpoint and restart (CPR)	event handlers

SYNOPSIS    [Toc]    [Back]

     #include <stdlib.h>

     int atcheckpoint(void (*func)(void));

     int atrestart(void	(*func)(void));

DESCRIPTION    [Toc]    [Back]

     These functions are used to register event	handlers for checkpoint	and
     restart, and activate CPR signal handling.	 The atcheckpoint() routine
     adds the function func() to the list of functions to be called without
     arguments upon receipt of checkpoint; see ckpt_create(3).	Similarly, the
     atrestart() routine registers the callback	function func()	for a restart
     event; see	ckpt_restart(3).  At checkpoint	or restart time, registered
     functions are called in the same order as their registration.

     These functions are recommended for use during initialization when
     applications expect to be checkpointed but	contain	checkpoint-unsafe
     objects; see cpr(1) for a list of unsafe objects.	An application may
     register multiple checkpoint and/or restart event handlers	to be called
     when checkpoint and/or restart occur, for example to disconnect socket
     connections at checkpoint time and	reconnect them at restart time.

DIAGNOSTICS    [Toc]    [Back]

     The atcheckpoint()	and atrestart()	routines return	0 if the registration
     succeeds, or -1 with errno	set if registration fails.  The	maximum	number
     of	handlers allowed for each process (or thread) is 32.

SEE ALSO    [Toc]    [Back]

     cpr(1), cview(1), ckpt_create(3), ckpt_remove(3), ckpt_restart(3),
     ckpt_stat(3)
     IRIX Checkpoint and Restart Operation Guide


									PPPPaaaaggggeeee 1111