OSSL_TRACE_GET_CATEGORY_NUM(3ossl)

💖 OSSL_TRACE_GET_CATEGORY_NUM(3ossl) 💖

okay bestie, welcome to the OpenSSL manual, page OSSL_TRACE_GET_CATEGORY_NUM, part of the OpenSSL fam. no cap, this one is short and sweet — it's the little translator duo for tracing categories, and it literally just goes both ways: name → number, number → name. that's it. that's the whole vibe. 🦋

---

✨ NAME ✨

OSSL_trace_get_category_num, OSSL_trace_get_category_name — the OpenSSL tracing information functions. yes, both of them, they come as a set, like matching bestie bracelets. 🎀

---

🌸 SYNOPSIS 🌸

#include <openssl/trace.h>

int OSSL_trace_get_category_num(const char *name);
const char *OSSL_trace_get_category_name(int num);

---

👑 DESCRIPTION 👑

so here's the tea, and it's genuinely simple:

• OSSL_trace_get_category_num() — you hand it a name, it gives you back the category number that goes with it. name in, number out. 💅
• OSSL_trace_get_category_name() — the reverse queen. you hand it a num, she hands you back the category name corresponding to it. number in, name out. 🔥

---

⭐ RETURN VALUES ⭐

• OSSL_trace_get_category_num() — returns the category number if the name you passed is a recognised category name. if it's not recognised? you get -1. rude but fair. 💀
• OSSL_trace_get_category_name() — returns the category name if the num you passed is a recognised category number. if it's not? you get NULL. 😭

lowkey important: unrecognised input is not an error you can ignore — -1 and NULL are the actual, documented ways these functions tell you "nah, never heard of her". check for them, bestie. 🫶

---

🌈 HISTORY 🌈

the OpenSSL Tracing API was added in OpenSSL 3.0. so it's a 3.0+ era icon. 👑

---

🍓 COPYRIGHT 🍓

Copyright 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>.

---

and that's the whole page, bestie, short and slay ✨ this was OpenSSL manpage OSSL_TRACE_GET_CATEGORY_NUM(3ossl), version 3.5.9, dated 2026-09-29. go forth and translate those categories, you absolute legend. 🧚💜