2021-02-03 09:42:38 +01:00
|
|
|
/****************************************************************************
|
2008-09-12 02:39:12 +02:00
|
|
|
* include/net/if.h
|
2007-11-30 21:46:29 +01:00
|
|
|
*
|
2021-02-03 11:33:49 +01:00
|
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
|
|
* this work for additional information regarding copyright ownership. The
|
|
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
|
|
* "License"); you may not use this file except in compliance with the
|
|
|
|
* License. You may obtain a copy of the License at
|
2007-11-30 21:46:29 +01:00
|
|
|
*
|
2021-02-03 11:33:49 +01:00
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
2007-11-30 21:46:29 +01:00
|
|
|
*
|
2021-02-03 11:33:49 +01:00
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
* License for the specific language governing permissions and limitations
|
|
|
|
* under the License.
|
2007-11-30 21:46:29 +01:00
|
|
|
*
|
2021-02-03 09:42:38 +01:00
|
|
|
****************************************************************************/
|
2007-11-30 21:46:29 +01:00
|
|
|
|
2012-07-17 05:58:11 +02:00
|
|
|
#ifndef __INCLUDE_NET_IF_H
|
|
|
|
#define __INCLUDE_NET_IF_H
|
2007-11-30 21:46:29 +01:00
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/****************************************************************************
|
2007-11-30 21:46:29 +01:00
|
|
|
* Included Files
|
2021-02-03 09:42:38 +01:00
|
|
|
****************************************************************************/
|
2007-11-30 21:46:29 +01:00
|
|
|
|
2019-01-27 15:57:23 +01:00
|
|
|
#include <signal.h>
|
2007-11-30 21:46:29 +01:00
|
|
|
#include <sys/socket.h>
|
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/****************************************************************************
|
2015-04-08 15:25:06 +02:00
|
|
|
* Pre-processor Definitions
|
2021-02-03 09:42:38 +01:00
|
|
|
****************************************************************************/
|
2007-11-30 21:46:29 +01:00
|
|
|
|
2021-06-22 05:19:06 +02:00
|
|
|
/* If CONFIG_NETDEV_IFINDEX is enabled then there is limit to the number of
|
|
|
|
* devices that can be registered due to the nature of some static data.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define MAX_IFINDEX 32
|
|
|
|
|
2007-11-30 21:46:29 +01:00
|
|
|
/* Sizing parameters */
|
|
|
|
|
2019-12-13 15:20:07 +01:00
|
|
|
#define IFNAMSIZ 16 /* Older naming standard */
|
|
|
|
#define IF_NAMESIZE 16 /* Newer naming standard */
|
2015-01-17 14:42:09 +01:00
|
|
|
#define IFHWADDRLEN 6
|
|
|
|
|
|
|
|
/* Interface flag bits */
|
|
|
|
|
2022-06-01 06:47:30 +02:00
|
|
|
#define IFF_DOWN (1 << 0) /* Interface is down */
|
|
|
|
#define IFF_UP (1 << 1) /* Interface is up */
|
|
|
|
#define IFF_RUNNING (1 << 2) /* Carrier is available */
|
|
|
|
#define IFF_IPv6 (1 << 3) /* Configured for IPv6 packet (vs ARP or IPv4) */
|
|
|
|
#define IFF_LOOPBACK (1 << 5) /* Is a loopback net */
|
|
|
|
#define IFF_POINTOPOINT (1 << 6) /* Is point-to-point link */
|
|
|
|
#define IFF_NOARP (1 << 7) /* ARP is not required for this packet */
|
2022-10-17 09:13:34 +02:00
|
|
|
#define IFF_NAT (1 << 8) /* NAT is enabled for this interface */
|
2023-04-14 12:09:32 +02:00
|
|
|
#define IFF_SLAVE (1 << 11) /* Slave of a load balancer. */
|
2022-06-01 06:47:30 +02:00
|
|
|
#define IFF_MULTICAST (1 << 12) /* Supports multicast. */
|
|
|
|
#define IFF_BROADCAST (1 << 13) /* Broadcast address valid. */
|
2023-04-14 12:09:32 +02:00
|
|
|
#define IFF_DYNAMIC (1 << 15) /* Dialup device with changing addresses. */
|
2015-01-17 14:42:09 +01:00
|
|
|
|
|
|
|
/* Interface flag helpers */
|
|
|
|
|
2022-06-01 06:47:30 +02:00
|
|
|
#define IFF_SET_UP(f) do { (f) |= IFF_UP; } while (0)
|
|
|
|
#define IFF_SET_RUNNING(f) do { (f) |= IFF_RUNNING; } while (0)
|
|
|
|
#define IFF_SET_NOARP(f) do { (f) |= IFF_NOARP; } while (0)
|
2022-10-17 09:13:34 +02:00
|
|
|
#define IFF_SET_NAT(f) do { (f) |= IFF_NAT; } while (0)
|
2022-06-01 06:47:30 +02:00
|
|
|
#define IFF_SET_LOOPBACK(f) do { (f) |= IFF_LOOPBACK; } while (0)
|
|
|
|
#define IFF_SET_POINTOPOINT(f) do { (f) |= IFF_POINTOPOINT; } while (0)
|
|
|
|
#define IFF_SET_MULTICAST(f) do { (f) |= IFF_MULTICAST; } while (0)
|
|
|
|
#define IFF_SET_BROADCAST(f) do { (f) |= IFF_BROADCAST; } while (0)
|
2023-04-14 12:09:32 +02:00
|
|
|
#define IFF_SET_SLAVE(f) do { (f) |= IFF_SLAVE; } while (0)
|
|
|
|
#define IFF_SET_DYNAMIC(f) do { (f) |= IFF_DYNAMIC; } while (0)
|
2022-06-01 06:47:30 +02:00
|
|
|
|
|
|
|
#define IFF_CLR_UP(f) do { (f) &= ~IFF_UP; } while (0)
|
|
|
|
#define IFF_CLR_RUNNING(f) do { (f) &= ~IFF_RUNNING; } while (0)
|
|
|
|
#define IFF_CLR_NOARP(f) do { (f) &= ~IFF_NOARP; } while (0)
|
2022-10-17 09:13:34 +02:00
|
|
|
#define IFF_CLR_NAT(f) do { (f) &= ~IFF_NAT; } while (0)
|
2022-06-01 06:47:30 +02:00
|
|
|
#define IFF_CLR_LOOPBACK(f) do { (f) &= ~IFF_LOOPBACK; } while (0)
|
|
|
|
#define IFF_CLR_POINTOPOINT(f) do { (f) &= ~IFF_POINTOPOINT; } while (0)
|
|
|
|
#define IFF_CLR_MULTICAST(f) do { (f) &= ~IFF_MULTICAST; } while (0)
|
|
|
|
#define IFF_CLR_BROADCAST(f) do { (f) &= ~IFF_BROADCAST; } while (0)
|
2023-04-14 12:09:32 +02:00
|
|
|
#define IFF_CLR_SLAVE(f) do { (f) &= ~IFF_SLAVE; } while (0)
|
|
|
|
#define IFF_CLR_DYNAMIC(f) do { (f) &= ~IFF_DYNAMIC; } while (0)
|
2022-06-01 06:47:30 +02:00
|
|
|
|
|
|
|
#define IFF_IS_UP(f) (((f) & IFF_UP) != 0)
|
|
|
|
#define IFF_IS_RUNNING(f) (((f) & IFF_RUNNING) != 0)
|
|
|
|
#define IFF_IS_NOARP(f) (((f) & IFF_NOARP) != 0)
|
2022-10-17 09:13:34 +02:00
|
|
|
#define IFF_IS_NAT(f) (((f) & IFF_NAT) != 0)
|
2022-06-01 06:47:30 +02:00
|
|
|
#define IFF_IS_LOOPBACK(f) (((f) & IFF_LOOPBACK) != 0)
|
|
|
|
#define IFF_IS_POINTOPOINT(f) (((f) & IFF_POINTOPOINT) != 0)
|
|
|
|
#define IFF_IS_MULTICAST(f) (((f) & IFF_MULTICAST) != 0)
|
|
|
|
#define IFF_IS_BROADCAST(f) (((f) & IFF_BROADCAST) != 0)
|
2023-04-14 12:09:32 +02:00
|
|
|
#define IFF_IS_SLAVE(f) (((f) & IFF_SLAVE) != 0)
|
|
|
|
#define IFF_IS_DYNAMIC(f) (((f) & IFF_DYNAMIC) != 0)
|
2015-01-17 14:42:09 +01:00
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/* We only need to manage the IPv6 bit if both IPv6 and IPv4 are supported.
|
2021-04-28 22:18:16 +02:00
|
|
|
* Otherwise, we can save a few bytes by ignoring it.
|
2015-01-24 14:29:43 +01:00
|
|
|
*/
|
|
|
|
|
|
|
|
#if defined(CONFIG_NET_IPv4) && defined(CONFIG_NET_IPv6)
|
|
|
|
# define IFF_SET_IPv6(f) do { (f) |= IFF_IPv6; } while (0)
|
|
|
|
# define IFF_CLR_IPv6(f) do { (f) &= ~IFF_IPv6; } while (0)
|
|
|
|
# define IFF_IS_IPv6(f) (((f) & IFF_IPv6) != 0)
|
|
|
|
|
|
|
|
# define IFF_SET_IPv4(f) IFF_CLR_IPv6(f)
|
|
|
|
# define IFF_CLR_IPv4(f) IFF_SET_IPv6(f)
|
|
|
|
# define IFF_IS_IPv4(f) (!IFF_IS_IPv6(f))
|
|
|
|
|
|
|
|
#elif defined(CONFIG_NET_IPv6)
|
|
|
|
# define IFF_SET_IPv6(f)
|
|
|
|
# define IFF_CLR_IPv6(f)
|
|
|
|
# define IFF_IS_IPv6(f) (1)
|
|
|
|
|
|
|
|
# define IFF_SET_IPv4(f)
|
|
|
|
# define IFF_CLR_IPv4(f)
|
|
|
|
# define IFF_IS_IPv4(f) (0)
|
|
|
|
|
|
|
|
#else /* if defined(CONFIG_NET_IPv4) */
|
|
|
|
# define IFF_SET_IPv6(f)
|
|
|
|
# define IFF_CLR_IPv6(f)
|
|
|
|
# define IFF_IS_IPv6(f) (0)
|
|
|
|
|
|
|
|
# define IFF_SET_IPv4(f)
|
|
|
|
# define IFF_CLR_IPv4(f)
|
|
|
|
# define IFF_IS_IPv4(f) (1)
|
|
|
|
#endif
|
2014-01-21 17:21:45 +01:00
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/****************************************************************************
|
2008-09-12 02:39:12 +02:00
|
|
|
* Public Type Definitions
|
2021-02-03 09:42:38 +01:00
|
|
|
****************************************************************************/
|
2007-11-30 21:46:29 +01:00
|
|
|
|
2021-06-22 05:19:06 +02:00
|
|
|
struct if_nameindex
|
|
|
|
{
|
|
|
|
unsigned int if_index; /* 1, 2, ... */
|
|
|
|
FAR char *if_name; /* null terminated name: "eth0", ... */
|
|
|
|
};
|
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/* Structure passed with the SIOCMIINOTIFY ioctl command to enable
|
|
|
|
* notification of of PHY state changes.
|
2014-06-27 17:30:41 +02:00
|
|
|
*/
|
|
|
|
|
2019-01-27 23:42:18 +01:00
|
|
|
struct mii_ioctl_notify_s
|
2014-08-16 22:08:04 +02:00
|
|
|
{
|
2019-01-27 15:57:23 +01:00
|
|
|
pid_t pid; /* PID of the task to receive the signal. Zero means "this task" */
|
|
|
|
struct sigevent event; /* Describe the way a task is to be notified */
|
2014-08-16 22:08:04 +02:00
|
|
|
};
|
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/* Structure passed to read from or write to the MII/PHY management
|
|
|
|
* interface via the SIOCxMIIREG ioctl commands.
|
2014-08-16 22:08:04 +02:00
|
|
|
*/
|
|
|
|
|
|
|
|
struct mii_ioctl_data_s
|
2014-06-27 17:30:41 +02:00
|
|
|
{
|
|
|
|
uint16_t phy_id; /* PHY device address */
|
|
|
|
uint16_t reg_num; /* PHY register address */
|
|
|
|
uint16_t val_in; /* PHY input data */
|
|
|
|
uint16_t val_out; /* PHY output data */
|
|
|
|
};
|
|
|
|
|
2020-06-15 10:23:25 +02:00
|
|
|
/* Structure passed to get or set the CAN bitrate
|
|
|
|
* SIOCxCANBITRATE ioctl commands.
|
|
|
|
*/
|
|
|
|
|
|
|
|
struct can_ioctl_data_s
|
|
|
|
{
|
|
|
|
uint16_t arbi_bitrate; /* Classic CAN / Arbitration phase bitrate kbit/s */
|
|
|
|
uint16_t arbi_samplep; /* Classic CAN / Arbitration phase input % */
|
|
|
|
uint16_t data_bitrate; /* Data phase bitrate kbit/s */
|
|
|
|
uint16_t data_samplep; /* Data phase sample point % */
|
|
|
|
};
|
|
|
|
|
2022-04-15 23:40:00 +02:00
|
|
|
/* Structure passed to add or remove hardware-level CAN ID filters
|
|
|
|
* SIOCxCANSTDFILTER / SIOCxCANEXTFILTER ioctl commands.
|
|
|
|
*/
|
|
|
|
|
|
|
|
struct can_ioctl_filter_s
|
|
|
|
{
|
|
|
|
uint32_t fid1; /* 11- or 29-bit ID (context dependent). For dual match or
|
|
|
|
* for the lower address in a range of addresses */
|
|
|
|
uint32_t fid2; /* 11- or 29-bit ID. For dual match, address mask or for
|
|
|
|
* upper address in address range */
|
|
|
|
uint8_t ftype; /* See CAN_FILTER_* definitions */
|
|
|
|
uint8_t fprio; /* See CAN_MSGPRIO_* definitions */
|
|
|
|
};
|
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/* There are two forms of the I/F request structure.
|
|
|
|
* One for IPv6 and one for IPv4.
|
|
|
|
* Notice that they are (and must be) cast compatible and really different
|
|
|
|
* only in the size of the structure allocation.
|
2015-01-14 20:03:12 +01:00
|
|
|
*
|
|
|
|
* This is the I/F request that should be used with IPv6.
|
2012-06-08 00:00:19 +02:00
|
|
|
*/
|
|
|
|
|
|
|
|
struct lifreq
|
|
|
|
{
|
2022-04-15 23:40:00 +02:00
|
|
|
char lifr_name[IFNAMSIZ]; /* Network device name (e.g. "eth0") */
|
|
|
|
int16_t lifr_ifindex; /* Interface index */
|
2012-06-08 00:00:19 +02:00
|
|
|
union
|
|
|
|
{
|
2022-04-15 23:40:00 +02:00
|
|
|
struct sockaddr_storage lifru_addr; /* IP Address */
|
|
|
|
struct sockaddr_storage lifru_dstaddr; /* P-to-P Address */
|
|
|
|
struct sockaddr_storage lifru_broadaddr; /* Broadcast address */
|
|
|
|
struct sockaddr_storage lifru_netmask; /* Netmask */
|
|
|
|
struct sockaddr lifru_hwaddr; /* MAC address */
|
|
|
|
int lifru_count; /* Number of devices */
|
|
|
|
int lifru_mtu; /* MTU size */
|
2022-06-01 06:47:30 +02:00
|
|
|
uint32_t lifru_flags; /* Interface flags */
|
2022-04-15 23:40:00 +02:00
|
|
|
struct mii_ioctl_notify_s llfru_mii_notify; /* PHY event notification */
|
|
|
|
struct mii_ioctl_data_s lifru_mii_data; /* MII request data */
|
|
|
|
struct can_ioctl_data_s lifru_can_data; /* CAN bitrate request data */
|
|
|
|
struct can_ioctl_filter_s lifru_can_filter; /* CAN filter request data */
|
2012-06-08 00:00:19 +02:00
|
|
|
} lifr_ifru;
|
|
|
|
};
|
|
|
|
|
2020-06-15 14:09:26 +02:00
|
|
|
#define lifr_addr lifr_ifru.lifru_addr /* IP address */
|
|
|
|
#define lifr_dstaddr lifr_ifru.lifru_dstaddr /* P-to-P Address */
|
|
|
|
#define lifr_broadaddr lifr_ifru.lifru_broadaddr /* Broadcast address */
|
|
|
|
#define lifr_netmask lifr_ifru.lifru_netmask /* Interface net mask */
|
|
|
|
#define lifr_hwaddr lifr_ifru.lifru_hwaddr /* MAC address */
|
|
|
|
#define lifr_mtu lifr_ifru.lifru_mtu /* MTU */
|
|
|
|
#define lifr_count lifr_ifru.lifru_count /* Number of devices */
|
|
|
|
#define lifr_flags lifr_ifru.lifru_flags /* interface flags */
|
2014-08-17 17:46:03 +02:00
|
|
|
#define lifr_mii_notify_pid lifr_ifru.llfru_mii_notify.pid /* PID to be notified */
|
2019-01-27 23:42:18 +01:00
|
|
|
#define lifr_mii_notify_event lifr_ifru.llfru_mii_notify.event /* Describes notification */
|
2014-08-16 22:08:04 +02:00
|
|
|
#define lifr_mii_phy_id lifr_ifru.lifru_mii_data.phy_id /* PHY device address */
|
|
|
|
#define lifr_mii_reg_num lifr_ifru.lifru_mii_data.reg_num /* PHY register address */
|
|
|
|
#define lifr_mii_val_in lifr_ifru.lifru_mii_data.val_in /* PHY input data */
|
|
|
|
#define lifr_mii_val_out lifr_ifru.lifru_mii_data.val_out /* PHY output data */
|
2012-06-08 00:00:19 +02:00
|
|
|
|
2020-02-23 09:50:23 +01:00
|
|
|
/* Used only with the SIOCGLIFCONF IOCTL command */
|
2017-09-19 22:17:05 +02:00
|
|
|
|
|
|
|
struct lifconf
|
|
|
|
{
|
2022-04-15 23:40:00 +02:00
|
|
|
size_t lifc_len; /* Size of buffer */
|
2017-09-19 22:17:05 +02:00
|
|
|
union
|
|
|
|
{
|
2022-04-15 23:40:00 +02:00
|
|
|
FAR char *lifcu_buf; /* Buffer address */
|
|
|
|
FAR struct lifreq *lifcu_req; /* Array of ifreq structures */
|
2017-09-19 22:17:05 +02:00
|
|
|
} lifc_ifcu;
|
|
|
|
};
|
|
|
|
|
2022-04-15 23:40:00 +02:00
|
|
|
#define lifc_buf lifc_ifcu.lifcu_buf /* Buffer address */
|
|
|
|
#define lifc_req lifc_ifcu.lifcu_req /* Array of ifreq structures */
|
2017-09-19 22:17:05 +02:00
|
|
|
|
2015-01-14 20:03:12 +01:00
|
|
|
/* This is the I/F request that should be used with IPv4. */
|
2012-06-08 00:00:19 +02:00
|
|
|
|
2007-11-30 21:46:29 +01:00
|
|
|
struct ifreq
|
|
|
|
{
|
2022-04-15 23:40:00 +02:00
|
|
|
char ifr_name[IFNAMSIZ]; /* Network device name (e.g. "eth0") */
|
|
|
|
int16_t ifr_ifindex; /* Interface index */
|
2007-11-30 21:46:29 +01:00
|
|
|
union
|
|
|
|
{
|
2022-04-15 23:40:00 +02:00
|
|
|
struct sockaddr ifru_addr; /* IP Address */
|
|
|
|
struct sockaddr ifru_dstaddr; /* P-to-P Address */
|
|
|
|
struct sockaddr ifru_broadaddr; /* Broadcast address */
|
|
|
|
struct sockaddr ifru_netmask; /* Netmask */
|
|
|
|
struct sockaddr ifru_hwaddr; /* MAC address */
|
|
|
|
int ifru_count; /* Number of devices */
|
|
|
|
int ifru_mtu; /* MTU size */
|
2022-06-01 06:47:30 +02:00
|
|
|
uint32_t ifru_flags; /* Interface flags */
|
2022-04-15 23:40:00 +02:00
|
|
|
struct mii_ioctl_notify_s ifru_mii_notify; /* PHY event notification */
|
|
|
|
struct mii_ioctl_data_s ifru_mii_data; /* MII request data */
|
|
|
|
struct can_ioctl_data_s ifru_can_data; /* CAN bitrate request data */
|
|
|
|
struct can_ioctl_filter_s ifru_can_filter; /* CAN filter request data */
|
2007-11-30 21:46:29 +01:00
|
|
|
} ifr_ifru;
|
|
|
|
};
|
|
|
|
|
2020-06-15 14:09:26 +02:00
|
|
|
#define ifr_addr ifr_ifru.ifru_addr /* IP address */
|
|
|
|
#define ifr_dstaddr ifr_ifru.ifru_dstaddr /* P-to-P Address */
|
|
|
|
#define ifr_broadaddr ifr_ifru.ifru_broadaddr /* Broadcast address */
|
|
|
|
#define ifr_netmask ifr_ifru.ifru_netmask /* Interface net mask */
|
|
|
|
#define ifr_hwaddr ifr_ifru.ifru_hwaddr /* MAC address */
|
|
|
|
#define ifr_mtu ifr_ifru.ifru_mtu /* MTU */
|
|
|
|
#define ifr_count ifr_ifru.ifru_count /* Number of devices */
|
|
|
|
#define ifr_flags ifr_ifru.ifru_flags /* interface flags */
|
2014-08-17 17:46:03 +02:00
|
|
|
#define ifr_mii_notify_pid ifr_ifru.ifru_mii_notify.pid /* PID to be notified */
|
2019-01-27 23:42:18 +01:00
|
|
|
#define ifr_mii_notify_event ifr_ifru.ifru_mii_notify.event /* Describes notification */
|
2014-08-16 22:08:04 +02:00
|
|
|
#define ifr_mii_phy_id ifr_ifru.ifru_mii_data.phy_id /* PHY device address */
|
|
|
|
#define ifr_mii_reg_num ifr_ifru.ifru_mii_data.reg_num /* PHY register address */
|
|
|
|
#define ifr_mii_val_in ifr_ifru.ifru_mii_data.val_in /* PHY input data */
|
|
|
|
#define ifr_mii_val_out ifr_ifru.ifru_mii_data.val_out /* PHY output data */
|
2012-06-08 00:00:19 +02:00
|
|
|
|
2020-06-15 10:23:25 +02:00
|
|
|
/* Used only with the SIOCGIFCONF IOCTL command */
|
2017-09-19 22:17:05 +02:00
|
|
|
|
|
|
|
struct ifconf
|
|
|
|
{
|
2022-04-15 23:40:00 +02:00
|
|
|
size_t ifc_len; /* Size of buffer */
|
2017-09-19 22:17:05 +02:00
|
|
|
union
|
|
|
|
{
|
|
|
|
FAR char *ifcu_buf; /* Buffer address */
|
|
|
|
FAR struct ifreq *ifcu_req; /* Array of ifreq structures */
|
|
|
|
} ifc_ifcu;
|
|
|
|
};
|
|
|
|
|
|
|
|
#define ifc_buf ifc_ifcu.ifcu_buf /* Buffer address */
|
|
|
|
#define ifc_req ifc_ifcu.ifcu_req /* Array of ifreq structures */
|
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/****************************************************************************
|
2007-11-30 21:46:29 +01:00
|
|
|
* Public Function Prototypes
|
2021-02-03 09:42:38 +01:00
|
|
|
****************************************************************************/
|
2007-11-30 21:46:29 +01:00
|
|
|
|
2018-10-27 20:13:02 +02:00
|
|
|
#ifdef __cplusplus
|
|
|
|
#define EXTERN extern "C"
|
|
|
|
extern "C"
|
|
|
|
{
|
|
|
|
#else
|
|
|
|
#define EXTERN extern
|
|
|
|
#endif
|
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/****************************************************************************
|
2018-06-25 20:08:10 +02:00
|
|
|
* Name: if_nametoindex
|
|
|
|
*
|
|
|
|
* Description:
|
2021-02-03 09:42:38 +01:00
|
|
|
* The if_nametoindex() function returns the interface index corresponding
|
|
|
|
* to name ifname.
|
2018-06-25 20:08:10 +02:00
|
|
|
*
|
|
|
|
* Input Parameters:
|
|
|
|
* ifname - The interface name
|
|
|
|
*
|
|
|
|
* Returned Value:
|
2021-02-03 09:42:38 +01:00
|
|
|
* The corresponding index if ifname is the name of an interface;
|
|
|
|
* otherwise, zero.
|
2018-06-25 20:08:10 +02:00
|
|
|
*
|
2021-02-03 09:42:38 +01:00
|
|
|
****************************************************************************/
|
2018-06-25 20:08:10 +02:00
|
|
|
|
|
|
|
unsigned int if_nametoindex(FAR const char *ifname);
|
|
|
|
|
2021-02-03 09:42:38 +01:00
|
|
|
/****************************************************************************
|
2018-06-25 20:08:10 +02:00
|
|
|
* Name: if_indextoname
|
|
|
|
*
|
|
|
|
* Description:
|
2021-02-03 09:42:38 +01:00
|
|
|
* The if_indextoname() function maps an interface index to its
|
|
|
|
* corresponding name.
|
2018-06-25 20:08:10 +02:00
|
|
|
*
|
|
|
|
* Input Parameters:
|
2021-02-03 09:42:38 +01:00
|
|
|
* ifname - Points to a buffer of at least IF_NAMESIZE bytes.
|
|
|
|
* if_indextoname() will place in this buffer the name
|
|
|
|
* of the interface with index ifindex.
|
2018-06-25 20:08:10 +02:00
|
|
|
*
|
|
|
|
* Returned Value:
|
2021-02-03 09:42:38 +01:00
|
|
|
* If ifindex is an interface index, then the function will return the
|
|
|
|
* value supplied by ifname.
|
|
|
|
* Otherwise, the function returns a NULL pointer and sets errno to
|
|
|
|
* indicate the error.
|
2018-06-25 20:08:10 +02:00
|
|
|
*
|
2021-02-03 09:42:38 +01:00
|
|
|
****************************************************************************/
|
2018-06-25 20:08:10 +02:00
|
|
|
|
|
|
|
FAR char *if_indextoname(unsigned int ifindex, FAR char *ifname);
|
|
|
|
|
2021-06-22 05:19:06 +02:00
|
|
|
/****************************************************************************
|
|
|
|
* Name: if_nameindex
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* The if_nameindex() function returns an array of if_nameindex structures,
|
|
|
|
* each containing information about one of the network interfaces on the
|
|
|
|
* local system. The if_nameindex structure contains at least the following
|
|
|
|
* entries:
|
|
|
|
* unsigned int if_index;
|
|
|
|
* FAR char *if_name;
|
|
|
|
* The if_index field contains the interface index. The if_name field
|
|
|
|
* points to the null-terminated interface name. The end of the array
|
|
|
|
* is indicated by entry with if_index set to zero and if_name set to NULL.
|
|
|
|
*
|
|
|
|
* Input Parameters:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* On success, if_nameindex() returns pointer to the array; on error, NULL
|
|
|
|
* is returned, and errno is set to indicate the error.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
FAR struct if_nameindex *if_nameindex(void);
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: if_freenameindex
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* The if_freenameindex() function free the data structure returned by
|
|
|
|
* if_nameindex().
|
|
|
|
*
|
|
|
|
* Input Parameters:
|
|
|
|
* ifn - The data structure to free
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
void if_freenameindex(FAR struct if_nameindex *ifn);
|
|
|
|
|
2018-10-27 20:13:02 +02:00
|
|
|
#undef EXTERN
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
2012-07-17 05:58:11 +02:00
|
|
|
#endif /* __INCLUDE_NET_IF_H */
|