debian man page for hostname

FBB::Hostname(3bobcat)						     Host Info						    FBB::Hostname(3bobcat)

NAME
       FBB::Hostname - Contains name/address info about a host

SYNOPSIS
       #include <bobcat/hostname>
       Linking option: -lbobcat

DESCRIPTION
       FBB::Hostname  objects  inherit from Hostent, and offers information about a host, like Hostent. Apart from being initialized by a hostname
       or host address, they can also be initialized by a FBB::InetAddress object. Most of the functionality of an FBB::Hostname object is  avail-
       able through its parent-class FBB::Hostent.

NAMESPACE
       FBB
       All constructors, members, operators and manipulators, mentioned in this man-page, are defined in the namespace FBB.

INHERITS FROM
       FBB::Hostent

CONSTRUCTORS
       o      Hostname():
	      The default constructor initializes an empty FBB::Hostname object.

       o      Hostname((std::string const &host)):
	      This  constructor  initializes  an  FBB::Hostname object from a string representing the name or dotted decimal address of a host. An
	      FBB::Errno object is thrown if the hostname information could not be retrieved.

       o      Hostname(InetAddress const &inetAddress):
	      This constructor initializes an FBB::Hostname object from an InetAddress object. An FBB::Errno object  is  thrown  if  the  hostname
	      information could not be retrieved.  The copy constructor is available.

MEMBER FUNCTIONS
       All members of FBB::Hostent are available, as FBB::Hostname inherits from this class. There are no additional members.

EXAMPLE
       #include <iostream>

       #include <bobcat/hostname>
       #include <bobcat/errno>

       using namespace std;
       using namespace FBB;

       int main(int argc, char **argv)
       {
	   while (true)
	   {
	       cout << "Enter name or address:
";

	       string str;

	       if (!getline(cin, str))
		   return 0;

	       if (str == "")
		   break;

	       try
	       {
		   Hostname h(str);

		   cout << "Official name:
";
		       cout << h.hostname() << endl;

		   cout << "Aliases:
";
		   for (size_t idx = 0; idx < h.nAliases(); idx++)
		       cout << h.alias(idx) << " ";
		   cout << endl;

		   cout << "Adresses:
";
		   for (size_t idx = 0; idx < h.nAddresses(); idx++)
		       cout << h.dottedDecimalAddress(idx) << " ";
		   cout << endl;
	       }
	       catch (Errno const &err)
	       {
		   cout << err.why() << endl;
	       }
	   }
	   return 0;
       }

FILES
       bobcat/hostname - defines the class interface

SEE ALSO
       bobcat(7), hostent(3bobcat)

BUGS
       None Reported.

DISTRIBUTION FILES
       o      bobcat_3.01.00-x.dsc: detached signature;

       o      bobcat_3.01.00-x.tar.gz: source archive;

       o      bobcat_3.01.00-x_i386.changes: change log;

       o      libbobcat1_3.01.00-x_*.deb: debian package holding the libraries;

       o      libbobcat1-dev_3.01.00-x_*.deb: debian package holding the libraries, headers and manual pages;

       o      http://sourceforge.net/projects/bobcat: public archive location;

BOBCAT
       Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.

COPYRIGHT
       This is free software, distributed under the terms of the GNU General Public License (GPL).

AUTHOR
       Frank B. Brokken (f.b.brokken@rug.nl).

libbobcat1-dev_3.01.00-x.tar.gz 				     2005-2012						    FBB::Hostname(3bobcat)