#include <sys.socket.h>
Kernighan-Ritchie-C:
int getbcamhost(bcamname, bcamnamelen);
char *bcamname;
int bcamnamelen;
ANSI-C:
int getbcamhost(char* bcamname, int bcamnamelen);
Description
Use of the getbcamhost() function only makes sense in the AF_ISO address family.
getbcamhost() returns the BCAM host name in the bcamname parameter. The BCAM host name is used for the ISO transport service in the AF_ISO address family and corresponds to the local network selector NSEL. The BCAM host name has a fixed length of 8 characters; blanks are permitted at the end of the name.
The length of the bcamname string variable must be specified in the bcamnamelen parameter in the getbcamhost() call.
If the length of the bcamname string variable specified by bcamnamelen is sufficient to accept the host name, the host name is terminated with a null byte. Otherwise, the excess host name characters are truncated, and it is then undefined whether the host name returned in this way is terminated by a null byte.
Definition of BCAM host name: see getsockopt() in section "getsockopt(), setsockopt() - get and set socket options"
Return value
0:
If successful.
-1:
If errors occur. errno is not set.