posix_trace_start(3p) - phpMan

POSIX_TRACE_START(P)                                      POSIX_TRACE_START(P)



NAME
       posix_trace_start, posix_trace_stop - trace start and stop (TRACING)

SYNOPSIS
       #include <trace.h>

       int posix_trace_start(trace_id_t trid);
       int posix_trace_stop (trace_id_t trid);


DESCRIPTION
       The posix_trace_start() and posix_trace_stop() functions, respectively, shall start
       and stop the trace stream identified by the argument trid.

       The effect of calling the posix_trace_start() function shall  be  recorded  in  the
       trace  stream  as  the  POSIX_TRACE_START  system trace event and the status of the
       trace stream shall become POSIX_TRACE_RUNNING. If the trace stream is  in  progress
       when this function is called, the POSIX_TRACE_START system trace event shall not be
       recorded and the trace stream shall continue to run.  If the trace stream is  full,
       the  POSIX_TRACE_START  system  trace event shall not be recorded and the status of
       the trace stream shall not be changed.

       The effect of calling the posix_trace_stop() function  shall  be  recorded  in  the
       trace stream as the POSIX_TRACE_STOP system trace event and the status of the trace
       stream shall become POSIX_TRACE_SUSPENDED. If the trace stream  is  suspended  when
       this  function  is  called,  the  POSIX_TRACE_STOP  system trace event shall not be
       recorded and the trace stream shall remain suspended.  If the trace stream is full,
       the POSIX_TRACE_STOP system trace event shall not be recorded and the status of the
       trace stream shall not be changed.

RETURN VALUE
       Upon successful completion, these functions shall return a value  of  zero.  Other-
       wise, they shall return the corresponding error number.

ERRORS
       These functions shall fail if:

       EINVAL The value of the argument trid does not correspond to an active trace stream
              and thus no trace stream was started or stopped.

       EINTR  The operation was interrupted by a signal and thus the trace stream was  not
              necessarily started or stopped.


       The following sections are informative.

EXAMPLES
       None.

APPLICATION USAGE
       None.

RATIONALE
       None.

FUTURE DIRECTIONS
       None.

SEE ALSO
       posix_trace_create()   ,  the  Base  Definitions  volume  of  IEEE Std 1003.1-2001,
       <trace.h>

COPYRIGHT
       Portions of this text are reprinted and reproduced in electronic form from IEEE Std
       1003.1,  2003  Edition,  Standard  for Information Technology -- Portable Operating
       System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C)
       2001-2003  by  the  Institute  of Electrical and Electronics Engineers, Inc and The
       Open Group. In the event of any discrepancy between this version and  the  original
       IEEE  and The Open Group Standard, the original IEEE and The Open Group Standard is
       the  referee  document.  The  original  Standard  can   be   obtained   online   at
       http://www.opengroup.org/unix/online.html .



POSIX                                2003                 POSIX_TRACE_START(P)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-10 09:55 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)