1 /* 2 3 -Procedure trcoff_c ( Turn tracing off ) 4 5 -Abstract 6 7 Disable tracing. 8 9 -Disclaimer 10 11 THIS SOFTWARE AND ANY RELATED MATERIALS WERE CREATED BY THE 12 CALIFORNIA INSTITUTE OF TECHNOLOGY (CALTECH) UNDER A U.S. 13 GOVERNMENT CONTRACT WITH THE NATIONAL AERONAUTICS AND SPACE 14 ADMINISTRATION (NASA). THE SOFTWARE IS TECHNOLOGY AND SOFTWARE 15 PUBLICLY AVAILABLE UNDER U.S. EXPORT LAWS AND IS PROVIDED "AS-IS" 16 TO THE RECIPIENT WITHOUT WARRANTY OF ANY KIND, INCLUDING ANY 17 WARRANTIES OF PERFORMANCE OR MERCHANTABILITY OR FITNESS FOR A 18 PARTICULAR USE OR PURPOSE (AS SET FORTH IN UNITED STATES UCC 19 SECTIONS 2312-2313) OR FOR ANY PURPOSE WHATSOEVER, FOR THE 20 SOFTWARE AND RELATED MATERIALS, HOWEVER USED. 21 22 IN NO EVENT SHALL CALTECH, ITS JET PROPULSION LABORATORY, OR NASA 23 BE LIABLE FOR ANY DAMAGES AND/OR COSTS, INCLUDING, BUT NOT 24 LIMITED TO, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND, 25 INCLUDING ECONOMIC DAMAGE OR INJURY TO PROPERTY AND LOST PROFITS, 26 REGARDLESS OF WHETHER CALTECH, JPL, OR NASA BE ADVISED, HAVE 27 REASON TO KNOW, OR, IN FACT, SHALL KNOW OF THE POSSIBILITY. 28 29 RECIPIENT BEARS ALL RISK RELATING TO QUALITY AND PERFORMANCE OF 30 THE SOFTWARE AND ANY RELATED MATERIALS, AND AGREES TO INDEMNIFY 31 CALTECH AND NASA FOR ALL THIRD-PARTY CLAIMS RESULTING FROM THE 32 ACTIONS OF RECIPIENT IN THE USE OF THE SOFTWARE. 33 34 -Required_Reading 35 36 ERROR 37 38 -Keywords 39 40 ERROR 41 42 */ 43 44 #include "SpiceUsr.h" 45 #include "SpiceZfc.h" 46 #include "SpiceZst.h" 47 48 trcoff_c(void)49 void trcoff_c ( void ) 50 51 /* 52 53 -Brief_I/O 54 55 VARIABLE I/O DESCRIPTION 56 -------- --- -------------------------------------------------- 57 58 None. 59 60 -Detailed_Input 61 62 None. 63 64 -Detailed_Output 65 66 None. 67 68 -Parameters 69 70 None. 71 72 -Files 73 74 None. 75 76 -Exceptions 77 78 Error free. 79 80 -Particulars 81 82 This routine disables tracing. Checking in or out does not modify 83 the current traceback any further after trcoff_c is called. The 84 routines trcnam_, trcdep_, and qcktrc_ will return information 85 based on the traceback at the point where trcoff_c is called. 86 87 Once tracing has been disabled, it cannot be re-enabled. 88 89 Additionally, trcoff_c blanks out the existing trace, since the 90 trace will usually be invalid at the time an error is signalled. 91 The frozen copy of the trace, if there is one, is not modified. 92 93 -Examples 94 95 1) /. 96 Program initialization: 97 98 . 99 . 100 . 101 102 We disable tracing to enhance speed: 103 ./ 104 trcoff_c (); 105 /. 106 More initialization code: 107 ./ 108 . 109 . 110 . 111 112 -Restrictions 113 114 None. 115 116 -Literature_References 117 118 None. 119 120 -Author_and_Institution 121 122 N.J. Bachman (JPL) 123 K.R. Gehringer (JPL) 124 125 -Version 126 127 -CSPICE Version 1.0.0, 08-FEB-1998 (EDW) 128 129 -Index_Entries 130 131 turn tracing off 132 133 -& 134 */ 135 136 { /* Begin trcoff_c */ 137 138 /* 139 Call the f2c'd routine 140 */ 141 trcoff_(); 142 143 144 145 } /* End trcoff_c */ 146