Procedure

   void trcoff_c ( void ) 

Abstract

 
   Disable tracing. 
 

Required_Reading

 
   ERROR 
 

Keywords

 
   ERROR 
 

Brief_I/O

 
   VARIABLE  I/O  DESCRIPTION 
   --------  ---  -------------------------------------------------- 
 
   None. 
 

Detailed_Input

 
   None. 
 

Detailed_Output

 
   None. 
 

Parameters

 
   None. 
 

Exceptions

 
   Error free. 
 

Files

 
   None. 
 

Particulars

 
   This routine disables tracing.  Checking in or out does not modify 
   the current traceback any further after trcoff_c is called. The 
   routines trcnam_, trcdep_, and qcktrc_ will return information 
   based on the traceback at the point where trcoff_c is called. 
 
   Once tracing has been disabled, it cannot be re-enabled. 
 
   Additionally, trcoff_c blanks out the existing trace, since the 
   trace will usually be invalid at the time an error is signalled. 
   The frozen copy of the trace, if there is one, is not modified. 
 

Examples

 
   1)    /.
               Program initialization: 
           
                    . 
                    . 
                    . 
           
               We disable tracing to enhance speed: 
         ./  
               trcoff_c ();
         /.
               More initialization code: 
         ./
                    . 
                    . 
                    . 
 

Restrictions

 
   None. 
 

Literature_References

 
   None. 
 

Author_and_Institution

 
   N.J. Bachman    (JPL) 
   K.R. Gehringer  (JPL) 
 

Version

   -CSPICE Version 1.0.0, 08-FEB-1998 (EDW)

Index_Entries

 
   turn tracing off 
 

Link to routine trcoff_c source file trcoff_c.c