OPENSSL_FILE(3ossl)

💖 OPENSSL_FILE(3ossl) — the OpenSSL macros bestie 💖

okay so bestie, gather round, we're talking about generic C programming utility macros and honestly? they're little icons. this is the OpenSSL manual page, version 3.5.9, and it's short and sweet and we're gonna get through it together, no cap. 🎀

---

✨ NAME ✨

OPENSSL_FILE, OPENSSL_LINE, OPENSSL_FUNC, OPENSSL_MSTR, OPENSSL_MSTR_HELPER — generic C programming utility macros 🦋

like. that's the whole squad. five macros. all of them useful. periodt.

---

🌸 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)

look at that. gorgeous. textbook. 💅

---

💜 DESCRIPTION 💜

so the macros OPENSSL_FILE and OPENSSL_LINE typically yield the current filename and line number during C compilation, which is lowkey the most helpful thing ever when something explodes and you need to know where. but — plot twist — when OPENSSL_NO_FILENAMES is defined, they yield "" and 0, respectively. so like, the info just dips. 🙈

the macro OPENSSL_FUNC attempts to yield the name of the C function currently being compiled, as far as language and compiler versions allow. and if they don't allow? if the vibes are simply not there? it yields "(unknown function)". which is honestly the most relatable string in all of OpenSSL. 😭

the macro OPENSSL_MSTR yields the expansion of the macro given as argument, which is useful for concatenation with string constants — that's its whole thing, that's its main character moment. and the macro OPENSSL_MSTR_HELPER is an auxiliary macro for this purpose. the helper. the supportive bestie of the group. 🫶

---

⭐ RETURN VALUES ⭐

see above 👆 like, literally scroll up, the answers are right there bestie, i'm not repeating myself.

---

🦋 SEE ALSO 🦋

• crypto(7) — go read it, it's giving foundational knowledge ✨

---

👑 HISTORY 👑

OPENSSL_FUNC, OPENSSL_MSTR, and OPENSSL_MSTR_HELPER were added in OpenSSL 3.0. glow up era. 🎀

---

🌈 COPYRIGHT 🌈

Copyright 2018-2019 The OpenSSL Project Authors. All Rights Reserved. 💖

Licensed under the Apache License 2.0 (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.

fr fr read the license, bestie. it's not a vibe suggestion, it's the rules. 💀

---

okay that's the whole page!! ✨ this was OpenSSL 3.5.9, dated 2026-09-29, manual page OPENSSL_FILE(3ossl) — and that's a wrap, mwah 💅🫶🌸