116 lines
3.1 KiB
Groff
116 lines
3.1 KiB
Groff
|
.TH "KDK_NC_GET_IPV6" 3 "Fri Aug 25 2023" "Linux Programmer's Manual" \"
|
||
|
|
.SH NAME
|
||
|
|
kdk_nc_get_ipv6 - 获取指定网卡的所有IPv6地址
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.nf
|
||
|
|
.B #include <libkync.h>
|
||
|
|
.sp
|
||
|
|
.BI "extern char** kdk_nc_get_ipv6(const char* "nc ");"
|
||
|
|
.sp
|
||
|
|
Link with \fI\-lkyhw\fP.
|
||
|
|
.SH "Detailed Description"
|
||
|
|
The main function of the interface is to obtain all IPv6 addresses of the specified NIC
|
||
|
|
.I nc
|
||
|
|
.
|
||
|
|
.PP
|
||
|
|
The argument
|
||
|
|
.I nc
|
||
|
|
is the name of the NIC, such as "eno1".
|
||
|
|
.SH "RETURN VALUE"
|
||
|
|
On success, returns a list of IPv6 addresses, ending with
|
||
|
|
.BR
|
||
|
|
NULL
|
||
|
|
, generated by alloc and required to be recycled by
|
||
|
|
.BR kdk_nc_freeall
|
||
|
|
.PP
|
||
|
|
On error, return
|
||
|
|
.BR NULL.
|
||
|
|
.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_cardlist (),
|
||
|
|
.BR kdk_nc_get_phymac (),
|
||
|
|
.BR kdk_nc_get_private_ipv4 (),
|
||
|
|
.BR kdk_nc_get_upcards (),
|
||
|
|
.BR kdk_nc_get_private_ipv6 (),
|
||
|
|
.BR kdk_nc_get_ipv4 (),
|
||
|
|
.BR kdk_nc_is_wireless (),
|
||
|
|
.BR kdk_nc_get_vendor_and_product (),
|
||
|
|
.BR kdk_nc_get_driver (),
|
||
|
|
and
|
||
|
|
.BR kdk_nc_freeall ().
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.BR kdk_nc_is_up (3),
|
||
|
|
.BR kdk_nc_get_cardlist (3),
|
||
|
|
.BR kdk_nc_get_phymac (3),
|
||
|
|
.BR kdk_nc_get_private_ipv4 (3),
|
||
|
|
.BR kdk_nc_get_upcards (3),
|
||
|
|
.BR kdk_nc_get_private_ipv6 (3),
|
||
|
|
.BR kdk_nc_get_ipv4 (3),
|
||
|
|
.BR kdk_nc_is_wireless (3),
|
||
|
|
.BR kdk_nc_get_vendor_and_product (3),
|
||
|
|
.BR kdk_nc_get_driver (3),
|
||
|
|
and
|
||
|
|
.BR kdk_nc_freeall (3).
|