TLSPOOL_CONFIGVAR(3)

💅 TLSPOOL_CONFIGVAR — like, the library calls one, bestie

okay so this is tlspool_configvar(3) and it's literally about grabbing a config variable value out of the TLS Pool's config file. tiny function, big main character energy. let's go 🎀

---

✨ SYNOPSIS ✨

#include <tlspool/starttls.h>

char *tlspool_configvar (char *cfgfile, char *varname);

that's it. two args. you got this 🫶

---

🌸 DESCRIPTION 🌸

okay so tlspool_configvar() fetches the value of a configuration file variable named varname from the configuration file for the TLS Pool. like, it goes and gets the thing for you 💖

now, where does it look for that config file? the way that this works is:

• the name of the configuration file can be provided in the cfgfile parameter, or
• if it's NULL, then first the environment variable TLSPOOL_CONFIG_FILE is tried, and
• failing to find that, it tries the compile-time setting TLSPOOL_DEFAULT_CONFIG_PATH.

three-tier fallback situation, very demure, very mindful ✨

and ngl the returned string is a duplicate, so you must free it with a call to free(). that's not a suggestion, bestie, that's the whole vibe. leak it and it's giving 💀

---

⭐ RETURN VALUE ⭐

the value returned is NULL when the requested variable was not found — but also when the configuration file did not load at all 😭 so like, NULL is doing double duty here, lowkey iconic but also kinda annoying.

the error output may hold further hints on the cause of problems, so check that if you're confused 🦋

---

👑 AUTHOR 👑

written by Rick van Rein of OpenFortress.nl, for the ARPA2.net project. king behavior, honestly 💜

---

🙈 REPORTING BUGS 🙈

for any discussion, including about bugs, please use the mailing list found on http://lists.arpa2.org/mailman/listinfo/tls-pool — yes, bugs count as discussion, bring them to the group chat 🧚

also please read the software distribution's README, INSTALL and TODO files for information about the tlspool-daemon implementation status. fr fr, they're there for a reason 🌸

---

💖 COPYRIGHT 💖

Copyright © 2016 Rick van Rein, ARPA2.net.

ARPA2 is funded from InternetWide.org, which in turns receives donations from various funding sources with an interest in a private and secure Internet that gives users control over their online presence. this particular project has been sponsored in part by NCSC. so like, funded by people who actually care about your privacy, we love to see it 🫶

---

🌈 SEE ALSO 🌈

• tlspool-daemon(8)

the TLS Pool API is documented in the include file <tlspool/commands.h> and <tlspool/starttls.h> for C, and the tlspool.py module for Python 🐍

online resources may be found on the project home page, http://tlspool.arpa2.net — go poke around, it's cute ⭐

---

and that's the page, bestie 🎀 sign-off time: brought to you by ARPA2.net, dated August 2016, and yes the whole thing is TLSPOOL_CONFIGVAR(3) in case you forgot where you were 💅✨