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