-rw-r--r-- 1726 lib1305-20250415/doc/man/lib1305-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 "lib1305-speed" "1" "" "" ""
.hy
.SS NAME
.PP
lib1305-speed - run some lib1305 speed tests
.SS SYNOPSIS
.IP
.nf
\f[C]
lib1305-speed
\f[R]
.fi
.SS DESCRIPTION
.PP
\f[V]lib1305-speed\f[R] runs some tests of the speed of the lib1305
implementation of Poly1305.
.PP
The \f[V]lib1305-speed\f[R] output format is subject to change.
Examples of output lines with the current format, from a
\f[V]lib1305-speed\f[R] run on an Intel Skylake CPU core, include the
following:
.IP
.nf
\f[C]
onetimeauth_poly1305 selected implementation amd64-mxaa-g24 compiler clang -Wall -fPIC -fwrapv -Qunused-arguments -O2 -mbmi -mbmi2 -mtune=skylake; Ubuntu clang version 14.0.0-1ubuntu1.1; Target: x86_64-pc-linux-gnu; Thread model: posix; InstalledDir: /usr/bin
onetimeauth_poly1305_verify selected 8090 6563 +453+92+44+41-4-27+8-32-12+3-5-15+37-28+26+19-18-48-15+28+3+13+66-42+41-25-10+2-9-36+18-64
\f[R]
.fi
.PP
These lines say that the automatically selected implementation for
\f[V]onetimeauth_poly1305_verify\f[R] was the \f[V]amd64-mxaa-g24\f[R]
implementation compiled with the \f[V]clang\f[R] options shown, taking
an interquartile mean (IQM) of 6563 CPU cycles for 8090-byte inputs.
The numbers \f[V]6563 +453+92...\f[R] show the timings for a series of
consecutive operations: the IQM was 6563 cycles, the first run took 453
cycles more than the IQM, the second run took 92 cycles more than the
IQM, etc.
.SS SEE ALSO
.PP
\f[B]lib1305\f[R](3)