/home/abui...G/cblat2.f(3)
π NAME π
So this page is from the Library Functions Manual, section 3, and the thing it's documenting is a whole file path, bestie:
/home/abuild/rpmbuild/BUILD/lapack-
static-3.12.0-build/lapack-3.12.0/BLAS/TESTING/cblat2.f
Yep. That's the entire NAME stanza. It's literally just the file's whole life story as a path β cblat2.f living its best life inside the BLAS TESTING directory of the lapack-static-3.12.0-build rpmbuild tree. No cap, that's the name. π«Ά
β¨ SYNOPSIS β¨
π Functions/Subroutines π
Okay so this is the part where I list every single function and subroutine this file has to offer β and I mean every one, no skipping, no "and friends", we're doing all of them π . Signatures are copied exactly, character for character, because we do not play with argument lists. πΈ
program CBLAT2β the program itself, main character energy fr fr πCBLAT2β yep, that's the name again, it's a whole program and it's calledCBLAT2
subroutine CCHK1β a subroutine, and here is its full arg list, exactly as written:(sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nkb, kb, nalf, alf, nbet, bet, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g)π¦subroutine CCHK2β another one, and look at that arg list, it's giving long:(sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nkb, kb, nalf, alf, nbet, bet, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g)β¨subroutine CCHK3β this one swaps inxtandz, obsessed:(sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nkb, kb, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, xt, g, z)πsubroutine CCHK4β nokb/bethere, but it's gotzat the end, periodt:(sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nalf, alf, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g, z)πsubroutine CCHK5β same energy, same exact arg list as its sibling, lowkey iconic:(sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nalf, alf, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g, z)πsubroutine CCHK6β and the sixth one, same args again, the way they just kept the pattern:(sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nalf, alf, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g, z)πΈsubroutine CCHKEβ short and sweet, only three args:(isnum, srnamt, nout)π§subroutine CMAKEβ a builder-ish little guy, here's the whole thing:(type, uplo, diag, m, n, a, nmax, aa, lda, kl, ku, reset, transl)π₯subroutine CMVCHβ big arg list incoming, brace yourself:(trans, m, n, alpha, a, nmax, x, incx, beta, y, incy, yt, g, yy, eps, err, fatal, nout, mv)πlogical function LCEβ note: it returns alogical, bestie, and it takes(ri, rj, lr)π¦logical function LCERESβ also alogicalfunction:(type, uplo, m, n, aa, as, lda)β¨complex function CBEGβ this one returnscomplexand takes exactly one thing:(reset)πreal function SDIFFβ returnsreal, takes two:(x, y)βsubroutine CHKXERβ args:(srnamt, infot, nout, lerr, ok)πsubroutine CREGR1β long boi, all of it, no edits:(trans, m, n, ly, kl, ku, alpha, a, lda, x, incx, beta, y, incy, ys)πsubroutine XERBLAβ the classic, taking(srname, info)π
That's every single entry in the synopsis, bestie β nothing dropped, nothing merged, nothing "cleaned up" π
β¨ Function/Subroutine Documentation β¨
okay bestie, buckle up β this is the part where the page just... lists everything. Every single routine in cblat2.f, signature and all. No descriptions for most of them (the source is lowkey mysterious like that π), but we are NOT skipping any, because every detail matters. π
πΈ CBEG
complex function CBEG (logical reset)
Definition at line 3155 of file cblat2.f.
(that's it. that's the whole entry. she's giving mystery, she's giving "look me up in the source" energy β¨)
π program CBLAT2
π Purpose:
fr fr this is the main character of the whole file, so listen up:
Test program for the COMPLEX Level 2 Blas.
The program must be driven by a short data file. The first 18 records of the file are read using list-directed input, and the last 17 records are read using the format ( A6, L2 ). An annotated example of a data file can be obtained by deleting the first 3 characters from the following 35 lines β and here they are, verbatim, don't touch anything:
!> 'cblat2.out' NAME OF SUMMARY OUTPUT FILE
!> 6 UNIT NUMBER OF SUMMARY FILE
!> 'CBLA2T.SNAP' NAME OF SNAPSHOT OUTPUT FILE
!> -1 UNIT NUMBER OF SNAPSHOT FILE (NOT USED IF .LT. 0)
!> F LOGICAL FLAG, T TO REWIND SNAPSHOT FILE AFTER EACH RECORD.
!> F LOGICAL FLAG, T TO STOP ON FAILURES.
!> T LOGICAL FLAG, T TO TEST ERROR EXITS.
!> 16.0 THRESHOLD VALUE OF TEST RATIO
!> 6 NUMBER OF VALUES OF N
!> 0 1 2 3 5 9 VALUES OF N
!> 4 NUMBER OF VALUES OF K
!> 0 1 2 4 VALUES OF K
!> 4 NUMBER OF VALUES OF INCX AND INCY
!> 1 2 -1 -2 VALUES OF INCX AND INCY
!> 3 NUMBER OF VALUES OF ALPHA
!> (0.0,0.0) (1.0,0.0) (0.7,-0.9) VALUES OF ALPHA
!> 3 NUMBER OF VALUES OF BETA
!> (0.0,0.0) (1.0,0.0) (1.3,-1.1) VALUES OF BETA
!> CGEMV T PUT F FOR NO TEST. SAME COLUMNS.
!> CGBMV T PUT F FOR NO TEST. SAME COLUMNS.
!> CHEMV T PUT F FOR NO TEST. SAME COLUMNS.
!> CHBMV T PUT F FOR NO TEST. SAME COLUMNS.
!> CHPMV T PUT F FOR NO TEST. SAME COLUMNS.
!> CTRMV T PUT F FOR NO TEST. SAME COLUMNS.
!> CTBMV T PUT F FOR NO TEST. SAME COLUMNS.
!> CTPMV T PUT F FOR NO TEST. SAME COLUMNS.
!> CTRSV T PUT F FOR NO TEST. SAME COLUMNS.
!> CTBSV T PUT F FOR NO TEST. SAME COLUMNS.
!> CTPSV T PUT F FOR NO TEST. SAME COLUMNS.
!> CGERC T PUT F FOR NO TEST. SAME COLUMNS.
!> CGERU T PUT F FOR NO TEST. SAME COLUMNS.
!> CHER T PUT F FOR NO TEST. SAME COLUMNS.
!> CHPR T PUT F FOR NO TEST. SAME COLUMNS.
!> CHER2 T PUT F FOR NO TEST. SAME COLUMNS.
!> CHPR2 T PUT F FOR NO TEST. SAME COLUMNS.
π§ Further Details
===============
See:
Dongarra J. J., Du Croz J. J., Hammarling S. and Hanson R. J.. An extended set of Fortran Basic Linear Algebra Subprograms. Technical Memoranda Nos. 41 (revision 3) and 81, Mathematics and Computer Science Division, Argonne National Laboratory, 9700 South Cass Avenue, Argonne, Illinois 60439, US. Or NAG Technical Reports TR3/87 and TR4/87, Numerical Algorithms Group Ltd., NAG Central Office, 256 Banbury Road, Oxford OX2 7DE, UK, and Numerical Algorithms Group Inc., 1101 31st Street, Suite 100, Downers Grove, Illinois 60515-1263, USA.
-- Written on 10-August-1987. Richard Hanson, Sandia National Labs. Jeremy Du Croz, NAG Central Office. 10-9-00: Change STATUS='NEW' to 'UNKNOWN' so that the testers can be run multiple times without deleting generated output files (susan)
(shoutout susan for that one, we stan a maintainer who fixes the rerun pain π)
Author
- Univ. of Tennessee
- Univ. of California Berkeley
- Univ. of Colorado Denver
- NAG Ltd.
Definition at line 102 of file cblat2.f.
π§ͺ CCHK1
subroutine CCHK1 (character*6 sname, real eps, real thresh, integer nout,
integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
integer, dimension( nidim ) idim, integer nkb, integer, dimension( nkb )
kb, integer nalf, complex, dimension( nalf ) alf, integer nbet, complex,
dimension( nbet ) bet, integer ninc, integer, dimension( ninc ) inc,
integer nmax, integer incmax, complex, dimension( nmax, nmax ) a,
complex, dimension( nmax*nmax ) aa, complex, dimension( nmax*nmax ) as,
complex, dimension( nmax ) x, complex, dimension( nmax*incmax ) xx,
complex, dimension( nmax*incmax ) xs, complex, dimension( nmax ) y,
complex, dimension( nmax*incmax ) yy, complex, dimension( nmax*incmax )
ys, complex, dimension( nmax ) yt, real, dimension( nmax ) g)
Definition at line 434 of file cblat2.f.
π§ͺ CCHK2
subroutine CCHK2 (character*6 sname, real eps, real thresh, integer nout,
integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
integer, dimension( nidim ) idim, integer nkb, integer, dimension( nkb )
kb, integer nalf, complex, dimension( nalf ) alf, integer nbet, complex,
dimension( nbet ) bet, integer ninc, integer, dimension( ninc ) inc,
integer nmax, integer incmax, complex, dimension( nmax, nmax ) a,
complex, dimension( nmax*nmax ) aa, complex, dimension( nmax*nmax ) as,
complex, dimension( nmax ) x, complex, dimension( nmax*incmax ) xx,
complex, dimension( nmax*incmax ) xs, complex, dimension( nmax ) y,
complex, dimension( nmax*incmax ) yy, complex, dimension( nmax*incmax )
ys, complex, dimension( nmax ) yt, real, dimension( nmax ) g)
Definition at line 807 of file cblat2.f.
π§ͺ CCHK3
subroutine CCHK3 (character*6 sname, real eps, real thresh, integer nout,
integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
integer, dimension( nidim ) idim, integer nkb, integer, dimension( nkb )
kb, integer ninc, integer, dimension( ninc ) inc, integer nmax, integer
incmax, complex, dimension( nmax, nmax ) a, complex, dimension(
nmax*nmax ) aa, complex, dimension( nmax*nmax ) as, complex, dimension(
nmax ) x, complex, dimension( nmax*incmax ) xx, complex, dimension(
nmax*incmax ) xs, complex, dimension( nmax ) xt, real, dimension( nmax )
g, complex, dimension( nmax ) z)
Definition at line 1155 of file cblat2.f.
notice how CCHK3 has xt and z instead of y/yt/yy/ys β she's built different, and yes that's just how it is π
π§ͺ CCHK4
subroutine CCHK4 (character*6 sname, real eps, real thresh, integer nout,
integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
integer, dimension( nidim ) idim, integer nalf, complex, dimension( nalf
) alf, integer ninc, integer, dimension( ninc ) inc, integer nmax,
integer incmax, complex, dimension( nmax, nmax ) a, complex, dimension(
nmax*nmax ) aa, complex, dimension( nmax*nmax ) as, complex, dimension(
nmax ) x, complex, dimension( nmax*incmax ) xx, complex, dimension(
nmax*incmax ) xs, complex, dimension( nmax ) y, complex, dimension(
nmax*incmax ) yy, complex, dimension( nmax*incmax ) ys, complex,
dimension( nmax ) yt, real, dimension( nmax ) g, complex, dimension(
nmax ) z)
Definition at line 1516 of file cblat2.f.
π§ͺ CCHK5
subroutine CCHK5 (character*6 sname, real eps, real thresh, integer nout,
integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
integer, dimension( nidim ) idim, integer nalf, complex, dimension( nalf
) alf, integer ninc, integer, dimension( ninc ) inc, integer nmax,
integer incmax, complex, dimension( nmax, nmax ) a, complex, dimension(
nmax*nmax ) aa, complex, dimension( nmax*nmax ) as, complex, dimension(
nmax ) x, complex, dimension( nmax*incmax ) xx, complex, dimension(
nmax*incmax ) xs, complex, dimension( nmax ) y, complex, dimension(
nmax*incmax ) yy, complex, dimension( nmax*incmax ) ys, complex,
dimension( nmax ) yt, real, dimension( nmax ) g, complex, dimension(
nmax ) z)
Definition at line 1793 of file cblat2.f.
π§ͺ CCHK6
subroutine CCHK6 (character*6 sname, real eps, real thresh, integer nout,
integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
integer, dimension( nidim ) idim, integer nalf, complex, dimension( nalf
) alf, integer ninc, integer, dimension( ninc ) inc, integer nmax,
integer incmax, complex, dimension( nmax, nmax ) a, complex, dimension(
nmax*nmax ) aa, complex, dimension( nmax*nmax ) as, complex, dimension(
nmax ) x, complex, dimension( nmax*incmax ) xx, complex, dimension(
nmax*incmax ) xs, complex, dimension( nmax ) y, complex, dimension(
nmax*incmax ) yy, complex, dimension( nmax*incmax ) ys, complex,
dimension( nmax ) yt, real, dimension( nmax ) g, complex, dimension(
nmax, 2 ) z)
Definition at line 2077 of file cblat2.f.
okay so CCHK4, CCHK5 and CCHK6 look near-identical but CCHK6's z is dimension( nmax, 2 ) β two columns, because she needs room for two vectors. not me noticing that on the third read π
π§ͺ CCHKE
subroutine CCHKE (integer isnum, character*6 srnamt, integer nout)
Definition at line 2399 of file cblat2.f.
π CHKXER
subroutine CHKXER (character*6 srnamt, integer infot, integer nout, logical
lerr, logical ok)
Definition at line 3223 of file cblat2.f.
ποΈ CMAKE
subroutine CMAKE (character*2 type, character*1 uplo, character*1 diag,
integer m, integer n, complex, dimension( nmax, * ) a, integer nmax,
complex, dimension( * ) aa, integer lda, integer kl, integer ku, logical
reset, complex transl)
Definition at line 2742 of file cblat2.f.
π¬ CMVCH
subroutine CMVCH (character*1 trans, integer m, integer n, complex alpha,
complex, dimension( nmax, * ) a, integer nmax, complex, dimension( * )
x, integer incx, complex beta, complex, dimension( * ) y, integer incy,
complex, dimension( * ) yt, real, dimension( * ) g, complex, dimension(
* ) yy, real eps, real err, logical fatal, integer nout, logical mv)
Definition at line 2934 of file cblat2.f.
π§΅ CREGR1
subroutine CREGR1 (character*1 trans, integer m, integer n, integer ly,
integer kl, integer ku, complex alpha, complex, dimension(lda,*) a,
integer lda, complex, dimension(*) x, integer incx, complex beta,
complex, dimension(*) y, integer incy, complex, dimension(*) ys)
Definition at line 3251 of file cblat2.f.
π«Ά LCE
logical function LCE (complex, dimension( * ) ri, complex, dimension( * )
rj, integer lr)
Definition at line 3066 of file cblat2.f.
π«Ά LCERES
logical function LCERES (character*2 type, character*1 uplo, integer m,
integer n, complex, dimension( lda, * ) aa, complex, dimension( lda, * )
as, integer lda)
Definition at line 3096 of file cblat2.f.
π SDIFF
real function SDIFF (real x, real y)
Definition at line 3207 of file cblat2.f.
π¨ XERBLA
subroutine XERBLA (character*6 srname, integer info)
Definition at line 3284 of file cblat2.f.
π Author
Generated automatically by Doxygen for LAPACK from the source code.
and that's the whole page bestie, you made it to the end ππ every routine, every dimension, every last logical, all accounted for β no skips, no summaries, periodt.
this diva right here is LAPACK, Version 3.12.0, straight from cblat2.f, and yes she was auto-generated by Doxygen for LAPACK from the source code β iconic behaviour honestly π«Άβ¨
π¦ where this page comes from
- opensuse-leap 16.0: lapack-man 3.12.0-160000.2.2 Β· BSD-3-Clause
- opensuse-leap 16.0: lapack-man 3.12.0-160000.2.2 Β· BSD-3-Clause
- opensuse-leap 16.0: lapack-man 3.12.0-160000.2.2 Β· BSD-3-Clause
- opensuse-leap 16.0: lapack-man 3.12.0-160000.2.2 Β· BSD-3-Clause
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms