Scroll to navigation

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.

specifies the group name. It must be at most 255 characters long.
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

groupname or gid is a NULL pointer.
This group name does not exist in the internal mapping table or the length of groupname exceeds 255.
Host unknown.
Service unknown.
Communication error.
Name server is not running or is being shutdown.
$Date: 2005/10/19 11:30:57 $ DPNS