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.
