RAND: Rename the RAND_poll_ex() callback and its typedef
[openssl.git] / e_os.h
1 /*
2  * Copyright 1995-2017 The OpenSSL Project Authors. All Rights Reserved.
3  *
4  * Licensed under the OpenSSL license (the "License").  You may not use
5  * this file except in compliance with the License.  You can obtain a copy
6  * in the file LICENSE in the source distribution or at
7  * https://www.openssl.org/source/license.html
8  */
9
10 #ifndef HEADER_E_OS_H
11 # define HEADER_E_OS_H
12
13 # include <openssl/opensslconf.h>
14
15 # include <openssl/e_os2.h>
16 # include <openssl/crypto.h>
17 # include "internal/nelem.h"
18
19 /*
20  * <openssl/e_os2.h> contains what we can justify to make visible to the
21  * outside; this file e_os.h is not part of the exported interface.
22  */
23
24 #ifdef  __cplusplus
25 extern "C" {
26 #endif
27
28 /* Used to checking reference counts, most while doing perl5 stuff :-) */
29 # if defined(OPENSSL_NO_STDIO)
30 #  if defined(REF_PRINT)
31 #   error "REF_PRINT requires stdio"
32 #  endif
33 # endif
34
35 /*
36  * Format specifier for printing size_t. Original conundrum was to
37  * get it working with -Wformat [-Werror], which can be considered
38  * overzealous, especially in multi-platform context, but it's
39  * conscious choice...
40  */
41 # if defined(_WIN64)
42 #  define OSSLzu  "I64u"    /* One would expect _WIN{64|32} cases after
43                              * __STDC_VERSION__, but there are corner
44                              * cases of MinGW compilers that link with
45                              * non-compliant MSVCRT.DLL... */
46 # elif defined(_WIN32)
47 #  define OSSLzu  "u"
48 # elif defined(__VMS)
49 #  define OSSLzu  "u"       /* VMS suffers from similar problem as MinGW,
50                              * i.e. C RTL falling behind compiler. Recall
51                              * that sizeof(size_t)==4 even in LP64 case. */
52 # elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
53 #  define OSSLzu  "zu"
54 # elif defined(__SIZEOF_SIZE_T__) && __SIZEOF_SIZE_T__==4
55 #  define OSSLzu  "u"       /* 'lu' should have worked, but when generating
56                              * 32-bit code gcc still complains :-( */
57 # else
58 #  define OSSLzu  "lu"      /* To see that is works recall what does L
59                              * stand for in ILP32 and LP64 */
60 # endif
61
62 # if !defined(NDEBUG) && !defined(OPENSSL_NO_STDIO)
63 #  define REF_ASSERT_ISNT(test) \
64     (void)((test) ? (OPENSSL_die("refcount error", __FILE__, __LINE__), 1) : 0)
65 # else
66 #  define REF_ASSERT_ISNT(i)
67 # endif
68 # ifdef REF_PRINT
69 #  define REF_PRINT_COUNT(a, b) \
70         fprintf(stderr, "%p:%4d:%s\n", b, b->references, a)
71 # else
72 #  define REF_PRINT_COUNT(a, b)
73 # endif
74
75 # define OPENSSL_CONF        "openssl.cnf"
76
77 # ifndef DEVRANDOM
78 /*
79  * set this to a comma-separated list of 'random' device files to try out. By
80  * default, we will try to read at least one of these files
81  */
82 #  define DEVRANDOM "/dev/urandom","/dev/random","/dev/srandom"
83 # endif
84 # if !defined(OPENSSL_NO_EGD) && !defined(DEVRANDOM_EGD)
85 /*
86  * set this to a comma-separated list of 'egd' sockets to try out. These
87  * sockets will be tried in the order listed in case accessing the device
88  * files listed in DEVRANDOM did not return enough randomness.
89  */
90 #  define DEVRANDOM_EGD "/var/run/egd-pool","/dev/egd-pool","/etc/egd-pool","/etc/entropy"
91 # endif
92
93 # if defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_UEFI)
94 #  define NO_CHMOD
95 #  define NO_SYSLOG
96 # endif
97
98 # define get_last_sys_error()    errno
99 # define clear_sys_error()       errno=0
100
101 /********************************************************************
102  The Microsoft section
103  ********************************************************************/
104 # if defined(OPENSSL_SYS_WIN32) && !defined(WIN32)
105 #  define WIN32
106 # endif
107 # if defined(OPENSSL_SYS_WINDOWS) && !defined(WINDOWS)
108 #  define WINDOWS
109 # endif
110 # if defined(OPENSSL_SYS_MSDOS) && !defined(MSDOS)
111 #  define MSDOS
112 # endif
113
114 # ifdef WIN32
115 #  undef get_last_sys_error
116 #  undef clear_sys_error
117 #  define get_last_sys_error()    GetLastError()
118 #  define clear_sys_error()       SetLastError(0)
119 #  if !defined(WINNT)
120 #   define WIN_CONSOLE_BUG
121 #  endif
122 # else
123 # endif
124
125 # if (defined(WINDOWS) || defined(MSDOS))
126
127 #  ifdef __DJGPP__
128 #   include <unistd.h>
129 #   include <sys/stat.h>
130 #   define _setmode setmode
131 #   define _O_TEXT O_TEXT
132 #   define _O_BINARY O_BINARY
133 #   define HAS_LFN_SUPPORT(name)  (pathconf((name), _PC_NAME_MAX) > 12)
134 #   undef DEVRANDOM_EGD  /*  Neither MS-DOS nor FreeDOS provide 'egd' sockets.  */
135 #   undef DEVRANDOM
136 #   define DEVRANDOM "/dev/urandom\x24"
137 #  endif                        /* __DJGPP__ */
138
139 #  ifndef S_IFDIR
140 #   define S_IFDIR     _S_IFDIR
141 #  endif
142
143 #  ifndef S_IFMT
144 #   define S_IFMT      _S_IFMT
145 #  endif
146
147 #  if !defined(WINNT) && !defined(__DJGPP__)
148 #   define NO_SYSLOG
149 #  endif
150
151 #  ifdef WINDOWS
152 #   if !defined(_WIN32_WCE) && !defined(_WIN32_WINNT)
153        /*
154         * Defining _WIN32_WINNT here in e_os.h implies certain "discipline."
155         * Most notably we ought to check for availability of each specific
156         * routine that was introduced after denoted _WIN32_WINNT with
157         * GetProcAddress(). Normally newer functions are masked with higher
158         * _WIN32_WINNT in SDK headers. So that if you wish to use them in
159         * some module, you'd need to override _WIN32_WINNT definition in
160         * the target module in order to "reach for" prototypes, but replace
161         * calls to new functions with indirect calls. Alternatively it
162         * might be possible to achieve the goal by /DELAYLOAD-ing .DLLs
163         * and check for current OS version instead.
164         */
165 #    define _WIN32_WINNT 0x0501
166 #   endif
167 #   if defined(_WIN32_WINNT) || defined(_WIN32_WCE)
168        /*
169         * Just like defining _WIN32_WINNT including winsock2.h implies
170         * certain "discipline" for maintaining [broad] binary compatibility.
171         * As long as structures are invariant among Winsock versions,
172         * it's sufficient to check for specific Winsock2 API availability
173         * at run-time [DSO_global_lookup is recommended]...
174         */
175 #    include <winsock2.h>
176 #    include <ws2tcpip.h>
177        /* yes, they have to be #included prior to <windows.h> */
178 #   endif
179 #   include <windows.h>
180 #   include <stdio.h>
181 #   include <stddef.h>
182 #   include <errno.h>
183 #   if defined(_WIN32_WCE) && !defined(EACCES)
184 #    define EACCES   13
185 #   endif
186 #   include <string.h>
187 #   ifdef _WIN64
188 #    define strlen(s) _strlen31(s)
189 /* cut strings to 2GB */
190 static __inline unsigned int _strlen31(const char *str)
191 {
192     unsigned int len = 0;
193     while (*str && len < 0x80000000U)
194         str++, len++;
195     return len & 0x7FFFFFFF;
196 }
197 #   endif
198 #   include <malloc.h>
199 #   if defined(_MSC_VER) && !defined(_WIN32_WCE) && !defined(_DLL) && defined(stdin)
200 #    if _MSC_VER>=1300 && _MSC_VER<1600
201 #     undef stdin
202 #     undef stdout
203 #     undef stderr
204 FILE *__iob_func();
205 #     define stdin  (&__iob_func()[0])
206 #     define stdout (&__iob_func()[1])
207 #     define stderr (&__iob_func()[2])
208 #    elif _MSC_VER<1300 && defined(I_CAN_LIVE_WITH_LNK4049)
209 #     undef stdin
210 #     undef stdout
211 #     undef stderr
212          /*
213           * pre-1300 has __p__iob(), but it's available only in msvcrt.lib,
214           * or in other words with /MD. Declaring implicit import, i.e. with
215           * _imp_ prefix, works correctly with all compiler options, but
216           * without /MD results in LINK warning LNK4049: 'locally defined
217           * symbol "__iob" imported'.
218           */
219 extern FILE *_imp___iob;
220 #     define stdin  (&_imp___iob[0])
221 #     define stdout (&_imp___iob[1])
222 #     define stderr (&_imp___iob[2])
223 #    endif
224 #   endif
225 #  endif
226 #  include <io.h>
227 #  include <fcntl.h>
228
229 #  ifdef OPENSSL_SYS_WINCE
230 #   define OPENSSL_NO_POSIX_IO
231 #  endif
232
233 #  define EXIT(n) exit(n)
234 #  define LIST_SEPARATOR_CHAR ';'
235 #  ifndef W_OK
236 #   define W_OK        2
237 #  endif
238 #  ifndef R_OK
239 #   define R_OK        4
240 #  endif
241 #  ifdef OPENSSL_SYS_WINCE
242 #   define DEFAULT_HOME  ""
243 #  else
244 #   define DEFAULT_HOME  "C:"
245 #  endif
246
247 /* Avoid Visual Studio 13 GetVersion deprecated problems */
248 #  if defined(_MSC_VER) && _MSC_VER>=1800
249 #   define check_winnt() (1)
250 #   define check_win_minplat(x) (1)
251 #  else
252 #   define check_winnt() (GetVersion() < 0x80000000)
253 #   define check_win_minplat(x) (LOBYTE(LOWORD(GetVersion())) >= (x))
254 #  endif
255
256 # else                          /* The non-microsoft world */
257
258 #  ifdef OPENSSL_SYS_VMS
259 #   define VMS 1
260   /*
261    * some programs don't include stdlib, so exit() and others give implicit
262    * function warnings
263    */
264 #   include <stdlib.h>
265 #   if defined(__DECC)
266 #    include <unistd.h>
267 #   else
268 #    include <unixlib.h>
269 #   endif
270 #   define LIST_SEPARATOR_CHAR ','
271   /* We don't have any well-defined random devices on VMS, yet... */
272 #   undef DEVRANDOM
273   /*-
274      We need to do this since VMS has the following coding on status codes:
275
276      Bits 0-2: status type: 0 = warning, 1 = success, 2 = error, 3 = info ...
277                The important thing to know is that odd numbers are considered
278                good, while even ones are considered errors.
279      Bits 3-15: actual status number
280      Bits 16-27: facility number.  0 is considered "unknown"
281      Bits 28-31: control bits.  If bit 28 is set, the shell won't try to
282                  output the message (which, for random codes, just looks ugly)
283
284      So, what we do here is to change 0 to 1 to get the default success status,
285      and everything else is shifted up to fit into the status number field, and
286      the status is tagged as an error, which is what is wanted here.
287
288      Finally, we add the VMS C facility code 0x35a000, because there are some
289      programs, such as Perl, that will reinterpret the code back to something
290      POSIXly.  'man perlvms' explains it further.
291
292      NOTE: the perlvms manual wants to turn all codes 2 to 255 into success
293      codes (status type = 1).  I couldn't disagree more.  Fortunately, the
294      status type doesn't seem to bother Perl.
295      -- Richard Levitte
296   */
297 #   define EXIT(n)  exit((n) ? (((n) << 3) | 2 | 0x10000000 | 0x35a000) : 1)
298
299 #   define DEFAULT_HOME "SYS$LOGIN:"
300
301 #  else
302      /* !defined VMS */
303 #   ifdef OPENSSL_UNISTD
304 #    include OPENSSL_UNISTD
305 #   else
306 #    include <unistd.h>
307 #   endif
308 #   include <sys/types.h>
309 #   ifdef OPENSSL_SYS_WIN32_CYGWIN
310 #    include <io.h>
311 #    include <fcntl.h>
312 #   endif
313
314 #   define LIST_SEPARATOR_CHAR ':'
315 #   define EXIT(n)             exit(n)
316 #  endif
317
318 # endif
319
320 /***********************************************/
321
322 # if defined(OPENSSL_SYS_WINDOWS)
323 #  define strcasecmp _stricmp
324 #  define strncasecmp _strnicmp
325 #  if (_MSC_VER >= 1310)
326 #   define open _open
327 #   define fdopen _fdopen
328 #   define close _close
329 #   ifndef strdup
330 #    define strdup _strdup
331 #   endif
332 #   define unlink _unlink
333 #   define fileno _fileno
334 #  endif
335 # else
336 #  include <strings.h>
337 # endif
338
339 /* vxworks */
340 # if defined(OPENSSL_SYS_VXWORKS)
341 #  include <ioLib.h>
342 #  include <tickLib.h>
343 #  include <sysLib.h>
344 #  include <vxWorks.h>
345 #  include <sockLib.h>
346 #  include <taskLib.h>
347
348 #  define TTY_STRUCT int
349 #  define sleep(a) taskDelay((a) * sysClkRateGet())
350
351 /*
352  * NOTE: these are implemented by helpers in database app! if the database is
353  * not linked, we need to implement them elsewhere
354  */
355 struct hostent *gethostbyname(const char *name);
356 struct hostent *gethostbyaddr(const char *addr, int length, int type);
357 struct servent *getservbyname(const char *name, const char *proto);
358
359 # endif
360 /* end vxworks */
361
362 #ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
363 # define CRYPTO_memcmp memcmp
364 #endif
365
366 #ifdef  __cplusplus
367 }
368 #endif
369
370 #endif