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