---
name: "smi_event"
section: "3"
platform: "linux"
package: "libsmi2-dev"
version: "0.4.8+dfsg2-17+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/smi_event"
---

# smi\_event(3)

SMI identity information routines

## NAME

smiGetEvent, smiGetFirstEvent, smiGetNextEvent - SMI identity information routines

## SYNOPSIS

```
#include <smi.h>

smiGetEvent(SmiClass *smiClassPtr,char*"name);

smiGetFirstEvent(SmiClass *smiClassPtr);

smiGetNextEvent(SmiEvent *smiEventPtr);
typedef struct SmiEvent {
    SmiIdentifier       name;
    SmiDecl             decl;
    SmiStatus           status;
    char                *description;
    char                *reference;
} SmiEvent;
```

## DESCRIPTION

These functions retrieve information on a SMIng event definition (SMIng).

**smiGetEvent(SmiClass \*smiClassPtr, char \*name)** returns a pointer to **struct SmiEvent** for the event with the given *name* in the given class(*smiClassPtr*), or NULL if the event with the given name does not exist

**smiGetFirstEvent(SmiClass \*smiClassPtr)** and **smiGetNextEvent(SmiEvent \*smiEventPtr)** are used to iterate through the events of the class given by *smiClassPtr*. They return a pointer to **struct SmiEvent** that represents an event or NULL if there are no events left in the class, or error has occurred.

## FILES

```
${prefix}/include/smi.h    SMI library header file
```

## SEE ALSO

[**libsmi**(3)](/libsmi/3.md),  [**smi\_module**(3)](/smi_module/3.md),  [**smi\_class**(3)](/smi_class/3.md),  **smi.h**

## AUTHOR

(C) 2007 Kaloyan Kanev, Jacobs University, Germany \<k.kanev@jacobs-university.de\>\