include/netlink/route/link.h

   1 /*
   2  * netlink/route/link.h         Links (Interfaces)
   3  *
   4  *      This library is free software; you can redistribute it and/or
   5  *      modify it under the terms of the GNU Lesser General Public
   6  *      License as published by the Free Software Foundation version 2.1
   7  *      of the License.
   8  *
   9  * Copyright (c) 2003-2012 Thomas Graf <tgraf@suug.ch>
  10  */
  11
  12 #ifndef NETLINK_LINK_H_
  13 #define NETLINK_LINK_H_
  14
  15 #include <netlink/netlink.h>
  16 #include <netlink/cache.h>
  17 #include <netlink/addr.h>
  18
  19 #ifdef __cplusplus
  20 extern "C" {
  21 #endif
  22
  23 /**
  24  * @struct rtnl_link link.h "netlink/route/link.h"
  25  * @brief Link object
  26  * @implements nl_object
  27  * @ingroup link
  28  *
  29  * @copydoc private_struct
  30  */
  31 struct rtnl_link;
  32
  33 /**
  34  * @ingroup link
  35  */
  36 typedef enum {
  37         RTNL_LINK_RX_PACKETS,           /*!< Packets received */
  38         RTNL_LINK_TX_PACKETS,           /*!< Packets sent */
  39         RTNL_LINK_RX_BYTES,             /*!< Bytes received */
  40         RTNL_LINK_TX_BYTES,             /*!< Bytes sent */
  41         RTNL_LINK_RX_ERRORS,            /*!< Receive errors */
  42         RTNL_LINK_TX_ERRORS,            /*!< Send errors */
  43         RTNL_LINK_RX_DROPPED,           /*!< Received packets dropped */
  44         RTNL_LINK_TX_DROPPED,           /*!< Packets dropped during transmit */
  45         RTNL_LINK_RX_COMPRESSED,        /*!< Compressed packets received */
  46         RTNL_LINK_TX_COMPRESSED,        /*!< Compressed packets sent */
  47         RTNL_LINK_RX_FIFO_ERR,          /*!< Receive FIFO errors */
  48         RTNL_LINK_TX_FIFO_ERR,          /*!< Send FIFO errors */
  49         RTNL_LINK_RX_LEN_ERR,           /*!< Length errors */
  50         RTNL_LINK_RX_OVER_ERR,          /*!< Over errors */
  51         RTNL_LINK_RX_CRC_ERR,           /*!< CRC errors */
  52         RTNL_LINK_RX_FRAME_ERR,         /*!< Frame errors */
  53         RTNL_LINK_RX_MISSED_ERR,        /*!< Missed errors */
  54         RTNL_LINK_TX_ABORT_ERR,         /*!< Aborted errors */
  55         RTNL_LINK_TX_CARRIER_ERR,       /*!< Carrier errors */
  56         RTNL_LINK_TX_HBEAT_ERR,         /*!< Heartbeat errors */
  57         RTNL_LINK_TX_WIN_ERR,           /*!< Window errors */
  58         RTNL_LINK_COLLISIONS,           /*!< Send collisions */
  59         RTNL_LINK_MULTICAST,            /*!< Multicast */
  60         RTNL_LINK_IP6_INPKTS,           /*!< IPv6 SNMP InReceives */
  61         RTNL_LINK_IP6_INHDRERRORS,      /*!< IPv6 SNMP InHdrErrors */
  62         RTNL_LINK_IP6_INTOOBIGERRORS,   /*!< IPv6 SNMP InTooBigErrors */
  63         RTNL_LINK_IP6_INNOROUTES,       /*!< IPv6 SNMP InNoRoutes */
  64         RTNL_LINK_IP6_INADDRERRORS,     /*!< IPv6 SNMP InAddrErrors */
  65         RTNL_LINK_IP6_INUNKNOWNPROTOS,  /*!< IPv6 SNMP InUnknownProtos */
  66         RTNL_LINK_IP6_INTRUNCATEDPKTS,  /*!< IPv6 SNMP InTruncatedPkts */
  67         RTNL_LINK_IP6_INDISCARDS,       /*!< IPv6 SNMP InDiscards */
  68         RTNL_LINK_IP6_INDELIVERS,       /*!< IPv6 SNMP InDelivers */
  69         RTNL_LINK_IP6_OUTFORWDATAGRAMS, /*!< IPv6 SNMP OutForwDatagrams */
  70         RTNL_LINK_IP6_OUTPKTS,          /*!< IPv6 SNMP OutRequests */
  71         RTNL_LINK_IP6_OUTDISCARDS,      /*!< IPv6 SNMP OutDiscards */
  72         RTNL_LINK_IP6_OUTNOROUTES,      /*!< IPv6 SNMP OutNoRoutes */
  73         RTNL_LINK_IP6_REASMTIMEOUT,     /*!< IPv6 SNMP ReasmTimeout */
  74         RTNL_LINK_IP6_REASMREQDS,       /*!< IPv6 SNMP ReasmReqds */
  75         RTNL_LINK_IP6_REASMOKS,         /*!< IPv6 SNMP ReasmOKs */
  76         RTNL_LINK_IP6_REASMFAILS,       /*!< IPv6 SNMP ReasmFails */
  77         RTNL_LINK_IP6_FRAGOKS,          /*!< IPv6 SNMP FragOKs */
  78         RTNL_LINK_IP6_FRAGFAILS,        /*!< IPv6 SNMP FragFails */
  79         RTNL_LINK_IP6_FRAGCREATES,      /*!< IPv6 SNMP FragCreates */
  80         RTNL_LINK_IP6_INMCASTPKTS,      /*!< IPv6 SNMP InMcastPkts */
  81         RTNL_LINK_IP6_OUTMCASTPKTS,     /*!< IPv6 SNMP OutMcastPkts */
  82         RTNL_LINK_IP6_INBCASTPKTS,      /*!< IPv6 SNMP InBcastPkts */
  83         RTNL_LINK_IP6_OUTBCASTPKTS,     /*!< IPv6 SNMP OutBcastPkts */
  84         RTNL_LINK_IP6_INOCTETS,         /*!< IPv6 SNMP InOctets */
  85         RTNL_LINK_IP6_OUTOCTETS,        /*!< IPv6 SNMP OutOctets */
  86         RTNL_LINK_IP6_INMCASTOCTETS,    /*!< IPv6 SNMP InMcastOctets */
  87         RTNL_LINK_IP6_OUTMCASTOCTETS,   /*!< IPv6 SNMP OutMcastOctets */
  88         RTNL_LINK_IP6_INBCASTOCTETS,    /*!< IPv6 SNMP InBcastOctets */
  89         RTNL_LINK_IP6_OUTBCASTOCTETS,   /*!< IPv6 SNMP OutBcastOctets */
  90         RTNL_LINK_ICMP6_INMSGS,         /*!< ICMPv6 SNMP InMsgs */
  91         RTNL_LINK_ICMP6_INERRORS,       /*!< ICMPv6 SNMP InErrors */
  92         RTNL_LINK_ICMP6_OUTMSGS,        /*!< ICMPv6 SNMP OutMsgs */
  93         RTNL_LINK_ICMP6_OUTERRORS,      /*!< ICMPv6 SNMP OutErrors */
  94         __RTNL_LINK_STATS_MAX,
  95 } rtnl_link_stat_id_t;
  96
  97 #define RTNL_LINK_STATS_MAX (__RTNL_LINK_STATS_MAX - 1)
  98
  99 extern struct rtnl_link *rtnl_link_alloc(void);
 100 extern void     rtnl_link_put(struct rtnl_link *);
 101
 102 extern int      rtnl_link_alloc_cache(struct nl_sock *, int, struct nl_cache **);
 103 extern struct rtnl_link *rtnl_link_get(struct nl_cache *, int);
 104 extern struct rtnl_link *rtnl_link_get_by_name(struct nl_cache *, const char *);
 105
 106
 107 extern int      rtnl_link_build_add_request(struct rtnl_link *, int,
 108                                             struct nl_msg **);
 109 extern int      rtnl_link_add(struct nl_sock *, struct rtnl_link *, int);
 110 extern int      rtnl_link_build_change_request(struct rtnl_link *,
 111                                                struct rtnl_link *, int,
 112                                                struct nl_msg **);
 113 extern int      rtnl_link_change(struct nl_sock *, struct rtnl_link *,
 114                                  struct rtnl_link *, int);
 115
 116 extern int      rtnl_link_build_delete_request(const struct rtnl_link *,
 117                                                struct nl_msg **);
 118 extern int      rtnl_link_delete(struct nl_sock *, const struct rtnl_link *);
 119 extern int      rtnl_link_build_get_request(int, const char *,
 120                                             struct nl_msg **);
 121 extern int      rtnl_link_get_kernel(struct nl_sock *, int, const char *,
 122                                      struct rtnl_link **);
 123
 124 /* Name <-> Index Translations */
 125 extern char *   rtnl_link_i2name(struct nl_cache *, int, char *, size_t);
 126 extern int      rtnl_link_name2i(struct nl_cache *, const char *);
 127
 128 /* Name <-> Statistic Translations */
 129 extern char *   rtnl_link_stat2str(int, char *, size_t);
 130 extern int      rtnl_link_str2stat(const char *);
 131
 132 /* Link Flags Translations */
 133 extern char *   rtnl_link_flags2str(int, char *, size_t);
 134 extern int      rtnl_link_str2flags(const char *);
 135
 136 extern char *   rtnl_link_operstate2str(uint8_t, char *, size_t);
 137 extern int      rtnl_link_str2operstate(const char *);
 138
 139 extern char *   rtnl_link_mode2str(uint8_t, char *, size_t);
 140 extern int      rtnl_link_str2mode(const char *);
 141
 142 /* Carrier State Translations */
 143 extern char *   rtnl_link_carrier2str(uint8_t, char *, size_t);
 144 extern int      rtnl_link_str2carrier(const char *);
 145
 146 /* Access Functions */
 147 extern void     rtnl_link_set_qdisc(struct rtnl_link *, const char *);
 148 extern char *   rtnl_link_get_qdisc(struct rtnl_link *);
 149
 150 extern void     rtnl_link_set_name(struct rtnl_link *, const char *);
 151 extern char *   rtnl_link_get_name(struct rtnl_link *);
 152
 153 extern void     rtnl_link_set_group(struct rtnl_link *, uint32_t);
 154 extern uint32_t rtnl_link_get_group(struct rtnl_link *);
 155
 156 extern void     rtnl_link_set_flags(struct rtnl_link *, unsigned int);
 157 extern void     rtnl_link_unset_flags(struct rtnl_link *, unsigned int);
 158 extern unsigned int rtnl_link_get_flags(struct rtnl_link *);
 159
 160 extern void     rtnl_link_set_mtu(struct rtnl_link *, unsigned int);
 161 extern unsigned int rtnl_link_get_mtu(struct rtnl_link *);
 162
 163 extern void     rtnl_link_set_txqlen(struct rtnl_link *, unsigned int);
 164 extern unsigned int rtnl_link_get_txqlen(struct rtnl_link *);
 165
 166 extern void     rtnl_link_set_ifindex(struct rtnl_link *, int);
 167 extern int      rtnl_link_get_ifindex(struct rtnl_link *);
 168
 169 extern void     rtnl_link_set_family(struct rtnl_link *, int);
 170 extern int      rtnl_link_get_family(struct rtnl_link *);
 171
 172 extern void     rtnl_link_set_arptype(struct rtnl_link *, unsigned int);
 173 extern unsigned int rtnl_link_get_arptype(struct rtnl_link *);
 174
 175 extern void     rtnl_link_set_addr(struct rtnl_link *, struct nl_addr *);
 176 extern struct nl_addr *rtnl_link_get_addr(struct rtnl_link *);
 177
 178 extern void     rtnl_link_set_broadcast(struct rtnl_link *, struct nl_addr *);
 179 extern struct nl_addr *rtnl_link_get_broadcast(struct rtnl_link *);
 180
 181 extern void     rtnl_link_set_link(struct rtnl_link *, int);
 182 extern int      rtnl_link_get_link(struct rtnl_link *);
 183
 184 extern void     rtnl_link_set_master(struct rtnl_link *, int);
 185 extern int      rtnl_link_get_master(struct rtnl_link *);
 186
 187 extern void     rtnl_link_set_carrier(struct rtnl_link *, uint8_t);
 188 extern uint8_t  rtnl_link_get_carrier(struct rtnl_link *);
 189
 190 extern void     rtnl_link_set_operstate(struct rtnl_link *, uint8_t);
 191 extern uint8_t  rtnl_link_get_operstate(struct rtnl_link *);
 192
 193 extern void     rtnl_link_set_linkmode(struct rtnl_link *, uint8_t);
 194 extern uint8_t  rtnl_link_get_linkmode(struct rtnl_link *);
 195
 196 extern const char *     rtnl_link_get_ifalias(struct rtnl_link *);
 197 extern void             rtnl_link_set_ifalias(struct rtnl_link *, const char *);
 198
 199 extern int              rtnl_link_get_num_vf(struct rtnl_link *, uint32_t *);
 200
 201 extern uint64_t rtnl_link_get_stat(struct rtnl_link *, rtnl_link_stat_id_t);
 202 extern int      rtnl_link_set_stat(struct rtnl_link *, rtnl_link_stat_id_t,
 203                                    const uint64_t);
 204
 205 extern int      rtnl_link_set_type(struct rtnl_link *, const char *);
 206 extern char *   rtnl_link_get_type(struct rtnl_link *);
 207
 208 extern void     rtnl_link_set_promiscuity(struct rtnl_link *, uint32_t);
 209 extern uint32_t rtnl_link_get_promiscuity(struct rtnl_link *);
 210
 211 extern void     rtnl_link_set_num_tx_queues(struct rtnl_link *, uint32_t);
 212 extern uint32_t rtnl_link_get_num_tx_queues(struct rtnl_link *);
 213
 214 extern void     rtnl_link_set_num_rx_queues(struct rtnl_link *, uint32_t);
 215 extern uint32_t rtnl_link_get_num_rx_queues(struct rtnl_link *);
 216
 217 extern int      rtnl_link_enslave_ifindex(struct nl_sock *, int, int);
 218 extern int      rtnl_link_enslave(struct nl_sock *, struct rtnl_link *,
 219                                   struct rtnl_link *);
 220 extern int      rtnl_link_release_ifindex(struct nl_sock *, int);
 221 extern int      rtnl_link_release(struct nl_sock *, struct rtnl_link *);
 222
 223 /* deprecated */
 224 extern int      rtnl_link_set_info_type(struct rtnl_link *, const char *) __attribute__((deprecated));
 225 extern char *   rtnl_link_get_info_type(struct rtnl_link *) __attribute__((deprecated));
 226 extern void     rtnl_link_set_weight(struct rtnl_link *, unsigned int) __attribute__((deprecated));
 227 extern unsigned int rtnl_link_get_weight(struct rtnl_link *) __attribute__((deprecated));
 228
 229
 230 #ifdef __cplusplus
 231 }
 232 #endif
 233
 234 #endif