tau_get_func_vals(3) [debian man page]

TAU_GET_FUNC_VALS(3)					      TAU Instrumentation API					      TAU_GET_FUNC_VALS(3)

NAME

       TAU_GET_FUNC_VALS - Gets detailed performance data for given functions

SYNOPSIS

       C/C++:

       TAU_GET_FUNC_VALS(const char **inFuncs, int numOfFuncs, double ***counterExclusiveValues, double ***counterInclusiveValues,
			 int **numOfCalls, int **numOfSubRoutines, const char ***counterNames, int *numOfCounters, int tid);

DESCRIPTION

       It gets detailed performance data for the list of routines. The user specifies inFuncs and the number of routines; TAU then returns the
       other arguments with the performance data. counterExclusiveValues and counterInclusiveValues are two dimensional arrays: the first
       dimension is the routine id and the second is counter id. The value is indexed by these two dimensions. numCalls and numSubrs (or child
       routines) are one dimensional arrays.

EXAMPLE

       C/C++ :

       const char **inFuncs;
       /* The first dimension is functions, and the
       second dimension is counters */
       double **counterExclusiveValues;
       double **counterInclusiveValues;
       int *numOfCalls;
       int *numOfSubRoutines;
       const char **counterNames;
       int numOfCouns;

       TAU_GET_FUNC_NAMES(functionList, numOfFunctions);

       /* We are only interested in the first two routines
       that are executing in this context. So, we allocate
       space for two routine names and get the performance
       data for these two routines at runtime. */
       if (numOfFunctions >=2 ) {
	 inFuncs = (const char **) malloc(sizeof(const char *) * 2);

	 inFuncs[0] = functionList[0];
	 inFuncs[1] = functionList[1];

	 //Just to show consistency.
	 TAU_DB_DUMP();

	 TAU_GET_FUNC_VALS(inFuncs, 2,
	 counterExclusiveValues,
	 counterInclusiveValues,
	 numOfCalls,
	 numOfSubRoutines,
	 counterNames,
	 numOfCouns);

	 TAU_DUMP_FUNC_VALS_INCR(inFuncs, 2);

	 cout << "@@@@@@@@@@@@@@@" << endl;
	 cout << "The number of counters is: " << numOfCouns << endl;
	 cout << "The first counter is: " << counterNames[0] << endl;

	 cout << "The Exclusive value of: " << inFuncs[0]
	 << " is: " << counterExclusiveValues[0][0] << endl;
	 cout << "The numOfSubRoutines of: " << inFuncs[0]
	 << " is: " << numOfSubRoutines[0]
	 << endl;

	 cout << "The Inclusive value of: " << inFuncs[1]
	 << " is: " << counterInclusiveValues[1][0]
	 << endl;
	 cout << "The numOfCalls of: " << inFuncs[1]
	 << " is: " << numOfCalls[1]
	 << endl;

	 cout << "@@@@@@@@@@@@@@@" << endl;
       }

       TAU_DB_DUMP_INCR();

SEE ALSO

       TAU_GET_COUNTER_NAMES(3), TAU_GET_FUNC_NAMES(3), TAU_DUMP_FUNC_NAMES(3), TAU_DUMP_FUNC_VALS(3)

								    08/31/2005						      TAU_GET_FUNC_VALS(3)

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)