Further comment changes for reformat (master)
[openssl.git] / crypto / rand / randfile.c
1 /* crypto/rand/randfile.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 "e_os.h"
60
61 /* We need to define this to get macros like S_IFBLK and S_IFCHR */
62 #if !defined(OPENSSL_SYS_VXWORKS)
63 #define _XOPEN_SOURCE 500
64 #endif
65
66 #include <errno.h>
67 #include <stdio.h>
68 #include <stdlib.h>
69 #include <string.h>
70
71 #include <openssl/crypto.h>
72 #include <openssl/rand.h>
73 #include <openssl/buffer.h>
74
75 #ifdef OPENSSL_SYS_VMS
76 #include <unixio.h>
77 #endif
78 #ifndef NO_SYS_TYPES_H
79 # include <sys/types.h>
80 #endif
81 #ifndef OPENSSL_NO_POSIX_IO
82 # include <sys/stat.h>
83 # include <fcntl.h>
84 #endif
85
86 #ifdef _WIN32
87 #define stat    _stat
88 #define chmod   _chmod
89 #define open    _open
90 #define fdopen  _fdopen
91 #endif
92
93 #undef BUFSIZE
94 #define BUFSIZE 1024
95 #define RAND_DATA 1024
96
97 #ifdef OPENSSL_SYS_VMS
98 /* This declaration is a nasty hack to get around vms' extension to fopen
99  * for passing in sharing options being disabled by our /STANDARD=ANSI89 */
100 static FILE *(*const vms_fopen)(const char *, const char *, ...) =
101     (FILE *(*)(const char *, const char *, ...))fopen;
102 #define VMS_OPEN_ATTRS "shr=get,put,upd,del","ctx=bin,stm","rfm=stm","rat=none","mrs=0"
103 #endif
104
105 /* #define RFILE ".rnd" - defined in ../../e_os.h */
106
107 /* Note that these functions are intended for seed files only.
108  * Entropy devices and EGD sockets are handled in rand_unix.c */
109
110 int RAND_load_file(const char *file, long bytes)
111         {
112         /*-
113          * If bytes >= 0, read up to 'bytes' bytes.
114          * if bytes == -1, read complete file.
115          */
116
117         MS_STATIC unsigned char buf[BUFSIZE];
118 #ifndef OPENSSL_NO_POSIX_IO
119         struct stat sb;
120 #endif
121         int i,ret=0,n;
122         FILE *in;
123
124         if (file == NULL) return(0);
125
126 #ifndef OPENSSL_NO_POSIX_IO
127 #ifdef PURIFY
128         /* struct stat can have padding and unused fields that may not be
129          * initialized in the call to stat(). We need to clear the entire
130          * structure before calling RAND_add() to avoid complaints from
131          * applications such as Valgrind.
132          */
133         memset(&sb, 0, sizeof(sb));
134 #endif
135         if (stat(file,&sb) < 0) return(0);
136         RAND_add(&sb,sizeof(sb),0.0);
137 #endif
138         if (bytes == 0) return(ret);
139
140 #ifdef OPENSSL_SYS_VMS
141         in=vms_fopen(file,"rb",VMS_OPEN_ATTRS);
142 #else
143         in=fopen(file,"rb");
144 #endif
145         if (in == NULL) goto err;
146 #if defined(S_IFBLK) && defined(S_IFCHR) && !defined(OPENSSL_NO_POSIX_IO)
147         if (sb.st_mode & (S_IFBLK | S_IFCHR)) {
148           /* this file is a device. we don't want read an infinite number
149            * of bytes from a random device, nor do we want to use buffered
150            * I/O because we will waste system entropy. 
151            */
152           bytes = (bytes == -1) ? 2048 : bytes; /* ok, is 2048 enough? */
153 #ifndef OPENSSL_NO_SETVBUF_IONBF
154           setvbuf(in, NULL, _IONBF, 0); /* don't do buffered reads */
155 #endif /* ndef OPENSSL_NO_SETVBUF_IONBF */
156         }
157 #endif
158         for (;;)
159                 {
160                 if (bytes > 0)
161                         n = (bytes < BUFSIZE)?(int)bytes:BUFSIZE;
162                 else
163                         n = BUFSIZE;
164                 i=fread(buf,1,n,in);
165                 if (i <= 0) break;
166 #ifdef PURIFY
167                 RAND_add(buf,i,(double)i);
168 #else
169                 /* even if n != i, use the full array */
170                 RAND_add(buf,n,(double)i);
171 #endif
172                 ret+=i;
173                 if (bytes > 0)
174                         {
175                         bytes-=n;
176                         if (bytes <= 0) break;
177                         }
178                 }
179         fclose(in);
180         OPENSSL_cleanse(buf,BUFSIZE);
181 err:
182         return(ret);
183         }
184
185 int RAND_write_file(const char *file)
186         {
187         unsigned char buf[BUFSIZE];
188         int i,ret=0,rand_err=0;
189         FILE *out = NULL;
190         int n;
191 #ifndef OPENSSL_NO_POSIX_IO
192         struct stat sb;
193         
194         i=stat(file,&sb);
195         if (i != -1) { 
196 #if defined(S_ISBLK) && defined(S_ISCHR)
197           if (S_ISBLK(sb.st_mode) || S_ISCHR(sb.st_mode)) {
198             /* this file is a device. we don't write back to it. 
199              * we "succeed" on the assumption this is some sort 
200              * of random device. Otherwise attempting to write to 
201              * and chmod the device causes problems.
202              */
203             return(1); 
204           }
205 #endif
206         }
207 #endif
208
209 #if defined(O_CREAT) && !defined(OPENSSL_NO_POSIX_IO) && !defined(OPENSSL_SYS_VMS)
210         {
211 #ifndef O_BINARY
212 #define O_BINARY 0
213 #endif
214         /* chmod(..., 0600) is too late to protect the file,
215          * permissions should be restrictive from the start */
216         int fd = open(file, O_WRONLY|O_CREAT|O_BINARY, 0600);
217         if (fd != -1)
218                 out = fdopen(fd, "wb");
219         }
220 #endif
221
222 #ifdef OPENSSL_SYS_VMS
223         /* VMS NOTE: Prior versions of this routine created a _new_
224          * version of the rand file for each call into this routine, then
225          * deleted all existing versions named ;-1, and finally renamed
226          * the current version as ';1'. Under concurrent usage, this
227          * resulted in an RMS race condition in rename() which could
228          * orphan files (see vms message help for RMS$_REENT). With the
229          * fopen() calls below, openssl/VMS now shares the top-level
230          * version of the rand file. Note that there may still be
231          * conditions where the top-level rand file is locked. If so, this
232          * code will then create a new version of the rand file. Without
233          * the delete and rename code, this can result in ascending file
234          * versions that stop at version 32767, and this routine will then
235          * return an error. The remedy for this is to recode the calling
236          * application to avoid concurrent use of the rand file, or
237          * synchronize usage at the application level. Also consider
238          * whether or not you NEED a persistent rand file in a concurrent
239          * use situation. 
240          */
241
242         out = vms_fopen(file,"rb+",VMS_OPEN_ATTRS);
243         if (out == NULL)
244                 out = vms_fopen(file,"wb",VMS_OPEN_ATTRS);
245 #else
246         if (out == NULL)
247                 out = fopen(file,"wb");
248 #endif
249         if (out == NULL) goto err;
250
251 #ifndef NO_CHMOD
252         chmod(file,0600);
253 #endif
254         n=RAND_DATA;
255         for (;;)
256                 {
257                 i=(n > BUFSIZE)?BUFSIZE:n;
258                 n-=BUFSIZE;
259                 if (RAND_bytes(buf,i) <= 0)
260                         rand_err=1;
261                 i=fwrite(buf,1,i,out);
262                 if (i <= 0)
263                         {
264                         ret=0;
265                         break;
266                         }
267                 ret+=i;
268                 if (n <= 0) break;
269                 }
270
271         fclose(out);
272         OPENSSL_cleanse(buf,BUFSIZE);
273 err:
274         return (rand_err ? -1 : ret);
275         }
276
277 const char *RAND_file_name(char *buf, size_t size)
278         {
279         char *s=NULL;
280 #ifdef __OpenBSD__
281         struct stat sb;
282 #endif
283
284         if (OPENSSL_issetugid() == 0)
285                 s=getenv("RANDFILE");
286         if (s != NULL && *s && strlen(s) + 1 < size)
287                 {
288                 if (BUF_strlcpy(buf,s,size) >= size)
289                         return NULL;
290                 }
291         else
292                 {
293                 if (OPENSSL_issetugid() == 0)
294                         s=getenv("HOME");
295 #ifdef DEFAULT_HOME
296                 if (s == NULL)
297                         {
298                         s = DEFAULT_HOME;
299                         }
300 #endif
301                 if (s && *s && strlen(s)+strlen(RFILE)+2 < size)
302                         {
303                         BUF_strlcpy(buf,s,size);
304 #ifndef OPENSSL_SYS_VMS
305                         BUF_strlcat(buf,"/",size);
306 #endif
307                         BUF_strlcat(buf,RFILE,size);
308                         }
309                 else
310                         buf[0] = '\0'; /* no file name */
311                 }
312
313 #ifdef __OpenBSD__
314         /* given that all random loads just fail if the file can't be 
315          * seen on a stat, we stat the file we're returning, if it
316          * fails, use /dev/arandom instead. this allows the user to 
317          * use their own source for good random data, but defaults
318          * to something hopefully decent if that isn't available. 
319          */
320
321         if (!buf[0])
322                 if (BUF_strlcpy(buf,"/dev/arandom",size) >= size) {
323                         return(NULL);
324                 }       
325         if (stat(buf,&sb) == -1)
326                 if (BUF_strlcpy(buf,"/dev/arandom",size) >= size) {
327                         return(NULL);
328                 }       
329
330 #endif
331         return(buf);
332         }