Annotation of embedaddon/quagga/lib/if.h, revision 1.1
1.1 ! misho 1: /* Interface related header.
! 2: Copyright (C) 1997, 98, 99 Kunihiro Ishiguro
! 3:
! 4: This file is part of GNU Zebra.
! 5:
! 6: GNU Zebra is free software; you can redistribute it and/or modify
! 7: it under the terms of the GNU General Public License as published
! 8: by the Free Software Foundation; either version 2, or (at your
! 9: option) any later version.
! 10:
! 11: GNU Zebra is distributed in the hope that it will be useful, but
! 12: WITHOUT ANY WARRANTY; without even the implied warranty of
! 13: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
! 14: General Public License for more details.
! 15:
! 16: You should have received a copy of the GNU General Public License
! 17: along with GNU Zebra; see the file COPYING. If not, write to the
! 18: Free Software Foundation, Inc., 59 Temple Place - Suite 330,
! 19: Boston, MA 02111-1307, USA. */
! 20:
! 21: #ifndef _ZEBRA_IF_H
! 22: #define _ZEBRA_IF_H
! 23:
! 24: #include "linklist.h"
! 25:
! 26: /*
! 27: Interface name length.
! 28:
! 29: Linux define value in /usr/include/linux/if.h.
! 30: #define IFNAMSIZ 16
! 31:
! 32: FreeBSD define value in /usr/include/net/if.h.
! 33: #define IFNAMSIZ 16
! 34: */
! 35:
! 36: #define INTERFACE_NAMSIZ 20
! 37: #define INTERFACE_HWADDR_MAX 20
! 38:
! 39: #ifdef HAVE_PROC_NET_DEV
! 40: struct if_stats
! 41: {
! 42: unsigned long rx_packets; /* total packets received */
! 43: unsigned long tx_packets; /* total packets transmitted */
! 44: unsigned long rx_bytes; /* total bytes received */
! 45: unsigned long tx_bytes; /* total bytes transmitted */
! 46: unsigned long rx_errors; /* bad packets received */
! 47: unsigned long tx_errors; /* packet transmit problems */
! 48: unsigned long rx_dropped; /* no space in linux buffers */
! 49: unsigned long tx_dropped; /* no space available in linux */
! 50: unsigned long rx_multicast; /* multicast packets received */
! 51: unsigned long rx_compressed;
! 52: unsigned long tx_compressed;
! 53: unsigned long collisions;
! 54:
! 55: /* detailed rx_errors: */
! 56: unsigned long rx_length_errors;
! 57: unsigned long rx_over_errors; /* receiver ring buff overflow */
! 58: unsigned long rx_crc_errors; /* recved pkt with crc error */
! 59: unsigned long rx_frame_errors; /* recv'd frame alignment error */
! 60: unsigned long rx_fifo_errors; /* recv'r fifo overrun */
! 61: unsigned long rx_missed_errors; /* receiver missed packet */
! 62: /* detailed tx_errors */
! 63: unsigned long tx_aborted_errors;
! 64: unsigned long tx_carrier_errors;
! 65: unsigned long tx_fifo_errors;
! 66: unsigned long tx_heartbeat_errors;
! 67: unsigned long tx_window_errors;
! 68: };
! 69: #endif /* HAVE_PROC_NET_DEV */
! 70:
! 71: /* Interface structure */
! 72: struct interface
! 73: {
! 74: /* Interface name. This should probably never be changed after the
! 75: interface is created, because the configuration info for this interface
! 76: is associated with this structure. For that reason, the interface
! 77: should also never be deleted (to avoid losing configuration info).
! 78: To delete, just set ifindex to IFINDEX_INTERNAL to indicate that the
! 79: interface does not exist in the kernel.
! 80: */
! 81: char name[INTERFACE_NAMSIZ + 1];
! 82:
! 83: /* Interface index (should be IFINDEX_INTERNAL for non-kernel or
! 84: deleted interfaces). */
! 85: unsigned int ifindex;
! 86: #define IFINDEX_INTERNAL 0
! 87:
! 88: /* Zebra internal interface status */
! 89: u_char status;
! 90: #define ZEBRA_INTERFACE_ACTIVE (1 << 0)
! 91: #define ZEBRA_INTERFACE_SUB (1 << 1)
! 92: #define ZEBRA_INTERFACE_LINKDETECTION (1 << 2)
! 93:
! 94: /* Interface flags. */
! 95: uint64_t flags;
! 96:
! 97: /* Interface metric */
! 98: int metric;
! 99:
! 100: /* Interface MTU. */
! 101: unsigned int mtu; /* IPv4 MTU */
! 102: unsigned int mtu6; /* IPv6 MTU - probably, but not neccessarily same as mtu */
! 103:
! 104: /* Hardware address. */
! 105: #ifdef HAVE_STRUCT_SOCKADDR_DL
! 106: struct sockaddr_dl sdl;
! 107: #else
! 108: unsigned short hw_type;
! 109: u_char hw_addr[INTERFACE_HWADDR_MAX];
! 110: int hw_addr_len;
! 111: #endif /* HAVE_STRUCT_SOCKADDR_DL */
! 112:
! 113: /* interface bandwidth, kbits */
! 114: unsigned int bandwidth;
! 115:
! 116: /* description of the interface. */
! 117: char *desc;
! 118:
! 119: /* Distribute list. */
! 120: void *distribute_in;
! 121: void *distribute_out;
! 122:
! 123: /* Connected address list. */
! 124: struct list *connected;
! 125:
! 126: /* Daemon specific interface data pointer. */
! 127: void *info;
! 128:
! 129: /* Statistics fileds. */
! 130: #ifdef HAVE_PROC_NET_DEV
! 131: struct if_stats stats;
! 132: #endif /* HAVE_PROC_NET_DEV */
! 133: #ifdef HAVE_NET_RT_IFLIST
! 134: struct if_data stats;
! 135: #endif /* HAVE_NET_RT_IFLIST */
! 136: };
! 137:
! 138: /* Connected address structure. */
! 139: struct connected
! 140: {
! 141: /* Attached interface. */
! 142: struct interface *ifp;
! 143:
! 144: /* Flags for configuration. */
! 145: u_char conf;
! 146: #define ZEBRA_IFC_REAL (1 << 0)
! 147: #define ZEBRA_IFC_CONFIGURED (1 << 1)
! 148: /*
! 149: The ZEBRA_IFC_REAL flag should be set if and only if this address
! 150: exists in the kernel.
! 151: The ZEBRA_IFC_CONFIGURED flag should be set if and only if this address
! 152: was configured by the user from inside quagga.
! 153: */
! 154:
! 155: /* Flags for connected address. */
! 156: u_char flags;
! 157: #define ZEBRA_IFA_SECONDARY (1 << 0)
! 158: #define ZEBRA_IFA_PEER (1 << 1)
! 159: /* N.B. the ZEBRA_IFA_PEER flag should be set if and only if
! 160: a peer address has been configured. If this flag is set,
! 161: the destination field must contain the peer address.
! 162: Otherwise, if this flag is not set, the destination address
! 163: will either contain a broadcast address or be NULL.
! 164: */
! 165:
! 166: /* Address of connected network. */
! 167: struct prefix *address;
! 168:
! 169: /* Peer or Broadcast address, depending on whether ZEBRA_IFA_PEER is set.
! 170: Note: destination may be NULL if ZEBRA_IFA_PEER is not set. */
! 171: struct prefix *destination;
! 172:
! 173: /* Label for Linux 2.2.X and upper. */
! 174: char *label;
! 175: };
! 176:
! 177: /* Does the destination field contain a peer address? */
! 178: #define CONNECTED_PEER(C) CHECK_FLAG((C)->flags, ZEBRA_IFA_PEER)
! 179:
! 180: /* Prefix to insert into the RIB */
! 181: #define CONNECTED_PREFIX(C) \
! 182: (CONNECTED_PEER(C) ? (C)->destination : (C)->address)
! 183:
! 184: /* Identifying address. We guess that if there's a peer address, but the
! 185: local address is in the same prefix, then the local address may be unique. */
! 186: #define CONNECTED_ID(C) \
! 187: ((CONNECTED_PEER(C) && !prefix_match((C)->destination, (C)->address)) ?\
! 188: (C)->destination : (C)->address)
! 189:
! 190: /* Interface hook sort. */
! 191: #define IF_NEW_HOOK 0
! 192: #define IF_DELETE_HOOK 1
! 193:
! 194: /* There are some interface flags which are only supported by some
! 195: operating system. */
! 196:
! 197: #ifndef IFF_NOTRAILERS
! 198: #define IFF_NOTRAILERS 0x0
! 199: #endif /* IFF_NOTRAILERS */
! 200: #ifndef IFF_OACTIVE
! 201: #define IFF_OACTIVE 0x0
! 202: #endif /* IFF_OACTIVE */
! 203: #ifndef IFF_SIMPLEX
! 204: #define IFF_SIMPLEX 0x0
! 205: #endif /* IFF_SIMPLEX */
! 206: #ifndef IFF_LINK0
! 207: #define IFF_LINK0 0x0
! 208: #endif /* IFF_LINK0 */
! 209: #ifndef IFF_LINK1
! 210: #define IFF_LINK1 0x0
! 211: #endif /* IFF_LINK1 */
! 212: #ifndef IFF_LINK2
! 213: #define IFF_LINK2 0x0
! 214: #endif /* IFF_LINK2 */
! 215: #ifndef IFF_NOXMIT
! 216: #define IFF_NOXMIT 0x0
! 217: #endif /* IFF_NOXMIT */
! 218: #ifndef IFF_NORTEXCH
! 219: #define IFF_NORTEXCH 0x0
! 220: #endif /* IFF_NORTEXCH */
! 221: #ifndef IFF_IPV4
! 222: #define IFF_IPV4 0x0
! 223: #endif /* IFF_IPV4 */
! 224: #ifndef IFF_IPV6
! 225: #define IFF_IPV6 0x0
! 226: #endif /* IFF_IPV6 */
! 227: #ifndef IFF_VIRTUAL
! 228: #define IFF_VIRTUAL 0x0
! 229: #endif /* IFF_VIRTUAL */
! 230:
! 231: /* Prototypes. */
! 232: extern int if_cmp_func (struct interface *, struct interface *);
! 233: extern struct interface *if_create (const char *name, int namelen);
! 234: extern struct interface *if_lookup_by_index (unsigned int);
! 235: extern struct interface *if_lookup_exact_address (struct in_addr);
! 236: extern struct interface *if_lookup_address (struct in_addr);
! 237:
! 238: /* These 2 functions are to be used when the ifname argument is terminated
! 239: by a '\0' character: */
! 240: extern struct interface *if_lookup_by_name (const char *ifname);
! 241: extern struct interface *if_get_by_name (const char *ifname);
! 242:
! 243: /* For these 2 functions, the namelen argument should be the precise length
! 244: of the ifname string (not counting any optional trailing '\0' character).
! 245: In most cases, strnlen should be used to calculate the namelen value. */
! 246: extern struct interface *if_lookup_by_name_len(const char *ifname,
! 247: size_t namelen);
! 248: extern struct interface *if_get_by_name_len(const char *ifname, size_t namelen);
! 249:
! 250:
! 251: /* Delete the interface, but do not free the structure, and leave it in the
! 252: interface list. It is often advisable to leave the pseudo interface
! 253: structure because there may be configuration information attached. */
! 254: extern void if_delete_retain (struct interface *);
! 255:
! 256: /* Delete and free the interface structure: calls if_delete_retain and then
! 257: deletes it from the interface list and frees the structure. */
! 258: extern void if_delete (struct interface *);
! 259:
! 260: extern int if_is_up (struct interface *);
! 261: extern int if_is_running (struct interface *);
! 262: extern int if_is_operative (struct interface *);
! 263: extern int if_is_loopback (struct interface *);
! 264: extern int if_is_broadcast (struct interface *);
! 265: extern int if_is_pointopoint (struct interface *);
! 266: extern int if_is_multicast (struct interface *);
! 267: extern void if_add_hook (int, int (*)(struct interface *));
! 268: extern void if_init (void);
! 269: extern void if_terminate (void);
! 270: extern void if_dump_all (void);
! 271: extern const char *if_flag_dump(unsigned long);
! 272:
! 273: /* Please use ifindex2ifname instead of if_indextoname where possible;
! 274: ifindex2ifname uses internal interface info, whereas if_indextoname must
! 275: make a system call. */
! 276: extern const char *ifindex2ifname (unsigned int);
! 277:
! 278: /* Please use ifname2ifindex instead of if_nametoindex where possible;
! 279: ifname2ifindex uses internal interface info, whereas if_nametoindex must
! 280: make a system call. */
! 281: extern unsigned int ifname2ifindex(const char *ifname);
! 282:
! 283: /* Connected address functions. */
! 284: extern struct connected *connected_new (void);
! 285: extern void connected_free (struct connected *);
! 286: extern void connected_add (struct interface *, struct connected *);
! 287: extern struct connected *connected_add_by_prefix (struct interface *,
! 288: struct prefix *,
! 289: struct prefix *);
! 290: extern struct connected *connected_delete_by_prefix (struct interface *,
! 291: struct prefix *);
! 292: extern struct connected *connected_lookup_address (struct interface *,
! 293: struct in_addr);
! 294:
! 295: #ifndef HAVE_IF_NAMETOINDEX
! 296: extern unsigned int if_nametoindex (const char *);
! 297: #endif
! 298: #ifndef HAVE_IF_INDEXTONAME
! 299: extern char *if_indextoname (unsigned int, char *);
! 300: #endif
! 301:
! 302: /* Exported variables. */
! 303: extern struct list *iflist;
! 304: extern struct cmd_element interface_desc_cmd;
! 305: extern struct cmd_element no_interface_desc_cmd;
! 306: extern struct cmd_element interface_cmd;
! 307: extern struct cmd_element no_interface_cmd;
! 308: extern struct cmd_element interface_pseudo_cmd;
! 309: extern struct cmd_element no_interface_pseudo_cmd;
! 310: extern struct cmd_element show_address_cmd;
! 311:
! 312: #endif /* _ZEBRA_IF_H */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>