profile.h

Go to the documentation of this file.

#ifndef _IPXE_PROFILE_H
#define _IPXE_PROFILE_H
 
/** @file
 *
 * Profiling
 *
 */
 
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
FILE_SECBOOT ( PERMITTED );
 
#include <bits/profile.h>
#include <ipxe/tables.h>
 
#ifndef PROFILING
#ifdef NDEBUG
#define PROFILING 0
#else
#define PROFILING 1
#endif
#endif
 
/**
 * A data structure for storing profiling information
 */
struct profiler {
        /** Name */
        const char *name;
        /** Start timestamp */
        unsigned long started;
        /** Stop timestamp */
        unsigned long stopped;
        /** Number of samples */
        unsigned int count;
        /** Mean sample value (scaled) */
        unsigned long mean;
        /** Mean sample value MSB
         *
         * This is the highest bit set in the raw (unscaled) value
         * (i.e. one less than would be returned by flsl(raw_mean)).
         */
        unsigned int mean_msb;
        /** Accumulated variance (scaled) */
        unsigned long long accvar;
        /** Accumulated variance MSB
         *
         * This is the highest bit set in the raw (unscaled) value
         * (i.e. one less than would be returned by flsll(raw_accvar)).
         */
        unsigned int accvar_msb;
};
 
/** Profiler table */
#define PROFILERS __table ( struct profiler, "profilers" )
 
/** Declare a profiler */
#if PROFILING
#define __profiler __table_entry ( PROFILERS, 01 )
#else
#define __profiler
#endif
 
unsigned long profile_timestamp ( void );
 
extern unsigned long profile_excluded;
 
extern void profile_update ( struct profiler *profiler, unsigned long sample );
extern unsigned long profile_mean ( struct profiler *profiler );
extern unsigned long profile_variance ( struct profiler *profiler );
extern unsigned long profile_stddev ( struct profiler *profiler );
 
/**
 * Get start time
 *
 * @v profiler          Profiler
 * @ret started         Start time
 */
static inline __attribute__ (( always_inline )) unsigned long
profile_started ( struct profiler *profiler ) {
 
        /* If profiling is active then return start time */
        if ( PROFILING ) {
                return ( profiler->started + profile_excluded );
        } else {
                return 0;
        }
}
 
/**
 * Get stop time
 *
 * @v profiler          Profiler
 * @ret stopped         Stop time
 */
static inline __attribute__ (( always_inline )) unsigned long
profile_stopped ( struct profiler *profiler ) {
 
        /* If profiling is active then return start time */
        if ( PROFILING ) {
                return ( profiler->stopped + profile_excluded );
        } else {
                return 0;
        }
}
 
/**
 * Get elapsed time
 *
 * @v profiler          Profiler
 * @ret elapsed         Elapsed time
 */
static inline __attribute__ (( always_inline )) unsigned long
profile_elapsed ( struct profiler *profiler ) {
 
        /* If profiling is active then return elapsed time */
        if ( PROFILING ) {
                return ( profile_stopped ( profiler ) -
                         profile_started ( profiler ) );
        } else {
                return 0;
        }
}
 
/**
 * Start profiling
 *
 * @v profiler          Profiler
 * @v started           Start timestamp
 */
static inline __attribute__ (( always_inline )) void
profile_start_at ( struct profiler *profiler, unsigned long started ) {
 
        /* If profiling is active then record start timestamp */
        if ( PROFILING )
                profiler->started = ( started - profile_excluded );
}
 
/**
 * Stop profiling
 *
 * @v profiler          Profiler
 * @v stopped           Stop timestamp
 */
static inline __attribute__ (( always_inline )) void
profile_stop_at ( struct profiler *profiler, unsigned long stopped ) {
 
        /* If profiling is active then record end timestamp and update stats */
        if ( PROFILING ) {
                profiler->stopped = ( stopped - profile_excluded );
                profile_update ( profiler, profile_elapsed ( profiler ) );
        }
}
 
/**
 * Start profiling
 *
 * @v profiler          Profiler
 */
static inline __attribute__ (( always_inline )) void
profile_start ( struct profiler *profiler ) {
 
        /* If profiling is active then record start timestamp */
        if ( PROFILING )
                profile_start_at ( profiler, profile_timestamp() );
}
 
/**
 * Stop profiling
 *
 * @v profiler          Profiler
 */
static inline __attribute__ (( always_inline )) void
profile_stop ( struct profiler *profiler ) {
 
        /* If profiling is active then record end timestamp and update stats */
        if ( PROFILING )
                profile_stop_at ( profiler, profile_timestamp() );
}
 
/**
 * Exclude time from other ongoing profiling results
 *
 * @v profiler          Profiler
 */
static inline __attribute__ (( always_inline )) void
profile_exclude ( struct profiler *profiler ) {
 
        /* If profiling is active then update accumulated excluded time */
        if ( PROFILING )
                profile_excluded += profile_elapsed ( profiler );
}
 
/**
 * Record profiling sample in custom units
 *
 * @v profiler          Profiler
 * @v sample            Profiling sample
 */
static inline __attribute__ (( always_inline )) void
profile_custom ( struct profiler *profiler, unsigned long sample ) {
 
        /* If profiling is active then update stats */
        if ( PROFILING )
                profile_update ( profiler, sample );
}
 
#endif /* _IPXE_PROFILE_H */