grp.h File Reference

_PATH_GROUP

Typedef gid_t

typedef __gid_t gid_t

Used for group IDs.

_GID_T_DECLARED

Typedef size_t

typedef __size_t size_t

Used for sizes of objects.

A type to define sizes of strings and memory blocks.

_SIZE_T_DECLARED

endgrent ( void )

IMPORT_C voidendgrent(void)

Refer to getgrent() for the documentation

getgrent ( void )

IMPORT_C struct group *getgrent(void)

Note: This description also covers the following functions - getgrnam() getgrnam_r() getgrgid() getgrgid_r() setgroups() setgrent() endgrent()

 These APIs are build supported but not available functionally. Symbian OS does not support multiple users and groups.

getgrgid ( gid_t )

IMPORT_C struct group *getgrgid(gid_t)

Parameters
Refer to getgrent() for the documentation
Return Value
The functions getgrent, getgrnam, and getgrgid, return a pointer to a group structure on success or NULL if the entry is not found or if an error occurs. If an error does occur, errno will be set. The functions getgrnam_r and getgrgid_r return 0 if no error occurred, or an error number to indicate failure. It is not an error if a matching entry is not found. (Thus, if result is set to NULL and the return value is 0, no matching entry exists.) The setgrent return the value 1 if successful, otherwise the value 0 is returned. The endgrent API has no return value.

getgrnam ( const char * )

IMPORT_C struct group *getgrnam(const char *)

Refer to getgrent() for the documentation

setgrent ( void )

IMPORT_C intsetgrent(void)

Refer to getgrent() for the documentation

getgrgid_r ( gid_t, struct group *, char *, size_t, struct group ** )

IMPORT_C intgetgrgid_r(gid_t,
struct group *,
char *,
size_t,
struct group **
)

Parameters
Refer to getgrent() for the documentation

getgrnam_r ( const char *, struct group *, char *, size_t, struct group ** )

IMPORT_C intgetgrnam_r(const char *,
struct group *,
char *,
size_t,
struct group **
)

Parameters
Refer to getgrent() for the documentation
© Nokia 2005.