libkysdk-system/man/hardware/kdk_nc_freeall.3

107 lines
3.0 KiB
Groff

.TH "KDK_NC_FREEALL" 3 "Tue Sep 05 2023" "Linux Programmer's Manual" \"
.SH NAME
kdk_nc_freeall - 用于回收字符串列表
.SH SYNOPSIS
.nf
.B #include <libkync.h>
.sp
.BI "extern inline void kdk_nc_freeall(char **"ptr ");"
.sp
Link with \fI\-lkyhw\fP.
.SH "Detailed Description"
The main function of the interface is to recycle a list of strings of type char **.
.PP
The argument
.I ptr
is a list of strings of type char **.
.SH "RETURN VALUE"
No return value
.SH EXAMPLES
.EX
#include "libkync.h"
#include <stdio.h>
#include <stdlib.h>
int main()
{
char **cards = kdk_nc_get_cardlist();
size_t index = 0;
printf("所有网卡:\en");
while (cards[index])
{
char *mac = kdk_nc_get_phymac(cards[index]);
char *ipv4 = kdk_nc_get_private_ipv4(cards[index]);
char *ipv6 = kdk_nc_get_private_ipv6(cards[index]);
char *driver = kdk_nc_get_driver(cards[index]);
char vendor[256] = "\0", product[256] = "\0";
kdk_nc_get_vendor_and_product(cards[index], vendor, product);
printf("Card %zd: %s\tStatus: %s\tMac: %s\tIPv4: %s\tIPv6: %s\t Vendor: %s\t Product: %s\t Type: %s\t driver: %s\en",
index + 1, cards[index], kdk_nc_is_up(cards[index]) == 1 ? "Up" : "Down",
mac, ipv4, ipv6, vendor, product,
kdk_nc_is_wireless(cards[index]) ? "wireless" : "ethernet", driver);
char **list4 = kdk_nc_get_ipv4(cards[index]);
int i = 0;
printf("AllIpV4: ");
while (list4 && list4[i])
{
printf("%s\t", list4[i++]);
}
printf("\en");
char **list6 = kdk_nc_get_ipv6(cards[index]);
printf("AllIpV6: ");
i = 0;
while (list6 && list6[i])
{
printf("%s\t", list6[i++]);
}
printf("\en");
free(mac);
free(ipv4);
free(ipv6);
free(list4);
free(list6);
free(driver);
index++;
}
kdk_nc_freeall(cards);
char **upcards = kdk_nc_get_upcards();
index = 0;
printf("工作网卡:\en");
while (upcards[index])
{
printf("Card %zd: %s\en", index + 1, upcards[index]);
index++;
}
kdk_nc_freeall(upcards);
return 0;
}
.SH "CONFORMING TO"
These functions are as per the withdrawn POSIX.1e draft specification.
The following functions are Linux extensions:
.BR kdk_nc_is_up (),
.BR kdk_nc_get_upcards (),
.BR kdk_nc_get_cardlist (),
.BR kdk_nc_get_private_ipv4 (),
.BR kdk_nc_get_ipv4 (),
.BR kdk_nc_get_private_ipv6 (),
.BR kdk_nc_get_ipv6 (),
.BR kdk_nc_is_wireless (),
.BR kdk_nc_get_vendor_and_product (),
.BR kdk_nc_get_phymac (),
and
.BR kdk_nc_get_driver ().
.SH "SEE ALSO"
.BR kdk_nc_is_up (3),
.BR kdk_nc_get_upcards (3),
.BR kdk_nc_get_cardlist (3),
.BR kdk_nc_get_private_ipv4 (3),
.BR kdk_nc_get_ipv4 (3),
.BR kdk_nc_get_private_ipv6 (3),
.BR kdk_nc_get_ipv6 (3),
.BR kdk_nc_is_wireless (3),
.BR kdk_nc_get_vendor_and_product (3),
.BR kdk_nc_get_phymac (3),
and
.BR kdk_nc_get_driver (3).