Converted all m_free to xfree etc.
[gnupg.git] / cipher / random.c
1 /* random.c  -  random number generator
2  * Copyright (C) 1998, 1999, 2000, 2001, 2002,
3  *               2003 Free Software Foundation, Inc.
4  *
5  * This file is part of GnuPG.
6  *
7  * GnuPG is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * GnuPG is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
20  * USA.
21  */
22
23
24 /****************
25  * This random number generator is modelled after the one described
26  * in Peter Gutmann's Paper: "Software Generation of Practically
27  * Strong Random Numbers".
28  */
29
30
31 #include <config.h>
32 #include <stdio.h>
33 #include <stdlib.h>
34 #include <assert.h>
35 #include <errno.h>
36 #include <string.h>
37 #include <time.h>
38 #ifndef _WIN32
39 #include <sys/time.h>
40 #endif
41 #include <sys/types.h>
42 #include <sys/stat.h>
43 #include <unistd.h>
44 #include <fcntl.h>
45 #ifdef HAVE_GETHRTIME
46 #include <sys/times.h>
47 #endif
48 #ifdef HAVE_GETTIMEOFDAY
49 #include <sys/times.h>
50 #endif
51 #ifdef HAVE_TIMES
52 #include <sys/times.h>
53 #endif
54 #ifdef HAVE_GETRUSAGE
55 #include <sys/resource.h>
56 #endif
57 #ifdef _WIN32
58 #include <process.h>
59 #endif
60 #include "util.h"
61 #include "rmd.h"
62 #include "ttyio.h"
63 #include "i18n.h"
64 #include "random.h"
65 #include "rand-internal.h"
66 #include "algorithms.h"
67
68 #ifndef RAND_MAX   /* for SunOS */
69 #define RAND_MAX 32767
70 #endif
71
72
73 #if SIZEOF_UNSIGNED_LONG == 8
74 #define ADD_VALUE 0xa5a5a5a5a5a5a5a5
75 #elif SIZEOF_UNSIGNED_LONG == 4
76 #define ADD_VALUE 0xa5a5a5a5
77 #else
78 #error weird size for an unsigned long
79 #endif
80
81 #define BLOCKLEN  64   /* hash this amount of bytes */
82 #define DIGESTLEN 20   /* into a digest of this length (rmd160) */
83 /* poolblocks is the number of digests which make up the pool
84  * and poolsize must be a multiple of the digest length
85  * to make the AND operations faster, the size should also be
86  * a multiple of ulong
87  */
88 #define POOLBLOCKS 30
89 #define POOLSIZE (POOLBLOCKS*DIGESTLEN)
90 #if (POOLSIZE % SIZEOF_UNSIGNED_LONG)
91 #error Please make sure that poolsize is a multiple of ulong
92 #endif
93 #define POOLWORDS (POOLSIZE / SIZEOF_UNSIGNED_LONG)
94
95
96 static int is_initialized;
97 #define MASK_LEVEL(a) do {if( a > 2 ) a = 2; else if( a < 0 ) a = 0; } while(0)
98 static char *rndpool;   /* allocated size is POOLSIZE+BLOCKLEN */
99 static char *keypool;   /* allocated size is POOLSIZE+BLOCKLEN */
100 static size_t pool_readpos;
101 static size_t pool_writepos;
102 static int pool_filled;
103 static int pool_balance;
104 static int just_mixed;
105 static int did_initial_extra_seeding;
106 static char *seed_file_name;
107 static int allow_seed_file_update;
108
109 static int secure_alloc;
110 static int quick_test;
111 static int faked_rng;
112
113
114 static void read_pool( byte *buffer, size_t length, int level );
115 static void add_randomness( const void *buffer, size_t length, int source );
116 static void random_poll(void);
117 static void read_random_source( int requester, size_t length, int level);
118 static int gather_faked( void (*add)(const void*, size_t, int), int requester,
119                                                     size_t length, int level );
120
121 static struct {
122     ulong mixrnd;
123     ulong mixkey;
124     ulong slowpolls;
125     ulong fastpolls;
126     ulong getbytes1;
127     ulong ngetbytes1;
128     ulong getbytes2;
129     ulong ngetbytes2;
130     ulong addbytes;
131     ulong naddbytes;
132 } rndstats;
133
134
135 static int (*
136 getfnc_gather_random (void))(void (*)(const void*, size_t, int), int,
137                         size_t, int)
138 {
139 #ifdef USE_ALL_RANDOM_MODULES
140   static int (*fnc)(void (*)(const void*, size_t, int), int, size_t, int);
141   
142   if (fnc)
143     return fnc;
144 # ifdef USE_RNDLINUX
145   if ( !access (NAME_OF_DEV_RANDOM, R_OK)
146        && !access (NAME_OF_DEV_URANDOM, R_OK))
147     {
148       fnc = rndlinux_gather_random;
149       return fnc;
150     }
151 # endif
152 # ifdef USE_RNDEGD
153   if ( rndegd_connect_socket (1) != -1 )
154     {
155       fnc = rndegd_gather_random;
156       return fnc;
157     }
158 # endif
159 # ifdef USE_RNDUNIX
160   fnc = rndunix_gather_random;
161   return fnc;
162 # endif
163
164   log_fatal (_("no entropy gathering module detected\n"));
165
166 #else
167 # ifdef USE_RNDLINUX
168   return rndlinux_gather_random;
169 # endif
170 # ifdef USE_RNDUNIX
171   return rndunix_gather_random;
172 # endif
173 # ifdef USE_RNDEGD
174   return rndegd_gather_random;
175 # endif
176 # ifdef USE_RNDW32
177   return rndw32_gather_random;
178 # endif
179 # ifdef USE_RNDRISCOS
180   return rndriscos_gather_random;
181 # endif
182 #endif
183   return NULL;
184 }
185
186 static int (*
187 getfnc_fast_random_poll (void))( void (*)(const void*, size_t, int), int)
188 {
189 #ifdef USE_RNDW32
190   return rndw32_gather_random_fast;
191 #endif
192   return NULL;
193 }
194
195
196
197 static void
198 initialize(void)
199 {
200     /* The data buffer is allocated somewhat larger, so that
201      * we can use this extra space (which is allocated in secure memory)
202      * as a temporary hash buffer */
203     rndpool = secure_alloc ? xmalloc_secure_clear(POOLSIZE+BLOCKLEN)
204                            : xmalloc_clear(POOLSIZE+BLOCKLEN);
205     keypool = secure_alloc ? xmalloc_secure_clear(POOLSIZE+BLOCKLEN)
206                            : xmalloc_clear(POOLSIZE+BLOCKLEN);
207     is_initialized = 1;
208 }
209
210 static void
211 burn_stack (int bytes)
212 {
213     char buf[128];
214     
215     wipememory(buf,sizeof buf);
216     bytes -= sizeof buf;
217     if (bytes > 0)
218         burn_stack (bytes);
219 }
220
221 void
222 random_dump_stats()
223 {
224     fprintf(stderr,
225             "random usage: poolsize=%d mixed=%lu polls=%lu/%lu added=%lu/%lu\n"
226             "              outmix=%lu getlvl1=%lu/%lu getlvl2=%lu/%lu\n",
227         POOLSIZE, rndstats.mixrnd, rndstats.slowpolls, rndstats.fastpolls,
228                   rndstats.naddbytes, rndstats.addbytes,
229         rndstats.mixkey, rndstats.ngetbytes1, rndstats.getbytes1,
230                     rndstats.ngetbytes2, rndstats.getbytes2 );
231 }
232
233 void
234 secure_randoxmalloc()
235 {
236     secure_alloc = 1;
237 }
238
239
240 int
241 quick_random_gen( int onoff )
242 {
243     int last;
244
245     read_random_source(0,0,0); /* init */
246     last = quick_test;
247     if( onoff != -1 )
248         quick_test = onoff;
249     return faked_rng? 1 : last;
250 }
251
252
253 /****************
254  * Fill the buffer with LENGTH bytes of cryptographically strong
255  * random bytes. level 0 is not very strong, 1 is strong enough
256  * for most usage, 2 is good for key generation stuff but may be very slow.
257  */
258 void
259 randomize_buffer( byte *buffer, size_t length, int level )
260 {
261     char *p = get_random_bits( length*8, level, 1 );
262     memcpy( buffer, p, length );
263     xfree(p);
264 }
265
266
267 int
268 random_is_faked()
269 {
270     if( !is_initialized )
271         initialize();
272     return faked_rng || quick_test;
273 }
274
275 /****************
276  * Return a pointer to a randomized buffer of level 0 and LENGTH bits
277  * caller must free the buffer.
278  * Note: The returned value is rounded up to bytes.
279  */
280 byte *
281 get_random_bits( size_t nbits, int level, int secure )
282 {
283     byte *buf, *p;
284     size_t nbytes = (nbits+7)/8;
285
286     if( quick_test && level > 1 )
287         level = 1;
288     MASK_LEVEL(level);
289     if( level == 1 ) {
290         rndstats.getbytes1 += nbytes;
291         rndstats.ngetbytes1++;
292     }
293     else if( level >= 2 ) {
294         rndstats.getbytes2 += nbytes;
295         rndstats.ngetbytes2++;
296     }
297
298     buf = secure && secure_alloc ? xmalloc_secure( nbytes ) : xmalloc( nbytes );
299     for( p = buf; nbytes > 0; ) {
300         size_t n = nbytes > POOLSIZE? POOLSIZE : nbytes;
301         read_pool( p, n, level );
302         nbytes -= n;
303         p += n;
304     }
305     return buf;
306 }
307
308
309 /****************
310  * Mix the pool
311  */
312 static void
313 mix_pool(byte *pool)
314 {
315     char *hashbuf = pool + POOLSIZE;
316     char *p, *pend;
317     int i, n;
318     RMD160_CONTEXT md;
319
320     rmd160_init( &md );
321 #if DIGESTLEN != 20
322 #error must have a digest length of 20 for ripe-md-160
323 #endif
324     /* loop over the pool */
325     pend = pool + POOLSIZE;
326     memcpy(hashbuf, pend - DIGESTLEN, DIGESTLEN );
327     memcpy(hashbuf+DIGESTLEN, pool, BLOCKLEN-DIGESTLEN);
328     rmd160_mixblock( &md, hashbuf);
329     memcpy(pool, hashbuf, 20 );
330
331     p = pool;
332     for( n=1; n < POOLBLOCKS; n++ ) {
333         memcpy(hashbuf, p, DIGESTLEN );
334
335         p += DIGESTLEN;
336         if( p+DIGESTLEN+BLOCKLEN < pend )
337             memcpy(hashbuf+DIGESTLEN, p+DIGESTLEN, BLOCKLEN-DIGESTLEN);
338         else {
339             char *pp = p+DIGESTLEN;
340             for(i=DIGESTLEN; i < BLOCKLEN; i++ ) {
341                 if( pp >= pend )
342                     pp = pool;
343                 hashbuf[i] = *pp++;
344             }
345         }
346
347         rmd160_mixblock( &md, hashbuf);
348         memcpy(p, hashbuf, 20 );
349     }
350     burn_stack (384); /* for the rmd160_mixblock() */
351 }
352
353
354 void
355 set_random_seed_file( const char *name )
356 {
357     if( seed_file_name )
358         BUG();
359     seed_file_name = xstrdup( name );
360 }
361
362 /****************
363  * Read in a seed form the random_seed file
364  * and return true if this was successful
365  */
366 static int
367 read_seed_file(void)
368 {
369     int fd;
370     struct stat sb;
371     unsigned char buffer[POOLSIZE];
372     int n;
373
374     if( !seed_file_name )
375         return 0;
376
377 #if defined(HAVE_DOSISH_SYSTEM) || defined(__CYGWIN__)
378     fd = open( seed_file_name, O_RDONLY | O_BINARY );
379 #else
380     fd = open( seed_file_name, O_RDONLY );
381 #endif
382     if( fd == -1 && errno == ENOENT) {
383         allow_seed_file_update = 1;
384         return 0;
385     }
386
387     if( fd == -1 ) {
388         log_info(_("can't open `%s': %s\n"), seed_file_name, strerror(errno) );
389         return 0;
390     }
391     if( fstat( fd, &sb ) ) {
392         log_info(_("can't stat `%s': %s\n"), seed_file_name, strerror(errno) );
393         close(fd);
394         return 0;
395     }
396     if( !S_ISREG(sb.st_mode) ) {
397         log_info(_("`%s' is not a regular file - ignored\n"), seed_file_name );
398         close(fd);
399         return 0;
400     }
401     if( !sb.st_size ) {
402         log_info(_("note: random_seed file is empty\n") );
403         close(fd);
404         allow_seed_file_update = 1;
405         return 0;
406     }
407     if( sb.st_size != POOLSIZE ) {
408         log_info(_("WARNING: invalid size of random_seed file - not used\n") );
409         close(fd);
410         return 0;
411     }
412     do {
413         n = read( fd, buffer, POOLSIZE );
414     } while( n == -1 && errno == EINTR );
415     if( n != POOLSIZE ) {
416         log_fatal(_("can't read `%s': %s\n"), seed_file_name,strerror(errno) );
417         close(fd);
418         return 0;
419     }
420
421     close(fd);
422
423     add_randomness( buffer, POOLSIZE, 0 );
424     /* add some minor entropy to the pool now (this will also force a mixing) */
425     {   pid_t x = getpid();
426         add_randomness( &x, sizeof(x), 0 );
427     }
428     {   time_t x = time(NULL);
429         add_randomness( &x, sizeof(x), 0 );
430     }
431     {   clock_t x = clock();
432         add_randomness( &x, sizeof(x), 0 );
433     }
434     /* And read a few bytes from our entropy source.  By using
435      * a level of 0 this will not block and might not return anything
436      * with some entropy drivers, however the rndlinux driver will use
437      * /dev/urandom and return some stuff - Do not read to much as we
438      * want to be friendly to the scare system entropy resource. */
439     read_random_source( 0, 16, 0 );
440
441     allow_seed_file_update = 1;
442     return 1;
443 }
444
445 void
446 update_random_seed_file()
447 {
448     ulong *sp, *dp;
449     int fd, i;
450
451     if( !seed_file_name || !is_initialized || !pool_filled )
452         return;
453     if( !allow_seed_file_update ) {
454         log_info(_("note: random_seed file not updated\n"));
455         return;
456     }
457
458
459     /* copy the entropy pool to a scratch pool and mix both of them */
460     for(i=0,dp=(ulong*)keypool, sp=(ulong*)rndpool;
461                                     i < POOLWORDS; i++, dp++, sp++ ) {
462         *dp = *sp + ADD_VALUE;
463     }
464     mix_pool(rndpool); rndstats.mixrnd++;
465     mix_pool(keypool); rndstats.mixkey++;
466
467 #if defined(HAVE_DOSISH_SYSTEM) || defined(__CYGWIN__)
468     fd = open( seed_file_name, O_WRONLY|O_CREAT|O_TRUNC|O_BINARY,
469                                                         S_IRUSR|S_IWUSR );
470 #else
471     fd = open( seed_file_name, O_WRONLY|O_CREAT|O_TRUNC, S_IRUSR|S_IWUSR );
472 #endif
473     if( fd == -1 ) {
474         log_info(_("can't create `%s': %s\n"), seed_file_name, strerror(errno) );
475         return;
476     }
477     do {
478         i = write( fd, keypool, POOLSIZE );
479     } while( i == -1 && errno == EINTR );
480     if( i != POOLSIZE ) {
481         log_info(_("can't write `%s': %s\n"), seed_file_name, strerror(errno) );
482     }
483     if( close(fd) )
484         log_info(_("can't close `%s': %s\n"), seed_file_name, strerror(errno) );
485 }
486
487
488 static void
489 read_pool( byte *buffer, size_t length, int level )
490 {
491     int i;
492     ulong *sp, *dp;
493
494     if( length > POOLSIZE ) {
495         log_bug("too many random bits requested\n");
496     }
497
498     if( !pool_filled ) {
499         if( read_seed_file() )
500             pool_filled = 1;
501     }
502
503     /* For level 2 quality (key generation) we alwas make
504      * sure that the pool has been seeded enough initially */
505     if( level == 2 && !did_initial_extra_seeding ) {
506         size_t needed;
507
508         pool_balance = 0;
509         needed = length - pool_balance;
510         if( needed < POOLSIZE/2 )
511             needed = POOLSIZE/2;
512         else if( needed > POOLSIZE )
513             BUG();
514         read_random_source( 3, needed, 2 );
515         pool_balance += needed;
516         did_initial_extra_seeding=1;
517     }
518
519     /* for level 2 make sure that there is enough random in the pool */
520     if( level == 2 && pool_balance < length ) {
521         size_t needed;
522
523         if( pool_balance < 0 )
524             pool_balance = 0;
525         needed = length - pool_balance;
526         if( needed > POOLSIZE )
527             BUG();
528         read_random_source( 3, needed, 2 );
529         pool_balance += needed;
530     }
531
532     /* make sure the pool is filled */
533     while( !pool_filled )
534         random_poll();
535
536     /* do always a fast random poll */
537     fast_random_poll();
538
539     if( !level ) { /* no need for cryptographic strong random */
540         /* create a new pool */
541         for(i=0,dp=(ulong*)keypool, sp=(ulong*)rndpool;
542                                     i < POOLWORDS; i++, dp++, sp++ )
543             *dp = *sp + ADD_VALUE;
544         /* must mix both pools */
545         mix_pool(rndpool); rndstats.mixrnd++;
546         mix_pool(keypool); rndstats.mixkey++;
547         memcpy( buffer, keypool, length );
548     }
549     else {
550         /* mix the pool (if add_randomness() didn't it) */
551         if( !just_mixed ) {
552             mix_pool(rndpool);
553             rndstats.mixrnd++;
554         }
555         /* create a new pool */
556         for(i=0,dp=(ulong*)keypool, sp=(ulong*)rndpool;
557                                     i < POOLWORDS; i++, dp++, sp++ )
558             *dp = *sp + ADD_VALUE;
559         /* and mix both pools */
560         mix_pool(rndpool); rndstats.mixrnd++;
561         mix_pool(keypool); rndstats.mixkey++;
562         /* read the required data
563          * we use a readpoiter to read from a different postion each
564          * time */
565         while( length-- ) {
566             *buffer++ = keypool[pool_readpos++];
567             if( pool_readpos >= POOLSIZE )
568                 pool_readpos = 0;
569             pool_balance--;
570         }
571         if( pool_balance < 0 )
572             pool_balance = 0;
573         /* and clear the keypool */
574         wipememory(keypool, POOLSIZE);
575     }
576 }
577
578
579 /****************
580  * Add LENGTH bytes of randomness from buffer to the pool.
581  * source may be used to specify the randomness source.
582  * Source is:
583  *      0 - used ony for initialization
584  *      1 - fast random poll function
585  *      2 - normal poll function
586  *      3 - used when level 2 random quality has been requested
587  *          to do an extra pool seed.
588  */
589 static void
590 add_randomness( const void *buffer, size_t length, int source )
591 {
592     const byte *p = buffer;
593
594     if( !is_initialized )
595         initialize();
596     rndstats.addbytes += length;
597     rndstats.naddbytes++;
598     while( length-- ) {
599         rndpool[pool_writepos++] ^= *p++;
600         if( pool_writepos >= POOLSIZE ) {
601             if( source > 1 )
602                 pool_filled = 1;
603             pool_writepos = 0;
604             mix_pool(rndpool); rndstats.mixrnd++;
605             just_mixed = !length;
606         }
607     }
608 }
609
610
611
612 static void
613 random_poll()
614 {
615     rndstats.slowpolls++;
616     read_random_source( 2, POOLSIZE/5, 1 );
617 }
618
619
620 void
621 fast_random_poll()
622 {
623     static int (*fnc)( void (*)(const void*, size_t, int), int) = NULL;
624     static int initialized = 0;
625
626     rndstats.fastpolls++;
627     if( !initialized ) {
628         if( !is_initialized )
629             initialize();
630         initialized = 1;
631         fnc = getfnc_fast_random_poll();
632     }
633     if( fnc ) {
634         (*fnc)( add_randomness, 1 );
635         return;
636     }
637
638     /* fall back to the generic function */
639 #if defined(HAVE_GETHRTIME) && !defined(HAVE_BROKEN_GETHRTIME)
640     {   hrtime_t tv;
641         /* On some Solaris and HPUX system gethrtime raises an SIGILL, but we 
642          * checked this with configure */
643         tv = gethrtime();
644         add_randomness( &tv, sizeof(tv), 1 );
645     }
646 #elif defined (HAVE_GETTIMEOFDAY)
647     {   struct timeval tv;
648         if( gettimeofday( &tv, NULL ) )
649             BUG();
650         add_randomness( &tv.tv_sec, sizeof(tv.tv_sec), 1 );
651         add_randomness( &tv.tv_usec, sizeof(tv.tv_usec), 1 );
652     }
653 #elif defined (HAVE_CLOCK_GETTIME)
654     {   struct timespec tv;
655         if( clock_gettime( CLOCK_REALTIME, &tv ) == -1 )
656             BUG();
657         add_randomness( &tv.tv_sec, sizeof(tv.tv_sec), 1 );
658         add_randomness( &tv.tv_nsec, sizeof(tv.tv_nsec), 1 );
659     }
660 #elif defined (HAVE_TIMES)
661     {   struct tms buf;
662         if( times( &buf ) == -1 )
663             BUG();
664         add_randomness( &buf, sizeof buf, 1 );
665     }
666 #endif
667 #ifdef HAVE_GETRUSAGE
668 #ifndef RUSAGE_SELF
669 #ifdef __GCC__
670 #warning There is no RUSAGE_SELF on this system
671 #endif
672 #else
673     {   struct rusage buf;
674         /* QNX/Neutrino does return ENOSYS - so we just ignore it and
675          * add whatever is in buf.  In a chroot environment it might not
676          * work at all (i.e. because /proc/ is not accessible), so we better 
677          * ignore all error codes and hope for the best
678          */
679         getrusage( RUSAGE_SELF, &buf );
680         
681         add_randomness( &buf, sizeof buf, 1 );
682         wipememory( &buf, sizeof buf );
683     }
684 #endif
685 #endif
686     /* time and clock are available on all systems - so
687      * we better do it just in case one of the above functions
688      * didn't work */
689     {   time_t x = time(NULL);
690         add_randomness( &x, sizeof(x), 1 );
691     }
692     {   clock_t x = clock();
693         add_randomness( &x, sizeof(x), 1 );
694     }
695 }
696
697
698
699 static void
700 read_random_source( int requester, size_t length, int level )
701 {
702     static int (*fnc)(void (*)(const void*, size_t, int), int,
703                                                     size_t, int) = NULL;
704     if( !fnc ) {
705         if( !is_initialized )
706             initialize();
707         fnc = getfnc_gather_random();
708         if( !fnc ) {
709             faked_rng = 1;
710             fnc = gather_faked;
711         }
712         if( !requester && !length && !level )
713             return; /* init only */
714     }
715     if( (*fnc)( add_randomness, requester, length, level ) < 0 )
716         log_fatal("No way to gather entropy for the RNG\n");
717 }
718
719
720 static int
721 gather_faked( void (*add)(const void*, size_t, int), int requester,
722               size_t length, int level )
723 {
724     static int initialized=0;
725     size_t n;
726     char *buffer, *p;
727
728     if( !initialized ) {
729         log_info(_("WARNING: using insecure random number generator!!\n"));
730         tty_printf(_("The random number generator is only a kludge to let\n"
731                    "it run - it is in no way a strong RNG!\n\n"
732                    "DON'T USE ANY DATA GENERATED BY THIS PROGRAM!!\n\n"));
733         initialized=1;
734 #ifdef HAVE_RAND
735         srand(make_timestamp()*getpid());
736 #else
737         srandom(make_timestamp()*getpid());
738 #endif
739     }
740
741     p = buffer = xmalloc( length );
742     n = length;
743 #ifdef HAVE_RAND
744     while( n-- )
745         *p++ = ((unsigned)(1 + (int) (256.0*rand()/(RAND_MAX+1.0)))-1);
746 #else
747     while( n-- )
748         *p++ = ((unsigned)(1 + (int) (256.0*random()/(RAND_MAX+1.0)))-1);
749 #endif
750     add_randomness( buffer, length, requester );
751     xfree(buffer);
752     return 0; /* okay */
753 }