KDK_SYSTEM...ON_DETAILE(3)

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

💖 KDK_SYSTEM_GET_VERSION_DETAILE 💖

okay bestie, welcome to the manual page for kdk_system_get_version_detaile, which lives in section 3 of the Library Functions Manual and is genuinely the moment you find out what version of the system you're on. pull up a chair. 🫶

✨ NAME ✨

kdk_system_get_version_detaile — 获取系统版本号/补丁版本号 (grab the system version number / patch version number, basically)

🌸 SYNOPSIS 🌸

#include <libkysysinfo.h>

extern version_t kdk_system_get_version_detaile();

Link with -lkysysinfo.

yes bestie, that's the whole vibe. -lkysysinfo is non-negotiable, don't forget her 💅

🦋 Detailed Description 🦋

so the main character job of this interface is to obtain the system version number or patch version number. that's it. that's the whole function. it goes and gets the numbers, hands them to you, and minds its own business. iconic behavior honestly. ✨

💜 RETURN VALUE 💜

  • On success — you get back a pointer to a version_t structure, and that structure is stuffed with the system version number and patch version number info. slay.
  • On error — you get NULL. 😭 check for it, please, i am begging.

the version_t structure is defined in <libkysysinfo.h> and looks like this, exactly like this, no notes:

typedef struct {
    char    *os_version;            //系统版本
    char    *update_version;        //补丁版本
} version_t;

so os_version is the 系统版本 and update_version is the 补丁版本. two little strings, carrying so much weight. 🎀

🧚 EXAMPLES 🧚

okay so here's a full-on example and it is long, bestie, it's giving "the whole tour". every single line is verbatim because i do not mess with code:

#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 kdk_system_get_version_detaile( ) just slides in there mid-tour and prints test.os_version and test.update_version? that's our girl. 🌟

heads up bestie: i copied this example character for character, weird bits and all. do not come for me, i am simply the messenger 🕊️

👑 CONFORMING TO 👑

these functions are as per the withdrawn POSIX.1e draft specification. yep, withdrawn. it's giving vintage. still here though, still serving. 💅

and 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_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_resolving_freeall()
  • kdk_hw_get_pci_info()
  • kdk_hw_free_pci_info()
  • and kdk_system_get_appScene()

🌈 SEE ALSO 🌈

the whole friend group, go say hi 🫶

okay that's the whole page, you made it, i'm so proud of you 🥹 this one came out of the Linux Programmer's Manual, dated Tue Sep 19 2023, and it's filed under KDK_SYSTEM...ON_DETAILE(3). go get those version numbers bestie, ilysm 💖✨🎀🦋

📦 where this page comes from