@@@ much mess, mostly manpages
[mLib] / test / tvec-bench.3.in
CommitLineData
c4ccbbf9
MW
1.\" -*-nroff-*-
2.\"
3.\" Manual for bencharking with the test-vector framework
4.\"
5.\" (c) 2024 Straylight/Edgeware
6.\"
7.
8.\"----- Licensing notice ---------------------------------------------------
9.\"
10.\" This file is part of the mLib utilities library.
11.\"
12.\" mLib is free software: you can redistribute it and/or modify it under
13.\" the terms of the GNU Library General Public License as published by
14.\" the Free Software Foundation; either version 2 of the License, or (at
15.\" your option) any later version.
16.\"
17.\" mLib is distributed in the hope that it will be useful, but WITHOUT
18.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
19.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
20.\" License for more details.
21.\"
22.\" You should have received a copy of the GNU Library General Public
23.\" License along with mLib. If not, write to the Free Software
24.\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
25.\" USA.
26.
27.\"--------------------------------------------------------------------------
28.so ../defs.man \" @@@PRE@@@
29.
30.\"--------------------------------------------------------------------------
31.TH tvec-bench 3mLib "11 March 2024" "Straylight/Edgeware" "mLib utilities library"
32.\" @TVEC_BENCHENV
33.\" @TVEC_BENCHINIT
34.\" @tvec_benchreport
35.
36.\"--------------------------------------------------------------------------
37.SH NAME
38tvec-bench \- benchmarking with the test vector framework
39.
40.\"--------------------------------------------------------------------------
41.SH SYNOPSIS
42.
43.nf
44.B "#include <mLib/tvec.h>"
45.PP
46.ta 2n
47.B "struct tvec_benchenv {"
48.B " struct tvec_env _env;"
49.B " struct bench_state **bst;"
50.B " unsigned long niter;"
51.B " int riter, rbuf;"
52.B " const struct tvec_env *env;"
53.B "};"
54.B "struct bench_state *tvec_benchstate;"
55.B "#define TVEC_BENCHENV ..."
56.B "#define TVEC_BENCHINIT ..."
57.B "enum {"
58.B " TVBU_OP = ...,"
59.B " TVBU_BYTE = ...,"
60.B " ...,"
61.B " TVBU_LIMIT"
62.B "};"
63.PP
64.ta \w'\fBvoid tvec_benchreport('u
65.BI "void tvec_benchreport(const struct gprintf_ops *" gops ", void *" go ,
66.BI " unsigned " unit ", const struct bench_timing *" tm );
67.fi