X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=senf%2FSocket%2FProtocols%2FINet%2FINet4Address.hh;h=be54958ff4be61e8d6efa2bb80a29dd6cd95dfca;hb=51b24c3227717ce5ad8111a99c2d7eea5fa0bd8d;hp=b214fc325cc89d91e2ea41974564c8c6bc82ce24;hpb=afae50abf125df375ff1610b7a659f9b1da61bc0;p=senf.git diff --git a/senf/Socket/Protocols/INet/INet4Address.hh b/senf/Socket/Protocols/INet/INet4Address.hh index b214fc3..be54958 100644 --- a/senf/Socket/Protocols/INet/INet4Address.hh +++ b/senf/Socket/Protocols/INet/INet4Address.hh @@ -2,23 +2,28 @@ // // Copyright (C) 2007 // 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 -// the Free Software Foundation; either version 2 of the License, or -// (at your option) any later version. +// The contents of this file are subject to the Fraunhofer FOKUS Public License +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// http://senf.berlios.de/license.html // -// This program is distributed in the hope that it will be useful, -// but WITHOUT ANY WARRANTY; without even the implied warranty of -// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -// GNU General Public License for more details. +// The Fraunhofer FOKUS Public License Version 1.0 is based on, +// but modifies the Mozilla Public License Version 1.1. +// See the full license text for the amendments. // -// You should have received a copy of the GNU General Public License -// along with this program; if not, write to the -// Free Software Foundation, Inc., -// 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +// Software distributed under the License is distributed on an "AS IS" basis, +// WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License +// for the specific language governing rights and limitations under the License. +// +// The Original Code is Fraunhofer FOKUS code. +// +// The Initial Developer of the Original Code is Fraunhofer-Gesellschaft e.V. +// (registered association), Hansastraße 27 c, 80686 Munich, Germany. +// All Rights Reserved. +// +// Contributor(s): +// Stefan Bund /** \file \brief INet4Address public header */ @@ -36,7 +41,7 @@ #include //#include "INet4Address.mpp" -///////////////////////////////hh.p//////////////////////////////////////// +//-///////////////////////////////////////////////////////////////////////////////////////////////// namespace senf { @@ -90,7 +95,7 @@ namespace senf { public comparable_safe_bool { public: - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// // Types typedef uint32_t address_type; ///< Address representation as number in host byte order @@ -100,9 +105,9 @@ namespace senf { static INet4Address const Loopback; ///< The loopback (127.0.0.1) address static INet4Address const Broadcast; ////< The global broadcast (255.255.255.255) address - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// ///\name Structors and default members - ///@{ + //\{ INet4Address(); ///< Construct an empty address explicit INet4Address(senf::NoInit_t); ///< Construct uninitialized (!) address @@ -119,6 +124,8 @@ namespace senf { protocol like DNS or NIS \throws AddressSyntaxException if the address cannot be converted for some reason + \throws UnknownHostnameException if the hostname cannot + be resolved \param[in] s Address literal or hostname */ template @@ -133,10 +140,10 @@ namespace senf { code to convert a network byte order address in an integer number into an INet4Address. */ - ///@} - /////////////////////////////////////////////////////////////////////////// + //\} + //-//////////////////////////////////////////////////////////////////////// ///\name Accessors - ///@{ + //\{ bool local() const; ///< \c true, if address is locally administered /**< This call checks, if the address is within one of the @@ -158,7 +165,7 @@ namespace senf { /**< This member returns the address as an integer number in host byte order. This representation allows simple network math operations. */ - ////@} + //-///////////////////////////////////////////////////////////////////////////////////////// private: enum InAddr_t { IsInAddr }; @@ -179,7 +186,7 @@ namespace senf { */ std::istream & operator>>(std::istream & os, INet4Address & addr); - /** \brief CHeck INet4Address against a fixed network prefix + /** \brief Check INet4Address against a fixed network prefix This helper allows to easily and efficiently check an INet4Address against an arbitrary but constant network prefix. The network prefix is represented by @@ -218,17 +225,17 @@ namespace senf { public comparable_safe_bool { public: - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// ///\name Structors and default members - ///@{ + //\{ INet4Network(); ///< Construct empty (0.0.0.0/0) network INet4Network(INet4Address const & address, unsigned prefix_len); ///< Construct network from given address and prefix length explicit INet4Network(std::string const & s); ///< Construct network from CIDR notation - ///@} - /////////////////////////////////////////////////////////////////////////// + //\} + //-//////////////////////////////////////////////////////////////////////// INet4Address const & address() const; ///< Get the networks address unsigned prefix_len() const; ///< Get the networks prefix length @@ -286,7 +293,7 @@ namespace senf { } -///////////////////////////////hh.e//////////////////////////////////////// +//-///////////////////////////////////////////////////////////////////////////////////////////////// #include "INet4Address.cci" #include "INet4Address.ct" #include "INet4Address.cti"