Interface.h

/*
** libutil++
** $Id: Interface.h 1653 2016-02-28 19:54:59Z sella $
** Copyright (c) 2011-2016 Digital Genesis, LLC. All Rights Reserved.
** Released under the LGPL Version 2.1 License.
** http://www.digitalgenesis.com
*/

#ifndef __libutilxx__sella__util__Interface_H__
#define __libutilxx__sella__util__Interface_H__

#include "../../common.h"
#include "InterfaceException.h"
#include "../net/IPAddress.h"

#include <net/if.h> 
#include <sys/ioctl.h>
#include <netinet/in.h>

#include <list>
#include <string>

namespace sella {
        namespace util {
                class Interface;
        }
}

class sella::util::Interface {
        public:
                /* See SIOCGIFFLAGS in man inetdevice for settings. */
                static const unsigned int ifrFlagMatchDefault = (IFF_UP);
                static const unsigned int ifrFlagRejectDefault = (IFF_LOOPBACK);

                static void setPromiscous(const std::string &interface, bool on = true) throw (InterfaceException);

                static std::string getInterface(const sella::net::IPAddress &ipAddress, unsigned int ifrFlagMatch = ifrFlagMatchDefault, unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                static sella::net::IPAddress::shared_list getIPAddresses(const std::string &interface = "", unsigned int ifrFlagMatch = ifrFlagMatchDefault, unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                static sella::net::IPAddress getIPAddress(const std::string &interface, int family = AF_INET) throw (InterfaceException);
                static std::list<std::string> getNames(unsigned int ifrFlagMatch = ifrFlagMatchDefault, unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                static std::list<std::string> getEthernetNames(const unsigned int ifrFlagMatch = ifrFlagMatchDefault, const unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                static std::string getMAC(const std::string &interface) throw (InterfaceException);
                static std::list<std::string> getMACs(unsigned int ifrFlagMatch = ifrFlagMatchDefault, unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);

                static struct in_addr* getAddr(const std::string &interface, struct in_addr *ip) throw (InterfaceException);
                static unsigned int getIndex(const std::string &interface) throw (InterfaceException);
                static std::string getName(unsigned int index) throw (InterfaceException);

                static unsigned char* convertMAC(unsigned char dst[6], const std::string &mac) throw (InterfaceException);
                static std::string& convertMAC(std::string &dst, const unsigned char mac[6], char delim = ':') throw (InterfaceException);

                static unsigned char* convertMAC(unsigned char dst[6], const uint64_t mac) throw (InterfaceException);
                static uint64_t& convertMAC(uint64_t &dst, const unsigned char mac[6]) throw (InterfaceException);

                static std::string& convertMAC(std::string &dst, const uint64_t mac) throw (InterfaceException);
                static uint64_t& convertMAC(uint64_t &dst, const std::string &mac) throw (InterfaceException);

                static bool isEthernet(const std::string &interface) throw (InterfaceException);

#if 0
                LIBUTIL_API_DEPRECATED static unsigned char* parseMAC(const std::string &mac, unsigned char addr[6]) throw (InterfaceException);
                LIBUTIL_API_DEPRECATED static sella::net::IPAddress::shared_list getInterfaceIPAddresses(const std::string &interface = "", unsigned int ifrFlagMatch = ifrFlagMatchDefault, unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                LIBUTIL_API_DEPRECATED static std::list<std::string> getInterfaceNames(unsigned int ifrFlagMatch = ifrFlagMatchDefault, unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                LIBUTIL_API_DEPRECATED static std::string getInterfaceMAC(const std::string &interface) throw (InterfaceException);
                LIBUTIL_API_DEPRECATED static std::list<std::string> getInterfaceMACs(unsigned int ifrFlagMatch = ifrFlagMatchDefault, unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                LIBUTIL_API_DEPRECATED static void getInterfaceAddr(const std::string &interface, struct in_addr *ip) throw (InterfaceException);

                LIBUTIL_API_DEPRECATED static sella::net::IPAddress::shared_list interfaceIPAddressList(const std::string &interface = std::string(), const unsigned int ifrFlagMatch = ifrFlagMatchDefault, const unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                LIBUTIL_API_DEPRECATED static std::list<std::string> interfaceNameList(const unsigned int ifrFlagMatch = ifrFlagMatchDefault, const unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                LIBUTIL_API_DEPRECATED static std::list<std::string> interfaceMACList(const unsigned int ifrFlagMatch = ifrFlagMatchDefault, const unsigned int ifrFlagReject = ifrFlagRejectDefault) throw (InterfaceException);
                LIBUTIL_API_DEPRECATED static void source_ip(char *interface, struct in_addr *ip) throw (InterfaceException);
#endif
};

#endif

/*
** vim: noet ts=3 sw=3
*/