Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <grp.h>
Link against: libc.lib

_PATH_GROUP

_PATH_GROUP "/etc/group"

Description

[Top]

Typedef gid_t

Interface status: externallyDefinedApi

typedef __gid_t gid_t;

Description

Used for group IDs.

[Top]

endgrent(void)

Interface status: externallyDefinedApi

IMPORT_C void endgrent(void);

Description

Refer to getgrent(void)getgrent(void) for the documentation

[Top]

getgrent(void)

Interface status: externallyDefinedApi

IMPORT_C struct group* getgrent(void);

Description

Note: This description also covers the following functions - getgrnam(const char *)getgrnam(const char *) getgrnam_r(const char *,struct group *,char *,size_t,struct group **)getgrnam_r(const char *,struct group *,char *,size_t,struct group **) getgrgid(gid_t)getgrgid(gid_t) getgrgid_r(gid_t,struct group *,char *,size_t,struct group **)getgrgid_r(gid_t,struct group *,char *,size_t,struct group **) setgroups(int,const gid_t *)setgroups(int,const gid_t *) setgrent(void)setgrent(void) endgrent(void)endgrent(void)

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

Return value

struct groupgroup *

[Top]

getgrgid(gid_t)

Interface status: externallyDefinedApi

IMPORT_C struct group* getgrgid(gid_t);

Description

Parameters

gid_tgid_t

Refer to getgrent(void)getgrent(void) for the documentation

Return value

struct groupgroup *

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.

[Top]

getgrnam(const char *)

Interface status: externallyDefinedApi

IMPORT_C struct group* getgrnam(const char *);

Description

Refer to getgrent(void)getgrent(void) for the documentation

Parameters

const char *

Return value

struct groupgroup *

[Top]

setgrent(void)

Interface status: externallyDefinedApi

IMPORT_C int setgrent(void);

Description

Refer to getgrent(void)getgrent(void) for the documentation

Return value

int

[Top]

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

Interface status: externallyDefinedApi

IMPORT_C int getgrgid_r(gid_t, struct group *, char *, size_t, struct group **);

Description

Parameters

gid_tgid_t

struct groupgroup *

char *

size_tsize_t

struct groupgroup **

Refer to getgrent(void)getgrent(void) for the documentation

Return value

int

[Top]

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

Interface status: externallyDefinedApi

IMPORT_C int getgrnam_r(const char *, struct group *, char *, size_t, struct group **);

Description

Parameters

const char *

struct groupgroup *

char *

size_tsize_t

struct groupgroup **

Refer to getgrent(void)getgrent(void) for the documentation

Return value

int

[Previous] [Top] [Next]