openssl/test/test_main.h

/*
 * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved.
 *
 * Licensed under the OpenSSL license (the "License").  You may not use
 * this file except in compliance with the License.  You can obtain a copy
 * in the file LICENSE in the source distribution or at
 * https://www.openssl.org/source/license.html
 */

#ifndef HEADER_TEST_MAIN_H
# define HEADER_TEST_MAIN_H

/*
 * Simple unit tests should implement register_tests() and link to test_main.c.
 */
extern void register_tests(void);

#endif  /* HEADER_TEST_MAIN_H */
Add main() test methods to reduce test boilerplate. Simple tests only need to implement register_tests(). Tests that need a custom main() should implement test_main(). This will be wrapped in a main() that performs common setup/teardown (currently crypto-mdebug). Note that for normal development, enable-asan is usually sufficient for detecting leaks, and more versatile. enable-crypto-mdebug is stricter as it will also insist that all static variables be freed. This is useful for debugging library init/deinit; however, it also means that test_main() must free everything it allocates. Reviewed-by: Richard Levitte <levitte@openssl.org> Reviewed-by: Rich Salz <rsalz@openssl.org> 2016-11-07 23:53:15 +08:00			`/*`
			`* Copyright 2016 The OpenSSL Project Authors. All Rights Reserved.`
			`*`
			`* Licensed under the OpenSSL license (the "License"). You may not use`
			`* this file except in compliance with the License. You can obtain a copy`
			`* in the file LICENSE in the source distribution or at`
			`* https://www.openssl.org/source/license.html`
			`*/`

			`#ifndef HEADER_TEST_MAIN_H`
			`# define HEADER_TEST_MAIN_H`

			`/*`
			`* Simple unit tests should implement register_tests() and link to test_main.c.`
			`*/`
			`extern void register_tests(void);`

			`#endif /* HEADER_TEST_MAIN_H */`