PMPARSEINTERVAL(3) - man page online | library functions

Convert interval string to timeval structure.

PMPARSEINTERVAL(3)                   Library Functions Manual                  PMPARSEINTERVAL(3)


pmParseInterval - convert interval string to timeval structure


#include <pcp/pmapi.h> int pmParseInterval(const char *string, struct timeval *rslt, char **errmsg); cc ... -lpcp


pmParseInterval parses the argument string specifying an interval of time and fills in the tv_sec and tv_usec components of the rslt structure to represent that interval. The input string is most commonly the argument following a -t command line option to a PCP application, and the syntax is fully described in PCPIntro(1). pmParseInterval returns 0 and errmsg is undefined if the parsing is successful. If the given string does not conform to the required syntax pmParseInterval returns -1 and a dynamically allocated error message string in errmsg. The error message is terminated with a newline and includes the text of the input string along with an indicator of the position at which the error was detected, e.g. 4minutes 30mumble ^ -- unexpected value In the case of an error, the caller is responsible for calling free(3C) to release the space allocated for errmsg.


PMAPI(3) and pmParseTimeWindow(3).
Performance Co-Pilot PCP PMPARSEINTERVAL(3)
This manual Reference Other manuals
pmParseInterval(3) referred by pcp-free(1) | __pmConvertTime(3) | __pmParseCtime(3)
refer to malloc(3) | PCPIntro(1) | PMAPI(3) | pmParseTimeWindow(3)