1 /* tkvrsn.f -- translated by f2c (version 19980913).
2 You must link the resulting object file with the libraries:
3 -lf2c -lm (in that order)
4 */
5
6 #include "f2c.h"
7
8 /* $Procedure TKVRSN ( Toolkit version strings ) */
tkvrsn_(char * item,char * verstr,ftnlen item_len,ftnlen verstr_len)9 /* Subroutine */ int tkvrsn_(char *item, char *verstr, ftnlen item_len,
10 ftnlen verstr_len)
11 {
12 /* Builtin functions */
13 /* Subroutine */ int s_copy(char *, char *, ftnlen, ftnlen);
14
15 /* Local variables */
16 extern logical eqstr_(char *, char *, ftnlen, ftnlen);
17
18 /* $ Abstract */
19
20 /* Given an item such as the toolkit or an entry point name, return */
21 /* the latest version string. */
22
23 /* $ Disclaimer */
24
25 /* THIS SOFTWARE AND ANY RELATED MATERIALS WERE CREATED BY THE */
26 /* CALIFORNIA INSTITUTE OF TECHNOLOGY (CALTECH) UNDER A U.S. */
27 /* GOVERNMENT CONTRACT WITH THE NATIONAL AERONAUTICS AND SPACE */
28 /* ADMINISTRATION (NASA). THE SOFTWARE IS TECHNOLOGY AND SOFTWARE */
29 /* PUBLICLY AVAILABLE UNDER U.S. EXPORT LAWS AND IS PROVIDED "AS-IS" */
30 /* TO THE RECIPIENT WITHOUT WARRANTY OF ANY KIND, INCLUDING ANY */
31 /* WARRANTIES OF PERFORMANCE OR MERCHANTABILITY OR FITNESS FOR A */
32 /* PARTICULAR USE OR PURPOSE (AS SET FORTH IN UNITED STATES UCC */
33 /* SECTIONS 2312-2313) OR FOR ANY PURPOSE WHATSOEVER, FOR THE */
34 /* SOFTWARE AND RELATED MATERIALS, HOWEVER USED. */
35
36 /* IN NO EVENT SHALL CALTECH, ITS JET PROPULSION LABORATORY, OR NASA */
37 /* BE LIABLE FOR ANY DAMAGES AND/OR COSTS, INCLUDING, BUT NOT */
38 /* LIMITED TO, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND, */
39 /* INCLUDING ECONOMIC DAMAGE OR INJURY TO PROPERTY AND LOST PROFITS, */
40 /* REGARDLESS OF WHETHER CALTECH, JPL, OR NASA BE ADVISED, HAVE */
41 /* REASON TO KNOW, OR, IN FACT, SHALL KNOW OF THE POSSIBILITY. */
42
43 /* RECIPIENT BEARS ALL RISK RELATING TO QUALITY AND PERFORMANCE OF */
44 /* THE SOFTWARE AND ANY RELATED MATERIALS, AND AGREES TO INDEMNIFY */
45 /* CALTECH AND NASA FOR ALL THIRD-PARTY CLAIMS RESULTING FROM THE */
46 /* ACTIONS OF RECIPIENT IN THE USE OF THE SOFTWARE. */
47
48 /* $ Required_Reading */
49
50 /* None. */
51
52 /* $ Keywords */
53
54 /* UTILITY */
55
56 /* $ Declarations */
57 /* $ Brief_I/O */
58
59 /* Variable I/O Description */
60 /* -------- --- -------------------------------------------------- */
61 /* ITEM I Item for which a version string is desired. */
62 /* VERSTR O Version string. */
63
64 /* $ Detailed_Input */
65
66 /* ITEM is the item for which a version string is to be */
67 /* returned. ITEM may be 'TOOLKIT', entry point names, */
68 /* or program names. ITEM is case insensitive. */
69
70 /* Currently, the only ITEM supported is 'TOOLKIT' */
71 /* and it will return the toolkit version number. */
72
73 /* Any other ITEM will return 'No version found.' */
74
75 /* $ Detailed_Output */
76
77 /* VERSTR is the latest version string for the specified ITEM. */
78
79 /* If ITEM is not one of the items haveing a version, */
80 /* the value 'No version found.' will be returned. */
81
82 /* $ Parameters */
83
84 /* None. */
85
86 /* $ Exceptions */
87
88 /* Error Free. */
89
90 /* 1) If the ITEM whose version string is requested is not */
91 /* recognized, the string 'No version found.' is returned. */
92
93 /* $ Files */
94
95 /* None. */
96
97 /* $ Particulars */
98
99 /* None. */
100
101 /* $ Examples */
102
103 /* Suppose you want to find out the recent Toolkit configuration */
104 /* version number. Using the code fragment below: */
105
106 /* CHARACTER*(80) VERSN */
107
108 /* CALL TKVRSN ( 'TOOLKIT', VERSN ) */
109
110 /* The variable VERSN would contain a string similar to the one */
111 /* shown below: */
112
113 /* 'N0035' */
114
115 /* $ Restrictions */
116
117 /* None. */
118
119 /* $ Literature_References */
120
121 /* None. */
122
123 /* $ Author_and_Institution */
124
125 /* K.R. Gehringer (JPL) */
126 /* H.A. Neilan (JPL) */
127
128 /* $ Version */
129
130 /* - SPICELIB Version 3.14.0, 05-APR-2017 (WLT) */
131
132 /* Version update, N0066 */
133
134 /* - SPICELIB Version 3.13.0, 15-JUL-2014 (WLT) */
135
136 /* Version update, N0065 */
137
138 /* - SPICELIB Version 3.12.0, 09-JUN-2010 (WLT) */
139
140 /* Version update, N0064 */
141
142 /* - SPICELIB Version 3.11.0, 15-APR-2009 (WLT) */
143
144 /* Version update, N0063 */
145
146 /* - SPICELIB Version 3.10.0, 04-MAR-2008 (WLT) */
147
148 /* Version update, N0062 */
149
150 /* - SPICELIB Version 3.9.0, 27-NOV-2006 (WLT) */
151
152 /* Version update, N0061 */
153
154 /* - SPICELIB Version 3.8.0, 16-DEC-2005 (WLT) */
155
156 /* Version update, N0060 */
157
158 /* - SPICELIB Version 3.7.0, 17-NOV-2005 (WLT) */
159
160 /* Version update, N0059 */
161
162 /* - SPICELIB Version 3.6.0, 11-JAN-2005 (WLT) */
163
164 /* Version update, N0058 */
165
166 /* - SPICELIB Version 3.5.0, 02-MAR-2004 (WLT) */
167
168 /* Version update, N0057 */
169
170 /* - SPICELIB Version 3.4.0, 30-JUL-2003 (WLT) */
171
172 /* Version update, N0056 */
173
174 /* - SPICELIB Version 3.3.0, 26-FEB-2003 (WLT) */
175
176 /* Version update, N0055 */
177
178 /* - SPICELIB Version 3.2.0, 13-DEC-2002 (WLT) */
179
180 /* Version update, N0054 */
181
182 /* - SPICELIB Version 3.1.0, 05-SEP-2002 (WLT) */
183
184 /* Version update, N0053 */
185
186 /* - SPICELIB Version 3.0.0, 06-FEB-2002 (FST) */
187
188 /* Version update, N0052a */
189
190 /* - SPICELIB Version 2.9.0, 17-JAN-2002 (WLT) */
191
192 /* Version update, N0052 */
193
194 /* - SPICELIB Version 2.8.0, 07-APR-2000 (WLT) */
195
196 /* Version update, N0051 */
197
198 /* - SPICELIB Version 2.7.0, 06-OCT-1999 (WLT) */
199
200 /* Version update, N0050 */
201
202 /* - SPICELIB Version 2.6.0, 04-SEP-1998 (WLT) */
203
204 /* Version update, N0049 */
205
206 /* - SPICELIB Version 2.5.0, 01-MAY-1998 (WLT) */
207
208 /* Version update, N0048 */
209
210 /* - SPICELIB Version 2.4.0, 31-JUL-1997 (WLT) */
211
212 /* Version update, N0047 */
213
214 /* - SPICELIB Version 2.3.0, 27-JAN-1997 (WLT) */
215
216 /* Version update, N0046 */
217
218 /* - SPICELIB Version 2.2.0, 15-OCT-1996 (WLT) */
219
220 /* Version update, N0045 */
221
222 /* - SPICELIB Version 2.1.0, 26-AUG-1996 (WLT) */
223
224 /* Version update, N0044 */
225
226 /* - SPICELIB Version 2.0.0, 09-MAY-1996 (KRG) */
227
228 /* Removed the check of the spicelib function RETURN. This */
229 /* routine is called by the error handling after an error */
230 /* has been signalled to get the toolkit version, so it */
231 /* cannot return on entry after an error. */
232
233 /* The calls to CHKIN and CHKOUT have also been removed to */
234 /* completly isolate this subroutine from the error handling. */
235
236 /* Version update, N0043. */
237
238 /* - SPICELIB Version 1.7.0, 2-JAN-1995 (WLT) */
239
240 /* Version update, N0042. */
241
242 /* - SPICELIB Version 1.6.0, 28-SEP-1995 (HAN) */
243
244 /* Version update, N0041. */
245
246 /* - SPICELIB Version 1.5.0, 19-AUG-1995 (HAN) */
247
248 /* Version update, N0040. */
249
250 /* - SPICELIB Version 1.4.0, 5-JUN-1995 (HAN) */
251
252 /* Version update, N0039. */
253
254 /* - SPICELIB Version 1.3.0, 28-MAR-1995 (HAN) */
255
256 /* Version update, N0038. */
257
258 /* - SPICELIB Version 1.2.0, 23-DEC-1994 (HAN) */
259
260 /* Version update, N0037. */
261
262 /* - SPICELIB Version 1.1.0, 31-OCT-1994 (HAN) */
263
264 /* Version update, N0036. */
265
266 /* - SPICELIB Version 1.0.0, 23-AUG-1994 (HAN) */
267
268 /* -& */
269 /* $ Index_Entries */
270
271 /* Return version strings */
272 /* -& */
273
274 /* SPICELIB functions */
275
276
277 /* At the current time only the TOOLKIT version number is */
278 /* defined. */
279
280 if (eqstr_(item, "TOOLKIT", item_len, (ftnlen)7)) {
281 s_copy(verstr, "N0066", verstr_len, (ftnlen)5);
282 } else {
283 s_copy(verstr, "No version found.", verstr_len, (ftnlen)17);
284 }
285 return 0;
286 } /* tkvrsn_ */
287
288