KDK_NC_GET_PRIVATE_IPV4(3)

📦 version 3.0.1.4, in arch rolling, ubuntu resolute, ubuntu stonking

💖 KDK_NC_GET_PRIVATE_IPV4 💖

Bestie, welcome to the manual page for KDK_NC_GET_PRIVATE_IPV4(3), straight out of the Library Functions Manual. Sit down, grab a boba, we're doing networking. 🧋✨

🌸 NAME 🌸

kdk_nc_get_private_ipv4 — 获取指定网卡的第一个IPv4地址 — aka it hands you the first IPv4 address of the NIC you point at 🦋

✨ SYNOPSIS ✨

#include <libkync.h>

extern char* kdk_nc_get_private_ipv4(const char *nc);

Link with -lkyhw.

Yes you literally have to link it, don't come crying to me when the symbols are undefined 💀

💅 Detailed Description 💅

Okay so the whole main-character job of this interface is getting the first IPv4 address of the NIC you name. That's it. That's the vibe. 👑

The argument nc is the name of the NIC, like "eno1". Real name, real interface, no guessing. 🎀

🔥 RETURN VALUE 🔥

  • On success — it returns an IPv4 address of type char* ✨
  • And it returns NULL without IP. 🙈
  • On error, return NULL. 😭
Heads up bestie: NULL means either "no IP, bestie" or "something went wrong" — the return value alone isn't telling you which, so plan accordingly. 💅

🎀 EXAMPLES 🎀

Here's the whole flex, verbatim, because copying is free:

#include "libkync.h"
#include <stdio.h>
#include <stdlib.h>

int main()
{
    char **cards = kdk_nc_get_cardlist();
    size_t index = 0;
    printf("所有网卡：\n");
    while (cards[index])
    {
        char *mac = kdk_nc_get_phymac(cards[index]);
        char *ipv4 = kdk_nc_get_private_ipv4(cards[index]);
        char *ipv6 = kdk_nc_get_private_ipv6(cards[index]);
        char *driver = kdk_nc_get_driver(cards[index]);
        char vendor[256] = " ", product[256] = " ";
        kdk_nc_get_vendor_and_product(cards[index], vendor, product);
        printf("Card %zd: %sStatus: %sMac: %sIPv4: %sIPv6: %s Vendor: %s Product: %s Type: %s driver: %s\n",
               index + 1, cards[index], kdk_nc_is_up(cards[index]) == 1 ? "Up" : "Down",
               mac, ipv4, ipv6, vendor, product,
               kdk_nc_is_wireless(cards[index]) ? "wireless" : "ethernet", driver);

        char **list4 = kdk_nc_get_ipv4(cards[index]);
        int i = 0;
        printf("AllIpV4: ");
        while (list4 && list4[i])
        {
            printf("%s", list4[i++]);
        }
        printf("\n");
        char **list6 = kdk_nc_get_ipv6(cards[index]);
        printf("AllIpV6: ");
        i = 0;
        while (list6 && list6[i])
        {
            printf("%s", list6[i++]);
        }
        printf("\n");
        free(mac);
        free(ipv4);
        free(ipv6);
        free(list4);
        free(list6);
        free(driver);
        index++;
    }
    kdk_nc_freeall(cards);
    char **upcards = kdk_nc_get_upcards();
    index = 0;
    printf("工作网卡：\n");
    while (upcards[index])
    {
        printf("Card %zd: %s\n", index + 1, upcards[index]);
        index++;
    }
    kdk_nc_freeall(upcards);
    return 0;
}
Notice the free() calls, bestie — that's your self-care routine and you will NOT be skipping it. 🫶

👑 CONFORMING TO 👑

These functions are as per the withdrawn POSIX.1e draft specification. Yes, withdrawn, we're all just living like that. 😭

The following functions are Linux extensions: kdk_nc_is_up(), kdk_nc_get_upcards(), kdk_nc_get_cardlist(), kdk_nc_get_phymac(), kdk_nc_get_ipv4(), kdk_nc_get_private_ipv6(), kdk_nc_get_ipv6(), kdk_nc_is_wireless(), kdk_nc_get_vendor_and_product(), kdk_nc_get_driver(), and kdk_nc_freeall(). ✨

🌈 SEE ALSO 🌈

And that's the whole page, bestie — courtesy of the Linux Programmer's Manual, dated Fri Aug 25 2023. Go get those IPv4 addresses, you absolute icon 💅✨🦋

📦 where this page comes from