Provided by: lmbench-doc_3.0-a9-1_all bug

NAME

       insertinit,    insertsort,   get_results,   set_results,   save_median,
       save_minimum      - the lmbench results subsystem

SYNOPSIS

       #include ‘‘lmbench.h’’

       #define TRIES 11

       typedef struct { uint64 u, n } value_t;

       typedef struct { int N; value_t v[TRIES]; } result_t;

       int       sizeof_result(int N)

       void insertinit(result_t *r)

       void insertsort(uint64 u, uint64 n, result_t *r)

       result_t* get_results()

       void set_results(result_t *r)

       void save_median()

       void save_minimum()

DESCRIPTION

       These routines provide some simple data management  functionality.   In
       most cases, you will not need these routines.

       The  current  timing  results  can  be  accessed  using the routines in
       timing(3).   The  current  timing  results  may   be   modified   using
       save_median and save_minimum.

       int       sizeof_result(int N)
              returns  the  number  of  bytes to allocate for a result_t which
              contains N results.

       void insertinit(result_t *r)
              initializes the results array.

       void insertsort(uint64 u, uint64 n, result_t *r)
              insert u and n into r.  Results are sorted in  decreasing  order
              by u/n.

       void get_results(result_t *r)
              get a copy of the current results.

       void set_results(result_t *r)
              save a copy r as the current results.

       void save_median()
              sets the timing results to the median of the current results.

       void save_minimum()
              sets the timing restuls to the minimum of the current results.

       Results  are  sorted  in  ascending  order,  so the minimum value is at
       TRIES-1 and the maximum value is at 0.

FUTURES

       Development of lmbench is continuing.

SEE ALSO

       lmbench(8), lmbench(3), reporting(3), results(3)

AUTHOR

       Carl Staelin and Larry McVoy

       Comments, suggestions, and bug reports are always welcome.

(c)1998 Larry McVoy                 $Date:$       lmbench result management(3)