| =pod |
| |
| =head1 NAME |
| |
| lh_stats, lh_node_stats, lh_node_usage_stats, lh_stats_bio, |
| lh_node_stats_bio, lh_node_usage_stats_bio - LHASH statistics |
| |
| =head1 SYNOPSIS |
| |
| #include <openssl/lhash.h> |
| |
| void lh_stats(LHASH *table, FILE *out); |
| void lh_node_stats(LHASH *table, FILE *out); |
| void lh_node_usage_stats(LHASH *table, FILE *out); |
| |
| void lh_stats_bio(LHASH *table, BIO *out); |
| void lh_node_stats_bio(LHASH *table, BIO *out); |
| void lh_node_usage_stats_bio(LHASH *table, BIO *out); |
| |
| =head1 DESCRIPTION |
| |
| The B<LHASH> structure records statistics about most aspects of |
| accessing the hash table. This is mostly a legacy of Eric Young |
| writing this library for the reasons of implementing what looked like |
| a nice algorithm rather than for a particular software product. |
| |
| lh_stats() prints out statistics on the size of the hash table, how |
| many entries are in it, and the number and result of calls to the |
| routines in this library. |
| |
| lh_node_stats() prints the number of entries for each 'bucket' in the |
| hash table. |
| |
| lh_node_usage_stats() prints out a short summary of the state of the |
| hash table. It prints the 'load' and the 'actual load'. The load is |
| the average number of data items per 'bucket' in the hash table. The |
| 'actual load' is the average number of items per 'bucket', but only |
| for buckets which contain entries. So the 'actual load' is the |
| average number of searches that will need to find an item in the hash |
| table, while the 'load' is the average number that will be done to |
| record a miss. |
| |
| lh_stats_bio(), lh_node_stats_bio() and lh_node_usage_stats_bio() |
| are the same as the above, except that the output goes to a B<BIO>. |
| |
| =head1 RETURN VALUES |
| |
| These functions do not return values. |
| |
| =head1 SEE ALSO |
| |
| L<bio(3)|bio(3)>, L<lhash(3)|lhash(3)> |
| |
| =head1 HISTORY |
| |
| These functions are available in all versions of SSLeay and OpenSSL. |
| |
| This manpage is derived from the SSLeay documentation. |
| |
| =cut |