sg_get_network_iface_stats(3)

💅 sg_get_network_iface_stats(3) — network interface stats, bestie 💅

okay so this page is literally all about peeking at your network interfaces: their speed, their duplex vibe, and whether they're up. it's giving network detective energy 🕵️‍♀️✨

🎀 NAME 🎀

sg_get_network_iface_stats, sg_get_network_iface_stats_r, sg_free_network_iface_stats, sg_network_iface_compare_name — get network interface statistics 🌈

✨ SYNOPSIS ✨

#include <statgrab.h>

sg_network_iface_stats *sg_get_network_iface_stats (size_t *entries);

sg_network_iface_stats *sg_get_network_iface_stats_r (size_t *entries);

sg_error sg_free_network_iface_stats (sg_network_iface_stats *data);

int sg_network_iface_compare_name (const void *va, const void *vb);

🦋 DESCRIPTION 🦋

so the functions sg_get_network_iface_stats() and sg_get_network_iface_stats_r() return statistics about the network interfaces in the machine. specifically, they return the speed of the interface, the duplex state, and whether it is currently up. both functions take an optional entries parameter, which points (when given) to a size_t to take the number of returned vector entries. 💖

🌟 API Shortcut 🌟

• sg_get_network_iface_stats → returns sg_network_iface_stats *, data owner: libstatgrab (thread local) ✨
• sg_get_network_iface_stats_r → returns sg_network_iface_stats *, data owner: caller 💅

the sg_network_iface_stats vectors received from sg_get_network_iface_stats_r() must be freed using sg_free_network_iface_stats() when not needed any more. the caller is responsible for doing it — yes bestie, that means you 🫶

additionally a support function for qsort(3) in available: sg_network_iface_compare_name(). (yes, that's what the page says — keep it cute and keep it exact 😭)

🧚 Sort Example 🧚

size_t entries;
sg_network_iface_stats *network_iface_stats = NULL;
while( NULL != ( network_iface_stats = sg_get_network_iface_stats(&entries) ) ) {
    /* order entries alphabetically using the mountpoint */
    qsort( network_iface_stats, entries, sizeof(network_iface_stats[0]), &sg_network_iface_compare_name );
    show_network_iface_stats( network_iface_stats );
}

🔥 RETURN VALUES 🔥

the sg_get_network_iface_stats returns a pointer to a structure of type sg_network_iface_stats.

typedef enum{
        SG_IFACE_DUPLEX_FULL,
        SG_IFACE_DUPLEX_HALF,
        SG_IFACE_DUPLEX_UNKNOWN
}sg_iface_duplex;

note: the SG_IFACE_DUPLEX_UNKNOWN value could mean that duplex hasn't been negotiated yet. 👀

typedef struct {
        char *interface_name;
        int speed;
        sg_iface_duplex duplex;
        int up;
        time_t systime;
} sg_network_iface_stats;

• interface_name — the name known to the operating system. (eg. on linux it might be eth0) 🐧
• speed — the speed of the interface, in megabits/sec. ⚡
• duplex — the duplex state the interface is in. see sg_iface_duplex for permitted values. 🔄
• up — whether the interface is up. ✅
• systime — the timestamp when the above stats where collected in seconds since epoch ⏰

💀 BUGS 💀

getting specific details may require elevated privileges, eg. on Linux the interface speed isn't visible to non-privileged processes. so if speed is acting mysterious, that's why 😭

the compare functions exist rather for backward compatibility than for functionality enhancements. limited flexibility (e.g. reverse order) and lack of optimising opportunities for the compiler leads to the recommendation to implement the required compare routines locally. ngl, bestie, just roll your own compare routine if you need fancy stuff 💅

👀 SEE ALSO 👀

statgrab(3)

🌐 WEBSITE 🌐

https://libstatgrab.org/

---

that's the whole page, bestie 💖 this cutie ships with libstatgrab, dated 2019-03-08 — mwah 💋✨