smi_macro(3)

hey bestie 💖 welcome to smi_macro(3) — manual name: SMI Management Information Library. this page is all about macro/extension info, and it’s lowkey iconic ✨

✨ NAME ✨

smiGetMacro, smiGetFirstMacro, smiGetNextMacro, smiGetMacroModule — the SMI macro and extension information routines 👑

🌸 SYNOPSIS 🌸

ok so first you include the header, then the function signatures and the struct show up like:

#include <smi.h>

SmiMacro *smiGetMacro(SmiModule *smiModulePtr, char *macro);

SmiMacro *smiGetFirstMacro(SmiModule *smiModulePtr);

SmiMacro *smiGetNextMacro(SmiMacro *smiMacroPtr);

SmiModule *smiGetMacroModule(SmiMacro *smiMacroPtr);

typedef struct SmiMacro {
    SmiIdentifier       name;
    SmiDecl             decl;
    SmiStatus           status;
    char                *description;
    char                *reference;
} SmiMacro;

💅 DESCRIPTION 💅

These functions retrieve information on an extension statement definition (SMIng) or a macro (SMIv1/v2) — that’s the vibe ✅

• smiGetMacro() — retrieves a struct SmiMacro that represents an extension or macro definition. The macro argument can be either a fully qualified descriptor or a simple macro or extension name. If smiModulePtr is not NULL, it’s used to limit the search to the given module. If the macro is not found, smiGetMacro() returns NULL 😭
• smiGetFirstMacro() and smiGetNextMacro() — use these to iteratively retrieve struct SmiMacros. smiGetFirstMacro() returns the first one defined in the module specified by smiModulePtr; subsequent calls to smiGetNextMacro() return the following ones. If there are no more extension or macro definitions in the module, NULL is returned 🫶
• smiGetMacroModule() — returns the module that defines the macro or extension given by struct SmiMacroPtr 👑

🎀 FILES 🎀

• ${prefix}/include/smi.h — SMI library header file. yes bestie, that’s where the header lives 💖

🔥 SEE ALSO 🔥

• libsmi(3)
• smi_module(3)
• smi.h

go check these out, iykyk 👀✨

🌈 AUTHOR 🌈

• (C) 1999-2001 Frank Strauss, TU Braunschweig, Germany <strauss@ibr.cs.tu-bs.de> — iconic authorship behavior 👑

---

xoxo, source/version IBR, date August 16, 2001 — catch u in smi_macro(3) 💅💖