Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PMC_EVENT_NAMES_OF_CL... BSD Library Functions Manual PMC_EVENT_NAMES_OF_CL...

NAME
     pmc_event_names_of_class -- return	a list of event	names supported	by a
     PMC class

LIBRARY
     Performance Counters Library (libpmc, -lpmc)

SYNOPSIS
     #include <pmc.h>

     int
     pmc_event_names_of_class(enum pmc_class cl, const char ***eventnames,
	 int *nevents);

DESCRIPTION
     Function pmc_event_names_of_class() retrieves the hardware	event names
     supported by the class of PMC hardware specified by argument cl.

     It	returns	an array of const char * pointers to names of events supported
     by	the specified class of PMC hardware.  The location pointed to by argu-
     ment nevents is set to the	number of event	names returned.

     The returned array	is allocated using malloc(3).

RETURN VALUES
     The pmc_event_names_of_class() function returns the value 0 if success-
     ful; otherwise the	value -1 is returned and the global variable errno is
     set to indicate the error.

ERRORS
     A call to pmc_event_names_of_class() may fail with	the following errors:

     [EINVAL]		Argument cl was	invalid.

     [ENOMEM]		Allocation of a	memory area to hold the	result failed.

SEE ALSO
     pmc(3), hwpmc(4)

BSD			       November	23, 2007			   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pmc_event_names_of_class&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help