Man Linux: Main Page and Category List

NAME

       dpm_getprotocols - get the list of supported protocols

SYNOPSIS

       #include <sys/types.h>
       #include "dpm_api.h"

       int     dpm_getprotocols     (int     *nb_supported_protocols,     char
       ***supported_protocols)

DESCRIPTION

       dpm_getprotocols gets the list of supported protocols.

       nb_supported_protocols
              will be set to the number of protocols in the array of supported
              protocols.

       supported_protocols
              will  be  set  to  the  address  of  an array of pointers to the
              supported protocols.  This array of pointers is allocated by the
              API  and  the  client application is responsible for freeing the
              array when not needed anymore.

RETURN VALUE

       This routine returns 0 if the operation was successful  or  -1  if  the
       operation failed. In the latter case, serrno is set appropriately.

ERRORS

       EFAULT       nb_supported_protocols  or  supported_protocols  is a NULL
                    pointer.

       ENOMEM       Memory could not be allocated for  storing  the  array  of
                    supported protocols.

       SENOSHOST    Host unknown.

       SECOMERR     Communication error.