QB_LOG_FILTER_CTL2(3)

📦
version 2.0.9 · 6 versions
, in fedora 44, ubuntu resolute, ubuntu stonking

💖 QB_LOG_FILTER_CTL2 💖

okay bestie, welcome to the libqb Programmer's Manual — yes that libqb, the one you already know and love 🫶. this page is all about qb_log_filter_ctl2, and no cap, it's basically the glow-up edition of qb_log_filter_ctl().

✨ NAME ✨

qb_log_filter_ctl2 — this extends qb_log_filter_ctl() by been able to provide a high_priority.

fr fr that's the whole name section, that's literally what it says. the original is giving "short and mysterious" and we respect it 💅

🌸 SYNOPSIS 🌸

#include <qb/qblog.h>

int32_t qb_log_filter_ctl2(
    int32_t                  value,
    enum qb_log_filter_conf  c,
    enum qb_log_filter_type  type,
    const char              *text,
    uint8_t                  high_priority,
    uint8_t                  low_priority
);

like… look at those params. value, c, type, text, and then two priority args — high_priority and low_priority — that's the whole plot twist of this function, that's the "extra" it brings to the table 🎀

🦋 DESCRIPTION 🦋

so here's the thing: this page doesn't actually spell out a big paragraph description. the vibe is delivered entirely through the NAME section (it extends qb_log_filter_ctl(), and it lets you provide a high_priority) plus the enums down below. the details live in the structures, bestie 👑

💜 STRUCTURES 💜

enum qb_log_filter_conf

these are your filter control actions, the "what am I doing to the filter" menu:

enum qb_log_filter_conf {
      QB_LOG_FILTER_ADD;
      QB_LOG_FILTER_REMOVE;
      QB_LOG_FILTER_CLEAR_ALL;
      QB_LOG_TAG_SET;
      QB_LOG_TAG_CLEAR;
      QB_LOG_TAG_CLEAR_ALL;
};
  • QB_LOG_FILTER_ADD — add a filter, we're building ✨
  • QB_LOG_FILTER_REMOVE — remove one, we're curating 🧹
  • QB_LOG_FILTER_CLEAR_ALL — nuke the whole filter list, scorched earth energy 💀
  • QB_LOG_TAG_SET — set a tag 🏷️
  • QB_LOG_TAG_CLEAR — clear a tag 🙈
  • QB_LOG_TAG_CLEAR_ALL — clear all the tags, all of them, no survivors 🫶

enum qb_log_filter_type

and these are the filter types — i.e. what the filter is actually matching against:

enum qb_log_filter_type {
      QB_LOG_FILTER_FILE;
      QB_LOG_FILTER_FUNCTION;
      QB_LOG_FILTER_FORMAT;
      QB_LOG_FILTER_FILE_REGEX;
      QB_LOG_FILTER_FUNCTION_REGEX;
      QB_LOG_FILTER_FORMAT_REGEX;
};
  • QB_LOG_FILTER_FILE — match by file 📁
  • QB_LOG_FILTER_FUNCTION — match by function 🔧
  • QB_LOG_FILTER_FORMAT — match by format 💬
  • QB_LOG_FILTER_FILE_REGEX — match by file, but make it regex 🔥
  • QB_LOG_FILTER_FUNCTION_REGEX — match by function, regex edition ⭐
  • QB_LOG_FILTER_FORMAT_REGEX — match by format, regex edition 🌈

🎀 SEE ALSO 🎀

the group chat is long, bestie. every single one of these is invited:

Copyright (c) 2017 Red Hat, Inc.

and that's the whole page, bestie!! mwah 💋 this was the libqb manual page for qb_log_filter_ctl2, dated 2025-09-16, and you absolutely ate that read. go forth and filter your logs, icon. periodt. 💅✨

📦 where this page comes from