xref: /freebsd/crypto/openssl/test/testutil/tests.c (revision 0d0c8621fd181e507f0fb50ffcca606faf66a8c2)
1  /*
2   * Copyright 2017-2025 The OpenSSL Project Authors. All Rights Reserved.
3   *
4   * Licensed under the Apache License 2.0 (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  #include "../testutil.h"
11  #include "output.h"
12  #include "tu_local.h"
13  
14  #include <errno.h>
15  #include <string.h>
16  #include <ctype.h>
17  #include "internal/nelem.h"
18  #include <openssl/asn1.h>
19  
20  /*
21   * Output a failed test first line.
22   * All items are optional are generally not preinted if passed as NULL.
23   * The special cases are for prefix where "ERROR" is assumed and for left
24   * and right where a non-failure message is produced if either is NULL.
25   */
test_fail_message_prefix(const char * prefix,const char * file,int line,const char * type,const char * left,const char * right,const char * op)26  void test_fail_message_prefix(const char *prefix, const char *file,
27                                int line, const char *type,
28                                const char *left, const char *right,
29                                const char *op)
30  {
31      test_printf_stderr("%s: ", prefix != NULL ? prefix : "ERROR");
32      if (type)
33          test_printf_stderr("(%s) ", type);
34      if (op != NULL) {
35          if (left != NULL && right != NULL)
36              test_printf_stderr("'%s %s %s' failed", left, op, right);
37          else
38              test_printf_stderr("'%s'", op);
39      }
40      if (file != NULL) {
41          test_printf_stderr(" @ %s:%d", file, line);
42      }
43      test_printf_stderr("\n");
44  }
45  
46  /*
47   * A common routine to output test failure messages.  Generally this should not
48   * be called directly, rather it should be called by the following functions.
49   *
50   * |desc| is a printf formatted description with arguments |args| that is
51   * supplied by the user and |desc| can be NULL.  |type| is the data type
52   * that was tested (int, char, ptr, ...).  |fmt| is a system provided
53   * printf format with following arguments that spell out the failure
54   * details i.e. the actual values compared and the operator used.
55   *
56   * The typical use for this is from an utility test function:
57   *
58   * int test6(const char *file, int line, int n) {
59   *     if (n != 6) {
60   *         test_fail_message(1, file, line, "int", "value %d is not %d", n, 6);
61   *         return 0;
62   *     }
63   *     return 1;
64   * }
65   *
66   * calling test6(3, "oops") will return 0 and produce out along the lines of:
67   *      FAIL oops: (int) value 3 is not 6\n
68   */
69  static void test_fail_message(const char *prefix, const char *file, int line,
70                                const char *type, const char *left,
71                                const char *right, const char *op,
72                                const char *fmt, ...)
73              PRINTF_FORMAT(8, 9);
74  
test_fail_message_va(const char * prefix,const char * file,int line,const char * type,const char * left,const char * right,const char * op,const char * fmt,va_list ap)75  static void test_fail_message_va(const char *prefix, const char *file,
76                                   int line, const char *type,
77                                   const char *left, const char *right,
78                                   const char *op, const char *fmt, va_list ap)
79  {
80      test_fail_message_prefix(prefix, file, line, type, left, right, op);
81      if (fmt != NULL) {
82          test_vprintf_stderr(fmt, ap);
83          test_printf_stderr("\n");
84      }
85      test_flush_stderr();
86  }
87  
test_fail_message(const char * prefix,const char * file,int line,const char * type,const char * left,const char * right,const char * op,const char * fmt,...)88  static void test_fail_message(const char *prefix, const char *file,
89                                int line, const char *type,
90                                const char *left, const char *right,
91                                const char *op, const char *fmt, ...)
92  {
93      va_list ap;
94  
95      va_start(ap, fmt);
96      test_fail_message_va(prefix, file, line, type, left, right, op, fmt, ap);
97      va_end(ap);
98  }
99  
test_info_c90(const char * desc,...)100  void test_info_c90(const char *desc, ...)
101  {
102      va_list ap;
103  
104      va_start(ap, desc);
105      test_fail_message_va("INFO", NULL, -1, NULL, NULL, NULL, NULL, desc, ap);
106      va_end(ap);
107  }
108  
test_info(const char * file,int line,const char * desc,...)109  void test_info(const char *file, int line, const char *desc, ...)
110  {
111      va_list ap;
112  
113      va_start(ap, desc);
114      test_fail_message_va("INFO", file, line, NULL, NULL, NULL, NULL, desc, ap);
115      va_end(ap);
116  }
117  
test_error_c90(const char * desc,...)118  void test_error_c90(const char *desc, ...)
119  {
120      va_list ap;
121  
122      va_start(ap, desc);
123      test_fail_message_va(NULL, NULL, -1, NULL, NULL, NULL, NULL, desc, ap);
124      va_end(ap);
125      test_printf_stderr("\n");
126  }
127  
test_error(const char * file,int line,const char * desc,...)128  void test_error(const char *file, int line, const char *desc, ...)
129  {
130      va_list ap;
131  
132      va_start(ap, desc);
133      test_fail_message_va(NULL, file, line, NULL, NULL, NULL, NULL, desc, ap);
134      va_end(ap);
135      test_printf_stderr("\n");
136  }
137  
test_perror(const char * s)138  void test_perror(const char *s)
139  {
140      /*
141       * Using openssl_strerror_r causes linking issues since it isn't
142       * exported from libcrypto.so
143       */
144      TEST_error("%s: %s", s, strerror(errno));
145  }
146  
test_note(const char * fmt,...)147  void test_note(const char *fmt, ...)
148  {
149      test_flush_stdout();
150      if (fmt != NULL) {
151          va_list ap;
152  
153          va_start(ap, fmt);
154          test_vprintf_stderr(fmt, ap);
155          va_end(ap);
156          test_printf_stderr("\n");
157      }
158      test_flush_stderr();
159  }
160  
161  
test_skip(const char * file,int line,const char * desc,...)162  int test_skip(const char *file, int line, const char *desc, ...)
163  {
164      va_list ap;
165  
166      va_start(ap, desc);
167      test_fail_message_va("SKIP", file, line, NULL, NULL, NULL, NULL, desc, ap);
168      va_end(ap);
169      return TEST_SKIP_CODE;
170  }
171  
test_skip_c90(const char * desc,...)172  int test_skip_c90(const char *desc, ...)
173  {
174      va_list ap;
175  
176      va_start(ap, desc);
177      test_fail_message_va("SKIP", NULL, -1, NULL, NULL, NULL, NULL, desc, ap);
178      va_end(ap);
179      test_printf_stderr("\n");
180      return TEST_SKIP_CODE;
181  }
182  
183  
test_openssl_errors(void)184  void test_openssl_errors(void)
185  {
186      ERR_print_errors_cb(openssl_error_cb, NULL);
187      ERR_clear_error();
188  }
189  
190  /*
191   * Define some comparisons between pairs of various types.
192   * These functions return 1 if the test is true.
193   * Otherwise, they return 0 and pretty-print diagnostics.
194   *
195   * In each case the functions produced are:
196   *  int test_name_eq(const type t1, const type t2, const char *desc, ...);
197   *  int test_name_ne(const type t1, const type t2, const char *desc, ...);
198   *  int test_name_lt(const type t1, const type t2, const char *desc, ...);
199   *  int test_name_le(const type t1, const type t2, const char *desc, ...);
200   *  int test_name_gt(const type t1, const type t2, const char *desc, ...);
201   *  int test_name_ge(const type t1, const type t2, const char *desc, ...);
202   *
203   * The t1 and t2 arguments are to be compared for equality, inequality,
204   * less than, less than or equal to, greater than and greater than or
205   * equal to respectively.  If the specified condition holds, the functions
206   * return 1.  If the condition does not hold, the functions print a diagnostic
207   * message and return 0.
208   *
209   * The desc argument is a printf format string followed by its arguments and
210   * this is included in the output if the condition being tested for is false.
211   */
212  #define DEFINE_COMPARISON(type, name, opname, op, fmt)                  \
213      int test_ ## name ## _ ## opname(const char *file, int line,        \
214                                       const char *s1, const char *s2,    \
215                                       const type t1, const type t2)      \
216      {                                                                   \
217          if (t1 op t2)                                                   \
218              return 1;                                                   \
219          test_fail_message(NULL, file, line, #type, s1, s2, #op,         \
220                            "[" fmt "] compared to [" fmt "]",            \
221                            t1, t2);                                      \
222          return 0;                                                       \
223      }
224  
225  #define DEFINE_COMPARISONS(type, name, fmt)                             \
226      DEFINE_COMPARISON(type, name, eq, ==, fmt)                          \
227      DEFINE_COMPARISON(type, name, ne, !=, fmt)                          \
228      DEFINE_COMPARISON(type, name, lt, <, fmt)                           \
229      DEFINE_COMPARISON(type, name, le, <=, fmt)                          \
230      DEFINE_COMPARISON(type, name, gt, >, fmt)                           \
231      DEFINE_COMPARISON(type, name, ge, >=, fmt)
232  
233  DEFINE_COMPARISONS(int, int, "%d")
234  DEFINE_COMPARISONS(unsigned int, uint, "%u")
235  DEFINE_COMPARISONS(char, char, "%c")
236  DEFINE_COMPARISONS(unsigned char, uchar, "%u")
237  DEFINE_COMPARISONS(long, long, "%ld")
238  DEFINE_COMPARISONS(unsigned long, ulong, "%lu")
239  DEFINE_COMPARISONS(size_t, size_t, "%zu")
240  DEFINE_COMPARISONS(double, double, "%g")
241  
242  DEFINE_COMPARISON(void *, ptr, eq, ==, "%p")
243  DEFINE_COMPARISON(void *, ptr, ne, !=, "%p")
244  
test_ptr_null(const char * file,int line,const char * s,const void * p)245  int test_ptr_null(const char *file, int line, const char *s, const void *p)
246  {
247      if (p == NULL)
248          return 1;
249      test_fail_message(NULL, file, line, "ptr", s, "NULL", "==", "%p", p);
250      return 0;
251  }
252  
test_ptr(const char * file,int line,const char * s,const void * p)253  int test_ptr(const char *file, int line, const char *s, const void *p)
254  {
255      if (p != NULL)
256          return 1;
257      test_fail_message(NULL, file, line, "ptr", s, "NULL", "!=", "%p", p);
258      return 0;
259  }
260  
test_true(const char * file,int line,const char * s,int b)261  int test_true(const char *file, int line, const char *s, int b)
262  {
263      if (b)
264          return 1;
265      test_fail_message(NULL, file, line, "bool", s, "true", "==", "false");
266      return 0;
267  }
268  
test_false(const char * file,int line,const char * s,int b)269  int test_false(const char *file, int line, const char *s, int b)
270  {
271      if (!b)
272          return 1;
273      test_fail_message(NULL, file, line, "bool", s, "false", "==", "true");
274      return 0;
275  }
276  
test_str_eq(const char * file,int line,const char * st1,const char * st2,const char * s1,const char * s2)277  int test_str_eq(const char *file, int line, const char *st1, const char *st2,
278                  const char *s1, const char *s2)
279  {
280      if (s1 == NULL && s2 == NULL)
281        return 1;
282      if (s1 == NULL || s2 == NULL || strcmp(s1, s2) != 0) {
283          test_fail_string_message(NULL, file, line, "string", st1, st2, "==",
284                                   s1, s1 == NULL ? 0 : strlen(s1),
285                                   s2, s2 == NULL ? 0 : strlen(s2));
286          return 0;
287      }
288      return 1;
289  }
290  
test_str_ne(const char * file,int line,const char * st1,const char * st2,const char * s1,const char * s2)291  int test_str_ne(const char *file, int line, const char *st1, const char *st2,
292                  const char *s1, const char *s2)
293  {
294      if ((s1 == NULL) ^ (s2 == NULL))
295        return 1;
296      if (s1 == NULL || strcmp(s1, s2) == 0) {
297          test_fail_string_message(NULL, file, line, "string", st1, st2, "!=",
298                                   s1, s1 == NULL ? 0 : strlen(s1),
299                                   s2, s2 == NULL ? 0 : strlen(s2));
300          return 0;
301      }
302      return 1;
303  }
304  
test_strn_eq(const char * file,int line,const char * st1,const char * st2,const char * s1,size_t n1,const char * s2,size_t n2)305  int test_strn_eq(const char *file, int line, const char *st1, const char *st2,
306                   const char *s1, size_t n1, const char *s2, size_t n2)
307  {
308      if (s1 == NULL && s2 == NULL)
309        return 1;
310      if (n1 != n2 || s1 == NULL || s2 == NULL || strncmp(s1, s2, n1) != 0) {
311          test_fail_string_message(NULL, file, line, "string", st1, st2, "==",
312                                   s1, s1 == NULL ? 0 : OPENSSL_strnlen(s1, n1),
313                                   s2, s2 == NULL ? 0 : OPENSSL_strnlen(s2, n2));
314          return 0;
315      }
316      return 1;
317  }
318  
test_strn_ne(const char * file,int line,const char * st1,const char * st2,const char * s1,size_t n1,const char * s2,size_t n2)319  int test_strn_ne(const char *file, int line, const char *st1, const char *st2,
320                   const char *s1, size_t n1, const char *s2, size_t n2)
321  {
322      if ((s1 == NULL) ^ (s2 == NULL))
323        return 1;
324      if (n1 != n2 || s1 == NULL || strncmp(s1, s2, n1) == 0) {
325          test_fail_string_message(NULL, file, line, "string", st1, st2, "!=",
326                                   s1, s1 == NULL ? 0 : OPENSSL_strnlen(s1, n1),
327                                   s2, s2 == NULL ? 0 : OPENSSL_strnlen(s2, n2));
328          return 0;
329      }
330      return 1;
331  }
332  
test_mem_eq(const char * file,int line,const char * st1,const char * st2,const void * s1,size_t n1,const void * s2,size_t n2)333  int test_mem_eq(const char *file, int line, const char *st1, const char *st2,
334                  const void *s1, size_t n1, const void *s2, size_t n2)
335  {
336      if (s1 == NULL && s2 == NULL)
337          return 1;
338      if (n1 != n2 || s1 == NULL || s2 == NULL || memcmp(s1, s2, n1) != 0) {
339          test_fail_memory_message(NULL, file, line, "memory", st1, st2, "==",
340                                   s1, n1, s2, n2);
341          return 0;
342      }
343      return 1;
344  }
345  
test_mem_ne(const char * file,int line,const char * st1,const char * st2,const void * s1,size_t n1,const void * s2,size_t n2)346  int test_mem_ne(const char *file, int line, const char *st1, const char *st2,
347                  const void *s1, size_t n1, const void *s2, size_t n2)
348  {
349      if ((s1 == NULL) ^ (s2 == NULL))
350          return 1;
351      if (n1 != n2)
352          return 1;
353      if (s1 == NULL || memcmp(s1, s2, n1) == 0) {
354          test_fail_memory_message(NULL, file, line, "memory", st1, st2, "!=",
355                                   s1, n1, s2, n2);
356          return 0;
357      }
358      return 1;
359  }
360  
361  #define DEFINE_BN_COMPARISONS(opname, op, zero_cond)                    \
362      int test_BN_ ## opname(const char *file, int line,                  \
363                             const char *s1, const char *s2,              \
364                             const BIGNUM *t1, const BIGNUM *t2)          \
365      {                                                                   \
366          if (BN_cmp(t1, t2) op 0)                                        \
367              return 1;                                                   \
368          test_fail_bignum_message(NULL, file, line, "BIGNUM", s1, s2,    \
369                                   #op, t1, t2);                          \
370          return 0;                                                       \
371      }                                                                   \
372      int test_BN_ ## opname ## _zero(const char *file, int line,         \
373                                      const char *s, const BIGNUM *a)     \
374      {                                                                   \
375          if (a != NULL &&(zero_cond))                                    \
376              return 1;                                                   \
377          test_fail_bignum_mono_message(NULL, file, line, "BIGNUM",       \
378                                        s, "0", #op, a);                  \
379          return 0;                                                       \
380      }
381  
382  DEFINE_BN_COMPARISONS(eq, ==, BN_is_zero(a))
383  DEFINE_BN_COMPARISONS(ne, !=, !BN_is_zero(a))
384  DEFINE_BN_COMPARISONS(gt, >,  !BN_is_negative(a) && !BN_is_zero(a))
385  DEFINE_BN_COMPARISONS(ge, >=, !BN_is_negative(a) || BN_is_zero(a))
386  DEFINE_BN_COMPARISONS(lt, <,  BN_is_negative(a) && !BN_is_zero(a))
387  DEFINE_BN_COMPARISONS(le, <=, BN_is_negative(a) || BN_is_zero(a))
388  
test_BN_eq_one(const char * file,int line,const char * s,const BIGNUM * a)389  int test_BN_eq_one(const char *file, int line, const char *s, const BIGNUM *a)
390  {
391      if (a != NULL && BN_is_one(a))
392          return 1;
393      test_fail_bignum_mono_message(NULL, file, line, "BIGNUM", s, "1", "==", a);
394      return 0;
395  }
396  
test_BN_odd(const char * file,int line,const char * s,const BIGNUM * a)397  int test_BN_odd(const char *file, int line, const char *s, const BIGNUM *a)
398  {
399      if (a != NULL && BN_is_odd(a))
400          return 1;
401      test_fail_bignum_mono_message(NULL, file, line, "BIGNUM", "ODD(", ")", s, a);
402      return 0;
403  }
404  
test_BN_even(const char * file,int line,const char * s,const BIGNUM * a)405  int test_BN_even(const char *file, int line, const char *s, const BIGNUM *a)
406  {
407      if (a != NULL && !BN_is_odd(a))
408          return 1;
409      test_fail_bignum_mono_message(NULL, file, line, "BIGNUM", "EVEN(", ")", s,
410                                    a);
411      return 0;
412  }
413  
test_BN_eq_word(const char * file,int line,const char * bns,const char * ws,const BIGNUM * a,BN_ULONG w)414  int test_BN_eq_word(const char *file, int line, const char *bns, const char *ws,
415                      const BIGNUM *a, BN_ULONG w)
416  {
417      BIGNUM *bw;
418  
419      if (a != NULL && BN_is_word(a, w))
420          return 1;
421      if ((bw = BN_new()) != NULL)
422          BN_set_word(bw, w);
423      test_fail_bignum_message(NULL, file, line, "BIGNUM", bns, ws, "==", a, bw);
424      BN_free(bw);
425      return 0;
426  }
427  
test_BN_abs_eq_word(const char * file,int line,const char * bns,const char * ws,const BIGNUM * a,BN_ULONG w)428  int test_BN_abs_eq_word(const char *file, int line, const char *bns,
429                          const char *ws, const BIGNUM *a, BN_ULONG w)
430  {
431      BIGNUM *bw, *aa;
432  
433      if (a != NULL && BN_abs_is_word(a, w))
434          return 1;
435      if ((aa = BN_dup(a)) != NULL)
436          BN_set_negative(aa, 0);
437      if ((bw = BN_new()) != NULL)
438          BN_set_word(bw, w);
439      test_fail_bignum_message(NULL, file, line, "BIGNUM", bns, ws, "abs==",
440                               aa, bw);
441      BN_free(bw);
442      BN_free(aa);
443      return 0;
444  }
445  
print_time(const ASN1_TIME * t)446  static const char *print_time(const ASN1_TIME *t)
447  {
448      return t == NULL ? "<null>" : (const char *)ASN1_STRING_get0_data(t);
449  }
450  
451  #define DEFINE_TIME_T_COMPARISON(opname, op)                            \
452      int test_time_t_ ## opname(const char *file, int line,              \
453                                 const char *s1, const char *s2,          \
454                                 const time_t t1, const time_t t2)        \
455      {                                                                   \
456          ASN1_TIME *at1 = ASN1_TIME_set(NULL, t1);                       \
457          ASN1_TIME *at2 = ASN1_TIME_set(NULL, t2);                       \
458          int r = at1 != NULL && at2 != NULL                              \
459                  && ASN1_TIME_compare(at1, at2) op 0;                    \
460          if (!r)                                                         \
461              test_fail_message(NULL, file, line, "time_t", s1, s2, #op,  \
462                                "[%s] compared to [%s]",                  \
463                                print_time(at1), print_time(at2));        \
464          ASN1_STRING_free(at1);                                          \
465          ASN1_STRING_free(at2);                                          \
466          return r;                                                       \
467      }
468  DEFINE_TIME_T_COMPARISON(eq, ==)
469  DEFINE_TIME_T_COMPARISON(ne, !=)
470  DEFINE_TIME_T_COMPARISON(gt, >)
471  DEFINE_TIME_T_COMPARISON(ge, >=)
472  DEFINE_TIME_T_COMPARISON(lt, <)
473  DEFINE_TIME_T_COMPARISON(le, <=)
474