xref: /aosp_15_r20/external/curl/src/tool_main.c (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker /***************************************************************************
2*6236dae4SAndroid Build Coastguard Worker  *                                  _   _ ____  _
3*6236dae4SAndroid Build Coastguard Worker  *  Project                     ___| | | |  _ \| |
4*6236dae4SAndroid Build Coastguard Worker  *                             / __| | | | |_) | |
5*6236dae4SAndroid Build Coastguard Worker  *                            | (__| |_| |  _ <| |___
6*6236dae4SAndroid Build Coastguard Worker  *                             \___|\___/|_| \_\_____|
7*6236dae4SAndroid Build Coastguard Worker  *
8*6236dae4SAndroid Build Coastguard Worker  * Copyright (C) Daniel Stenberg, <[email protected]>, et al.
9*6236dae4SAndroid Build Coastguard Worker  *
10*6236dae4SAndroid Build Coastguard Worker  * This software is licensed as described in the file COPYING, which
11*6236dae4SAndroid Build Coastguard Worker  * you should have received as part of this distribution. The terms
12*6236dae4SAndroid Build Coastguard Worker  * are also available at https://curl.se/docs/copyright.html.
13*6236dae4SAndroid Build Coastguard Worker  *
14*6236dae4SAndroid Build Coastguard Worker  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15*6236dae4SAndroid Build Coastguard Worker  * copies of the Software, and permit persons to whom the Software is
16*6236dae4SAndroid Build Coastguard Worker  * furnished to do so, under the terms of the COPYING file.
17*6236dae4SAndroid Build Coastguard Worker  *
18*6236dae4SAndroid Build Coastguard Worker  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19*6236dae4SAndroid Build Coastguard Worker  * KIND, either express or implied.
20*6236dae4SAndroid Build Coastguard Worker  *
21*6236dae4SAndroid Build Coastguard Worker  * SPDX-License-Identifier: curl
22*6236dae4SAndroid Build Coastguard Worker  *
23*6236dae4SAndroid Build Coastguard Worker  ***************************************************************************/
24*6236dae4SAndroid Build Coastguard Worker #include "tool_setup.h"
25*6236dae4SAndroid Build Coastguard Worker 
26*6236dae4SAndroid Build Coastguard Worker #include <sys/stat.h>
27*6236dae4SAndroid Build Coastguard Worker 
28*6236dae4SAndroid Build Coastguard Worker #ifdef _WIN32
29*6236dae4SAndroid Build Coastguard Worker #include <tchar.h>
30*6236dae4SAndroid Build Coastguard Worker #endif
31*6236dae4SAndroid Build Coastguard Worker 
32*6236dae4SAndroid Build Coastguard Worker #include <signal.h>
33*6236dae4SAndroid Build Coastguard Worker 
34*6236dae4SAndroid Build Coastguard Worker #ifdef HAVE_FCNTL_H
35*6236dae4SAndroid Build Coastguard Worker #include <fcntl.h>
36*6236dae4SAndroid Build Coastguard Worker #endif
37*6236dae4SAndroid Build Coastguard Worker 
38*6236dae4SAndroid Build Coastguard Worker #include "curlx.h"
39*6236dae4SAndroid Build Coastguard Worker 
40*6236dae4SAndroid Build Coastguard Worker #include "tool_cfgable.h"
41*6236dae4SAndroid Build Coastguard Worker #include "tool_doswin.h"
42*6236dae4SAndroid Build Coastguard Worker #include "tool_msgs.h"
43*6236dae4SAndroid Build Coastguard Worker #include "tool_operate.h"
44*6236dae4SAndroid Build Coastguard Worker #include "tool_vms.h"
45*6236dae4SAndroid Build Coastguard Worker #include "tool_main.h"
46*6236dae4SAndroid Build Coastguard Worker #include "tool_libinfo.h"
47*6236dae4SAndroid Build Coastguard Worker #include "tool_stderr.h"
48*6236dae4SAndroid Build Coastguard Worker 
49*6236dae4SAndroid Build Coastguard Worker /*
50*6236dae4SAndroid Build Coastguard Worker  * This is low-level hard-hacking memory leak tracking and similar. Using
51*6236dae4SAndroid Build Coastguard Worker  * the library level code from this client-side is ugly, but we do this
52*6236dae4SAndroid Build Coastguard Worker  * anyway for convenience.
53*6236dae4SAndroid Build Coastguard Worker  */
54*6236dae4SAndroid Build Coastguard Worker #include "memdebug.h" /* keep this as LAST include */
55*6236dae4SAndroid Build Coastguard Worker 
56*6236dae4SAndroid Build Coastguard Worker #ifdef __VMS
57*6236dae4SAndroid Build Coastguard Worker /*
58*6236dae4SAndroid Build Coastguard Worker  * vms_show is a global variable, used in main() as parameter for
59*6236dae4SAndroid Build Coastguard Worker  * function vms_special_exit() to allow proper curl tool exiting.
60*6236dae4SAndroid Build Coastguard Worker  * Its value may be set in other tool_*.c source files thanks to
61*6236dae4SAndroid Build Coastguard Worker  * forward declaration present in tool_vms.h
62*6236dae4SAndroid Build Coastguard Worker  */
63*6236dae4SAndroid Build Coastguard Worker int vms_show = 0;
64*6236dae4SAndroid Build Coastguard Worker #endif
65*6236dae4SAndroid Build Coastguard Worker 
66*6236dae4SAndroid Build Coastguard Worker #ifdef __MINGW32__
67*6236dae4SAndroid Build Coastguard Worker /*
68*6236dae4SAndroid Build Coastguard Worker  * There seems to be no way to escape "*" in command-line arguments with MinGW
69*6236dae4SAndroid Build Coastguard Worker  * when command-line argument globbing is enabled under the MSYS shell, so turn
70*6236dae4SAndroid Build Coastguard Worker  * it off.
71*6236dae4SAndroid Build Coastguard Worker  */
72*6236dae4SAndroid Build Coastguard Worker extern int _CRT_glob;
73*6236dae4SAndroid Build Coastguard Worker int _CRT_glob = 0;
74*6236dae4SAndroid Build Coastguard Worker #endif /* __MINGW32__ */
75*6236dae4SAndroid Build Coastguard Worker 
76*6236dae4SAndroid Build Coastguard Worker /* if we build a static library for unit tests, there is no main() function */
77*6236dae4SAndroid Build Coastguard Worker #ifndef UNITTESTS
78*6236dae4SAndroid Build Coastguard Worker 
79*6236dae4SAndroid Build Coastguard Worker #if defined(HAVE_PIPE) && defined(HAVE_FCNTL)
80*6236dae4SAndroid Build Coastguard Worker /*
81*6236dae4SAndroid Build Coastguard Worker  * Ensure that file descriptors 0, 1 and 2 (stdin, stdout, stderr) are
82*6236dae4SAndroid Build Coastguard Worker  * open before starting to run. Otherwise, the first three network
83*6236dae4SAndroid Build Coastguard Worker  * sockets opened by curl could be used for input sources, downloaded data
84*6236dae4SAndroid Build Coastguard Worker  * or error logs as they will effectively be stdin, stdout and/or stderr.
85*6236dae4SAndroid Build Coastguard Worker  *
86*6236dae4SAndroid Build Coastguard Worker  * fcntl's F_GETFD instruction returns -1 if the file descriptor is closed,
87*6236dae4SAndroid Build Coastguard Worker  * otherwise it returns "the file descriptor flags (which typically can only
88*6236dae4SAndroid Build Coastguard Worker  * be FD_CLOEXEC, which is not set here).
89*6236dae4SAndroid Build Coastguard Worker  */
main_checkfds(void)90*6236dae4SAndroid Build Coastguard Worker static int main_checkfds(void)
91*6236dae4SAndroid Build Coastguard Worker {
92*6236dae4SAndroid Build Coastguard Worker   int fd[2];
93*6236dae4SAndroid Build Coastguard Worker   while((fcntl(STDIN_FILENO, F_GETFD) == -1) ||
94*6236dae4SAndroid Build Coastguard Worker         (fcntl(STDOUT_FILENO, F_GETFD) == -1) ||
95*6236dae4SAndroid Build Coastguard Worker         (fcntl(STDERR_FILENO, F_GETFD) == -1))
96*6236dae4SAndroid Build Coastguard Worker     if(pipe(fd))
97*6236dae4SAndroid Build Coastguard Worker       return 1;
98*6236dae4SAndroid Build Coastguard Worker   return 0;
99*6236dae4SAndroid Build Coastguard Worker }
100*6236dae4SAndroid Build Coastguard Worker #else
101*6236dae4SAndroid Build Coastguard Worker #define main_checkfds() 0
102*6236dae4SAndroid Build Coastguard Worker #endif
103*6236dae4SAndroid Build Coastguard Worker 
104*6236dae4SAndroid Build Coastguard Worker #ifdef CURLDEBUG
memory_tracking_init(void)105*6236dae4SAndroid Build Coastguard Worker static void memory_tracking_init(void)
106*6236dae4SAndroid Build Coastguard Worker {
107*6236dae4SAndroid Build Coastguard Worker   char *env;
108*6236dae4SAndroid Build Coastguard Worker   /* if CURL_MEMDEBUG is set, this starts memory tracking message logging */
109*6236dae4SAndroid Build Coastguard Worker   env = curl_getenv("CURL_MEMDEBUG");
110*6236dae4SAndroid Build Coastguard Worker   if(env) {
111*6236dae4SAndroid Build Coastguard Worker     /* use the value as filename */
112*6236dae4SAndroid Build Coastguard Worker     char fname[CURL_MT_LOGFNAME_BUFSIZE];
113*6236dae4SAndroid Build Coastguard Worker     if(strlen(env) >= CURL_MT_LOGFNAME_BUFSIZE)
114*6236dae4SAndroid Build Coastguard Worker       env[CURL_MT_LOGFNAME_BUFSIZE-1] = '\0';
115*6236dae4SAndroid Build Coastguard Worker     strcpy(fname, env);
116*6236dae4SAndroid Build Coastguard Worker     curl_free(env);
117*6236dae4SAndroid Build Coastguard Worker     curl_dbg_memdebug(fname);
118*6236dae4SAndroid Build Coastguard Worker     /* this weird stuff here is to make curl_free() get called before
119*6236dae4SAndroid Build Coastguard Worker        curl_dbg_memdebug() as otherwise memory tracking will log a free()
120*6236dae4SAndroid Build Coastguard Worker        without an alloc! */
121*6236dae4SAndroid Build Coastguard Worker   }
122*6236dae4SAndroid Build Coastguard Worker   /* if CURL_MEMLIMIT is set, this enables fail-on-alloc-number-N feature */
123*6236dae4SAndroid Build Coastguard Worker   env = curl_getenv("CURL_MEMLIMIT");
124*6236dae4SAndroid Build Coastguard Worker   if(env) {
125*6236dae4SAndroid Build Coastguard Worker     char *endptr;
126*6236dae4SAndroid Build Coastguard Worker     long num = strtol(env, &endptr, 10);
127*6236dae4SAndroid Build Coastguard Worker     if((endptr != env) && (endptr == env + strlen(env)) && (num > 0))
128*6236dae4SAndroid Build Coastguard Worker       curl_dbg_memlimit(num);
129*6236dae4SAndroid Build Coastguard Worker     curl_free(env);
130*6236dae4SAndroid Build Coastguard Worker   }
131*6236dae4SAndroid Build Coastguard Worker }
132*6236dae4SAndroid Build Coastguard Worker #else
133*6236dae4SAndroid Build Coastguard Worker #  define memory_tracking_init() Curl_nop_stmt
134*6236dae4SAndroid Build Coastguard Worker #endif
135*6236dae4SAndroid Build Coastguard Worker 
136*6236dae4SAndroid Build Coastguard Worker /*
137*6236dae4SAndroid Build Coastguard Worker  * This is the main global constructor for the app. Call this before
138*6236dae4SAndroid Build Coastguard Worker  * _any_ libcurl usage. If this fails, *NO* libcurl functions may be
139*6236dae4SAndroid Build Coastguard Worker  * used, or havoc may be the result.
140*6236dae4SAndroid Build Coastguard Worker  */
main_init(struct GlobalConfig * config)141*6236dae4SAndroid Build Coastguard Worker static CURLcode main_init(struct GlobalConfig *config)
142*6236dae4SAndroid Build Coastguard Worker {
143*6236dae4SAndroid Build Coastguard Worker   CURLcode result = CURLE_OK;
144*6236dae4SAndroid Build Coastguard Worker 
145*6236dae4SAndroid Build Coastguard Worker #if defined(__DJGPP__) || defined(__GO32__)
146*6236dae4SAndroid Build Coastguard Worker   /* stop stat() wasting time */
147*6236dae4SAndroid Build Coastguard Worker   _djstat_flags |= _STAT_INODE | _STAT_EXEC_MAGIC | _STAT_DIRSIZE;
148*6236dae4SAndroid Build Coastguard Worker #endif
149*6236dae4SAndroid Build Coastguard Worker 
150*6236dae4SAndroid Build Coastguard Worker   /* Initialise the global config */
151*6236dae4SAndroid Build Coastguard Worker   config->showerror = FALSE;          /* show errors when silent */
152*6236dae4SAndroid Build Coastguard Worker   config->styled_output = TRUE;       /* enable detection */
153*6236dae4SAndroid Build Coastguard Worker   config->parallel_max = PARALLEL_DEFAULT;
154*6236dae4SAndroid Build Coastguard Worker 
155*6236dae4SAndroid Build Coastguard Worker   /* Allocate the initial operate config */
156*6236dae4SAndroid Build Coastguard Worker   config->first = config->last = malloc(sizeof(struct OperationConfig));
157*6236dae4SAndroid Build Coastguard Worker   if(config->first) {
158*6236dae4SAndroid Build Coastguard Worker     /* Perform the libcurl initialization */
159*6236dae4SAndroid Build Coastguard Worker     result = curl_global_init(CURL_GLOBAL_DEFAULT);
160*6236dae4SAndroid Build Coastguard Worker     if(!result) {
161*6236dae4SAndroid Build Coastguard Worker       /* Get information about libcurl */
162*6236dae4SAndroid Build Coastguard Worker       result = get_libcurl_info();
163*6236dae4SAndroid Build Coastguard Worker 
164*6236dae4SAndroid Build Coastguard Worker       if(!result) {
165*6236dae4SAndroid Build Coastguard Worker         /* Initialise the config */
166*6236dae4SAndroid Build Coastguard Worker         config_init(config->first);
167*6236dae4SAndroid Build Coastguard Worker         config->first->global = config;
168*6236dae4SAndroid Build Coastguard Worker       }
169*6236dae4SAndroid Build Coastguard Worker       else {
170*6236dae4SAndroid Build Coastguard Worker         errorf(config, "error retrieving curl library information");
171*6236dae4SAndroid Build Coastguard Worker         free(config->first);
172*6236dae4SAndroid Build Coastguard Worker       }
173*6236dae4SAndroid Build Coastguard Worker     }
174*6236dae4SAndroid Build Coastguard Worker     else {
175*6236dae4SAndroid Build Coastguard Worker       errorf(config, "error initializing curl library");
176*6236dae4SAndroid Build Coastguard Worker       free(config->first);
177*6236dae4SAndroid Build Coastguard Worker     }
178*6236dae4SAndroid Build Coastguard Worker   }
179*6236dae4SAndroid Build Coastguard Worker   else {
180*6236dae4SAndroid Build Coastguard Worker     errorf(config, "error initializing curl");
181*6236dae4SAndroid Build Coastguard Worker     result = CURLE_FAILED_INIT;
182*6236dae4SAndroid Build Coastguard Worker   }
183*6236dae4SAndroid Build Coastguard Worker 
184*6236dae4SAndroid Build Coastguard Worker   return result;
185*6236dae4SAndroid Build Coastguard Worker }
186*6236dae4SAndroid Build Coastguard Worker 
free_globalconfig(struct GlobalConfig * config)187*6236dae4SAndroid Build Coastguard Worker static void free_globalconfig(struct GlobalConfig *config)
188*6236dae4SAndroid Build Coastguard Worker {
189*6236dae4SAndroid Build Coastguard Worker   Curl_safefree(config->trace_dump);
190*6236dae4SAndroid Build Coastguard Worker 
191*6236dae4SAndroid Build Coastguard Worker   if(config->trace_fopened && config->trace_stream)
192*6236dae4SAndroid Build Coastguard Worker     fclose(config->trace_stream);
193*6236dae4SAndroid Build Coastguard Worker   config->trace_stream = NULL;
194*6236dae4SAndroid Build Coastguard Worker 
195*6236dae4SAndroid Build Coastguard Worker   Curl_safefree(config->libcurl);
196*6236dae4SAndroid Build Coastguard Worker }
197*6236dae4SAndroid Build Coastguard Worker 
198*6236dae4SAndroid Build Coastguard Worker /*
199*6236dae4SAndroid Build Coastguard Worker  * This is the main global destructor for the app. Call this after
200*6236dae4SAndroid Build Coastguard Worker  * _all_ libcurl usage is done.
201*6236dae4SAndroid Build Coastguard Worker  */
main_free(struct GlobalConfig * config)202*6236dae4SAndroid Build Coastguard Worker static void main_free(struct GlobalConfig *config)
203*6236dae4SAndroid Build Coastguard Worker {
204*6236dae4SAndroid Build Coastguard Worker   /* Cleanup the easy handle */
205*6236dae4SAndroid Build Coastguard Worker   /* Main cleanup */
206*6236dae4SAndroid Build Coastguard Worker   curl_global_cleanup();
207*6236dae4SAndroid Build Coastguard Worker   free_globalconfig(config);
208*6236dae4SAndroid Build Coastguard Worker 
209*6236dae4SAndroid Build Coastguard Worker   /* Free the config structures */
210*6236dae4SAndroid Build Coastguard Worker   config_free(config->last);
211*6236dae4SAndroid Build Coastguard Worker   config->first = NULL;
212*6236dae4SAndroid Build Coastguard Worker   config->last = NULL;
213*6236dae4SAndroid Build Coastguard Worker }
214*6236dae4SAndroid Build Coastguard Worker 
215*6236dae4SAndroid Build Coastguard Worker /*
216*6236dae4SAndroid Build Coastguard Worker ** curl tool main function.
217*6236dae4SAndroid Build Coastguard Worker */
218*6236dae4SAndroid Build Coastguard Worker #ifdef _UNICODE
219*6236dae4SAndroid Build Coastguard Worker #if defined(__GNUC__) || defined(__clang__)
220*6236dae4SAndroid Build Coastguard Worker /* GCC does not know about wmain() */
221*6236dae4SAndroid Build Coastguard Worker #pragma GCC diagnostic push
222*6236dae4SAndroid Build Coastguard Worker #pragma GCC diagnostic ignored "-Wmissing-prototypes"
223*6236dae4SAndroid Build Coastguard Worker #pragma GCC diagnostic ignored "-Wmissing-declarations"
224*6236dae4SAndroid Build Coastguard Worker #endif
wmain(int argc,wchar_t * argv[])225*6236dae4SAndroid Build Coastguard Worker int wmain(int argc, wchar_t *argv[])
226*6236dae4SAndroid Build Coastguard Worker #else
227*6236dae4SAndroid Build Coastguard Worker int main(int argc, char *argv[])
228*6236dae4SAndroid Build Coastguard Worker #endif
229*6236dae4SAndroid Build Coastguard Worker {
230*6236dae4SAndroid Build Coastguard Worker   CURLcode result = CURLE_OK;
231*6236dae4SAndroid Build Coastguard Worker   struct GlobalConfig global;
232*6236dae4SAndroid Build Coastguard Worker   memset(&global, 0, sizeof(global));
233*6236dae4SAndroid Build Coastguard Worker 
234*6236dae4SAndroid Build Coastguard Worker   tool_init_stderr();
235*6236dae4SAndroid Build Coastguard Worker 
236*6236dae4SAndroid Build Coastguard Worker #ifdef _WIN32
237*6236dae4SAndroid Build Coastguard Worker   /* Undocumented diagnostic option to list the full paths of all loaded
238*6236dae4SAndroid Build Coastguard Worker      modules. This is purposely pre-init. */
239*6236dae4SAndroid Build Coastguard Worker   if(argc == 2 && !_tcscmp(argv[1], _T("--dump-module-paths"))) {
240*6236dae4SAndroid Build Coastguard Worker     struct curl_slist *item, *head = GetLoadedModulePaths();
241*6236dae4SAndroid Build Coastguard Worker     for(item = head; item; item = item->next)
242*6236dae4SAndroid Build Coastguard Worker       printf("%s\n", item->data);
243*6236dae4SAndroid Build Coastguard Worker     curl_slist_free_all(head);
244*6236dae4SAndroid Build Coastguard Worker     return head ? 0 : 1;
245*6236dae4SAndroid Build Coastguard Worker   }
246*6236dae4SAndroid Build Coastguard Worker   /* win32_init must be called before other init routines. */
247*6236dae4SAndroid Build Coastguard Worker   result = win32_init();
248*6236dae4SAndroid Build Coastguard Worker   if(result) {
249*6236dae4SAndroid Build Coastguard Worker     errorf(&global, "(%d) Windows-specific init failed", result);
250*6236dae4SAndroid Build Coastguard Worker     return (int)result;
251*6236dae4SAndroid Build Coastguard Worker   }
252*6236dae4SAndroid Build Coastguard Worker #endif
253*6236dae4SAndroid Build Coastguard Worker 
254*6236dae4SAndroid Build Coastguard Worker   if(main_checkfds()) {
255*6236dae4SAndroid Build Coastguard Worker     errorf(&global, "out of file descriptors");
256*6236dae4SAndroid Build Coastguard Worker     return CURLE_FAILED_INIT;
257*6236dae4SAndroid Build Coastguard Worker   }
258*6236dae4SAndroid Build Coastguard Worker 
259*6236dae4SAndroid Build Coastguard Worker #if defined(HAVE_SIGNAL) && defined(SIGPIPE)
260*6236dae4SAndroid Build Coastguard Worker   (void)signal(SIGPIPE, SIG_IGN);
261*6236dae4SAndroid Build Coastguard Worker #endif
262*6236dae4SAndroid Build Coastguard Worker 
263*6236dae4SAndroid Build Coastguard Worker   /* Initialize memory tracking */
264*6236dae4SAndroid Build Coastguard Worker   memory_tracking_init();
265*6236dae4SAndroid Build Coastguard Worker 
266*6236dae4SAndroid Build Coastguard Worker   /* Initialize the curl library - do not call any libcurl functions before
267*6236dae4SAndroid Build Coastguard Worker      this point */
268*6236dae4SAndroid Build Coastguard Worker   result = main_init(&global);
269*6236dae4SAndroid Build Coastguard Worker   if(!result) {
270*6236dae4SAndroid Build Coastguard Worker     /* Start our curl operation */
271*6236dae4SAndroid Build Coastguard Worker     result = operate(&global, argc, argv);
272*6236dae4SAndroid Build Coastguard Worker 
273*6236dae4SAndroid Build Coastguard Worker     /* Perform the main cleanup */
274*6236dae4SAndroid Build Coastguard Worker     main_free(&global);
275*6236dae4SAndroid Build Coastguard Worker   }
276*6236dae4SAndroid Build Coastguard Worker 
277*6236dae4SAndroid Build Coastguard Worker #ifdef _WIN32
278*6236dae4SAndroid Build Coastguard Worker   /* Flush buffers of all streams opened in write or update mode */
279*6236dae4SAndroid Build Coastguard Worker   fflush(NULL);
280*6236dae4SAndroid Build Coastguard Worker #endif
281*6236dae4SAndroid Build Coastguard Worker 
282*6236dae4SAndroid Build Coastguard Worker #ifdef __VMS
283*6236dae4SAndroid Build Coastguard Worker   vms_special_exit(result, vms_show);
284*6236dae4SAndroid Build Coastguard Worker #else
285*6236dae4SAndroid Build Coastguard Worker   return (int)result;
286*6236dae4SAndroid Build Coastguard Worker #endif
287*6236dae4SAndroid Build Coastguard Worker }
288*6236dae4SAndroid Build Coastguard Worker 
289*6236dae4SAndroid Build Coastguard Worker #ifdef _UNICODE
290*6236dae4SAndroid Build Coastguard Worker #if defined(__GNUC__) || defined(__clang__)
291*6236dae4SAndroid Build Coastguard Worker #pragma GCC diagnostic pop
292*6236dae4SAndroid Build Coastguard Worker #endif
293*6236dae4SAndroid Build Coastguard Worker #endif
294*6236dae4SAndroid Build Coastguard Worker 
295*6236dae4SAndroid Build Coastguard Worker #endif /* ndef UNITTESTS */
296