smi_identity(3)

💖 NAME 💖

smiGetIdentity, smiGetFirstIdentity, smiGetNextIdentity, smiGetParentIdentity, smiGetIdentityModule — bestie, these are the SMI identity information routines, and they live in section 3 of the SMI Management Information Library manual. iykyk 💅

✨ SYNOPSIS ✨

okay so first you gotta include the header, then literally everything else is right here:

#include <smi.h>

SmiIdentity *smiGetIdentity(SmiModule *smiModulePtr, char *name);

SmiIdentity *smiGetFirstIdentity(SmiModule *smiModulePtr);

SmiIdentity *smiGetNextIdentity(SmiIdentity *smiIdentityPtr);

SmiIdentity *smiGetParentIdentity(SmiIdentity *smiIdentityPtr);

SmiModule *smiGetIdentityModule(SmiType *smiIdentityPtr);

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

look at that struct. she's giving organized. we love her. 🫶

🌸 DESCRIPTION 🌸

so these functions are how you go get info on a SMIng identity definition (that's SMIng, bestie). they're all about identities and honestly? iconic.

• smiGetIdentity(SmiModule *smiModulePtr,char *name) — hands you back a pointer to struct SmiIdentity for the identity with the given name in the given module (smiModulePtr), or NULL if the idenity with the given name does not exist. no cap, that's just what it does. 💀
• smiGetFirstIdentity(SmiModule *smiModulePtr) and smiGetNextIdentity(SmiIdentity *smiIdentityPtr) — these two are your lil duo for iterating through the identities of the module given by smiModulePtr. they return a pointer to struct SmiIdentity hat represents an identity, or NULL if there are no identities left in the module, or an error has occurred. so like, NULL means either "we're done here bestie" or "something went wrong" — vibe check accordingly. 😭
• smiGetIdentityModule(SmiIdentity *smiIdentityPtr) — returns a pointer to struct SmiModule, of the module containing the given identity. it's giving "who's your mom". 👑
• smiGetParentIdentity(SmiIdentity *smiIdentityPtr) — returns a pointer to struct SmiIdentity pointing to the parent of the given smiIdentityPtr, or NULL if the Identity is not derived. no parent? no problem. 🌈

🎀 FILES 🎀

• ${prefix}/include/smi.h — the SMI library header file, aka the moment it all begins ✨

🦋 SEE ALSO 🦋

go read these next, fr fr:

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

👑 AUTHOR 👑

(C) 2007 Kaloyan Kanev, Jacobs University, Germany <k.kanev@jacobs-university.de> — legend behavior, we thank her 💜

and that's the whole page, bestie!! this was the SMI Management Information Library version, dated February 10, 2007, and yes it's smi_identity(3) the whole time, no plot twist. slay, go read the source, mwah 🎀💖✨