Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
flexiblas_list_loaded(3)     The FlexiBLAS Library    flexiblas_list_loaded(3)

NAME
       flexiblas_list_loaded - list all	loaded backends.

SYNOPSIS
       #include	<flexiblas/flexiblas_api.h>

       int flexiblas_list_loaded(char *name, size_t len, int pos);

       Link with -lflexiblas.

DESCRIPTION
       flexiblas_list_loaded  returns  information about all loaded  FlexiBLAS
       backends.  If the buffer	name is	set to NULL the	function  returns  the
       number  of  loaded backends. Otherwise the name parameter needs to be a
       character buffer	of size	len and	the pos	arguments specifies the	number
       of the entry to return. The name	of the backend is  then	 copy  to  the
       buffer  name  with  a  length of	at most	len and	the real length	of the
       backend name is returned. The name is  copied  into  the	 buffer	 using
       strncpy with a maximum length of	len.

       The  pos	parameter is valid in a	range from 0..B-1, where B is the num-
       ber of backends returned	by a first call	to flexiblas_list_loaded  with
       a NULL buffer.

       If  the buffer is not large enough, i.e.	the return value equals	len-1,
       the returned named can not be used in other FlexiBLAS  API  calls  like
       flexiblas_load_backend.

RETURN VALUE
       On  success,  it	returns	the number of loaded backends if name==NULL or
       the length of the returned name using strlen.

       In case of an error, like an out	of range index pos, a negative	number
       is returned.

ERRORS
       All negative return values are errors.

EXAMPLE
       The following example show how to list all loaded backends.

   Program Source

       #include	<stdio.h>
       #include	<flexiblas/flexiblas_api.h>

       int main	( int argc, char **argv	) {
	    char buffer[512];
	    int	n, pos;

	    n =	flexiblas_list_loaded(NULL, 0, 0);
	    for	( pos =	0; pos < n; pos++ ) {
		 flexiblas_list_loaded(buffer, 512, pos);
		 printf("[%2d] %s\n", pos, buffer);
	    }
	    return 0;
       }

SEE ALSO
       flexiblas_list(3), flexiblas_load_backend(3)

REPORTING BUGS
       The  current information	about the developers and reporting bugs	can be
       found on	the FlexiBLAS homepage.

       FlexiBLAS  Homepage:   <http://www.mpi-magdeburg.mpg.de/projects/flexi-
       blas>

AUTHORS
	Martin Koehler,	Jens Saak

COPYRIGHT
       Copyright (C) 2013-2025 Martin Koehler

LICENSE
       License	 GPLv3+:  GNU  GPL  version  3	or  later  <http://gnu.org/li-
       censes/gpl.html>.  This is free software: you are free  to  change  and
       redistribute it.	 There is NO WARRANTY, to the extent permitted by law.

M. Koehler			   2013-2025	      flexiblas_list_loaded(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=flexiblas_list_loaded&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help