os/ossrv/genericopenlibs/liboil/src/liboilprofile.h
author sl@SLION-WIN7.fritz.box
Fri, 15 Jun 2012 03:10:57 +0200
changeset 0 bde4ae8d615e
permissions -rw-r--r--
First public contribution.
sl@0
     1
/*
sl@0
     2
 * LIBOIL - Library of Optimized Inner Loops
sl@0
     3
 * Copyright (c) 2003,2004 David A. Schleef <ds@schleef.org>
sl@0
     4
 * All rights reserved.
sl@0
     5
 *
sl@0
     6
 * Redistribution and use in source and binary forms, with or without
sl@0
     7
 * modification, are permitted provided that the following conditions
sl@0
     8
 * are met:
sl@0
     9
 * 1. Redistributions of source code must retain the above copyright
sl@0
    10
 *    notice, this list of conditions and the following disclaimer.
sl@0
    11
 * 2. Redistributions in binary form must reproduce the above copyright
sl@0
    12
 *    notice, this list of conditions and the following disclaimer in the
sl@0
    13
 *    documentation and/or other materials provided with the distribution.
sl@0
    14
 * 
sl@0
    15
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
sl@0
    16
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
sl@0
    17
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
sl@0
    18
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
sl@0
    19
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
sl@0
    20
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
sl@0
    21
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
sl@0
    22
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
sl@0
    23
 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
sl@0
    24
 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
sl@0
    25
 * POSSIBILITY OF SUCH DAMAGE.
sl@0
    26
 */
sl@0
    27
sl@0
    28
#ifndef _LIBOIL_PROFILE_H_
sl@0
    29
#define _LIBOIL_PROFILE_H_
sl@0
    30
sl@0
    31
#include <liboil/liboilutils.h>
sl@0
    32
sl@0
    33
OIL_BEGIN_DECLS
sl@0
    34
sl@0
    35
#ifdef OIL_ENABLE_UNSTABLE_API
sl@0
    36
sl@0
    37
/**
sl@0
    38
 * OIL_PROFILE_HIST_LENGTH
sl@0
    39
 *
sl@0
    40
 * Internal definition of the number of histogram entries in #OilProfile.
sl@0
    41
 */
sl@0
    42
#define OIL_PROFILE_HIST_LENGTH 10
sl@0
    43
sl@0
    44
typedef struct _OilProfile OilProfile;
sl@0
    45
/**
sl@0
    46
 * OilProfile:
sl@0
    47
 *
sl@0
    48
 * An opaque structure representing profiling information.
sl@0
    49
 */
sl@0
    50
struct _OilProfile {
sl@0
    51
  /*< private >*/
sl@0
    52
  unsigned long start;
sl@0
    53
  unsigned long stop;
sl@0
    54
  unsigned long min;
sl@0
    55
  unsigned long last;
sl@0
    56
  unsigned long total;
sl@0
    57
  int n;
sl@0
    58
sl@0
    59
  int hist_n;
sl@0
    60
  unsigned long hist_time[OIL_PROFILE_HIST_LENGTH];
sl@0
    61
  int hist_count[OIL_PROFILE_HIST_LENGTH];
sl@0
    62
};
sl@0
    63
sl@0
    64
IMPORT_C unsigned long oil_profile_stamp(void);
sl@0
    65
IMPORT_C void oil_profile_init(OilProfile *prof);
sl@0
    66
IMPORT_C void oil_profile_stop_handle(OilProfile *prof);
sl@0
    67
IMPORT_C void oil_profile_get_ave_std (OilProfile *prof, double *ave_p, double *std_p);
sl@0
    68
sl@0
    69
/**
sl@0
    70
 * oil_profile_start:
sl@0
    71
 * @x: a pointer to an OilProfile structure
sl@0
    72
 *
sl@0
    73
 * Starts a profiling run by obtaining a timestamp via oil_profile_stamp()
sl@0
    74
 * and writing it into @x.
sl@0
    75
 */
sl@0
    76
#define oil_profile_start(x) do{ \
sl@0
    77
	(x)->start = oil_profile_stamp(); \
sl@0
    78
}while(0)
sl@0
    79
/**
sl@0
    80
 * oil_profile_stop:
sl@0
    81
 * @x: a pointer to an OilProfile structure
sl@0
    82
 *
sl@0
    83
 * Stops a profiling run by obtaining a timestamp via oil_profile_stamp()
sl@0
    84
 * and writing it into @x.  It then calls oil_profile_stop_handle() to
sl@0
    85
 * handle post-processing of the profiling run.
sl@0
    86
 */
sl@0
    87
#define oil_profile_stop(x) do{ \
sl@0
    88
	(x)->stop = oil_profile_stamp(); \
sl@0
    89
        oil_profile_stop_handle(x); \
sl@0
    90
}while(0)
sl@0
    91
sl@0
    92
#endif
sl@0
    93
sl@0
    94
OIL_END_DECLS
sl@0
    95
sl@0
    96
sl@0
    97
#endif
sl@0
    98