Tcl_SetPanicProc man page on QNX

Man page or keyword search:  
man Server   4347 pages
apropos Keyword Search (all sections)
Output format
QNX logo
[printable version]

Tcl_Panic(3)		    Tcl Library Procedures		  Tcl_Panic(3)


       Tcl_Panic, Tcl_PanicVA, Tcl_SetPanicProc, panic, panicVA - report fatal
       error and abort

       #include <tcl.h>

       Tcl_Panic(format, arg, arg, ...)

       Tcl_PanicVA(format, argList)


       panic(format, arg, arg, ...)

       panicVA(format, argList)

       CONST char*     format	    (in)      A printf-style format string.

		       arg	    (in)      Arguments	 matching  the	format

       va_list	       argList	    (in)      An  argument  list  of arguments
					      matching	the   format   string.
					      Must have been initialized using
					      TCL_VARARGS_START,  and  cleared
					      using va_end.

       Tcl_PanicProc   *panicProc   (in)      Procedure	 to report fatal error
					      message and abort.


       When the Tcl library detects that its internal data structures  are  in
       an  inconsistent	 state, or that its C procedures have been called in a
       manner inconsistent with their documentation,  it  calls	 Tcl_Panic  to
       display a message describing the error and abort the process.  The for‐
       mat argument is a format string describing how to format the  remaining
       arguments  arg  into an error message, according to the same formatting
       rules used by the printf family	of  functions.	 The  same  formatting
       rules are also used by the builtin Tcl command format.

       In  a  freshly loaded Tcl library, Tcl_Panic prints the formatted error
       message to the standard error file of the process, and then calls abort
       to terminate the process.  Tcl_Panic does not return.

       Tcl_SetPanicProc	 may be used to modify the behavior of Tcl_Panic.  The
       panicProc argument should match the type Tcl_PanicProc:

	      typedef void Tcl_PanicProc(
		CONST char *format,
		arg, arg,...);

       After Tcl_SetPanicProc returns, any future calls to Tcl_Panic will call
       panicProc,  passing  along  the	format and arg arguments.  To maintain
       consistency with the callers of Tcl_Panic, panicProc must  not  return;
       it  must	 call abort.  panicProc should avoid making calls into the Tcl
       library, or into other libraries that may call the Tcl  library,	 since
       the  original  call  to Tcl_Panic indicates the Tcl library is not in a
       state of reliable operation.

       The typical use of Tcl_SetPanicProc arranges for the error  message  to
       be  displayed or reported in a manner more suitable for the application
       or the platform.	 As an example, the  Windows  implementation  of  wish
       calls Tcl_SetPanicProc to force all panic messages to be displayed in a
       system dialog box, rather than to be printed to the standard error file
       (usually not visible under Windows).

       Although the primary callers of Tcl_Panic are the procedures of the Tcl
       library, Tcl_Panic is a public function and may be called by any exten‐
       sion  or	 application that wishes to abort the process and have a panic
       message displayed the same way that panic messages  from	 Tcl  will  be

       Tcl_PanicVA  is	the  same as Tcl_Panic except that instead of taking a
       variable number of arguments it takes an argument list.	The procedures
       panic  and  panicVA  are synonyms (implemented as macros) for Tcl_Panic
       and Tcl_PanicVA, respectively.  They exist to  support  old  code;  new
       code should use direct calls to Tcl_Panic or Tcl_PanicVA.

       abort(3), printf(3), exec(n), format(n)

       abort, fatal, error

Tcl				      8.4			  Tcl_Panic(3)
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server QNX

List of man pages available for QNX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net