-rw-r--r-- 1850 djbsort-20260127/doc/man/djbsort-speed.1 raw
.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "djbsort-speed" "1" "" "" ""
.hy
.SS NAME
.PP
djbsort-speed - run some djbsort speed tests
.SS SYNOPSIS
.IP
.nf
\f[C]
djbsort-speed
\f[R]
.fi
.SS DESCRIPTION
.PP
\f[V]djbsort-speed\f[R] runs some tests of the speed of the djbsort
library.
.PP
The \f[V]djbsort-speed\f[R] output format is subject to change.
Examples of output lines with the current format, from a
\f[V]djbsort-speed\f[R] run on an AMD Zen 3 CPU core, include the
following:
.IP
.nf
\f[C]
sort_int32 selected implementation avx2 compiler gcc -Wall -fPIC -fwrapv -O2 -mmmx -msse -msse2 -msse3 -mssse3 -msse4.1 -msse4.2 -mavx -mbmi -mbmi2 -mpopcnt -mavx2 -mtune=haswell; gcc (Debian 12.2.0-14+deb12u1) 12.2.0; Copyright (C) 2022 Free Software Foundation, Inc.; This is free software; see the source for copying conditions.  There is NO; warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
sort_int32 selected 1597 8769 +1335+200-12+36-20-70+20-61-25+57-55+26+4-22+10+0+26-1-70-41+53-59-25+57-55+26+4-22+10+0+26-1
\f[R]
.fi
.PP
These lines say that the automatically selected implementation for
\f[V]djbsort_int32\f[R] was the \f[V]avx2\f[R] implementation compiled
with the \f[V]clang\f[R] options shown, taking an interquartile mean
(IQM) of 8769 CPU cycles to sort an \f[V]int32[1597]\f[R] array.
The numbers \f[V]8769 +1335+200+...\f[R] show the timings for a series
of consecutive operations: the IQM was 8769 cycles, the first run took
1335 cycles more than the IQM, the second run took 200 cycles more than
the IQM, etc.
.SS SEE ALSO
.PP
\f[B]djbsort\f[R](3)