CLTRACE(1)            Standard Compute Layer (CL) Manual            CLTRACE(1)



NAME
       cltrace - trace computer layer (CL) calls

SYNOPSIS
       cltrace [-ctT]  [-0] [-1] [-2]
               [--cal|--no-cal] [--opencl|--no-opencl] [--stdcl|--no-stdcl]
               command [arg...]

DESCRIPTION
       cltrace  can  be used to trace compute layer (CL) calls including stdcl
       calls, OpenCL calls, and low-level implementation calls such as the ATI
       CAL layer.  Tracing of the following libraries are currently supported:

       API       level library

       ATI/CAL   0     libaticalrt.so,libaticalcl.so

       OpenCL    1     libopenCl.so

       libstdcl  2     libstdcl.so


OPTIONS
       -c    Count time, number of calls, and errors for  each  call  that  is
             traced  and  report  a  summary  upon  program exit.  This option
             supresses the printing of the actual trace output for each  call.

       -t    Prefix each line of the trace output with a timestamp of the form
             sec:usec based on a call to the function gettimeofday().

       -T    Add to each line of the trace output the time spent in each  call
             measured in seconds.

       -0    Trace  level  0  CL calls that correspond to the OpenCL implemen-
             taion layers.

       -1    Trace level 1 CL calls that correspond  to  the  OpenCL  standard
             API.

       -2    Trace level 2 CL calls that corresond to interfaces to the OpenCL
             API.

       --cal, -0
             Trace ATI/CAL calls that correspond to the  OpenCL  implementaion
             layers.

       --opencl, -1
             Trace OpenCL calls that correspond to the OpenCL standard API.

       --stdcl, -2
             Trace libstdcl calls that corresond to an interface to the OpenCL
             API.

       --no-cal
             Do not trace ATI/CAL calls that correspond to the  OpenCL  imple-
             mentaion layers.

       --no-opencl
             Do  not trace OpenCL calls that correspond to the OpenCL standard
             API.

       --no-stdcl
             Do not trace libstdcl calls that corresond to an interface to the
             OpenCL API.


AUTHOR
       Written by David Richie.


REPORTING BUGS
       Report bugs to <support@browndeertechnology.com>


COPYRIGHT
       Copyright  (C) 2009 Brown Deer Technology, LLC.  Licensed under the GNU
       Lesser General Public License version 3 (LGPLv3).  There is NO WARRANTY
       to the extent permitted by law.


SEE ALSO
       stdcl(3), strace(1)








libstdcl-0.7                      2009-11-10                        CLTRACE(1)