GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PMC_FLUSH_LOGFILE (3)

NAME

pmc_configure_logfile, pmc_flush_logfile, pmc_writelog, pmc_close_logfile - log file management

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also

LIBRARY


.Lb libpmc

SYNOPSIS


.In pmc.h int pmc_configure_logfile int fd int pmc_flush_logfile void int pmc_writelog uint32_t userdata int pmc_close_logfile void

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 corresponding 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.

Function pmc_close_logfile will flush all pending log data and close hwpmc 4 Ap s side of the stream.

RETURN VALUES


.Rv -std

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 servicing 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 servicing this request.

SEE ALSO

pmc(3), hwpmc(4)
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.