OSSL_TRACE_GET_CATEGORY_NUM(3SSL)

✨ NAME ✨

OSSL_trace_get_category_num, OSSL_trace_get_category_name — the OpenSSL tracing information functions 💅 (this is page OSSL_TRACE_GET_CATEGORY_NUM from the 3SSL manual, bestie, so you already know where you are 🫶)

---

🦋 SYNOPSIS 🦋

#include <openssl/trace.h>

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

---

🌸 DESCRIPTION 🌸

okay so these two are literally besties that translate for each other. one speaks name, the other speaks number, and they both know the same category list. no cap.

• OSSL_trace_get_category_num() — bestie, you hand it a name and it hands you back the category number that goes with it. it's giving translator energy 👑
• OSSL_trace_get_category_name() — other direction, same vibe: you give it a num and it gives you back the category name that num belongs to. obsessed. 💖

so like, name ➡️ num, num ➡️ name. that's the whole gig. iconic.

---

💀 RETURN VALUES 💀

• OSSL_trace_get_category_num() returns the category number when the name you passed is a recognised category name. if it's not recognised? it returns -1. so watch for that, because -1 is not a category, bestie, it's a vibe check you failed 🙈
• OSSL_trace_get_category_name() returns the category name when the num you passed is a recognised category number. otherwise it returns NULL. do not dereference the NULL. i'm serious. don't do it. 😭

---

📜 HISTORY 📜

the OpenSSL Tracing API was added in OpenSSL 3.0. (and yes, the source literally spells it "ino", iconic typo, we love her anyway 💅)

---

👑 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, babe — version 4.0.3, dated 2026-09-29, filed under OSSL_TRACE_GET_CATEGORY_NUM(3SSL). go forth and trace, you absolute main character. periodt 💖✨🎀