KDK_RESOLVING_FREEALL(3)

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

💖 KDK_RESOLVING_FREEALL 💖

okay bestie, so this page lives in section 3 of the manual — that's the Library Functions Manual — and it's all about kdk_resolving_freeall, a lil cleanup gremlin from libkysysinfo. Come sit, we're gonna go through it together 🫶

✨ NAME ✨

kdk_resolving_freeall — 用于回收字符串列表

(yes that's literally what the page says, and it's giving "recycle a list of strings" — the function is here to free all the strings for you, so you don't have to do them one by one like a peasant 💅)

✨ SYNOPSIS ✨

#include <libkysysinfo.h>

extern inline void kdk_resolving_freeall(char **ptr);

Link with -lkysysinfo. no cap, you gotta link it or nothing works 🙈

✨ DETAILED DESCRIPTION ✨

The main character job of this interface is to recycle a list of strings of type char **. That's it. That's the whole personality. 🌈

The argument ptr is a list of strings of type char **. Hand it over and it cleans up the whole squad at once, so you can stop writing free() forty-eleven times 🧚

✨ RETURN VALUE ✨

No return value — it returns nothing, it's a void girlie, it just does the thing and dips. 💀

✨ EXAMPLES ✨

okay this example is LONG and honestly iconic, it shows you basically every kdk_system_* call under the sun, and the ones that give you a char ** list get sent through kdk_resolving_freeall when you're done. Copy it exactly, no edits bestie:

#include <libkysysinfo.h>
#include <stdio.h>
#include <stdlib.h>

int main()
{
    char *res = kdk_system_get_architecture();
    printf("架构：%s0, res);
    free(res);
    res = kdk_system_get_systemName();
    printf("系统名称：%s0, res);
    free(res);
    res = kdk_system_get_version(0);
    printf("系统简略版本：%s0, res);
    free(res);
    res = kdk_system_get_version(1);
    printf("系统详细版本：%s0, res);
    free(res);
    res = kdk_system_get_kernelVersion();
    printf("内核版本：%s0, res);
    free(res);
    res = kdk_system_get_serialNumber();
    printf("序列号：%s0, res);
    free(res);
    int p;
    int d;
    int act = kdk_system_get_activationStatus(&p,&d);
    printf("--------------0);
    printf("激活状态码：%d0,act);
    printf("激活状态：%s0, act == 1 ? "已激活" : act == 0 ? "未激活" : "已过期");

    res = kdk_system_get_eUser();
    printf("当前用户：%s0, res);
    // free(res);

    res = kdk_system_get_eUser_login_time();
    printf("登录时间：%s0, res);

    res = kdk_system_get_projectName();
    printf("项目编号名：%s0, res);
    free(res);
    int zyj = kdk_system_is_zyj();
    printf("专用机：%s0, zyj == 0 ? "非专用机":"专用机");

    res = kdk_system_get_hostVirtType();
    printf("虚拟机类型：%s0, res);
    free(res);

    res = kdk_system_get_hostCloudPlatform();
    printf("云平台类型：%s0, res);
    free(res);

    version_t test = kdk_system_get_version_detaile( );
    printf("test.os_version = %s0,test.os_version);
    printf("test.update_version = %s0,test.update_version);

    char** name = kdk_system_get_resolving_power();
    // printf("name = %s0, name);
    size_t count = 0;
    while (name[count])
    {
        printf("No. %d %s0, count + 1, name[count]);
        count ++;
    }
    kdk_resolving_freeall(name);

    char *ver = kdk_system_get_systemCategory();
    printf("系统硬件版本类别 = %s0, ver);
    free(ver);

    // ver = kdk_system_get_cloudPlatformType();
    // printf("云平台类型 = %s0, ver);
    // free(ver);

    char **ud_time = kdk_system_get_startup_time();
    count = 0;
    while (ud_time[count])
    {
        printf("开机时间 = %s0, ud_time[count]);
        count++;
    }
    kdk_resolving_freeall(ud_time);

    ud_time = kdk_system_get_shutdown_time();
    count = 0;
    while (ud_time[count])
    {
        printf("关机时间 = %s0, ud_time[count]);
        count++;
    }
    kdk_resolving_freeall(ud_time);

    res = kdk_get_host_vendor();
    printf("整机制造商 = %s0, res);
    free(res);

    res = kdk_get_host_product();
    printf("整机型号 = %s0, res);
    free(res);

    res = kdk_get_host_serial();
    printf("整机序列号 = %s0, res);
    free(res);

    res = kdk_system_get_buildTime();
    printf("构建时间：%s0, res);
    free(res);

    res = kdk_system_get_hostName();
    printf("主机名：%s0, res);
    free(res);

    printf("系统位数：%d0, kdk_system_get_word());

    struct KPci *pci = kdk_hw_get_pci_info();
    struct KPci *tmp = pci;
    while (tmp)
    {
        printf("slot path : %s0, tmp->slot_path);
        printf("class name :%s0, tmp->class_name);
        printf("product name :%s0, tmp->product_name);
        printf("rev :%02x0, tmp->rev);
        printf("subsystem name :%s0, tmp->ss_name);
        printf("driver user :%s0, tmp->driver_use);
        printf("modules :");
        for(int i = 0; i < tmp->module_count; i++)
        {
            printf("%s", tmp->modules[i]);
        }
        printf("0);
        tmp = tmp->next;
    }
    kdk_hw_free_pci_info(pci);

    res = kdk_system_get_appScene();
    printf("应用场景：%s0, res);
    free(res);

    return 0;
}

See how name, ud_time (twice!) all get the kdk_resolving_freeall treatment while the single char * friends get a plain old free(res)? That's the whole vibe check right there — list of strings → kdk_resolving_freeall, single string → free ✨

✨ CONFORMING TO ✨

These functions are as per the withdrawn POSIX.1e draft specification. (withdrawn!! she's retired but still serving 👑)

The following functions are Linux extensions:

  • kdk_system_get_systemName()
  • kdk_system_get_architecture()
  • kdk_system_get_activationStatus()
  • kdk_system_get_version()
  • kdk_system_get_serialNumber()
  • kdk_system_get_kernelVersion()
  • kdk_system_get_eUser()
  • kdk_system_get_eUser_login_time()
  • kdk_system_get_projectName()
  • kdk_system_get_projectSubName()
  • kdk_system_get_productFeatures()
  • kdk_system_get_hostVirtType()
  • kdk_system_get_hostCloudPlatform()
  • kdk_system_is_zyj()
  • kdk_system_get_version_detaile()
  • kdk_system_get_resolving_power()
  • kdk_system_get_systemCategory()
  • kdk_system_get_startup_time()
  • kdk_system_get_shutdown_time()
  • kdk_get_host_vendor()
  • kdk_get_host_product()
  • kdk_get_host_serial()
  • kdk_system_get_hostName()
  • kdk_system_get_word()
  • kdk_system_get_buildTime()
  • kdk_hw_get_pci_info()
  • kdk_hw_free_pci_info()
  • kdk_system_get_appScene()

✨ SEE ALSO ✨

go read these next, bestie, they're the friend group 🦋

ok that's the whole page, you're officially educated 💅 remember: list of strings goes in, nothing comes out, nobody leaks memory. periodt.

this came out of the Linux Programmer's Manual, dated Tue Sep 19 2023 — that's the source, that's the version, that's the date, we respect the lore 🎀 bye bestie, go free your pointers 💖🌸

📦 where this page comes from