QB_LOG_CTL(3)

💖 QB_LOG_CTL(3) 💖

okay bestie, welcome to the QB_LOG_CTL(3) page from the libqb Programmer's Manual! this is literally the main logging control function and it's giving main character energy. no cap. 🫶

---

🌟 NAME 🌟

qb_log_ctl — the main logging control function. periodt. 💅

---

✨ SYNOPSIS ✨

so you wanna call it? here's the exact vibe, bestie:

       #include <qb/qblog.h>

       int32_t qb_log_ctl(
           /*
            * QB_LOG_SYSLOG, QB_LOG_STDERR or result from qb_log_file_open()
            */
           int32_t           target,
           /*
            * configuration directive ("what to configure") that accepts int32_t
            * argument determining the new value unless ignored for particular directive
            * altogether (incompatible directives: QB_LOG_CONF_IDENT)
            */
           enum qb_log_conf  conf_type,
           /*
            * the new value for a state-changing configuration directive, ignored
            * otherwise
            */
           int32_t           arg
       );

---

🎀 PARAMS 🎀

• target — QB_LOG_SYSLOG, QB_LOG_STDERR, or whatever qb_log_file_open() handed you. that's the destination, bestie. ✨
• conf_type — the configuration directive ("what to configure") that takes an int32_t argument to set the new value. heads up: some directives just ignore the argument entirely, and the incompatible one is QB_LOG_CONF_IDENT. so don't @ me if it doesn't care. 🙈
• arg — the new value for a state-changing configuration directive. if the directive isn't into that, it's ignored. lowkey chill. 💅

---

🦋 DESCRIPTION 🦋

bestie, the original manpage literally left this section blank. not a single word. so we're keeping it blank too — no invented lore, no extra claims, just vibes. iykyk. 💖

---

🌸 STRUCTURES 🌸

here's the enum qb_log_conf in all its iconic glory:

       enum qb_log_conf {
             QB_LOG_CONF_ENABLED;
             QB_LOG_CONF_FACILITY;
             QB_LOG_CONF_DEBUG;
             QB_LOG_CONF_SIZE;
             QB_LOG_CONF_THREADED;
             QB_LOG_CONF_PRIORITY_BUMP;
             QB_LOG_CONF_STATE_GET;
             QB_LOG_CONF_FILE_SYNC;
             QB_LOG_CONF_EXTENDED;
             QB_LOG_CONF_IDENT;
             QB_LOG_CONF_MAX_LINE_LEN;
             QB_LOG_CONF_ELLIPSIS;
             QB_LOG_CONF_USE_JOURNAL;
       };

slay. that's the whole roster. 🎀

---

🔥 RETURN VALUE 🔥

• -errno — on error. it's giving sad girl hours. 😭
• 0 — on success. we love a clean win. 💚

---

🌈 SEE ALSO 🌈

bestie, go read these too, fr fr:

• qb_log_filter_fn_set(3)
• qb_log_from_external_source_va2(3)
• qb_log_thread_start(3)
• qb_log_target_user_data_get(3)
• qb_log_tags_stringify_fn_set(3)
• qb_log_file_reopen(3)
• qb_log_fini(3)
• qb_log_callsites_dump(3)
• qb_log_ctl2(3)
• qb_log_target_user_data_set(3)
• qb_log_target_format(3)
• qb_log_thread_priority_set(3)
• qb_log_facility2int(3)
• qb_log_callsites_register(3)
• qb_log_filter_ctl2(3)
• qb_log_file_close(3)
• qb_log_format_set(3)
• qb_log_real_(3)
• qb_log_from_external_source_va(3)
• qb_log_callsite_get(3)
• qb_log_blackbox_write_to_file(3)
• qb_log_real_va_(3)
• qb_log_from_external_source(3)
• qb_log_blackbox_print_from_file(3)
• qb_log_facility2str(3)
• qb_log_callsite_get2(3)
• qb_log_filter_ctl(3)
• qb_log_custom_close(3)
• qb_log_init(3)
• qb_log_file_open(3)
• qb_log_custom_open(3)

---

👑 COPYRIGHT 👑

Copyright (c) 2017 Red Hat, Inc.

---

and that's the tea, bestie. this page is from LIBQB, dated 2025-09-16, and it's the QB_LOG_CTL(3) manual page. slay, stay logged, and don't forget to vibe check your file descriptors. 💖✨🦋