1PMPARSEINTERVAL(3)         Library Functions Manual         PMPARSEINTERVAL(3)
2
3
4

NAME

6       pmParseInterval - convert interval string to timeval structure
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10
11       int  pmParseInterval(const  char  *string,  struct  timeval *rslt, char
12       **errmsg)
13
14       cc ... -lpcp
15

DESCRIPTION

17       pmParseInterval parses the argument string specifying  an  interval  of
18       time  and fills in the tv_sec and tv_usec components of the rslt struc‐
19       ture to represent that interval.
20
21       The input string is most commonly the argument following a  -t  command
22       line  option to a PCP application, and the syntax is fully described in
23       PCPIntro(1).
24
25       pmParseInterval returns 0 and errmsg is undefined  if  the  parsing  is
26       successful.
27
28       If  the given string does not conform to the required syntax pmParseIn‐
29       terval returns -1 and a dynamically allocated error message  string  in
30       errmsg.   The  error  message is terminated with a newline and includes
31       the text of the input string along with an indicator of the position at
32       which the error was detected, e.g.
33                 4minutes 30mumble
34                            ^ -- unexpected value
35
36       In the case of an error, the caller is responsible for calling free(3C)
37       to release the space allocated for errmsg.
38

SEE ALSO

40       PMAPI(3) and pmParseTimeWindow(3).
41
42
43
44Performance Co-Pilot                  SGI                   PMPARSEINTERVAL(3)