39c997aef8932db263ae84ffb4c3861baff87433
[openssl.git] / crypto / err / err.c
1 /* crypto/err/err.c */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  * 
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  * 
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  * 
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *    notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *    notice, this list of conditions and the following disclaimer in the
30  *    documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *    must display the following acknowledgement:
33  *    "This product includes cryptographic software written by
34  *     Eric Young (eay@cryptsoft.com)"
35  *    The word 'cryptographic' can be left out if the rouines from the library
36  *    being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from 
38  *    the apps directory (application code) you must include an acknowledgement:
39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  * 
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  * 
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58
59 #include <stdio.h>
60 #include "lhash.h"
61 #include "crypto.h"
62 #include "cryptlib.h"
63 #include "buffer.h"
64 #include "err.h"
65 #include "crypto.h"
66
67
68 static LHASH *error_hash=NULL;
69 static LHASH *thread_hash=NULL;
70
71 #ifndef NOPROTO
72 static unsigned long err_hash(ERR_STRING_DATA *a);
73 static int err_cmp(ERR_STRING_DATA *a, ERR_STRING_DATA *b);
74 static unsigned long pid_hash(ERR_STATE *pid);
75 static int pid_cmp(ERR_STATE *a,ERR_STATE *pid);
76 static unsigned long get_error_values(int inc,char **file,int *line,
77         char **data,int *flags);
78 static void ERR_STATE_free(ERR_STATE *s);
79 #else
80 static unsigned long err_hash();
81 static int err_cmp();
82 static unsigned long pid_hash();
83 static int pid_cmp();
84 static unsigned long get_error_values();
85 static void ERR_STATE_free();
86 ERR_STATE *s;
87 #endif
88
89 #ifndef NO_ERR
90 static ERR_STRING_DATA ERR_str_libraries[]=
91         {
92 {ERR_PACK(ERR_LIB_NONE,0,0)             ,"unknown library"},
93 {ERR_PACK(ERR_LIB_SYS,0,0)              ,"system library"},
94 {ERR_PACK(ERR_LIB_BN,0,0)               ,"bignum routines"},
95 {ERR_PACK(ERR_LIB_RSA,0,0)              ,"rsa routines"},
96 {ERR_PACK(ERR_LIB_DH,0,0)               ,"Diffie-Hellman routines"},
97 {ERR_PACK(ERR_LIB_EVP,0,0)              ,"digital envelope routines"},
98 {ERR_PACK(ERR_LIB_BUF,0,0)              ,"memory buffer routines"},
99 {ERR_PACK(ERR_LIB_BIO,0,0)              ,"BIO routines"},
100 {ERR_PACK(ERR_LIB_OBJ,0,0)              ,"object identifier routines"},
101 {ERR_PACK(ERR_LIB_PEM,0,0)              ,"PEM routines"},
102 {ERR_PACK(ERR_LIB_ASN1,0,0)             ,"asn1 encoding routines"},
103 {ERR_PACK(ERR_LIB_X509,0,0)             ,"x509 certificate routines"},
104 {ERR_PACK(ERR_LIB_CONF,0,0)             ,"configuation file routines"},
105 {ERR_PACK(ERR_LIB_METH,0,0)             ,"X509 lookup 'method' routines"},
106 {ERR_PACK(ERR_LIB_SSL,0,0)              ,"SSL routines"},
107 {ERR_PACK(ERR_LIB_RSAREF,0,0)           ,"RSAref routines"},
108 {ERR_PACK(ERR_LIB_PROXY,0,0)            ,"Proxy routines"},
109 {ERR_PACK(ERR_LIB_BIO,0,0)              ,"BIO routines"},
110 {ERR_PACK(ERR_LIB_PKCS7,0,0)            ,"PKCS7 routines"},
111 {0,NULL},
112         };
113
114 static ERR_STRING_DATA ERR_str_functs[]=
115         {
116         {ERR_PACK(0,SYS_F_FOPEN,0),             "fopen"},
117         {ERR_PACK(0,SYS_F_CONNECT,0),           "connect"},
118         {ERR_PACK(0,SYS_F_GETSERVBYNAME,0),     "getservbyname"},
119         {ERR_PACK(0,SYS_F_SOCKET,0),            "socket"}, 
120         {ERR_PACK(0,SYS_F_IOCTLSOCKET,0),       "ioctlsocket"},
121         {ERR_PACK(0,SYS_F_BIND,0),              "bind"},
122         {ERR_PACK(0,SYS_F_LISTEN,0),            "listen"},
123         {ERR_PACK(0,SYS_F_ACCEPT,0),            "accept"},
124 #ifdef WINDOWS
125         {ERR_PACK(0,SYS_F_WSASTARTUP,0),        "WSAstartup"},
126 #endif
127         {0,NULL},
128         };
129
130 static ERR_STRING_DATA ERR_str_reasons[]=
131         {
132 {ERR_R_FATAL                             ,"fatal"},
133 {ERR_R_SYS_LIB                          ,"system lib"},
134 {ERR_R_BN_LIB                           ,"BN lib"},
135 {ERR_R_RSA_LIB                          ,"RSA lib"},
136 {ERR_R_DH_LIB                           ,"DH lib"},
137 {ERR_R_EVP_LIB                          ,"EVP lib"},
138 {ERR_R_BUF_LIB                          ,"BUF lib"},
139 {ERR_R_BIO_LIB                          ,"BIO lib"},
140 {ERR_R_OBJ_LIB                          ,"OBJ lib"},
141 {ERR_R_PEM_LIB                          ,"PEM lib"},
142 {ERR_R_X509_LIB                         ,"X509 lib"},
143 {ERR_R_METH_LIB                         ,"METH lib"},
144 {ERR_R_ASN1_LIB                         ,"ASN1 lib"},
145 {ERR_R_CONF_LIB                         ,"CONF lib"},
146 {ERR_R_SSL_LIB                          ,"SSL lib"},
147 {ERR_R_PROXY_LIB                        ,"PROXY lib"},
148 {ERR_R_BIO_LIB                          ,"BIO lib"},
149 {ERR_R_PKCS7_LIB                        ,"PKCS7 lib"},
150 {ERR_R_MALLOC_FAILURE                   ,"Malloc failure"},
151 {ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED      ,"called a fuction you should not call"},
152 {ERR_R_PASSED_NULL_PARAMETER            ,"passed a null parameter"},
153 {ERR_R_NESTED_ASN1_ERROR                ,"nested asn1 error"},
154 {ERR_R_BAD_ASN1_OBJECT_HEADER           ,"bad asn1 object header"},
155 {ERR_R_BAD_GET_ASN1_OBJECT_CALL         ,"bad get asn1 object call"},
156 {ERR_R_EXPECTING_AN_ASN1_SEQUENCE       ,"expecting an asn1 sequence"},
157 {ERR_R_ASN1_LENGTH_MISMATCH             ,"asn1 length mismatch"},
158 {ERR_R_MISSING_ASN1_EOS                 ,"missing asn1 eos"},
159
160 {0,NULL},
161         };
162 #endif
163
164 #define err_clear_data(p,i) \
165         if (((p)->err_data[i] != NULL) && \
166                 (p)->err_data_flags[i] & ERR_TXT_MALLOCED) \
167                 {  \
168                 Free((p)->err_data[i]); \
169                 (p)->err_data[i]=NULL; \
170                 } \
171         (p)->err_data_flags[i]=0;
172
173 static void ERR_STATE_free(s)
174 ERR_STATE *s;
175         {
176         int i;
177
178         if(s == NULL)
179             return;
180
181         for (i=0; i<ERR_NUM_ERRORS; i++)
182                 {
183                 err_clear_data(s,i);
184                 }
185         Free(s);
186         }
187
188 void ERR_load_ERR_strings()
189         {
190         static int init=1;
191
192         if (init)
193                 {
194                 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
195                 if (init == 0)
196                         {
197                         CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
198                         return;
199                         }
200                 init=0;
201                 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
202
203 #ifndef NO_ERR
204                 ERR_load_strings(0,ERR_str_libraries);
205                 ERR_load_strings(0,ERR_str_reasons);
206                 ERR_load_strings(ERR_LIB_SYS,ERR_str_functs);
207 #endif
208                 }
209         }
210
211 void ERR_load_strings(lib,str)
212 int lib;
213 ERR_STRING_DATA *str;
214         {
215         if (error_hash == NULL)
216                 {
217                 CRYPTO_w_lock(CRYPTO_LOCK_ERR_HASH);
218                 error_hash=lh_new(err_hash,err_cmp);
219                 if (error_hash == NULL)
220                         {
221                         CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
222                         return;
223                         }
224                 CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
225
226                 ERR_load_ERR_strings();
227                 }
228
229         CRYPTO_w_lock(CRYPTO_LOCK_ERR_HASH);
230         while (str->error)
231                 {
232                 str->error|=ERR_PACK(lib,0,0);
233                 lh_insert(error_hash,(char *)str);
234                 str++;
235                 }
236         CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
237         }
238
239 void ERR_free_strings()
240         {
241         CRYPTO_w_lock(CRYPTO_LOCK_ERR);
242
243         if (error_hash != NULL)
244                 {
245                 lh_free(error_hash);
246                 error_hash=NULL;
247                 }
248
249         CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
250         }
251
252 /********************************************************/
253
254 void ERR_put_error(lib,func,reason,file,line)
255 int lib,func,reason;
256 char *file;
257 int line;
258         {
259         ERR_STATE *es;
260
261         es=ERR_get_state();
262
263         es->top=(es->top+1)%ERR_NUM_ERRORS;
264         if (es->top == es->bottom)
265                 es->bottom=(es->bottom+1)%ERR_NUM_ERRORS;
266         es->err_buffer[es->top]=ERR_PACK(lib,func,reason);
267         es->err_file[es->top]=file;
268         es->err_line[es->top]=line;
269         err_clear_data(es,es->top);
270         }
271
272 void ERR_clear_error()
273         {
274         ERR_STATE *es;
275
276         es=ERR_get_state();
277
278 #if 0
279         /* hmm... is this needed */
280         for (i=0; i<ERR_NUM_ERRORS; i++)
281                 {
282                 es->err_buffer[i]=0;
283                 es->err_file[i]=NULL;
284                 es->err_line[i]= -1;
285                 err_clear_data(es,i);
286                 }
287 #endif
288         es->top=es->bottom=0;
289         }
290
291
292 unsigned long ERR_get_error()
293         { return(get_error_values(1,NULL,NULL,NULL,NULL)); }
294
295 unsigned long ERR_get_error_line(file,line)
296 char **file;
297 int *line;
298         { return(get_error_values(1,file,line,NULL,NULL)); }
299
300 unsigned long ERR_get_error_line_data(file,line,data,flags)
301 char **file;
302 int *line;
303 char **data;
304 int *flags;
305         { return(get_error_values(1,file,line,data,flags)); }
306
307 unsigned long ERR_peek_error()
308         { return(get_error_values(0,NULL,NULL,NULL,NULL)); }
309
310 unsigned long ERR_peek_error_line(file,line)
311 char **file;
312 int *line;
313         { return(get_error_values(0,file,line,NULL,NULL)); }
314
315 unsigned long ERR_peek_error_line_data(file,line,data,flags)
316 char **file;
317 int *line;
318 char **data;
319 int *flags;
320         { return(get_error_values(0,file,line,data,flags)); }
321
322 static unsigned long get_error_values(inc,file,line,data,flags)
323 int inc;
324 char **file;
325 int *line;
326 char **data;
327 int *flags;
328         {       
329         int i=0;
330         ERR_STATE *es;
331         unsigned long ret;
332
333         es=ERR_get_state();
334
335         if (es->bottom == es->top) return(0);
336         i=(es->bottom+1)%ERR_NUM_ERRORS;
337
338         ret=es->err_buffer[i];
339         if (inc)
340                 {
341                 es->bottom=i;
342                 es->err_buffer[i]=0;
343                 }
344
345         if ((file != NULL) && (line != NULL))
346                 {
347                 if (es->err_file[i] == NULL)
348                         {
349                         *file="NA";
350                         if (line != NULL) *line=0;
351                         }
352                 else
353                         {
354                         *file=es->err_file[i];
355                         if (line != NULL) *line=es->err_line[i];
356                         }
357                 }
358
359         if (data != NULL)
360                 {
361                 if (es->err_data[i] == NULL)
362                         {
363                         *data="";
364                         if (flags != NULL) *flags=0;
365                         }
366                 else
367                         {
368                         *data=es->err_data[i];
369                         if (flags != NULL) *flags=es->err_data_flags[i];
370                         }
371                 }
372         return(ret);
373         }
374
375 /* BAD for multi-threaded, uses a local buffer if ret == NULL */
376 char *ERR_error_string(e,ret)
377 unsigned long e;
378 char *ret;
379         {
380         static char buf[256];
381         char *ls,*fs,*rs;
382         unsigned long l,f,r;
383         int i;
384
385         l=ERR_GET_LIB(e);
386         f=ERR_GET_FUNC(e);
387         r=ERR_GET_REASON(e);
388
389         ls=ERR_lib_error_string(e);
390         fs=ERR_func_error_string(e);
391         rs=ERR_reason_error_string(e);
392
393         if (ret == NULL) ret=buf;
394
395         sprintf(&(ret[0]),"error:%08lX:",e);
396         i=strlen(ret);
397         if (ls == NULL)
398                 sprintf(&(ret[i]),":lib(%lu) ",l);
399         else    sprintf(&(ret[i]),"%s",ls);
400         i=strlen(ret);
401         if (fs == NULL)
402                 sprintf(&(ret[i]),":func(%lu) ",f);
403         else    sprintf(&(ret[i]),":%s",fs);
404         i=strlen(ret);
405         if (rs == NULL)
406                 sprintf(&(ret[i]),":reason(%lu)",r);
407         else    sprintf(&(ret[i]),":%s",rs);
408
409         return(ret);
410         }
411
412 LHASH *ERR_get_string_table()
413         {
414         return(error_hash);
415         }
416
417 LHASH *ERR_get_err_state_table()
418         {
419         return(thread_hash);
420         }
421
422 char *ERR_lib_error_string(e)
423 unsigned long e;
424         {
425         ERR_STRING_DATA d,*p=NULL;
426         unsigned long l;
427
428         l=ERR_GET_LIB(e);
429
430         CRYPTO_r_lock(CRYPTO_LOCK_ERR_HASH);
431
432         if (error_hash != NULL)
433                 {
434                 d.error=ERR_PACK(l,0,0);
435                 p=(ERR_STRING_DATA *)lh_retrieve(error_hash,(char *)&d);
436                 }
437
438         CRYPTO_r_unlock(CRYPTO_LOCK_ERR_HASH);
439
440         return((p == NULL)?NULL:p->string);
441         }
442
443 char *ERR_func_error_string(e)
444 unsigned long e;
445         {
446         ERR_STRING_DATA d,*p=NULL;
447         unsigned long l,f;
448
449         l=ERR_GET_LIB(e);
450         f=ERR_GET_FUNC(e);
451
452         CRYPTO_r_lock(CRYPTO_LOCK_ERR_HASH);
453
454         if (error_hash != NULL)
455                 {
456                 d.error=ERR_PACK(l,f,0);
457                 p=(ERR_STRING_DATA *)lh_retrieve(error_hash,(char *)&d);
458                 }
459
460         CRYPTO_r_unlock(CRYPTO_LOCK_ERR_HASH);
461
462         return((p == NULL)?NULL:p->string);
463         }
464
465 char *ERR_reason_error_string(e)
466 unsigned long e;
467         {
468         ERR_STRING_DATA d,*p=NULL;
469         unsigned long l,r;
470
471         l=ERR_GET_LIB(e);
472         r=ERR_GET_REASON(e);
473
474         CRYPTO_r_lock(CRYPTO_LOCK_ERR_HASH);
475
476         if (error_hash != NULL)
477                 {
478                 d.error=ERR_PACK(l,0,r);
479                 p=(ERR_STRING_DATA *)lh_retrieve(error_hash,(char *)&d);
480                 if (p == NULL)
481                         {
482                         d.error=ERR_PACK(0,0,r);
483                         p=(ERR_STRING_DATA *)lh_retrieve(error_hash,
484                                 (char *)&d);
485                         }
486                 }
487
488         CRYPTO_r_unlock(CRYPTO_LOCK_ERR_HASH);
489
490         return((p == NULL)?NULL:p->string);
491         }
492
493 static unsigned long err_hash(a)
494 ERR_STRING_DATA *a;
495         {
496         unsigned long ret,l;
497
498         l=a->error;
499         ret=l^ERR_GET_LIB(l)^ERR_GET_FUNC(l);
500         return(ret^ret%19*13);
501         }
502
503 static int err_cmp(a,b)
504 ERR_STRING_DATA *a,*b;
505         {
506         return((int)(a->error-b->error));
507         }
508
509 static unsigned long pid_hash(a)
510 ERR_STATE *a;
511         {
512         return(a->pid*13);
513         }
514
515 static int pid_cmp(a,b)
516 ERR_STATE *a,*b;
517         {
518         return((int)((long)a->pid - (long)b->pid));
519         }
520
521 void ERR_remove_state(pid)
522 unsigned long pid;
523         {
524         ERR_STATE *p,tmp;
525
526         if (thread_hash == NULL)
527                 return;
528         if (pid == 0)
529                 pid=(unsigned long)CRYPTO_thread_id();
530         tmp.pid=pid;
531         CRYPTO_w_lock(CRYPTO_LOCK_ERR);
532         p=(ERR_STATE *)lh_delete(thread_hash,(char *)&tmp);
533         CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
534
535         if (p != NULL) ERR_STATE_free(p);
536         }
537
538 ERR_STATE *ERR_get_state()
539         {
540         static ERR_STATE fallback;
541         ERR_STATE *ret=NULL,tmp,*tmpp;
542         int i;
543         unsigned long pid;
544
545         pid=(unsigned long)CRYPTO_thread_id();
546
547         CRYPTO_r_lock(CRYPTO_LOCK_ERR);
548         if (thread_hash == NULL)
549                 {
550                 CRYPTO_r_unlock(CRYPTO_LOCK_ERR);
551                 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
552                 if (thread_hash == NULL)
553                         {
554                         MemCheck_off();
555                         thread_hash=lh_new(pid_hash,pid_cmp);
556                         MemCheck_on();
557                         CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
558                         if (thread_hash == NULL) return(&fallback);
559                         }
560                 else
561                         CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
562                 }
563         else
564                 {
565                 tmp.pid=pid;
566                 ret=(ERR_STATE *)lh_retrieve(thread_hash,(char *)&tmp);
567                 CRYPTO_r_unlock(CRYPTO_LOCK_ERR);
568                 }
569
570         /* ret == the error state, if NULL, make a new one */
571         if (ret == NULL)
572                 {
573                 ret=(ERR_STATE *)Malloc(sizeof(ERR_STATE));
574                 if (ret == NULL) return(&fallback);
575                 ret->pid=pid;
576                 ret->top=0;
577                 ret->bottom=0;
578                 for (i=0; i<ERR_NUM_ERRORS; i++)
579                         {
580                         ret->err_data[i]=NULL;
581                         ret->err_data_flags[i]=0;
582                         }
583                 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
584                 tmpp=(ERR_STATE *)lh_insert(thread_hash,(char *)ret);
585                 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
586                 if (tmpp != NULL) /* old entry - should not happen */
587                         {
588                         ERR_STATE_free(tmpp);
589                         }
590                 }
591         return(ret);
592         }
593
594 int ERR_get_next_error_library()
595         {
596         static int value=ERR_LIB_USER;
597
598         return(value++);
599         }
600
601 void ERR_set_error_data(data,flags)
602 char *data;
603 int flags;
604         {
605         ERR_STATE *es;
606         int i;
607
608         es=ERR_get_state();
609
610         i=es->top;
611         if (i == 0)
612                 i=ERR_NUM_ERRORS-1;
613
614         es->err_data[i]=data;
615         es->err_data_flags[es->top]=flags;
616         }
617
618 void ERR_add_error_data( VAR_PLIST(int , num))
619 VAR_ALIST
620         {
621         VAR_BDEFN(args, int, num);
622         int i,n,s;
623         char *str,*p,*a;
624
625         s=64;
626         str=Malloc(s+1);
627         if (str == NULL) return;
628         str[0]='\0';
629
630         VAR_INIT(args,int,num);
631         n=0;
632         for (i=0; i<num; i++)
633                 {
634                 VAR_ARG(args,char *,a);
635                 /* ignore NULLs, thanks to Bob Beck <beck@obtuse.com> */
636                 if (a != NULL)
637                         {
638                         n+=strlen(a);
639                         if (n > s)
640                                 {
641                                 s=n+20;
642                                 p=Realloc(str,s+1);
643                                 if (p == NULL)
644                                         {
645                                         Free(str);
646                                         return;
647                                         }
648                                 else
649                                         str=p;
650                                 }
651                         strcat(str,a);
652                         }
653                 }
654         ERR_set_error_data(str,ERR_TXT_MALLOCED|ERR_TXT_STRING);
655
656         VAR_END( args );
657         }
658