OPENSSL_FILE.3ossl - Man Page

generic C programming utility macros

Synopsis

 #include <openssl/macros.h>

 #define OPENSSL_FILE /* typically: __FILE__ */
 #define OPENSSL_LINE /* typically: __LINE__ */
 #define OPENSSL_FUNC /* typically: __func__ */

 #define OPENSSL_MSTR_HELPER(x) #x
 #define OPENSSL_MSTR(x) OPENSSL_MSTR_HELPER(x)

Description

The macros OPENSSL_FILE and OPENSSL_LINE typically yield the current filename and line number during C compilation. When OPENSSL_NO_FILENAMES is defined they yield "" and 0, respectively.

The macro OPENSSL_FUNC attempts to yield the name of the C function currently being compiled, as far as language and compiler versions allow. Otherwise, it yields “(unknown function)”.

The macro OPENSSL_MSTR yields the expansion of the macro given as argument, which is useful for concatenation with string constants. The macro OPENSSL_MSTR_HELPER is an auxiliary macro for this purpose.

Return Values

see above

See Also

crypto(7)

History

OPENSSL_FUNC, OPENSSL_MSTR, and OPENSSL_MSTR_HELPER were added in OpenSSL 3.0.

Referenced By

The man pages OPENSSL_FUNC.3ossl(3), OPENSSL_LINE.3ossl(3), OPENSSL_MSTR.3ossl(3) and OPENSSL_MSTR_HELPER.3ossl(3) are aliases of OPENSSL_FILE.3ossl(3).

2021-09-09 3.0.0 OpenSSL