pmc_configure_logfile man page on PC-BSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
PC-BSD logo
[printable version]

PMC_CONFIGURE_LOGFILE(3) BSD Library Functions Manual PMC_CONFIGURE_LOGFILE(3)

NAME
     pmc_configure_logfile, pmc_flush_logfile, pmc_writelog — log file manage‐
     ment

LIBRARY
     Performance Counters Library (libpmc, -lpmc)

SYNOPSIS
     #include <pmc.h>

     int
     pmc_configure_logfile(int fd);

     int
     pmc_flush_logfile(void);

     int
     pmc_writelog(uint32_t userdata);

DESCRIPTION
     The functions manage logging of hwpmc(4) events.

     Function pmc_configure_logfile() is used to turn on and turn off logging.
     If argument fd is a valid file handle returned by a prior call to open(2)
     or socket(2) then performance events will be logged to the file corre‐
     sponding to the specified handle.	If the value of argument fd is -1 then
     logging will be stopped after any pending data is flushed.

     Function pmc_flush_logfile() will force all log data queued inside the
     hwpmc(4) driver to be written out.

     Function pmc_writelog() will append a log entry containing the value of
     argument userdata to the log file.

RETURN VALUES
     Upon successful completion, the value 0 is returned; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.

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

     [EAGAIN]		The hwpmc(4) driver was not able to create a helper
			process due to system limits being reached.

     [EBUSY]		Function pmc_configure_logfile() was called with a log
			file already configured.

     [EINVAL]		Function pmc_configure_logfile() was called with an
			argument of -1 without a log file being previously
			configured.

     [ENOMEM]		The system encountered a memory shortage when servic‐
			ing this request.

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

     [EINVAL]		Function pmc_flush_logfile() was called without a log
			file being previously configured.

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

     [EINVAL]		Function pmc_writelog() was called without a log file
			being previously configured.

     [ENOMEM]		The system encountered a memory shortage when servic‐
			ing this request.

SEE ALSO
     pmc(3), hwpmc(4)

BSD			       November 24, 2007			   BSD
[top]

List of man pages available for PC-BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net