X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=Socket%2FProtocols%2FINet%2FINetAddressing.hh;h=362e55cc1b2cfc860fc751cc50c2ff60bc30ec1a;hb=a1fdb7bb122f0b05be809a922d4b7ef5e125fa67;hp=e3a95d337488171c156bc6a5ee1ced265f159d1b;hpb=fa696fb7164ff243f6b7c1c5bda35ed75af153dc;p=senf.git diff --git a/Socket/Protocols/INet/INetAddressing.hh b/Socket/Protocols/INet/INetAddressing.hh index e3a95d3..362e55c 100644 --- a/Socket/Protocols/INet/INetAddressing.hh +++ b/Socket/Protocols/INet/INetAddressing.hh @@ -1,9 +1,9 @@ // $Id$ // // Copyright (C) 2006 -// Fraunhofer Institut fuer offene Kommunikationssysteme (FOKUS) -// Kompetenzzentrum fuer Satelitenkommunikation (SatCom) -// Stefan Bund +// Fraunhofer Institute for Open Communication Systems (FOKUS) +// Competence Center NETwork research (NET), St. Augustin, GERMANY +// Stefan Bund // // This program is free software; you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by @@ -24,18 +24,18 @@ \brief INet[46]Address and INet[46]AddressingPolicy public header */ -#ifndef HH_INetAddressing_ -#define HH_INetAddressing_ 1 +#ifndef HH_SENF_Socket_Protocols_INet_INetAddressing_ +#define HH_SENF_Socket_Protocols_INet_INetAddressing_ 1 // Custom includes #include #include #include -#include -#include "Socket/SocketPolicy.hh" -#include "Socket/ClientSocketHandle.hh" -#include "Socket/CommunicationPolicy.hh" -#include "Socket/Protocols/GenericAddressingPolicy.hh" +#include "../../SocketPolicy.hh" +#include "../../ClientSocketHandle.hh" +#include "../../CommunicationPolicy.hh" +#include "../BSDAddressingPolicy.hh" +#include "../BSDSocketAddress.hh" #include "INet4Address.hh" #include "INet6Address.hh" @@ -55,52 +55,50 @@ namespace senf { \ingroup addr_group */ class INet4SocketAddress - : public boost::equality_comparable, - public senf::ComparableSafeBool + : public BSDSocketAddress { public: + static short const addressFamily = AF_INET; + + /////////////////////////////////////////////////////////////////////////// + ///\name Structors and default members + ///@{ + INet4SocketAddress(); - explicit INet4SocketAddress(std::string const & address); ///< Set address and port + explicit INet4SocketAddress(std::string const & addr); ///< Set address and port /**< This constructor expects a string of the form 'host:port'. The constructor will use this value to initialize the host and port members. Since it uses the INet4Address::from_string constructor, this call may block while waiting for the resolver. - \throws SyntaxException if the 'host:port' syntax is - not obeyed. - \throws INet4Address::SyntaxException if the host part - cannot be converted to an IP address. */ + \throws AddressSyntaxException if the address syntax is + invalid + \throws UnknownHostnameException if the + address cannot be resolved. */ INet4SocketAddress(INet4Address const & addr, unsigned port); ///< Set address and port explicitly /**< \param[in] addr IP address \param[in] port port number */ - bool operator==(INet4SocketAddress const & other) const; - ///< Check INet4SocketAddress for equality + explicit INet4SocketAddress(unsigned port); + ///< Set port, address is set to 0.0.0.0 + /**< \param[in] port port number */ - INet4Address address() const; ///< Return address - unsigned port() const; ///< Return port number + INet4SocketAddress(const INet4SocketAddress& other); + INet4SocketAddress& operator=(const INet4SocketAddress& other); - bool boolean_test() const; ///< \c true, if address is empty (i.e. 0.0.0.0:0) + ///@} + /////////////////////////////////////////////////////////////////////////// - void clear(); ///< Clear address/port to 0.0.0.0:0 + INet4Address address() const; ///< Return address + unsigned port() const; ///< Return port number void address(INet4Address const & addr); ///< Set address void port(unsigned p); ///< Set port number - /// \name Generic Address Interface - /// @{ - - struct sockaddr * sockaddr_p(); - struct sockaddr const * sockaddr_p() const; - unsigned sockaddr_len() const; - - /// @} - - struct SyntaxException : public std::exception - { virtual char const * what() const throw() - { return "Invalid IpV4 socket address syntax"; } }; + using BSDSocketAddress::sockaddr_p; + using BSDSocketAddress::socklen_p; private: struct ::sockaddr_in addr_; @@ -111,6 +109,7 @@ namespace senf { \related INet4SocketAddress */ std::ostream & operator<<(std::ostream & os, INet4SocketAddress const & addr); + std::istream & operator>>(std::istream & is, INet4SocketAddress & addr); /** \brief IPv6 socket address @@ -144,60 +143,61 @@ namespace senf { \ingroup addr_group */ class INet6SocketAddress + : public BSDSocketAddress { public: - /////////////////////////////////////////////////////////////////////////// - // Types + static short const addressFamily = AF_INET6; /////////////////////////////////////////////////////////////////////////// ///\name Structors and default members ///@{ INet6SocketAddress(); ///< Create empty instance - explicit INet6SocketAddress(std::string const & addr); + explicit INet6SocketAddress(std::string const & addr, + INet6Address::Resolve_t resolve = INet6Address::ResolveINet6); ///< Initialize/convert from string representation + /**< \throws AddressSyntaxException if the address syntax is + invalid + \throws UnknownHostnameException if the + address cannot be resolved. + \param[in] addr Address to parse + \param[in] resolve If this is + INet6Address::ResolveINet4, support IPv4 + addresses. See INet6Address. */ INet6SocketAddress(INet6Address const & addr, unsigned port); ///< Initialize from address and port INet6SocketAddress(INet6Address const & addr, unsigned port, std::string const & iface); ///< Initialize explicitly from given parameters - INet6SocketAddress(std::string const & addr, std::string const & iface); - ///< Initialize from URL representation and explit interface + /**< \throws AddressSyntaxException if the + given iface cannot be resolved. */ + explicit INet6SocketAddress(unsigned port); + ///< Initialize from port and set to 'unspecified' addr + /**< The address is set to [::] + \param[in] port port number */ + + INet6SocketAddress(const INet6SocketAddress& other); + INet6SocketAddress& operator=(const INet6SocketAddress& other); ///@} /////////////////////////////////////////////////////////////////////////// - bool operator==(INet6SocketAddress const & other) const; ///< Check addresses for equality - bool operator!=(INet6SocketAddress const & other) const; ///< Inverse of above - - void clear(); ///< Clear socket address - INet6Address address() const; ///< Get printable address representation - void address(INet6Address const & addr); ///< Change address unsigned port() const; ///< Get port number - void port(unsigned poirt); ///< Change port number + void port(unsigned port); ///< Change port number std::string iface() const; ///< Get interface name void iface(std::string const & iface); ///< Change interface + /**< \throws AddressSyntaxException if the + given iface cannot be resolved. */ - ///\name Generic SocketAddress interface - ///@{ - - struct sockaddr * sockaddr_p(); - struct sockaddr const * sockaddr_p() const; - unsigned sockaddr_len() const; - - ///@} - - struct SyntaxException : public std::exception - { virtual char const * what() const throw() - { return "Invalid IpV6 socket address syntax"; } }; + using BSDSocketAddress::sockaddr_p; + using BSDSocketAddress::socklen_p; protected: private: - void assignAddr(std::string const & addr); void assignIface(std::string const & iface); struct sockaddr_in6 sockaddr_; @@ -207,6 +207,7 @@ namespace senf { \related INet6SocketAddress */ std::ostream & operator<<(std::ostream & os, INet6SocketAddress const & addr); + std::istream & operator>>(std::istream & is, INet6SocketAddress & addr); /// \addtogroup policy_impl_group /// @{ @@ -214,25 +215,25 @@ namespace senf { /** \brief Addressing policy supporting IPv4 addressing \par Address Type: - INet4Address + INet4SocketAddress This addressing policy implements addressing using Internet V4 addresses. The various members are directly imported from - GenericAddressingPolicy which see for a detailed + BSDAddressingPolicyMixin which see for a detailed documentation. */ struct INet4AddressingPolicy - : public AddressingPolicyBase, - private GenericAddressingPolicy + : public BSDAddressingPolicy, + private BSDAddressingPolicyMixin { typedef INet4SocketAddress Address; - using GenericAddressingPolicy::peer; - using GenericAddressingPolicy::local; - using GenericAddressingPolicy::connect; - using GenericAddressingPolicy::bind; + using BSDAddressingPolicyMixin::peer; + using BSDAddressingPolicyMixin::local; + using BSDAddressingPolicyMixin::connect; + using BSDAddressingPolicyMixin::bind; }; /** \brief Addressing policy supporting IPv6 addressing @@ -244,19 +245,19 @@ namespace senf { addresses. The various members are directly imported from - GenericAddressingPolicy which see for a detailed + BSDAddressingPolicyMixin which see for a detailed documentation. */ struct INet6AddressingPolicy - : public AddressingPolicyBase, - private GenericAddressingPolicy + : public BSDAddressingPolicy, + private BSDAddressingPolicyMixin { typedef INet6SocketAddress Address; - using GenericAddressingPolicy::peer; - using GenericAddressingPolicy::local; - using GenericAddressingPolicy::connect; - using GenericAddressingPolicy::bind; + using BSDAddressingPolicyMixin::peer; + using BSDAddressingPolicyMixin::local; + using BSDAddressingPolicyMixin::connect; + using BSDAddressingPolicyMixin::bind; }; /// @}