From 799fedc0a297ead5c5e778275369e38ebd6372ab Mon Sep 17 00:00:00 2001 From: chipo Date: Thu, 10 Nov 2022 08:34:12 +0000 Subject: [PATCH 1/4] =?UTF-8?q?update=20=E5=BC=80=E5=A7=8B=E8=B4=A1?= =?UTF-8?q?=E7=8C=AE/openKylin+SDK=E5=BC=80=E5=8F=91=E6=8C=87=E5=8D=97V2.0?= =?UTF-8?q?.md.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: chipo --- ...45\217\221\346\214\207\345\215\227V2.0.md" | 622 +++--------------- 1 file changed, 97 insertions(+), 525 deletions(-) diff --git "a/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" "b/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" index c6e4f5a..8dfa59d 100644 --- "a/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" +++ "b/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" @@ -194,297 +194,70 @@ $ sudo apt-get install libkysdk-hardware libkysdk-hardware-dev | 获取 CPU 架构 -``` -+----------------+------------+----------------+----------------+---+ -| 子模块 | 编程语言 | 声明 | 描述 | | -+================+============+================+================+===+ -| | C | extern const | 获取 CPU 架构 | | -| | | char\* | | | -| | | cpu_get_arch() | | | -|
| | | | | -|

获

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -| | | | | | -| | | | | | -|
| | | | | -|

CPU

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -|
| | | | | -|

息

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -|
取
信
| | | | | -+----------------+------------+----------------+----------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------------+------------+----------------+----------------+---+ -| | | > 无 | const char\* | | -| | | | 架构信息， | | -| | | | | | -| | | | 如\"x86_ | | -| | | | 64\"；返回的是 | | -| | | | | | -| | | | > const | | -| | | | > char\*，不要 | | -| | | | > free | | -+----------------+------------+----------------+----------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|---------|------|---------------------------------------|---------------------------------------------------| +| 获取CPU信息 | C | extern const char* kdk_cpu_get_arch() | 获取CPU架构 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | const char* 架构信息，如"x86_64"；返回的是const char*，不要free | + 获取 CPU 制造厂商 -``` -+----------------+------------+----------------+----------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+================+============+================+================+===+ -| | C | extern const | 获取 CPU 制造 | | -| | | char\* | | | -| | | u_get_vendor() | | | -|
| | | | | -|

获

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -| | | | | | -| | | | | | -|
| | | | | -|

CPU

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -|
取
信
| | | | | -| | | | | | -| > 息 | | | | | -+----------------+------------+----------------+----------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------------+------------+----------------+----------------+---+ -| | | > 无 | const char\* | | -| | | | 制 造 厂 商 字 | | -| | | | | | -| | | | > 符 串 ， 如 | | -| | | | | | -| | | | "GenuineIntel" | | -| | | | ； 返 回 | | -| | | | | | -| | | | 的 是 const | | -| | | | char\* ， 不要 | | -| | | | | | -| | | | > free | | -+----------------+------------+----------------+----------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|---------|------|-----------------------------------------|------------------------------------------------------------| +| 获取CPU信息 | C | extern const char* kdk_cpu_get_vendor() | 获取CPU制造商 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | const char* 制造厂商字符串，如“GenuineIntel”；返回的是const char*，不要free | + 获取 CPU 型号 -``` -+----------+------------+-----------------------------------------+-----------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+=========================================+=================+ -| > 获 取 | C | extern const char\* kdk_cpu_get_model() | > 获取 CPU 型号 | -+----------+------------+-----------------------------------------+-----------------+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|---------|------|----------------------------------------|----------------------------------------------------------------------------------------| +| 获取CPU信息 | C | extern const char* kdk_cpu_get_model() | 获取CPU型号 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | const char* CPU型号名称，如“Intel(R) Core(TM) i7-4790K CPU @ 4.00GHz”；返回的是const char*，不要free | -``` -+----------+---+------------+---------------------------+---+ -| > CPU 信 | | > 参数说明 | > 返回值说明 | | -| > | | | | | -| > 息 | | | | | -+==========+===+============+===========================+===+ -| | | > 无 | const char\* CPU 型 号 名 | | -| | | | | | -| | | | > 称 ， 如 "Intel(R) | | -| | | | | | -| | | | Core(TM) i7-4790K CPU | | -| | | | | | -| | | | @ 4.00GHz"；返回的是 | | -| | | | | | -| | | | > const char\*，不要 free | | -+----------+---+------------+---------------------------+---+ -``` 获取 CPU 额定主频 -``` -+----------------+------------+----------------+----------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+================+============+================+================+===+ -| | C | extern const | 获取 CPU 额定 | | -| | | char\* | | | -| 主频 | | -| lass="header"> | | get_freq_MHz() | | | -|
| | | | | -|

获

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -| | | | | | -| | | | | | -|
| | | | | -|

CPU

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -|
取
信
| | | | | -| | | | | | -| > 息 | | | | | -+----------------+------------+----------------+----------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------------+------------+----------------+----------------+---+ -| | | > 无 | const char\* | | -| | | | 额定主频赫兹 | | -| | | | | | -| | | | 数，如 | | -| | | | "1794.742"，单 | | -| | | | | | -| | | | 位 是 MHz ； | | -| | | | 返 回 的 是 | | -| | | | | | -| | | | > const | | -| | | | > char\*，不要 | | -| | | | > free | | -+----------------+------------+----------------+----------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|---------|------|-------------------------------------------|---------------------------------------------------------------| +| 获取CPU信息 | C | extern const char* kdk_cpu_get_freq_MHz() | 获取CPU额定主频 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | const char* 额定主频赫兹数，如“1794.742”，单位是MHz；返回的是const char*，不要free | + + 获取 CPU 核心数量 -``` -+----------------+------------+----------------+---------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+================+============+================+===============+===+ -| | C | extern | 获取 CPU 核心 | | -| | | unsigned int | | | -| 数量 | | -| lass="header"> | | get_corenums() | | | -|
| | | | | -|

获

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -| | | | | | -| | | | | | -|
| | | | | -|

CPU

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -|
取
信
| | | | | -| | | | | | -| > 息 | | | | | -+----------------+------------+----------------+---------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------------+------------+----------------+---------------+---+ -``` - - - -``` -+---+---+------+-----------------------------+---+ -| | | > 无 | unsigned int 所 有 可 用 的 | | -| | | | | | -| | | | > CPU 核心数量 | | -+---+---+------+-----------------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|---------|------|--------------------------------------------|---------------------------| +| 获取CPU信息 | C | extern unsigned int kdk_cpu_get_corenums() | 获取CPU核心数量 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned int 所有可用的CPU核心数量 | + 获取 CPU 对虚拟化的支持 -``` -+----------------+------------+----------------+----------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+================+============+================+================+===+ -| | C | const char\* | 获取 CPU 对虚 | | -| | | kdk_ | | | -| 拟化的支持 | | -| lass="header"> | | | | | -|
| | | | | -|

获

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -| | | | | | -| | | | | | -|
| | | | | -|

CPU

| | | | | -| | | | | | -|
| | | | | -| | | | | | -| | | | | | -|
取
信
| | | | | -| | | | | | -| > 息 | | | | | -+----------------+------------+----------------+----------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------------+------------+----------------+----------------+---+ -| | | > 无 | const char\* | | -| | | | 若 CPU 支持虚 | | -| | | | | | -| | | | 拟化， | | -| | | | 则返回虚拟化技 | | -| | | | | | -| | | | 术，如 | | -| | | | "vmx"；若不支 | | -| | | | | | -| | | | 持，返回 | | -| | | | NULL；返回的 | | -| | | | | | -| | | | > 是 const | | -| | | | > char\*，不要 | | -| | | | > free | | -+----------------+------------+----------------+----------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|---------|------|--------------------------------|--------------------------------------------------------------------------| +| 获取CPU信息 | C | const char* kdk_cpu_get_virt() | 获取CPU对虚拟化的支持 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | const char* 若CPU支持虚拟化，则返回虚拟化技术，如“vmx”；若不支持，返回NULL；返回的是const char*，不要free | + #### **3.1.2.2** 获取网卡信息 @@ -512,319 +285,118 @@ $ sudo apt-get install libkysdk-hardware libkysdk-hardware-dev | 获取系统中所有的网卡 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 网 | C | extern char\*\* | 获取系统中 | | -| | | kdk | | | -| > 卡信息 | | _nc_get_cardlist() | > 所有的网卡 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char\*\* | | -| | | | 网卡名称列表，由 | | -| | | | | | -| | | | NULL | | -| | | | 字符串表示结尾； | | -| | | | | | -| | | | 由 alloc 生 成 ， | | -| | | | 需 要 被 | | -| | | | | | -| | | | kdk_nc_freeall | | -| | | | 回收；若获 | | -| | | | | | -| | | | > 取出错，返回 | | -| | | | > NULL； | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------|-----------------------------------------------------------------------| +| 获取网卡信息 | C | extern char** kdk_nc_get_cardlist() | 获取系统中所有的网卡 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char** 网卡名称列表，由NULL字符串表示结尾；由alloc生成，需要被kdk_nc_freeall回收；若获取出错，返回NULL； | 检测指定网卡是否处于 UP 状态 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 网 | C | extern int | 检测指定网 | | -| | | kdk_nc_is_up(const | | | -| > 卡信息 | | char \*nc) | 卡是否处于 | | -| | | | | | -| | | | > UP 状态 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | nc：网卡名称， | int Up 返回 | | -| | | | 1，Down 返回 | | -| | | > 如 eno1 | | | -| | | | > 0 | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取系统中当前处于 link up 状态的网卡列表 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-----------------------------------------|-------------------| +| 获取网卡信息 | C | extern int kdk_nc_is_up(const char *nc) | 检测指定网卡是否处于UP状态 | +| | | 参数说明 | 返回值说明 | | +| | | nc：网卡名称，如eno1 | int Up返回1，Down返回0 | -``` -+----------+------------+--------------------------------------+--------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+======================================+==============+ -| 获 取 网 | C | extern char\*\* kdk_nc_get_upcards() | 获取系统中当 | -+----------+------------+--------------------------------------+--------------+ -``` + 获取系统中当前处于 link up 状态的网卡列表 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------|-----------------------------------------------------------------------| +| 获取网卡信息 | C | extern char** kdk_nc_get_upcards() | 获取系统中当前处于 link up 状态的网卡列表 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char** 网卡名称列表，由NULL字符串表示结尾；由alloc生成，需要被kdk_nc_freeall回收；若获取出错，返回NULL； | -``` -+----------+---+------------+----------------------------+---+ -| > 卡信息 | | | 前处于 link up | | -| | | | | | -| | | | 状态的网卡列 | | -| | | | | | -| | | | > 表 | | -+==========+===+============+============================+===+ -| | | > 参数说明 | > 返回值说明 | | -+----------+---+------------+----------------------------+---+ -| | | > 无 | char\*\* 网卡名称列表，由 | | -| | | | | | -| | | | NULL 字符串表示结尾； | | -| | | | | | -| | | | 由 alloc 生 成 ， 需 要 被 | | -| | | | | | -| | | | kdk_nc_freeall 回 收 ； 若 | | -| | | | | | -| | | | > 获取出错，返回 NULL； | | -+----------+---+------------+----------------------------+---+ -``` 获取指定网卡的物理 MAC 地址 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------------|-------------------------------------------------| +| 获取网卡信息 | C | extern char* kdk_nc_get_phymac(const char *nc) | 获取指定网卡的物理MAC地址 | +| | | 参数说明 | 返回值说明 | | +| | | nc：网卡名称，如eno1 | char* 物理MAC地址，由alloc生成，应当被free；若指定网卡不存在，则返回NULL | -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 网 | C | extern char\* | 获取指定网卡 | | -| | | kdk_n | | | -| > 卡信息 | | c_get_phymac(const | 的物理 MAC 地 | | -| | | char | | | -| | | | > 址 | | -| | | \*nc) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | nc：网卡名称， | char\* 物 理 MAC | | -| | | | 地 址， | | -| | | > 如 eno1 | | | -| | | | 由 alloc 生 成 ， | | -| | | | 应 当 被 | | -| | | | | | -| | | | free ； 若 指 定 | | -| | | | 网 卡 不 存 | | -| | | | | | -| | | | > 在，则返回 NULL | | -+----------+------------+--------------------+--------------------+---+ -``` 获取指定网卡的第一个 IPv4 地址 -``` -+----------+------------+---------------------+------------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+=====================+==================+ -| 获 取 网 | C | extern char\* | 获取指定网卡 | -| | | kdk_nc_get | | -| | | _private_ipv4(const | 的 第 一 个 IPv4 | -+----------+------------+---------------------+------------------+ -``` - - +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------------------|-----------------------------| +| 获取网卡信息 | C | extern char* kdk_nc_get_private_ipv4(const char *nc) | 获取指定网卡的第一个IPv4地址 | +| | | 参数说明 | 返回值说明 | | +| | | nc：网卡名称，如eno1 | char* IPv4地址，获取出错或无IP返回NULL | -``` -+----------+---+----------------+--------------------------+---+ -| > 卡信息 | | char \*nc) | > 地址 | | -+==========+===+================+==========================+===+ -| | | > 参数说明 | > 返回值说明 | | -+----------+---+----------------+--------------------------+---+ -| | | nc：网卡名称， | char\* IPv4 地址，获取出 | | -| | | | | | -| | | > 如 eno1 | > 错或无 IP 返回 NULL | | -+----------+---+----------------+--------------------------+---+ -``` 获取指定网卡的所有 IPv4 地址 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 网 | C | extern char\*\* | 获取指定网卡 | | -| | | kdk | | | -| > 卡信息 | | _nc_get_ipv4(const | 的所有 IPv4 地 | | -| | | char\* nc) | | | -| | | | > 址 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | nc：网卡名称， | char\*\* IPv4 | | -| | | | 地址列 表， | | -| | | > 如 eno1 | | | -| | | | 以 NULL 表示结尾， | | -| | | | 由 | | -| | | | | | -| | | | alloc 生 成 ， 需 | | -| | | | 要 被 | | -| | | | | | -| | | | kdk_nc_freeall 回 | | -| | | | 收 ； 若 | | -| | | | | | -| | | | 获取出错，返回 | | -| | | | NULL； | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取指定网卡的第一个 IPv6 地址 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-----------------------------------------------|----------------------------------------------------------------------| +| 获取网卡信息 | C | extern char** kdk_nc_get_ipv4(const char* nc) | 获取指定网卡的所有IPv4地址 | +| | | 参数说明 | 返回值说明 | | +| | | nc：网卡名称，如eno1 | char** IPv4地址列表，以NULL表示结尾，由alloc生成，需要被kdk_nc_freeall回收；若获取出错，返回NULL； | -``` -+----------+------------+--------------------+------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==================+===+ -| 获 取 网 | C | extern char\* | 获 取 指定 网 卡 | | -| | | kdk_nc_get_ | | | -| > 卡信息 | | private_ipv6(const | 的 第 一 个 IPv6 | | -| | | | | | -| | | char \*nc) | > 地址 | | -+----------+------------+--------------------+------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+------------------+---+ -``` + 获取指定网卡的第一个 IPv6 地址 -``` -+---+---+----------------+--------------------------+---+ -| | | nc：网卡名称， | char\* IPv6 地址，获取出 | | -| | | | | | -| | | > 如 eno1 | > 错或无 IP 返回 NULL | | -+---+---+----------------+--------------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------------------|-----------------------------| +| 获取网卡信息 | C | extern char* kdk_nc_get_private_ipv6(const char *nc) | 获取指定网卡的第一个IPv6地址 | +| | | 参数说明 | 返回值说明 | | +| | | nc：网卡名称，如eno1 | char* IPv6地址，获取出错或无IP返回NULL | 获取指定网卡的所有 IPv6 地址 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-----------------------------------------------|----------------------------------------------------------------------| +| 获取网卡信息 | C | extern char** kdk_nc_get_ipv6(const char *nc) | 获取指定网卡的所有IPv6地址 | +| | | 参数说明 | 返回值说明 | | +| | | nc：网卡名称，如eno1 | char** IPv6地址列表，以NULL表示结尾，由alloc生成，需要被kdk_nc_freeall回收；若获取出错，返回NULL； | -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 网 | C | extern char\*\* | 获 取 指定 网 卡 | | -| | | kdk | | | -| > 卡信息 | | _nc_get_ipv6(const | 的所有 IPv6 地 | | -| | | char \*nc) | | | -| | | | > 址 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | nc：网卡名称， | char\*\* IPv6 地 | | -| | | | 址 列 表 ， | | -| | | > 如 eno1 | | | -| | | | 以 NULL 表示 | | -| | | | 结尾， 由 | | -| | | | | | -| | | | alloc 生 成 ， 需 | | -| | | | 要 被 | | -| | | | | | -| | | | kdk_nc_freeall 回 | | -| | | | 收 ； 若 | | -| | | | | | -| | | | > 获取出错，返回 | | -| | | | > NULL； | | -+----------+------------+--------------------+--------------------+---+ -``` 获取指定网卡的有线/无线类型 -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------------|----------------| +| 获取网卡信息 | C | extern int kdk_nc_is_wireless(const char *nc); | 获取指定网卡的有线/无线类型 | +| | | 参数说明 | 返回值说明 | | +| | | nc：网卡名称，如eno1 | 0 : 有线 | +| 1 : 无线 | - +----------+------------+--------------------+------------------+---+ - | > 子模块 | > 编程语言 | 声明 | > 描述 | | - +==========+============+====================+==================+===+ - | 获 取 网 | C | extern int | 获 取 指定 网 卡 | | - | | | kdk_nc | | | - | > 卡信息 | | _is_wireless(const | 的有线/无线类 | | - | | | char \*nc); | | | - | | | | > 型 | | - +----------+------------+--------------------+------------------+---+ - | | | > 参数说明 | > 返回值说明 | | - +----------+------------+--------------------+------------------+---+ - | | | nc：网卡名称， | > 0 : 有线 | | - | | | | > | | - | | | > 如 eno1 | > 1 : 无线 | | - +----------+------------+--------------------+------------------+---+ -``` 获取指定网卡的厂商名称和设备型号 - -``` -+----------+------------+--------------------+------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==================+===+ -| 获 取 网 | C | extern int | 获 取 指定 网 卡 | | -| | | | | | -| > 卡信息 | | kdk_nc_get_vendor | 的 厂 商 名称 和 | | -| | | _and_product(const | | | -| | | char | > 设备型号 | | -| | | | | | -| | | \*nc, char | | | -| | | \*vendor, char | | | -| | | \*product); | | | -+----------+------------+--------------------+------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+------------------+---+ -| | | nc：网卡名称， | > 0 : 成功 | | -| | | | > | | -| | | > 如 eno1 | > 1 : 失败 | | -| | | | | | -| | | vendor ： 接 受 厂 | | | -| | | | | | -| | | > 商名称的缓冲区 | | | -| | | | | | -| | | product：接受设 | | | -| | | | | | -| | | > 备型号的缓冲区 | | | -+----------+------------+--------------------+------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------------------|--------|----------------------------------------------------------------------------------------|------------------| +| 获取网卡信息 | C | extern int kdk_nc_get_vendor_and_product(const char *nc, char *vendor, char *product); | 获取指定网卡的厂商名称和设备型号 | +| | | 参数说明 | 返回值说明 | | +| | | nc：网卡名称，如eno1 | +| vendor：接受厂商名称的缓冲区 | +| product：接受设备型号的缓冲区 | 0 : 成功 | +| 1 : 失败 | 回收字符串列表 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-----------------------------------------------|---------| +| 获取网卡信息 | C | extern inline void kdk_nc_freeall(char **ptr) | 回收字符串列表 | +| | | 参数说明 | 返回值说明 | | +| | | ptr：字符串列表 | 无 | -``` -+----------+------------+--------------------+------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==================+===+ -| 获 取 网 | C | extern inline void | 回 收 字符 串 列 | | -| | | k | | | -| > 卡信息 | | dk_nc_freeall(char | > 表 | | -| | | \*\*ptr) | | | -+----------+------------+--------------------+------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+------------------+---+ -| | | > ptr：字符串列表 | > 无 | | -+----------+------------+--------------------+------------------+---+ -``` #### **3.1.2.3** 获取磁盘信息 -- Gitee From 956a609721d840ad03f4d78bcb3ce3619f112fdb Mon Sep 17 00:00:00 2001 From: chipo Date: Fri, 11 Nov 2022 02:12:31 +0000 Subject: [PATCH 2/4] =?UTF-8?q?update=20=E5=BC=80=E5=A7=8B=E8=B4=A1?= =?UTF-8?q?=E7=8C=AE/openKylin+SDK=E5=BC=80=E5=8F=91=E6=8C=87=E5=8D=97V2.0?= =?UTF-8?q?.md.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: chipo --- ...45\217\221\346\214\207\345\215\227V2.0.md" | 764 ++++-------------- 1 file changed, 153 insertions(+), 611 deletions(-) diff --git "a/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" "b/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" index 8dfa59d..2b2f47a 100644 --- "a/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" +++ "b/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" @@ -431,126 +431,42 @@ $ sudo apt-get install libkysdk-hardware libkysdk-hardware-dev | 获取系统中所有磁盘的列表 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 磁 | C | extern char\*\* | 获取系统中 | | -| | | kdk_get_disklist() | | | -| > 盘信息 | | | 所有磁盘的 | | -| | | | | | -| | | | > 列表 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char\*\*， | | -| | | | 每个字符串表示 | | -| | | | | | -| | | | 一 | | -| | | | 个磁盘的绝对路径， | | -| | | | | | -| | | | 结尾以 NULL | | -| | | | 字符表示结 | | -| | | | | | -| | | | > 束 | | -+----------+------------+--------------------+--------------------+---+ +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------|-----------------------------------------| +| 获取磁盘信息 | C | extern char** kdk_get_disklist() | 获取系统中所有磁盘的列表 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char**， 每个字符串表示一个磁盘的绝对路径， 结尾以NULL字符表示结束 | -``` 释放由 kdk_get_disklist 返回的磁盘列表 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------------|----------------------------| +| 获取磁盘信息 | C | extern void kdk_free_disklist(char** disklist) | 释放由kdk_get_disklist返回的磁盘列表 | +| | | 参数说明 | 返回值说明 | | +| | | disklist ：由kdk_get_disk_list返回的字符串指针 | 无 | -``` -+----------+------------+--------------------+---------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+===============+===+ -| 获 取 磁 | C | extern void | > 释 放 由 | | -| | | kdk_free | | | -| > 盘信息 | | _disklist(char\*\* | kdk_get_disk | | -| | | disklist) | | | -| | | | list 返 回 的 | | -| | | | | | -| | | | > 磁盘列表 | | -+----------+------------+--------------------+---------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+---------------+---+ -| | | > disklist ： 由 | > 无 | | -| | | > | | | -| | | > | | | -| | | kdk_get_disk_list | | | -| | | | | | -| | | 返回的字符串指 | | | -| | | | | | -| | | > 针 | | | -+----------+------------+--------------------+---------------+---+ -``` 获取系统中指定磁盘的磁盘信息 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 磁 | C | extern | 获取指定磁 | | -| | | kdk_diskinfo | | | -| > 盘信息 | | \*kdk_ | 盘的磁盘信 | | -| | | get_diskinfo(const | | | -| | | | > 息 | | -| | | char \*diskname) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | diskname ： 指 定 | kdk_diskinfo\* | | -| | | | 该磁盘的详 | | -| | | 磁盘名称，应当 | | | -| | | | > 细 | | -| | | 是 例 如 /dev/sda | 信息，具体信息自取 | | -| | | | | | -| | | 这种绝对路径， | | | -| | | | | | -| | | 或者是 disklist 中 | | | -+----------+------------+--------------------+--------------------+---+ -``` - - +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------------------------------|-------------------------------| +| 获取磁盘信息 | C | extern kdk_diskinfo *kdk_get_diskinfo(const char *diskname) | 获取指定磁盘的磁盘信息 | +| | | 参数说明 | 返回值说明 | | +| | | diskname：指定磁盘名称，应当是例如/dev/sda这种绝对路径，或者是disklist中的某个元素 | kdk_diskinfo* 该磁盘的详细信息，具体信息自取 | -``` -+---+---+--------------+---+---+ -| | | > 的某个元素 | | | -+---+---+--------------+---+---+ -``` 释放由 kdk_get_diskinfo 返回的磁盘信息结构体 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|-------------------------------| +| 获取磁盘信息 | C | extern void kdk_free_diskinfo(kdk_diskinfo *disk); | 释放由kdk_get_diskinfo返回的磁盘信息结构体 | +| | | 参数说明 | 返回值说明 | | +| | | disk：由kdk_get_diskinfo返回的结构体指针 | 无 | -``` -+----------+------------+--------------------+---------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+===============+===+ -| 获 取 磁 | C | extern void | > 释 放 由 | | -| | | kdk_free_dis | | | -| > 盘信息 | | kinfo(kdk_diskinfo | kdk_get_disk | | -| | | | | | -| | | \*disk); | info 返 回 的 | | -| | | | | | -| | | | 磁盘信息结 | | -| | | | | | -| | | | > 构体 | | -+----------+------------+--------------------+---------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+---------------+---+ -| | | > disk ： 由 | > 无 | | -| | | > | | | -| | | > kdk_get_diskinfo | | | -| | | | | | -| | | 返回的结构体指 | | | -| | | | | | -| | | > 针 | | | -+----------+------------+--------------------+---------------+---+ -``` #### 3.1.2.4 获取 bios 信息 @@ -578,67 +494,33 @@ $ sudo apt-get install libkysdk-hardware libkysdk-hardware-dev | 获取 bios 厂商信息 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 磁 | C | extern const char | 获取 bios 厂 | | -| | | \*kdk_ | | | -| > 盘信息 | | bios_get_vendor(); | > 商信息 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | 成功返回 bios | | -| | | | 厂商，失败 | | -| | | | | | -| | | | > 返回 null | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------------|---------------------| +| 获取磁盘信息 | C | extern const char *kdk_bios_get_vendor(); | 获取bios厂商信息 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | 成功返回bios厂商，失败返回null | + 获取 bios 版本信息 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|--------------------------------------------|---------------------| +| 获取磁盘信息 | C | extern const char *kdk_bios_get_version(); | 获取bios版本信息 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | 成功返回bios版本，失败返回null | -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 磁 | C | extern const char | 获取 bios 版 | | -| | | \*kdk_b | | | -| > 盘信息 | | ios_get_version(); | > 本信息 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | 成功返回 bios | | -| | | | 版本，失败 | | -| | | | | | -| | | | > 返回 null | | -+----------+------------+--------------------+--------------------+---+ -``` 释放内存 -``` -+----------+------------+------+--------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+----------+------------+------+--------+ +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------|---------------| +| 获取磁盘信息 | C | extern void kdk_bios_free(char* info); | 释放获取信息接口申请的内存 | +| | | 参数说明 | 返回值说明 | | +| | | 获取信息接口返回的指针 | 无 | -+----------+---+-----------------------------------------+--------------+---+ -| 获 取 磁 | C | extern void kdk_bios_free(char\* info); | 释放获取信 | | -| | | | | | -| > 盘信息 | | | 息接口申请 | | -| | | | | | -| | | | > 的内存 | | -+==========+===+=========================================+==============+===+ -| | | > 参数说明 | > 返回值说明 | | -+----------+---+-----------------------------------------+--------------+---+ -| | | 获取信息接口返 | > 无 | | -| | | | | | -| | | > 回的指针 | | | -+----------+---+-----------------------------------------+--------------+---+ -``` #### 3.1.2.5 获取主板信息 @@ -665,113 +547,53 @@ $ sudo apt-get install libkysdk-hardware libkysdk-hardware-dev | 获取主板产品名称信息 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------|---------------------| +| 获取磁盘信息 | C | extern const char *kdk_board_get_name(); | 获取主板产品名称 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | 成功返回主板产品名称，失败返回null | -``` -+----------+------------+-------------------------------------------+------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+===========================================+============+ -| 获 取 磁 | C | extern const char \*kdk_board_get_name(); | 获取主板产 | -| | | | | -| > 盘信息 | | | > 品名称 | -+----------+------------+-------------------------------------------+------------+ -``` - - - -``` -+---+---+------------+------------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+===+===+============+========================+===+ -| | | > 无 | 成功返回主板产品名称， | | -| | | | | | -| | | | > 失败返回 null | | -+---+---+------------+------------------------+---+ -``` 获取主板生产日期 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 磁 | C | extern const char | 获取主板生 | | -| | | \*kdk | | | -| > 盘信息 | | _board_get_date(); | > 产日期 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | 成功 | | -| | | | 返回主板生产日期， | | -| | | | | | -| | | | > 失败返回 null | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------|---------------------| +| 获取磁盘信息 | C | extern const char *kdk_board_get_date(); | 获取主板生产日期 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | 成功返回主板生产日期，失败返回null | 获取主板序列号 - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 磁 | C | extern const char | 获取主板序 | | -| | | \*kdk_b | | | -| > 盘信息 | | oard_get_serial(); | > 列号 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | 成功 | | -| | | | 返回主板序列号，失 | | -| | | | | | -| | | | > 败返回 null | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|--------------------------------------------|--------------------| +| 获取磁盘信息 | C | extern const char *kdk_board_get_serial(); | 获取主板序列号 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | 成功返回主板序列号，失败返回null | 获取主板厂商信息 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 磁 | C | extern const char | 获取主板厂 | | -| | | \*kdk_b | | | -| > 盘信息 | | oard_get_vendor(); | > 商信息 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | 成功 | | -| | | | 返回主板厂商信息， | | -| | | | | | -| | | | > 失败返回 null | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|--------------------------------------------|---------------------| +| 获取磁盘信息 | C | extern const char *kdk_board_get_vendor(); | 获取主板厂商信息 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | 成功返回主板厂商信息，失败返回null | + 释放内存 -``` -+----------+------------+------------------------------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+==========================================+==============+===+ -| 获 取 磁 | C | extern void kdk_board_free(char\* info); | 释放获取信 | | -| | | | | | -| > 盘信息 | | | 息接口申请 | | -| | | | | | -| | | | > 的内存 | | -+----------+------------+------------------------------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+------------------------------------------+--------------+---+ -| | | 获取信息接口返 | > 无 | | -| | | | | | -| | | > 回的指针 | | | -+----------+------------+------------------------------------------+--------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-----------------------------------------|---------------| +| 获取磁盘信息 | C | extern void kdk_board_free(char* info); | 释放获取信息接口申请的内存 | +| | | 参数说明 | 返回值说明 | | +| | | 获取信息接口返回的指针 | 无 | + #### 3.1.2.6 获取 usb 设备信息 @@ -799,54 +621,21 @@ $ sudo apt-get install libkysdk-hardware libkysdk-hardware-dev | 获取所有 usb 设备信息 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 磁 | C | extern | 获 取 usb 设 | | -| | | pDriverInfoList | | | -| > 盘信息 | | k | > 备信息 | | -| | | dk_usb_get_list(); | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | pDriverInfoList : | | -| | | | usb 设 备 | | -| | | | | | -| | | | 信息 | | -| | | | 的结构体指针，具体 | | -| | | | | | -| | | | > 信息自取 | | -+----------+------------+--------------------+--------------------+---+ - -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|--------------------------------------------|----------------------------------------| +| 获取磁盘信息 | C | extern pDriverInfoList kdk_usb_get_list(); | 获取usb设备信息 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | pDriverInfoList : usb设备信息的结构体指针，具体信息自取 | 释放内存 -``` -+----------+------------+--------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==============+===+ -| 获 取 磁 | C | extern void | 释放获取信 | | -| | | kdk_usb_fr | | | -| > 盘信息 | | ee(pDriverInfoList | 息时申请的 | | -| | | list); | | | -| | | | > 内存 | | -+----------+------------+--------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------+---+ -``` - - +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------------------|--------------| +| 获取磁盘信息 | C | extern void kdk_usb_free(pDriverInfoList list); | 释放获取信息时申请的内存 | +| | | 参数说明 | 返回值说明 | | +| | | list:kdk_usb_get_list()返回的指针 | 无 | -``` -+---+---+--------------------+------+---+ -| | | list:kdk_usb_get_l | > 无 | | -| | | | | | -| | | > ist()返回的指针 | | | -+---+---+--------------------+------+---+ -``` ### **3.1.3** 获取包列表信息 @@ -877,105 +666,35 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev 获取系统中所有包列表 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 包 | C | extern | 获取系统中所有 | | -| | | kdk_package_list\* | | | -| 列 表 信 | | | > 包列表 | | -| | | kdk_package | | | -| > 息 | | _get_packagelist() | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | kdk_package_list\* | | -| | | | 包描述 | | -| | | | | | -| | | | 结构 | | -| | | | 体列表；返回的结构 | | -| | | | | | -| | | | > 体 需 要 由 | | -+----------+------------+--------------------+--------------------+---+ -``` - - +| 子模块 | 编程语言 | 声明 | 描述 | +|---------|------|--------------------------------------------------------|----------------------------------------------------------------------| +| 获取包列表信息 | C | extern kdk_package_list* kdk_package_get_packagelist() | 获取系统中所有包列表 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | kdk_package_list* 包描述结构体列表；返回的结构体需要由kdk_package_free_packagelist()回收 | -``` -+---+---+---+--------------------------+---+ -| | | | kdk_package_free_package | | -| | | | | | -| | | | > list()回收 | | -+---+---+---+--------------------------+---+ -``` 获取系统中指定包的版本号 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 包 | C | extern char\* | 获取系统中指 | | -| | | kdk_package | | | -| 列 表 信 | | _get_version(const | 定包的版本号 | | -| | | | | | -| > 息 | | char \*name) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > name：软件包名 | char\* 版本号，由 | | -| | | | alloc 生 | | -| | | | | | -| | | | 成，需要被 | | -| | | | free；若给定 | | -| | | | | | -| | | | 的 包 不 存 在 ， | | -| | | | 则 返 回 | | -| | | | | | -| | | | > NULL | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 检测指定包名的软件包是否正确安装 +| 子模块 | 编程语言 | 声明 | 描述 | +|---------|------|--------------------------------------------------------|---------------------------------------------| +| 获取包列表信息 | C | extern char* kdk_package_get_version(const char *name) | 获取系统中指定包的版本号 | +| | | 参数说明 | 返回值说明 | | +| | | name：软件包名 | char* 版本号，由alloc生成，需要被free；若给定的包不存在，则返回NULL | -``` -+----------+------------+--------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==============+===+ -| 获 取 包 | C | extern int | 检测指定包名 | | -| | | kdk_package_ | | | -| 列 表 信 | | is_installed(const | 的软件包是否 | | -| | | char | | | -| > 息 | | | > 正确安装 | | -| | | \*name, const char | | | -| | | \*version) | | | -+----------+------------+--------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------+---+ -``` + 检测指定包名的软件包是否正确安装 -``` -+---+---+------------------+------------------------+---+ -| | | name ： 软 件 | int 成功返回 0，失败返 | | -| | | | | | -| | | > 包名 | > 回错误码 | | -| | | | | | -| | | version：版本 | | | -| | | | | | -| | | 号，大部分情况下 | | | -| | | | | | -| | | 为 NULL，预留为 | | | -| | | | | | -| | | > snap 做准备 | | | -+---+---+------------------+------------------------+---+ +| 子模块 | 编程语言 | 声明 | 描述 | +|------------------------------------|-------------------|----------------------------------------------------------------------------|------------------| +| 获取包列表信息 | C | extern int kdk_package_is_installed(const char *name, const char *version) | 检测指定包名的软件包是否正确安装 | +| | | 参数说明 | 返回值说明 | | +| | | name：软件包名 | +| version：版本号，大部分情况下为NULL，预留为snap做准备 | int 成功返回0，失败返回错误码 | -``` ### **3.1.4** 获取资源信息 @@ -1007,301 +726,124 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev 获取系统中物理内存总大小 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------------------|-----------------------------| +| 获取资源信息 | C | extern unsigned long kdk_rti_get_mem_res_total_KiB() | 获取系统中物理内存总大小 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned long 物理内存大小，KiB为单位 | -``` -+----------+------------+---------------------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+=================================+==============+===+ -| 获 取 资 | C | extern unsigned long | 获取系统中物 | | -| | | | | | -| > 源信息 | | kdk_rti_get_mem_res_total_KiB() | 理内存总大小 | | -+----------+------------+---------------------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+---------------------------------+--------------+---+ -``` - - - -``` -+---+---+------+---------------------------+---+ -| | | > 无 | unsigned long 物 理 内 存 | | -| | | | | | -| | | | > 大小，KiB 为单位 | | -+---+---+------+---------------------------+---+ -``` 获取物理内存使用率 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|--------------------------------------------------|---------------| +| 获取资源信息 | C | extern float kdk_rti_get_mem_res_usage_percent() | 获取物理内存使用率 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | float 物理内存使用率 | -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern float | 获取物理内 | | -| | | | | | -| > 源信息 | | kdk_rti_get_mem_r | > 存使用率 | | -| | | es_usage_percent() | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | > float | | -| | | | > 物理内存使用率 | | -+----------+------------+--------------------+--------------------+---+ -``` 获取物理内存使用大小 -``` -+----------+----------+---------------------------------+--------------------------+---+ -| > 子模块 | 编程语言 | 声明 | > 描述 | | -+==========+==========+=================================+==========================+===+ -| 获 取 资 | C | extern unsigned long | 获 取 物 理 内 存 | | -| | | | | | -| > 源信息 | | kdk_rti_get_mem_res_usage_KiB() | 使 用 大 小 ， 注 | | -| | | | | | -| | | | 意 Buffer/Cache | | -| | | | | | -| | | | 被 计 算 为 已 使 | | -| | | | | | -| | | | > 用内存 | | -+----------+----------+---------------------------------+--------------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+----------+---------------------------------+--------------------------+---+ -| | | > 无 | unsigned long 物理内存使 | | -| | | | | | -| | | | > 用大小，KiB 为单位 | | -+----------+----------+---------------------------------+--------------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------------------|------------------------------------| +| 获取资源信息 | C | extern unsigned long kdk_rti_get_mem_res_usage_KiB() | 获取物理内存使用大小，注意Buffer/Cache被计算为已使用内存 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned long 物理内存使用大小，KiB为单位 | + 获取实际可用的物理内存大小 -``` -+----------+------------+------+--------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+----------+------------+------+--------+ +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------------|-------------------------------------------| +| 获取资源信息 | C | extern unsigned long kdk_rti_get_mem_res_available_KiB() | 获取实际可用的物理内存大小，该数值约等于Free + Buffer + Cache | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned long 可用物理内存大小，KiB为单位 | -+----------+---+-------------------------------------+----------------------------+---+ -| 获 取 资 | C | extern unsigned long | 获取实际可用 | | -| | | | | | -| > 源信息 | | kdk_rti_get_mem_res_available_KiB() | 的物理内存大 | | -| | | | | | -| | | | 小，该数值约 | | -| | | | | | -| | | | 等 于 Free + | | -| | | | | | -| | | | Buffer + Cache | | -+==========+===+=====================================+============================+===+ -| | | > 参数说明 | > 返回值说明 | | -+----------+---+-------------------------------------+----------------------------+---+ -| | | > 无 | unsigned long 可用物理内存 | | -| | | | | | -| | | | > 大小，KiB 为单位 | | -+----------+---+-------------------------------------+----------------------------+---+ -``` 获取实际空闲的物理内存大小 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-----------------------------------------------------|---------------------------------------| +| 获取资源信息 | C | extern unsigned long kdk_rti_get_mem_res_free_KiB() | 获取实际空闲的物理内存大小，注意Buffer/Cache被计算为已使用内存 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned long 空闲的物理内存大小，KiB为单位 | -``` -+----------+----------+---------------------+---------------------+---+ -| > 子模块 | 编程语言 | 声明 | > 描述 | | -+==========+==========+=====================+=====================+===+ -| 获 取 资 | C | extern unsigned | > 获取实际空闲 | | -| | | long | 的物理内存大小，注 | | -| > 源信息 | | | > 意Buffer/Cache | | -| | | kdk_rti_get | > | | -| | | _mem_res_free_KiB() | 被计算为已使用内存 | | -+----------+----------+---------------------+---------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+----------+---------------------+---------------------+---+ -| | | > 无 | unsigned long | | -| | | | 空闲的物理 | | -| | | | | | -| | | | > 内存大小，KiB | | -| | | | > 为单位 | | -+----------+----------+---------------------+---------------------+---+ - -``` 获取所有应用申请的虚拟内存总量 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------------------------|-------------------------------| +| 获取资源信息 | C | extern unsigned long kdk_rti_get_mem_virt_alloc_KiB() | 获取所有应用申请的虚拟内存总量 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned long 虚拟内存总申请量，KiB为单位 | -``` -+----------+------------+----------------------------------+----------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+==================================+================+ -| 获 取 资 | C | extern unsigned long | 获取所有应用申 | -| | | | | -| > 源信息 | | kdk_rti_get_mem_virt_alloc_KiB() | 请的虚拟内存总 | -+----------+------------+----------------------------------+----------------+ - -+---+---+------------+--------------------------+---+ -| | | | > 量 | | -+===+===+============+==========================+===+ -| | | > 参数说明 | > 返回值说明 | | -+---+---+------------+--------------------------+---+ -| | | > 无 | unsigned long 虚拟内存总 | | -| | | | | | -| | | | > 申请量，KiB 为单位 | | -+---+---+------------+--------------------------+---+ - -``` 获取系统中 Swap 分区总大小 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern unsigned | 获 取 系 统 中 | | -| | | long | | | -| > 源信息 | | | Swap 分 区总 大 | | -| | | kdk_rti_get_me | | | -| | | m_swap_total_KiB() | > 小 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | unsigned long Swap | | -| | | | 分 区 | | -| | | | | | -| | | | > 大小，KiB 为单位 | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------------------------|-------------------------------| +| 获取资源信息 | C | extern unsigned long kdk_rti_get_mem_swap_total_KiB() | 获取系统中Swap分区总大小 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned long Swap分区大小，KiB为单位 | + 获取 Swap 分区使用率 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|---------------------------------------------------|-----------------| +| 获取资源信息 | C | extern float kdk_rti_get_mem_swap_usage_percent() | 获取Swap分区使用率 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | float Swap分区使用率 | -``` -+----------+----------+---------------------+---------------------+---+ -| > 子模块 | 编程语言 | 声明 | > 描述 | | -+==========+==========+=====================+=====================+===+ -| 获 取 资 | C | extern float | 获 取 Swap | | -| | | | | | -| > 源信息 | | kdk_rti_get_mem_s | 分区使用率 | | -| | | wap_usage_percent() | | | -+----------+----------+---------------------+---------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+----------+---------------------+---------------------+---+ -| | | > 无 | > float Swap | | -| | | | > 分区使用率 | | -+----------+----------+---------------------+---------------------+---+ -``` 获取 Swap 分区使用量 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------------------------|--------------------------------| +| 获取资源信息 | C | extern unsigned long kdk_rti_get_mem_swap_usage_KiB() | 获取Swap分区使用量 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned long Swap分区使用量，KiB为单位 | -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern unsigned | 获取 Swap 分区 | | -| | | long | | | -| > 源信息 | | | > 使用量 | | -| | | kdk_rti_get_me | | | -| | | m_swap_usage_KiB() | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | unsigned long Swap | | -| | | | 分 区 | | -| | | | | | -| | | | > 使用量，KiB | | -| | | | > 为单位 | | -+----------+------------+--------------------+--------------------+---+ -``` 获取 Swap 分区空闲大小 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern unsigned | 获取 Swap 分区 | | -| | | long | | | -| > 源信息 | | | > 空闲大小 | | -| | | kdk_rti_get_m | | | -| | | em_swap_free_KiB() | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | unsigned long Swap | | -| | | | 分 区 | | -| | | | | | -| | | | > 空闲大小，KiB | | -| | | | > 为单位 | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|------------------------------------------------------|---------------------------------| +| 获取资源信息 | C | extern unsigned long kdk_rti_get_mem_swap_free_KiB() | 获取Swap分区空闲大小 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned long Swap分区空闲大小，KiB为单位 | + 获取 CPU 瞬时使用率 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern float | 获 取 CPU 瞬 时 | | -| | | kdk_rti_get_c | | | -| > 源信息 | | pu_current_usage() | > 使用率 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | float CPU | | -| | | | 瞬时使用率， | | -| | | | | | -| | | | > 该值 \< 1.00 | | -+----------+------------+--------------------+--------------------+---+ +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------|--------------------------| +| 获取资源信息 | C | extern float kdk_rti_get_cpu_current_usage() | 获取CPU瞬时使用率 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | float CPU瞬时使用率，该值 < 1.00 | -``` 获取操作系统开机时长 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern int | 获 取 操 作 系 统 | | -| | | kdk_rti_g | | | -| > 源信息 | | et_uptime(unsigned | > 开机时长 | | -| | | int | | | -| | | | | | -| | | \*day, unsigned | | | -| | | int \*hour, | | | -| | | unsigned int | | | -| | | \*min, | | | -| | | | | | -| | | unsigned int | | | -| | | \*sec) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > day：开机天数 | int 返 回 0 表 示 | | -| | | > | 成 | | -| | | > hour 小时数，该 | | | -| | | > | 功，返回非零表示 | | -| | | > 数值一定 \< 24 | | | -| | | > | > 失败 | | -| | | > min：分钟数，该 | | | -| | | > | | | -| | | > 数值一定 \< 60 | | | -| | | > | | | -| | | > sec ：秒数，该数 | | | -| | | > | | | -| | | > 值一定 \< 60 | | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------------------|----------------|------------------------------------------------------------------------------------------------------------|------------| +| 获取资源信息 | C | extern int kdk_rti_get_uptime(unsigned int *day, unsigned int *hour, unsigned int *min, unsigned int *sec) | 获取操作系统开机时长 | +| | | 参数说明 | 返回值说明 | | +| | | day：开机天数
hour小时数，该数值一定 < 24
min：分钟数，该数值一定 < 60
sec：秒数，该数值一定 < 60
int 返回0表示成功，返回非零表示失败 | 获取指定进程的 CPU 使用率 -- Gitee From 4cf6ac3c72f7ddb97f6c410548fc3302f9c594cd Mon Sep 17 00:00:00 2001 From: chipo Date: Fri, 11 Nov 2022 03:19:56 +0000 Subject: [PATCH 3/4] =?UTF-8?q?update=20=E5=BC=80=E5=A7=8B=E8=B4=A1?= =?UTF-8?q?=E7=8C=AE/openKylin+SDK=E5=BC=80=E5=8F=91=E6=8C=87=E5=8D=97V2.0?= =?UTF-8?q?.md.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: chipo --- ...45\217\221\346\214\207\345\215\227V2.0.md" | 1669 ++++------------- 1 file changed, 390 insertions(+), 1279 deletions(-) diff --git "a/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" "b/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" index 2b2f47a..52cf024 100644 --- "a/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" +++ "b/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" @@ -843,893 +843,318 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev |--------------------|----------------|------------------------------------------------------------------------------------------------------------|------------| | 获取资源信息 | C | extern int kdk_rti_get_uptime(unsigned int *day, unsigned int *hour, unsigned int *min, unsigned int *sec) | 获取操作系统开机时长 | | | | 参数说明 | 返回值说明 | | -| | | day：开机天数
hour小时数，该数值一定 < 24
min：分钟数，该数值一定 < 60
sec：秒数，该数值一定 < 60
int 返回0表示成功，返回非零表示失败 | +| | | day：开机天数
hour小时数，该数值一定 < 24
min：分钟数，该数值一定 < 60
sec：秒数，该数值一定 < 60 | int 返回0表示成功，返回非零表示失败 | 获取指定进程的 CPU 使用率 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern float | 获 取 指 定 进 程 | | -| | | | | | -| > 源信息 | | k | > 的 CPU 使用率 | | -| | | dk_get_process_cpu | | | -| | | _usage_percent(int | | | -| | | | | | -| | | proc_num) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | proc_num ： 进 程 | > float CPU 使用率 | | -| | | | | | -| | | > 号 | | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|--------------------------------------------------------------|---------------| +| 获取资源信息 | C | extern float kdk_get_process_cpu_usage_percent(int proc_num) | 获取指定进程的CPU使用率 | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | float CPU使用率 | + 获取指定进程的内存占用率 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern float | > 获取指定进程 | | -| | | | > 的内存占用率 | | -| > 源信息 | | k | | | -| | | dk_get_process_mem | | | -| | | _usage_percent(int | | | -| | | | | | -| | | proc_num) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | proc_num ： 进 程 | > float 内存占用率 | | -| | | | | | -| | | > 号 | | | -+----------+------------+--------------------+--------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|--------------------------------------------------------------|--------------| +| 获取资源信息 | C | extern float kdk_get_process_mem_usage_percent(int proc_num) | 获取指定进程的内存占用率 | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | float 内存占用率 | + 获取指定进程的进程状态 -``` -+----------+------------+--------------------+-------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+===================+===+ -| 获 取 资 | C | extern char\* | 获取指定进程 | | -| | | kdk_get_ | | | -| > 源信息 | | process_status(int | 的进程状态 | | -| | | | | | -| | | proc_num) | | | -+----------+------------+--------------------+-------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+-------------------+---+ -| | | proc_num ： 进 程 | > char\* 进程状态 | | -| | | | | | -| | | > 号 | | | -+----------+------------+--------------------+-------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|---------------------------------------------------|-------------| +| 获取资源信息 | C | extern char* kdk_get_process_status(int proc_num) | 获取指定进程的进程状态 | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | char* 进程状态 | - 获取指定进程的端口号占用 + 获取指定进程的端口号占用 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern int | > 获取指定进程 | | -| | | kdk_ge | > 的端口号占用 | | -| > 源信息 | | t_process_port(int | | | -| | | proc_num) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-----------------------------------------------|--------------| +| 获取资源信息 | C | extern int kdk_get_process_port(int proc_num) | 获取指定进程的端口号占用 | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | char* 使用的端口号 | -+---+---+-------------------+-----------------------+---+ -| | | proc_num ： 进 程 | > char\* 使用的端口号 | | -| | | | | | -| | | > 号 | | | -+---+---+-------------------+-----------------------+---+ -``` 获取指定进程的启动时间 - -``` -+----------+------------+--------------------+-------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+===================+===+ -| 获 取 资 | C | extern char\* | 获取指定进程 | | -| | | kdk_get_proc | | | -| > 源信息 | | ess_start_time(int | 的启动时间 | | -| | | | | | -| | | proc_num) | | | -+----------+------------+--------------------+-------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+-------------------+---+ -| | | proc_num ： 进 程 | > char\* 启动时间 | | -| | | | | | -| | | > 号 | | | -+----------+------------+--------------------+-------------------+---+ -``` - +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------------------------|-------------| +| 获取资源信息 | C | extern char* kdk_get_process_start_time(int proc_num) | 获取指定进程的启动时间 | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | char* 启动时间 | 获取指定进程的运行时间 -``` -+----------+------------+--------------------+-------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+===================+===+ -| 获 取 资 | C | extern char\* | 获取指定进程 | | -| | | kdk_get_proc | | | -| > 源信息 | | ess_start_time(int | 的启动时间 | | -| | | | | | -| | | proc_num) | | | -+----------+------------+--------------------+-------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+-------------------+---+ -| | | proc_num ： 进 程 | > char\* 启动时间 | | -| | | | | | -| | | > 号 | | | -+----------+------------+--------------------+-------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-------------------------------------------------------|-------------| +| 获取资源信息 | C | extern char* kdk_get_process_start_time(int proc_num) | 获取指定进程的启动时间 | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | char* 启动时间 | + 获取指定进程的 cpu 时间 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|-----------------------------------------------------|--------------| +| 获取资源信息 | C | extern char* kdk_get_process_cpu_time(int proc_num) | 获取指定进程的cpu时间 | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | char* cpu时间 | -``` -+----------+------------+--------------------------------------------+--------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+============================================+==============+ -| 获 取 资 | C | extern char\* kdk_get_process_cpu_time(int | 获取指定进程 | -| | | | | -| > 源信息 | | proc_num) | 的 cpu 时间 | -+----------+------------+--------------------------------------------+--------------+ - -+---+---+-------------------+-------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+===+===+===================+===================+===+ -| | | proc_num ： 进 程 | > char\* cpu 时间 | | -| | | | | | -| | | > 号 | | | -+---+---+-------------------+-------------------+---+ -``` 获取指定进程的 Command -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern char\* | > 获取指定进程 的 | | -| | | kdk_get_p | > Command | | -| > 源信息 | | rocess_command(int | | | -| | | | | | -| | | proc_num) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | proc_num ： 进 程 | > char\* Command | | -| | | | | | -| | | > 号 | | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取指定进程的属主 - - -``` -+----------+------------+----------------------------------------+---------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+========================================+===============+===+ -| 获 取 资 | C | extern char\* kdk_get_process_user(int | 获取指定进程 | | -| | | | | | -| > 源信息 | | proc_num) | 的属主 | | -+----------+------------+----------------------------------------+---------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+----------------------------------------+---------------+---+ -| | | proc_num ： 进 程 | > char\* 属主 | | -| | | | | | -| | | > 号 | | | -+----------+------------+----------------------------------------+---------------+---+ -``` - - - 获取指定进程的 CPU 使用率 - - -``` -+----------+------------+------+--------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+----------+------------+------+--------+ - -+----------+---+------------------------+------------------------+---+ -| 获 取 资 | C | extern float | > 获取指定进程 的 CPU | | -| | | | > 使用率 | | -| > 源信息 | | kdk_procname_get_pr | | | -| | | ocess_cpu_usage_percen | | | -| | | | | | -| | | t(char \*proc_name) | | | -+==========+===+========================+========================+===+ -| | | > 参数说明 | > 返回值说明 | | -+----------+---+------------------------+------------------------+---+ -| | | proc_name 进 程 | > float CPU 使用率 | | -| | | | | | -| | | > 名 | | | -+----------+---+------------------------+------------------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取资源信息 | C | extern char* kdk_get_process_command(int proc_num) | 获取指定进程的Command | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | char* Command | - 获取指定进程的信息 - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 资 | C | extern char\*\* | 获取指定进程 | | -| | | | | | -| > 源信息 | | kdk_ | 的信息 | | -| | | procname_get_proce | | | -| | | ss_infomation(char | | | -| | | | | | -| | | \*proc_name) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | proc_name 进 程 | char\*\* 进 程 的 | | -| | | | 信 息 列 | | -| | | > 名 | | | -| | | | 表 ， 以 NULL 表 | | -| | | | 示 结 | | -| | | | | | -| | | | 尾，由 alloc | | -| | | | 生成，需要 | | -| | | | | | -| | | | > 被 | | -| | | | > kdk_proc_freeall | | -| | | | > 回 | | -| | | | | | -| | | | 收 | | -| | | | ；若获取出错，返回 | | -| | | | | | -| | | | > NULL； | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取进程所有信息 - -``` - -+----------+------------+--------------------------------------------+--------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+============================================+==============+ -| 获 取 资 | C | char\*\* kdk_get_process_all_information() | 获取进程所有 | -| | | | | -| | | | 信息 | -+----------+------------+--------------------------------------------+--------------+ - -+----------+---+------------+--------------------------+---+ -| > 源信息 | | > 参数说明 | > 返回值说明 | | -+==========+===+============+==========================+===+ -| | | > 无 | char\*\* 进程所有信息列 | | -| | | | | | -| | | | 表，，以 NULL 表示结 | | -| | | | | | -| | | | 尾，由 alloc 生成，需要 | | -| | | | | | -| | | | > 被 kdk_proc_freeall 回 | | -| | | | | | -| | | | 收；若获取出错，返回 | | -| | | | | | -| | | | > NULL； | | -+----------+---+------------+--------------------------+---+ - -``` - - 回收字符串列表 - - -``` -+----------+------------+--------------------+------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==================+===+ -| 获 取 资 | C | extern inline void | 回 收 字符 串 列 | | -| | | kdk | | | -| > 源信息 | | _proc_freeall(char | > 表 | | -| | | \*\*ptr) | | | -+----------+------------+--------------------+------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+------------------+---+ -| | | > ptr：字符串列表 | > 无 | | -+----------+------------+--------------------+------------------+---+ -``` - - -### **3.1.5** 获取操作系统基础信息 - - 封装 C 接口获取系统名称、版本号、激活信息等。 - -+-----------------------------------------------------------------+ -| > \$ sudo apt-get install libkysdk-sysinfo libkysdk-sysinfo-dev | -+-----------------------------------------------------------------+ - - （1）CMakeLists.txt 构建项目 - - aux_source_directory(. SOURCESCODE) - - include_directories(.) - - find_library(GLIBC_LIB glib-2.0) - - find_library(DBUS_LIB dbus-1) - - find_library(DBUS_GLIB_LIB dbus-glib-1) - - add_library(kysysinfo SHARED \${SOURCESCODE}) - - add_executable(kysysinfo-test test/kysysinfo_test.c) - - target_link_libraries(kysysinfo kylin-activation kylog systemd kyconf - - \${GLIBC_LIB} \${DBUS_LIB} \${DBUS_GLIB_LIB}) - - target_link_libraries(kysysinfo-test kysysinfo) - - （2）获取操作系统信息，需要添加头文件： - - \#include \"kysdk/kysdk-system/libkysysinfo.h\" - - 获取操作系统架构信息 - - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern char\* | 获取系统架构信 | | -| | | kdk_system_ | | | -| 统 基 础 | | get_architecture() | > 息 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char\* 系 统 架 构 | | -| | | | ， 例 ： | | -| | | | | | -| | | | > x86_64 | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取操作系统名称 - - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern char\* | 获取操作系统名 | | -| | | kdk_syste | | | -| 统 基 础 | | m_get_systemName() | > 称 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char\* 系 统 名 称 | | -| | | | ， 例 ： | | -| | | | | | -| | | | > Kylin | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取操作系统版本号 - - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern char\* | 获取系统版本 | | -| | | kdk_syste | | | -| 统 基 础 | | m_get_version(bool | > 号 | | -| | | | | | -| > 信息 | | verbose) | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | verbose：0 获取 | > char\* 系 统 版 | | -| | | | > 本 号 ， | | -| | | 简略版本号，1 | | | -| | | | 例： | | -| | | 获取详细版本号 | 系统简略版本：xxxx | | -| | | | | | -| | | | 桌面 | | -| | | | 操作系统；系统详细 | | -| | | | | | -| | | | > 版 本 ： | | -| | | | > Desktop-V10- | | -| | | | > | | -| | | | > Professional- | | -| | | | > | | -| | | | > Release-Build1- | | -| | | | > | | -| | | | > 210203 | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取内核版本号 - - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern char\* | 获取内核版本 | | -| | | kdk_system_g | | | -| 统 基 础 | | et_kernelVersion() | > 号 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | > char\* | | -| | | | > 内核版本号 | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取当前登录用户的用户名 - - -``` -+----------+------------+--------------------------------------+--------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+======================================+==============+ -| 获 取 系 | C | extern char\* kdk_system_get_eUser() | 获取当前登录 | -+----------+------------+--------------------------------------+--------------+ - -+----------+---+------------+-----------------------+---+ -| 统 基 础 | | | 用户的用户名 | | -| | | | | | -| > 信息 | | | > （ Effect | | -| | | | > | | -| | | | > User） | | -+==========+===+============+=======================+===+ -| | | > 参数说明 | > 返回值说明 | | -+----------+---+------------+-----------------------+---+ -| | | > 无 | char\* 成功 返回字 符 | | -| | | | | | -| | | | 串 ， 失 败 返 回 | | -| | | | | | -| | | | NULL 。 返回 的 字符 | | -| | | | | | -| | | | > 串需要被 free 释放 | | -+----------+---+------------+-----------------------+---+ -``` - - - 获取操作系统项目编号名 - - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern char\* | 获取操作系统 | | -| | | kdk_system | | | -| 统 基 础 | | _get_projectName() | > 项目编号名 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char\* 成功 返回字 | | -| | | | 符 | | -| | | | | | -| | | | 串 ， 失 败 返 回 | | -| | | | | | -| | | | NULL 。 返回 的 | | -| | | | 字符 | | -| | | | | | -| | | | > 串需要被 free | | -| | | | > 释放 | | -+----------+------------+--------------------+--------------------+---+ - -``` - - 获取操作系统项目子编号名 - - -``` -+----------+------------+--------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==============+===+ -| 获 取 系 | C | extern char\* | 获取操作系统 | | -| | | kdk_system_ge | | | -| 统 基 础 | | t_projectSubName() | 项目子编号名 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------+---+ - -+---+---+------+-----------------------+---+ -| | | > 无 | char\* 成功 返回字 符 | | -| | | | | | -| | | | 串 ， 失 败 返 回 | | -| | | | | | -| | | | NULL 。 返回 的 字符 | | -| | | | | | -| | | | > 串需要被 free 释放 | | -+---+---+------+-----------------------+---+ -``` - -> 获取操作系统产品标识码 - - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern unsigned | 获取操作系统 | | -| | | int | | | -| 统 基 础 | | | > 产品标识码 | | -| | | kdk_system_get | | | -| > 信息 | | _productFeatures() | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | unsigned int | | -| | | | 返回标志 | | -| | | | | | -| | | | > 码 | | -| | | | > | | -| | | | > 0000：信息异常 | | -| | | | > | | -| | | | > 0001：仅 PC 特性 | | -| | | | > | | -| | | | > 0010：仅平板特性 | | -| | | | | | -| | | | 0011 ： 支 持 平 | | -| | | | 板 与 | | -| | | | | | -| | | | > PC 特性 | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取操作系统宿主机的虚拟机类型 - - -``` -+----------+------------+--------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==============+===+ -| 获 取 系 | C | extern char\* | 获取操作系统 | | -| | | kdk_system_ | | | -| 统 基 础 | | get_hostVirtType() | 宿主机的虚拟 | | -| | | | | | -| > 信息 | | | > 机类型 | | -+----------+------------+--------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------+---+ - -+---+---+------+--------------------------+---+ -| | | > 无 | char\* 获取 失败返 回 | | -| | | | | | -| | | | NULL ， 获取 成 功返 | | -| | | | | | -| | | | 回一个字符串，字符 | | -| | | | | | -| | | | > 串内容如下： | | -| | | | | | -| | | | \[none, qemu, kvm, zvm, | | -| | | | | | -| | | | vmware,hyper-v, orcale | | -| | | | | | -| | | | virtualbox, xen, bochs, | | -| | | | | | -| | | | > uml,parallels,bhyve,qn | | -| | | | > | | -| | | | > x,arcn,openvz,lxc,lxc- | | -| | | | > | | -| | | | > libvirt,systemd- | | -| | | | | | -| | | | nspawn,docker,podman | | -| | | | | | -| | | | > ,rkt,wsl\] | | -+---+---+------+--------------------------+---+ -``` - - - 获取操作系统宿主机的云平台类型 - - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern char\* | 获取操作系统 | | -| | | | | | -| 统 基 础 | | kdk_system_get_h | 宿主机的云平 | | -| | | ostCloudPlatform() | | | -| > 信息 | | | > 台类型 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char\* | | -| | | | 获取失败返回 | | -| | | | | | -| | | | NULL ， 获取 成 | | -| | | | 功返 | | -| | | | | | -| | | | 回一个字符串，字符 | | -| | | | | | -| | | | > 串内容如下： | | -| | | | > | | -| | | | > \[none, huawei\] | | -+----------+------------+--------------------+--------------------+---+ -``` + 获取指定进程的属主 - 判断当前操作系统是否为专用机系统 +| 子模块 | 编程语言 | 声明 | 描述 | +|---------------|------|--------------------------------------------------------------------------|-------------------------------------------------------------------------| +| 获取资源信息 | C | extern char* kdk_get_process_user(int proc_num) | 获取指定进程的属主 | +| | | 参数说明 | 返回值说明 | | +| | | proc_num：进程号 | char* 属主 | | + 获取指定进程的CPU使用率 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取资源信息 | C | extern float kdk_procname_get_process_cpu_usage_percent(char *proc_name) | 获取指定进程的CPU使用率 | +| | | 参数说明 | 返回值说明 | | +| | | proc_name 进程名 | float CPU使用率 | | + 获取指定进程的信息 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取资源信息 | C | extern char** kdk_procname_get_process_infomation(char *proc_name) | 获取指定进程的信息 | +| | | 参数说明 | 返回值说明 | | +| | | proc_name 进程名 | char** 进程的信息列表，以NULL表示结尾，由alloc生成，需要被kdk_proc_freeall回收；若获取出错，返回NULL； | | + 获取进程所有信息 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取资源信息 | C | char** kdk_get_process_all_information() | 获取进程所有信息 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char** 进程所有信息列表，，以NULL表示结尾，由alloc生成，需要被kdk_proc_freeall回收；若获取出错，返回NULL； | | + 回收字符串列表 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取资源信息 | C | extern inline void kdk_proc_freeall(char **ptr) | 回收字符串列表 | +| | | 参数说明 | 返回值说明 | | +| | | ptr：字符串列表 | 无 | -``` - +----------+------------+-------------------------------------+------------------+---+ - | > 子模块 | > 编程语言 | 声明 | > 描述 | | - +==========+============+=====================================+==================+===+ - | 获 取 系 | C | extern bool kdk_system_is_zyj(void) | 判断当前镜像 | | - | | | | | | - | 统 基 础 | | | 系统否为专用 | | - | | | | | | - | > 信息 | | | > 机系统 | | - +----------+------------+-------------------------------------+------------------+---+ - | | | > 参数说明 | > 返回值说明 | | - +----------+------------+-------------------------------------+------------------+---+ - | | | > 无 | > bool | | - | | | | > | | - | | | | > true 代表是 | | - | | | | > | | - | | | | > false 代表不是 | | - +----------+------------+-------------------------------------+------------------+---+ -``` +### **3.1.5** 获取操作系统基础信息 - 获取系统分辨率信息 + 封装 C 接口获取系统名称、版本号、激活信息等。 ``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern char\*\* | 获取系统分辨 | | -| | | kdk_system_get | | | -| 统 基 础 | | _resolving_power() | > 率信息 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char\*\* | | -| | | | 分辨率信息列 | | -| | | | | | -| | | | 表，以 NULL 表示结 | | -| | | | | | -| | | | 尾 ， 由 alloc 生 | | -| | | | 成 ， | | -| | | | | | -| | | | > 需 要 被 | | -| | | | > | | -| | | | > kdk | | -| | | | _resolving_freeall | | -| | | | | | -| | | | 回收；若获取出错， | | -| | | | | | -| | | | > 返回 NULL； | | -+----------+------------+--------------------+--------------------+---+ ++-----------------------------------------------------------------+ +| > \$ sudo apt-get install libkysdk-sysinfo libkysdk-sysinfo-dev | ++-----------------------------------------------------------------+ ``` - 回收字符串列表 - - -``` -+----------+------------+------+--------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+----------+------------+------+--------+ + （1）CMakeLists.txt 构建项目 -+----------+---+----------------------------------------------+------------------+---+ -| 获 取 系 | C | extern inline void kdk_resolving_freeal(char | 回 收 字符 串 列 | | -| | | | | | -| 统 基 础 | | \*\*ptr) | > 表 | | -| | | | | | -| > 信息 | | | | | -+==========+===+==============================================+==================+===+ -| | | > 参数说明 | > 返回值说明 | | -+----------+---+----------------------------------------------+------------------+---+ -| | | > ptr：字符串列表 | > 无 | | -+----------+---+----------------------------------------------+------------------+---+ + ``` +aux_source_directory(. SOURCESCODE) + include_directories(.) -### **3.1.6** 获取网络信息 + find_library(GLIBC_LIB glib-2.0) - 获取网络连接状态 + find_library(DBUS_LIB dbus-1) + find_library(DBUS_GLIB_LIB dbus-glib-1) -``` -+----------+-------------+-----------------+-----------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+=============+=================+=================+===+ -| 获 取 系 | > dbus 接口 | > bus: system | 获取网络连接 | | -| | | > bus | | | -| 统 基 础 | | > | > 状态。 | | -| | | > name : | | | -| > 信息 | | > | | | -| | | org.freedesktop | | | -| | | .NetworkManager | | | -| | | > | | | -| | | > path: | | | -| | | > | | | -| | | org.freedesktop | | | -| | | .NetworkManager | | | -| | | > | | | -| | | > method: | | | -| | | > state()-\>int | | | -| | | > arg0; | | | -+----------+-------------+-----------------+-----------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+-------------+-----------------+-----------------+---+ -| | | > 无 | > int | | -| | | | > 网络连接状态 | | -+----------+-------------+-----------------+-----------------+---+ -``` + add_library(kysysinfo SHARED \${SOURCESCODE}) + add_executable(kysysinfo-test test/kysysinfo_test.c) - 获取网络端口状态 + target_link_libraries(kysysinfo kylin-activation kylog systemd kyconf + \${GLIBC_LIB} \${DBUS_LIB} \${DBUS_GLIB_LIB}) + target_link_libraries(kysysinfo-test kysysinfo) ``` -+----------+------------+----------------------------+--------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+============================+==============+ -| 获 取 系 | C | extern int | 获取端口状态 | -| | | kdk_net_get_port_stat(int | | -| | | port); | | -+----------+------------+----------------------------+--------------+ -+----------+---+---------------+--------------------+---+ -| 统 基 础 | | > 参数说明 | > 返回值说明 | | -| | | | | | -| > 信息 | | | | | -+==========+===+===============+====================+===+ -| | | > port 端口号 | > int 端口状态 | | -| | | | > | | -| | | | > FREE：0 | | -| | | | | | -| | | | TCP_ESTABLISHED:1 | | -| | | | | | -| | | | > TCP_SYN_SENT:2 | | -| | | | > | | -| | | | > TCP_SYN_RECV:3 | | -| | | | > | | -| | | | > TCP_FIN_WAIT1:4 | | -| | | | > | | -| | | | > TCP_FIN_WAIT2:5 | | -| | | | > | | -| | | | > TCP_TIME_WAIT:6 | | -| | | | > | | -| | | | > TCP_CLOSE:7 | | -| | | | > | | -| | | | > TCP_CLOSE_WAIT:8 | | -| | | | > | | -| | | | > TCP_LAST_ACL:9 | | -| | | | > | | -| | | | > TCP_LISTEN:10 | | -| | | | > | | -| | | | > TCP_CLOSING:11 | | -+----------+---+---------------+--------------------+---+ -``` - - - 获取多个网络端口状态 + （2）获取操作系统信息，需要添加头文件： -``` -+----------+------------+--------------------+-------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+===================+===+ -| 获 取 系 | C | int | 获取\[start,end\] | | -| | | kdk_net_get_mult | | | -| 统 基 础 | | iple_port_stat(int | > 的端口状态 | | -| | | start, int | | | -| > 信息 | | | | | -| | | end, int \*result) | | | -+----------+------------+--------------------+-------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+-------------------+---+ + \#include \"kysdk/kysdk-system/libkysysinfo.h\" -+---+---+-----------------------+---------------------+---+ -| | | > start 开始端口号 | > 成功返回 0 | | -| | | > | > | | -| | | > end 结束端口号 | > 失败返回 端口状态 | | -| | | | | | -| | | result 具有足够空间的 | | | -| | | | | | -| | | int 数组。接受端口状 | | | -| | | | | | -| | | > 态 | | | -+---+---+-----------------------+---------------------+---+ -``` + 获取操作系统架构信息 +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|------|------------------------------------------------------|----------------------------------------------------------------------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_architecture() | 获取系统架构信息 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char* 系统架构，例：x86_64 | | + + 获取操作系统名称 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_systemName() | 获取操作系统名称 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char* 系统名称，例：Kylin | | + + 获取操作系统版本号 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_version(bool verbose) | 获取系统版本号 | +| | | 参数说明 | 返回值说明 | | +| | | verbose：0获取简略版本号，1获取详细版本号 | char* 系统版本号，例：系统简略版本：xxxx桌面操作系统；系统详细版本：Desktop-V10-Professional-Release-Build1-210203 | + + 获取内核版本号 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_kernelVersion() | 获取内核版本号 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char* | 内核版本号 | | + + 获取当前登录用户的用户名 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_eUser() | 获取当前登录用户的用户名（Effect User） | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char* 成功返回字符串，失败返回NULL。返回的字符串需要被 free 释放 | | + + 获取操作系统项目编号名 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_projectName() | 获取操作系统项目编号名 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char* 成功返回字符串，失败返回NULL。返回的字符串需要被 free 释放 | | + + 获取操作系统项目子编号名 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_projectSubName() | 获取操作系统项目子编号名 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char* 成功返回字符串，失败返回NULL。返回的字符串需要被 free 释放 | | + + 获取操作系统产品标识码 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern unsigned int kdk_system_get_productFeatures() | 获取操作系统产品标识码 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | unsigned int 返回标志码
0000：信息异常
0001：仅PC特性
0010：仅平板特性
0011：支持平板与PC特性 | + + 获取操作系统宿主机的虚拟机类型 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_hostVirtType() | 获取操作系统宿主机的虚拟机类型 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char* 获取失败返回NULL，获取成功返回一个字符串，字符串内容如下：
[none, qemu, kvm, zvm, vmware,hyper-v, orcale virtualbox, xen, bochs, uml,parallels,bhyve,qnx,arcn,openvz,lxc,lxc-libvirt,systemd-nspawn,docker,podman,rkt,wsl] | + + 获取操作系统宿主机的云平台类型 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char* kdk_system_get_hostCloudPlatform() | 获取操作系统宿主机的云平台类型 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char* 获取失败返回NULL，获取成功返回一个字符串，字符串内容如下：
[none, huawei] | + + 判断当前操作系统是否为专用机系统 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern bool kdk_system_is_zyj(void) | 判断当前镜像系统否为专用机系统 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | bool
true代表是
false代表不是 | + + 获取系统分辨率信息 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern char** kdk_system_get_resolving_power() | 获取系统分辨率信息 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char** 分辨率信息列表，以NULL表示结尾，由alloc生成，需要被kdk_resolving_freeall回收；若获取出错，返回NULL； | | + + 回收字符串列表 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern inline void kdk_resolving_freeal(char **ptr) | 回收字符串列表 | +| | | 参数说明 | 返回值说明 | | +| | | ptr：字符串列表 | 无 | - 获取默认网关 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern | 获取默认网关 | | -| | | prouteMapList | | | -| 统 基 础 | | kd | | | -| | | k_net_get_route(); | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | prouteMapList | | -| | | | 网管信 | | -| | | | | | -| | | | 息，具体信息自取， | | -| | | | | | -| | | | > 失败返回 NULL | | -+----------+------------+--------------------+--------------------+---+ -``` +### **3.1.6** 获取网络信息 + + 获取网络连接状态 - 获取防火墙状态 +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|---------------------------------------------------------------------|------------------------------------| +| 获取系统基础信息 | dbus接口 | bus: system bus | +| name : org.freedesktop.NetworkManager | +| path: org.freedesktop.NetworkManager | +| method: state()->int arg0; | 获取网络连接状态。 | +| | +| | | 参数说明 | 返回值说明 | | +| | | 无 | int 网络连接状态 | | +| | + +获取网络端口状态 +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern int kdk_net_get_port_stat(int port); | 获取端口状态 | +| | | 参数说明 | 返回值说明 | | +| | | port 端口号 | int 端口状态 | +| FREE：0 | +| TCP_ESTABLISHED:1 TCP_SYN_SENT:2 TCP_SYN_RECV:3 TCP_FIN_WAIT1:4 TCP_FIN_WAIT2:5 TCP_TIME_WAIT:6 TCP_CLOSE:7 TCP_CLOSE_WAIT:8 TCP_LAST_ACL:9 TCP_LISTEN:10 TCP_CLOSING:11 | | +| | +| | +| | + + 获取多个网络端口状态 | +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | int kdk_net_get_multiple_port_stat(int start, int end, int *result) | 获取[start,end]的端口状态 | +| | | 参数说明 | 返回值说明 | | +| | | start 开始端口号 | +| end 结束端口号 | +| result 具有足够空间的int数组。接受端口状态 | 成功返回0 | +| 失败返回 端口状态 | | +| | + + 获取默认网关 | +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern prouteMapList kdk_net_get_route(); | 获取默认网关 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | prouteMapList 网管信息，具体信息自取，失败返回NULL | | +| | + + 获取防火墙状态 | +| 子模块 | 编程语言 | 声明 | 描述 | +|--------|------|----------------------------------------------------|----------------| +| 获取系统基础信息 | C | extern pChain kdk_net_get_iptable_rules() | 获取防火墙信息 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | pChain 防火墙信息，具体信息自取，失败返回NULL | -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C | extern pChain | 获取防火墙信 | | -| | | kdk_net_g | | | -| 统 基 础 | | et_iptable_rules() | > 息 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | pChain | | -| | | | 防火墙信息， | | -| | | | | | -| | | | 具体信息自取，失败 | | -| | | | | | -| | | | > 返回 NULL | | -+----------+------------+--------------------+--------------------+---+ -``` ### **3.1.7** 获取系统运行时信息 @@ -1767,96 +1192,42 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev 获取瞬时网速 - -``` -+----------+------------+--------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==============+===+ -| 获 取 系 | C++ | R | 获取瞬时网速 | | -| | | ealTimeInfo::float | | | -| 统 基 础 | | kdk_rea | | | -| | | l_get_net_speed(); | | | -| > 信息 | | | | | -+----------+------------+--------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------+---+ -| | | > 无 | > float | | -| | | | > | | -| | | | > 瞬时网速 | | -+----------+------------+--------------------+--------------+---+ -``` - - - 获取 cpu 温度 - - -``` -+----------+------------+-------------------------------+----------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+===============================+================+===+ -| 获 取 系 | C++ | RealTimeInfo::float | 获取瞬时 cpu | | -| | | | | | -| 统 基 础 | | kdk_real_get_cpu_temperatu(); | > 温度 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+-------------------------------+----------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+-------------------------------+----------------+---+ -| | | > 无 | > float | | -| | | | > | | -| | | | > cpu 瞬时温度 | | -+----------+------------+-------------------------------+----------------+---+ -``` - - - 获取硬盘温度 +| 子模块 | 编程语言 | 声明 | 描述 | +|----------|------|---------------------------------------------------------------------|-----------| +| 获取系统基础信息 | C++ | RealTimeInfo::float kdk_real_get_net_speed(); | 获取瞬时网速 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | float | +| 瞬时网速 | | +| | +| | + + 获取cpu温度 +| 子模块 | 编程语言 | 声明 | 描述 | +|----------|------|---------------------------------------------------------------------|-----------| +| 获取系统基础信息 | C++ | RealTimeInfo::float kdk_real_get_cpu_temperatu(); | 获取瞬时cpu温度 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | float | +| cpu瞬时温度 | | +| | + + 获取硬盘温度 +| 子模块 | 编程语言 | 声明 | 描述 | +|----------|------|---------------------------------------------------------------------|-----------| +| 获取系统基础信息 | C++ | RealTimeInfo::float kdk_real_get_disk_temperatu(const char * name); | 获取瞬时硬盘温度 | +| | | 参数说明 | 返回值说明 | | +| | | name：硬盘绝对路径 | float | +| 指定硬盘瞬时温度 | | +| | + + 获取磁盘转速 +| 子模块 | 编程语言 | 声明 | 描述 | +|----------|------|---------------------------------------------------------------------|-----------| +| 获取系统基础信息 | C++ | RealTimeInfo::int kdk_real_get_disk_rate(const char *name); | 获取磁盘转速 | +| | | 参数说明 | 返回值说明 | | +| | | name：硬盘绝对路径 | int | +| 指定磁盘转速 | -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 获 取 系 | C++ | R | 获取瞬时硬盘 | | -| | | ealTimeInfo::float | | | -| 统 基 础 | | | > 温度 | | -| | | kdk_real_get_di | | | -| > 信息 | | sk_temperatu(const | | | -| | | char \* | | | -| | | | | | -| | | name); | | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > | > float | | -| | | name：硬盘绝对路径 | > | | -| | | | > 指定硬盘瞬时温度 | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取磁盘转速 - - -``` -+----------+------------+--------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==============+===+ -| 获 取 系 | C++ | RealTimeInfo::int | 获取磁盘转速 | | -| | | kdk_real_g | | | -| 统 基 础 | | et_disk_rate(const | | | -| | | | | | -| > 信息 | | char \*name); | | | -+----------+------------+--------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------+---+ - -+---+---+----------------------+----------------+---+ -| | | > name：硬盘绝对路径 | > int | | -| | | | > | | -| | | | > 指定磁盘转速 | | -+---+---+----------------------+----------------+---+ -``` - ### **3.1.8** 获取当前地理信息 @@ -1887,25 +1258,12 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev 获取本机地理位置 -``` -+----------+------------+-----------------------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+===================================+==============+===+ -| 获 取 系 | C | extern char \*kdk_loaction_get(); | 获取本机的地 | | -| | | | | | -| 统 基 础 | | | > 理位置 | | -| | | | | | -| > 信息 | | | | | -+----------+------------+-----------------------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+-----------------------------------+--------------+---+ +| 子模块 | 编程语言 | 声明 | 描述 | +|----------|------|----------------------------------|----------------| +| 获取系统基础信息 | C | extern char *kdk_loaction_get(); | 获取本机的地理位置 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | 描述地理位置的json字符串 | -+---+---+------+---------------------+---+ -| | | > 无 | 描述地理位置的 json | | -| | | | | | -| | | | > 字符串 | | -+---+---+------+---------------------+---+ -``` ## **3.2** 电源管理 @@ -1919,48 +1277,24 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev 设置禁止锁屏 -``` -+-----------------+----------+-----------------+-----------------+---+ -| > 子模块 | 编程语言 | 声明 | > 描述 | | -+=================+==========+=================+=================+===+ -| > 电源管 理模块 | C++ | > uint32_t | > 设 置 禁 止 | | -| | | > kd | > 锁屏 | | -| | | k_set_inhibit_l | | | -| | | ockscreen(const | | | -| | | | | | -| | | char \*appName | | | -| | | , const char | | | -| | | \*reason) | | | -+-----------------+----------+-----------------+-----------------+---+ -| | | > 参数说明\ | > 返回值说明 0: | | -| | | > a | > 失败\ | | -| | | ppName：应用名\ | > \>0: 成功 | | -| | | > rea | | | -| | | son：禁止锁屏原 | | | -| | | > 因 | | | -+-----------------+----------+-----------------+-----------------+---+ -``` +| 子模块 | 编程语言 | 声明 | 描述 | +|---------------|-------|--------------------------------------------------------------------------------|--------| +| 电源管理模块 | C++ | uint32_t kdk_set_inhibit_lockscreen(const char *appName , const char *reason) | 设置禁止锁屏 | +| | +| | | 参数说明 | 返回值说明 | +| | | appName：应用名
reason：禁止锁屏原因 | 0: 失败
>0: 成功 | - 取消禁止锁屏 + 取消禁止锁屏 -``` -+-----------------+----------+------------------+------------------+ -| > 子模块 | 编程语言 | 声明 | > 描述 | -+=================+==========+==================+==================+ -| > 电源管 理模块 | C++ | > int | > 取 消 禁 止 | -| | | > kd | > 锁屏 | -| | | k_un_inhibit_loc | | -| | | kscreen(uint32_t | | -| | | > flag) | | -+-----------------+----------+------------------+------------------+ +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 电源管理模块 | C++ | int kdk_un_inhibit_lockscreen(uint32_t flag) | 取消禁止锁屏 | +| | +| | | 参数说明 |返回值说明 | +| | | flag：禁止锁屏接口的返回值 | 0: 成功
-1: 失败 | -+---+---+-------------------------------+-----------------------+---+ -| | | > 参数说明\ | > 返回值说明 0: 成功\ | | -| | | > flag：禁止锁屏接口 的返回值 | > -1: 失败 | | -+---+---+-------------------------------+-----------------------+---+ -``` ## **3.3** 文件管理 @@ -1976,50 +1310,15 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev ``` -``` -+----------------------------------------+----------------------------+ -| 声明 | 描述 | -+========================================+============================+ -| QStringList | 增加需要监听的文件路径，对 | -| addWatchTargetRecursive(QString url, | | -| | 于目录，默认启用递归监听子 | -| FileWatcherType type = PERIODIC, int | | -| attr = | > 目录 | -| | | -| OPEN\|CLOSE\|MODIFY\|DELETE, int | | -| maxdepth = 5, | | -| | | -| > int recurType = DIR\|REGULAR); | | -+----------------------------------------+----------------------------+ -| > QStringList | > 增加需要监听的文件列表 | -| > | | -| > a | | -| ddWatchTargetListRecursive(QStringList | | -| > urlList, | | -| | | -| FileWatcherType type = PERIODIC, int | | -| attr = | | -| | | -| OPEN\|CLOSE\|MODIFY\|DELETE, int | | -| maxdepth = 5, | | -| | | -| > int recurType = DIR\|REGULAR); | | -+----------------------------------------+----------------------------+ -| > QStringList | 从监听列表中移除指定的文件 | -| > removeWatchTargetRecursive(QString | | -| > | | -| > url, int maxdepth = 5, int recurType | | -| > = ALLFILE); | | -+----------------------------------------+----------------------------+ +| 声明 | 描述 | | +|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------|---| +| QStringList addWatchTargetRecursive(QString url, FileWatcherType type = PERIODIC, int attr = OPEN|CLOSE|MODIFY|DELETE, int maxdepth = 5, int recurType = DIR|REGULAR); | 增加需要监听的文件路径，对于目录，默认启用递归监听子目录 | | +| QStringList addWatchTargetListRecursive(QStringList urlList, FileWatcherType type = PERIODIC, int attr = OPEN|CLOSE|MODIFY|DELETE, int maxdepth = 5, int recurType = DIR|REGULAR); | 增加需要监听的文件列表 | | +| QStringList removeWatchTargetRecursive(QString url, int maxdepth = 5, int recurType = ALLFILE); | 从监听列表中移除指定的文件 | | +| void clearWatchList(); | 清空监听列表 | | +| void pauseWatcher(); | 暂停文件监听 | | +| void restartWatcher(); | 恢复文件监听 | -+--------------------------+----------------+ -| > void clearWatchList(); | > 清空监听列表 | -+==========================+================+ -| > void pauseWatcher(); | > 暂停文件监听 | -+--------------------------+----------------+ -| > void restartWatcher(); | > 恢复文件监听 | -+--------------------------+----------------+ -``` ## **3.4** AI 能力 @@ -2036,61 +1335,24 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev 获取文字框 -``` -+--------+----------+----------------------+----------------------+---+ -| 子模块 | 编 程 语 | > 声明 | > 描述 | | -| | | | | | -| | > 言 | | | | -+========+==========+======================+======================+===+ -| > OCR | > C++ | > Std::vec | > 获取文字框 | | -| | | tor\\>\> | | | -| | | > | | | -| 别功能 | | > kdk::k | | | -| | | dkOCR::getRect(const | | | -| | | > std::string | | | -| | | > | | | -| | | > &imagePath) | | | -+--------+----------+----------------------+----------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+--------+----------+----------------------+----------------------+---+ -| | | String 图 片 文 | Vector\ 件路径 | | | -| | | | > nt\> | | -| | | | | | -| | | | 文字 | | -| | | | 框点的坐标矩阵、以及 | | -| | | | | | -| | | | > 文字框的个数 | | -+--------+----------+----------------------+----------------------+---+ -``` - +| 子模块 | 编程语言 | 声明 | 描述 | +|--------------------|------|-----------------------------------------------------------------------------------------------|----------------------------------| +| OCR文字识别功能 | C++ | Std::vector>> kdk::kdkOCR::getRect(const std::string &imagePath) | 获取文字框 | +| | | 参数说明 | 返回值说明 | | +| | | String 图片文件路径 | Vector | +| 文字框点的坐标矩阵、以及文字框的个数 | - 获取文字内容 -``` -+----------+----------+----------------------+----------------+ -| > 子模块 | 编程语言 | 声明 | 描述 | -+==========+==========+======================+================+ -| OCR 文 | C++ | Std::vecto | 获 取 文 字 内 | -| | | r\\>\>getCls(const | > 容 | -| | | | | -| | | std::string | | -| | | &imagePath,int nums) | | -+----------+----------+----------------------+----------------+ + 获取文字内容 -+--------+---+-------------------------+-------------------------+---+ -| > 功能 | | > 参数说明 | > 返回值说明 | | -+========+===+=========================+=========================+===+ -| | | > String 图片文件 路径\ | > Vector\ 图 | | -| | | > Int nums 同时处 | > 片 中 的 文字字符串 | | -| | | > 理的文字栈个数 | | | -+--------+---+-------------------------+-------------------------+---+ +| 子模块 | 编程语言 | 声明 | 描述 | +|---------------------|-------------------------|--------------------------------------------------------------------------------|--------| +| OCR文字识别功能 | C++ | Std::vector>>getCls(const std::string &imagePath,int nums) | 获取文字内容 | +| | | 参数说明 | 返回值说明 | | +| | | String 图片文件路径 | +| Int nums 同时处理的文字栈个数 | Vector图片中的文字字符串 | -``` ## **3.5** 打印机管理 @@ -2101,241 +1363,90 @@ $ sudo apt-get install libkysdk-package libkysdk-package-dev 获取系统打印机列表 -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 打 印 机 | C | extern char\*\* | 获取打印机列 | | -| | | kdk_p | | | -| > 管理 | | rinter_get_list(); | > 表 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char \*\* | | -| | | | 系统打印机列 | | -| | | | | | -| | | | > 表 | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 获取系统可用打印机列表 - - -``` -+----------+------------+--------------------+--------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+====================+===+ -| 打 印 机 | C | extern char\*\* | 获取可用打印 | | -| | | kdk_printer_get | | | -| > 管理 | | \_availablelist(); | > 机列表 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------------+---+ -| | | > 无 | char \*\* | | -| | | | 系统打印机列 | | -| | | | | | -| | | | > 表 | | -+----------+------------+--------------------+--------------------+---+ -``` - - - 设置打印参数 - - -``` -+----------+------------+-----------------------------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+=========================================+==============+===+ -| 打 印 机 | C | extern void kdk_printer_set_options(int | 设置打印参数 | | -| | | | | | -| > 管理 | | number_up,const char \*media,const char | | | -| | | | | | -| | | \*number_up_layout,const char \*sides); | | | -+----------+------------+-----------------------------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+-----------------------------------------+--------------+---+ -| | | number_up ： 一 张 纸 | > 无 | | -| | | | | | -| | | > 打印几页 | | | -| | | > | | | -| | | > media：纸张类型 | | | -| | | > | | | -| | | > number_up_layout ： | | | -| | | > | | | -| | | > cups 属性，如 lrtb | | | -| | | > | | | -| | | > sides ： 单 面 one- | | | -| | | | | | -| | | sided，双面（长边翻 | | | -| | | | | | -| | | > 转 ） ： | | | -| | | > | | | -| | | > two_sided_long_dege | | | -| | | > | | | -| | | > 双面（短边翻转）： | | | -| | | > | | | -| | | > two_sided_short_dege | | | -+----------+------------+-----------------------------------------+--------------+---+ -``` - - - 打印文件 - - -``` -+----------+------------+------------------------------+------------+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | -+==========+============+==============================+============+ -| 打 印 机 | C | extern int | > 打印文件 | -| | | kdk_pr | | -| > 管理 | | inter_print_local_file(const | | -| | | | | -| | | char \*printername, char | | -| | | \*filepath); | | -+----------+------------+------------------------------+------------+ - -+---+---+-----------------------+---------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+===+===+=======================+=====================+===+ -| | | printername: 打印机名 | > int 打印作业的 id | | -| | | | | | -| | | filepath：打印文件绝 | | | -| | | | | | -| | | > 对路径 | | | -+---+---+-----------------------+---------------------+---+ -``` - - - 取消打印作业 - - -``` -+----------+------------+--------------------+--------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==============+===+ -| 打 印 机 | C | extern int | 取消打印作业 | | -| | | kdk_printer_can | | | -| > 管理 | | cel_all_jobs(const | | | -| | | | | | -| | | char | | | -| | | \*printername); | | | -+----------+------------+--------------------+--------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+--------------+---+ -| | | printername ： 打 | > int | | -| | | 印 机 | > | | -| | | | > 成功：0 | | -| | | > 名 | > | | -| | | | > 失败：-1 | | -+----------+------------+--------------------+--------------+---+ -``` - - - 获取打印机状态 - - -``` -+----------+------------+--------------------+----------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+================+===+ -| 打 印 机 | C | > extern int | 获 取 打 印 机 | | -| | | > kdk_printe | | | -| > 管理 | | r_get_status(const | > 状态 | | -| | | > char | | | -| | | | | | -| | | \*printername); | | | -+----------+------------+--------------------+----------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+----------------+---+ -| | | printername ， 打 | > 打印机状态码 | | -| | | 印 机 | | | -| | | | | | -| | | > 名 | | | -+----------+------------+--------------------+----------------+---+ -``` - - - 从 url 中解析下载的文件名 - - -``` -+----------+------------+--------------------+---------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+===============+===+ -| 打 印 机 | C | extern void | 从 url 解析下 | | -| | | kdk_printer_ | | | -| > 管理 | | get_filename(const | > 载的文件名 | | -| | | char | | | -| | | | | | -| | | \*url, char | | | -| | | \*filename); | | | -+----------+------------+--------------------+---------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+---------------+---+ -| | | > url，下载链接 | | | -+----------+------------+--------------------+---------------+---+ -| | | fi | | | -| | | lename，解析出来的 | | | -| | | | | | -| | | > 文件名 | | | -+----------+------------+--------------------+---------------+---+ - -``` - - 获取当前打印任务状态 - - -``` -+----------+------------+--------------------+------------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+==================+===+ -| 打 印 机 | C | extern int | 获 取 当 前 打 | | -| | | kdk_printer_ge | | | -| > 管理 | | t_job_status(const | > 印任务状态 | | -| | | char | | | -| | | | | | -| | | \*printername, int | | | -| | | jobid); | | | -+----------+------------+--------------------+------------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+------------------+---+ -| | | printername ， 打 | > 打印任务状态码 | | -| | | 印 机 | | | -| | | | | | -| | | > 名 | | | -+----------+------------+--------------------+------------------+---+ -``` - - - 下载网络文件到本地 +| 子模块 | 编程语言 | 声明 | 描述 | +|------------------------------------------------|-------------|----------------------------------------------------------------------------------------------------------------------|-----------------| +| 打印机管理 | C | extern char** kdk_printer_get_list(); | 获取打印机列表 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char ** 系统打印机列表 | | +| | + + 获取系统可用打印机列表 + +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 打印机管理 | C | extern char** kdk_printer_get _availablelist(); | 获取可用打印机列表 | +| | | 参数说明 | 返回值说明 | | +| | | 无 | char ** 系统打印机列表 | | +| | + + 设置打印参数 + +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 打印机管理 | C | extern void kdk_printer_set_options(int number_up,const char *media,const char *number_up_layout,const char *sides); | 设置打印参数 | +| | | 参数说明 | 返回值说明 | | +| | | number_up：一张纸打印几页 | +| media：纸张类型 | +| number_up_layout：cups属性，如lrtb | +| sides：单面one-sided，双面（长边翻转）：two_sided_long_dege | +| 双面（短边翻转）： | +| two_sided_short_dege | 无 | | +| | + + 打印文件 +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 打印机管理 | C | extern int kdk_printer_print_local_file(const char *printername, char *filepath); | 打印文件 | +| | | 参数说明 | 返回值说明 | | +| | | printername: 打印机名 | +| filepath：打印文件绝对路径 | int 打印作业的id | | +| | + + 取消打印作业 +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 打印机管理 | C | extern int kdk_printer_cancel_all_jobs(const char *printername); | 取消打印作业 | +| | | 参数说明 | 返回值说明 | | +| | | printername：打印机名 | int | +| 成功：0 | +| 失败：-1 | | +| | + + 获取打印机状态 +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 打印机管理 | C | extern int kdk_printer_get_status(const char *printername); | 获取打印机状态 | +| | | 参数说明 | 返回值说明 | | +| | | printername，打印机名 | 打印机状态码 | | +| | + + 从url中解析下载的文件名 +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 打印机管理 | C | extern void kdk_printer_get_filename(const char *url, char *filename); | 从url解析下载的文件名 | +| | | 参数说明 | 返回值说明 | | +| | | url，下载链接 | | | +| | | filename，解析出来的文件名 | | | +| | + + 获取当前打印任务状态 + +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 打印机管理 | C | extern int kdk_printer_get_job_status(const char *printername, int jobid); | 获取当前打印任务状态 | +| | | 参数说明 | 返回值说明 | | +| | | printername，打印机名 | 打印任务状态码 | | +| | + + 下载网络文件到本地 +| 子模块 | 编程语言 | 声明 | 描述 | +|-----------------|-------|-----------------------------------------------|--------| +| 打印机管理 | C | extern int kdk_printer_print_download_remote_file(const char *url, const char *filepath); | 下载网络文件到本地 | +| | | 参数说明 | 返回值说明 | | +| | | url，网络文件 | 下载状态码 | | +| | | filepath，要保存的文件路径，用户自定义 | -``` -+----------+------------+--------------------+----------------+---+ -| > 子模块 | > 编程语言 | 声明 | > 描述 | | -+==========+============+====================+================+===+ -| 打 印 机 | C | extern int | 下 载 网 络 文 | | -| | | | | | -| > 管理 | | kdk_prin | > 件到本地 | | -| | | ter_print_download | | | -| | | _remote_file(const | | | -| | | | | | -| | | char \*url, const | | | -| | | char \*filepath); | | | -+----------+------------+--------------------+----------------+---+ -| | | > 参数说明 | > 返回值说明 | | -+----------+------------+--------------------+----------------+---+ -| | | > url，网络文件 | > 下载状态码 | | -+----------+------------+--------------------+----------------+---+ -| | | fi | | | -| | | lepath，要保存的文 | | | -| | | | | | -| | | > | | | -| | | 件路径，用户自定义 | | | -+----------+------------+--------------------+----------------+---+ -``` - # **4** 应用支撑 SDK -- Gitee From 02044a8e7d41fd3a6c13054d9c9f34a5306ac45e Mon Sep 17 00:00:00 2001 From: chipo Date: Fri, 11 Nov 2022 04:31:19 +0000 Subject: [PATCH 4/4] =?UTF-8?q?update=20=E5=BC=80=E5=A7=8B=E8=B4=A1?= =?UTF-8?q?=E7=8C=AE/openKylin+SDK=E5=BC=80=E5=8F=91=E6=8C=87=E5=8D=97V2.0?= =?UTF-8?q?.md.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: chipo --- ...45\217\221\346\214\207\345\215\227V2.0.md" | 55 ++++++++----------- 1 file changed, 22 insertions(+), 33 deletions(-) diff --git "a/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" "b/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" index 52cf024..ce04820 100644 --- "a/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" +++ "b/\345\274\200\345\247\213\350\264\241\347\214\256/openKylin+SDK\345\274\200\345\217\221\346\214\207\345\215\227V2.0.md" @@ -1310,17 +1310,18 @@ aux_source_directory(. SOURCESCODE) ``` -| 声明 | 描述 | | -|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------|---| -| QStringList addWatchTargetRecursive(QString url, FileWatcherType type = PERIODIC, int attr = OPEN|CLOSE|MODIFY|DELETE, int maxdepth = 5, int recurType = DIR|REGULAR); | 增加需要监听的文件路径，对于目录，默认启用递归监听子目录 | | -| QStringList addWatchTargetListRecursive(QStringList urlList, FileWatcherType type = PERIODIC, int attr = OPEN|CLOSE|MODIFY|DELETE, int maxdepth = 5, int recurType = DIR|REGULAR); | 增加需要监听的文件列表 | | -| QStringList removeWatchTargetRecursive(QString url, int maxdepth = 5, int recurType = ALLFILE); | 从监听列表中移除指定的文件 | | -| void clearWatchList(); | 清空监听列表 | | -| void pauseWatcher(); | 暂停文件监听 | | +| 声明 | 描述 | +|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------| +| QStringList addWatchTargetRecursive(QString url, FileWatcherType type = PERIODIC, int attr = OPEN`|`CLOSE`|`MODIFY`|`DELETE, int maxdepth = 5, int recurType = DIR`|`REGULAR); | 增加需要监听的文件路径，对于目录，默认启用递归监听子目录 | +| QStringList addWatchTargetListRecursive(QStringList urlList, FileWatcherType type = PERIODIC, int attr = OPEN`|`CLOSE`|`MODIFY`|`DELETE, int maxdepth = 5, int recurType = DIR`|`REGULAR); | 增加需要监听的文件列表 | +| QStringList removeWatchTargetRecursive(QString url, int maxdepth = 5, int recurType = ALLFILE); | 从监听列表中移除指定的文件 | +| void clearWatchList(); | 清空监听列表 | +| void pauseWatcher(); | 暂停文件监听 | | void restartWatcher(); | 恢复文件监听 | + ## **3.4** AI 能力 该层设计主要为应用提供 AI 识别功能接口，为 OS 增加 OCR @@ -1335,23 +1336,21 @@ aux_source_directory(. SOURCESCODE) 获取文字框 -| 子模块 | 编程语言 | 声明 | 描述 | -|--------------------|------|-----------------------------------------------------------------------------------------------|----------------------------------| -| OCR文字识别功能 | C++ | Std::vector>> kdk::kdkOCR::getRect(const std::string &imagePath) | 获取文字框 | +| 子模块 | 编程语言 | 声明 | | 描述 | +|--------------------|------|-----------------------------------------------------------------------------|------------------|----------------------------------| +| OCR文字识别功能 | C++ | Std::vector>> kdk::kdkOCR::getRect(const std::string &imagePath) || 获取文字框 | | | | 参数说明 | 返回值说明 | | -| | | String 图片文件路径 | Vector | -| 文字框点的坐标矩阵、以及文字框的个数 | +| | | String 图片文件路径 | Vector
文字框点的坐标矩阵、以及文字框的个数 | 获取文字内容 -| 子模块 | 编程语言 | 声明 | 描述 | -|---------------------|-------------------------|--------------------------------------------------------------------------------|--------| -| OCR文字识别功能 | C++ | Std::vector>>getCls(const std::string &imagePath,int nums) | 获取文字内容 | -| | | 参数说明 | 返回值说明 | | -| | | String 图片文件路径 | -| Int nums 同时处理的文字栈个数 | Vector图片中的文字字符串 | +| 子模块 | 编程语言 | 声明 || 描述 | +|----------------|---------|-------------------------------------------------------------------|-|--------| +| OCR文字识别功能 | C++ | Std::vector>>getCls(const std::string &imagePath,int nums) || 获取文字内容 | +| | | 参数说明 | 返回值说明 | | +| | | String 图片文件路径
Vector图片中的文字字符串 | Int nums 同时处理的文字栈个数 | | ## **3.5** 打印机管理 @@ -1385,32 +1384,22 @@ aux_source_directory(. SOURCESCODE) |-----------------|-------|-----------------------------------------------|--------| | 打印机管理 | C | extern void kdk_printer_set_options(int number_up,const char *media,const char *number_up_layout,const char *sides); | 设置打印参数 | | | | 参数说明 | 返回值说明 | | -| | | number_up：一张纸打印几页 | -| media：纸张类型 | -| number_up_layout：cups属性，如lrtb | -| sides：单面one-sided，双面（长边翻转）：two_sided_long_dege | -| 双面（短边翻转）： | -| two_sided_short_dege | 无 | | -| | +| | | number_up：一张纸打印几页
media：纸张类型
number_up_layout：cups属性，如lrtb
sides：单面one-sided，双面（长边翻转）：two_sided_long_dege
双面（短边翻转）：
two_sided_short_dege | 无 | 打印文件 | 子模块 | 编程语言 | 声明 | 描述 | |-----------------|-------|-----------------------------------------------|--------| | 打印机管理 | C | extern int kdk_printer_print_local_file(const char *printername, char *filepath); | 打印文件 | -| | | 参数说明 | 返回值说明 | | -| | | printername: 打印机名 | -| filepath：打印文件绝对路径 | int 打印作业的id | | +| | | 参数说明 | 返回值说明 | | +| | | printername: 打印机名
filepath：打印文件绝对路径 | int 打印作业的id | | | | 取消打印作业 | 子模块 | 编程语言 | 声明 | 描述 | |-----------------|-------|-----------------------------------------------|--------| | 打印机管理 | C | extern int kdk_printer_cancel_all_jobs(const char *printername); | 取消打印作业 | -| | | 参数说明 | 返回值说明 | | -| | | printername：打印机名 | int | -| 成功：0 | -| 失败：-1 | | -| | +| | | 参数说明 | 返回值说明 | | +| | | printername：打印机名 | int
成功：0
失败：-1 | 获取打印机状态 | 子模块 | 编程语言 | 声明 | 描述 | -- Gitee