debian man page for dpns_getgrpbynam

DPNS_GETGRPBYNAM(3)					      DPNS Library Functions					       DPNS_GETGRPBYNAM(3)

NAME
       dpns_getgrpbynam - get virtual gid associated with a given group name

SYNOPSIS
       #include <sys/types.h>
       #include "dpns_api.h"

       int dpns_getgrpbynam (char *groupname, gid_t *gid)

DESCRIPTION
       dpns_getgrpbynam gets the virtual gid associated with a given group name.

       groupname
	      specifies the group name.  It must be at most 255 characters long.

       gid    specifies the address of a buffer to receive the Virtual Group Id.

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	    groupname or gid is a NULL pointer.

       EINVAL	    This group name does not exist in the internal mapping table or the length of groupname exceeds 255.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT	    Name server is not running or is being shutdown.

DPNS
							   $Date: 2005/10/19 11:30:57 $ 				       DPNS_GETGRPBYNAM(3)