sl@0: /** @file ../include/grp.h sl@0: @internalComponent sl@0: */ sl@0: sl@0: /** @fn endgrent(void) sl@0: sl@0: Refer to getgrent() for the documentation sl@0: sl@0: sl@0: sl@0: sl@0: @publishedAll sl@0: @externallyDefinedApi sl@0: */ sl@0: sl@0: /** @fn *getgrent(void) sl@0: sl@0: Note: This description also covers the following functions - sl@0: getgrnam() getgrnam_r() getgrgid() getgrgid_r() setgroups() setgrent() endgrent() sl@0: sl@0: sl@0: sl@0: @code sl@0: sl@0: @endcode sl@0: These APIs are build supported but not available functionally. Symbian OS sl@0: does not support multiple users and groups. sl@0: sl@0: sl@0: sl@0: sl@0: @publishedAll sl@0: @externallyDefinedApi sl@0: */ sl@0: sl@0: /** @fn *getgrgid(gid_t gid) sl@0: @param gid sl@0: Refer to getgrent() for the documentation sl@0: sl@0: @return 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.) sl@0: The setgrent return the value 1 if successful, otherwise the value 0 is returned. The endgrent API has no return value. sl@0: sl@0: sl@0: sl@0: @publishedAll sl@0: @externallyDefinedApi sl@0: */ sl@0: sl@0: /** @fn *getgrnam(const char *) sl@0: sl@0: Refer to getgrent() for the documentation sl@0: sl@0: sl@0: sl@0: sl@0: @publishedAll sl@0: @externallyDefinedApi sl@0: */ sl@0: sl@0: /** @fn setgrent(void) sl@0: sl@0: Refer to getgrent() for the documentation sl@0: sl@0: sl@0: sl@0: sl@0: @publishedAll sl@0: @externallyDefinedApi sl@0: */ sl@0: sl@0: /** @fn getgrgid_r(gid_t gid, struct group *grp, char *, size_t, struct group **result) sl@0: @param gid sl@0: @param grp sl@0: @param result sl@0: Refer to getgrent() for the documentation sl@0: sl@0: sl@0: sl@0: sl@0: @publishedAll sl@0: @externallyDefinedApi sl@0: */ sl@0: sl@0: /** @fn getgrnam_r(const char *name, struct group *grp, char *, size_t, struct group **result) sl@0: @param name sl@0: @param grp sl@0: @param result sl@0: sl@0: Refer to getgrent() for the documentation sl@0: sl@0: sl@0: sl@0: sl@0: @publishedAll sl@0: @externallyDefinedApi sl@0: */ sl@0: sl@0: /** @struct group sl@0: sl@0: Includes the following members, sl@0: sl@0: @publishedAll sl@0: @externallyDefinedApi sl@0: */ sl@0: sl@0: /** @var group::gr_name sl@0: group name sl@0: */ sl@0: sl@0: /** @var group::gr_passwd sl@0: group password sl@0: */ sl@0: sl@0: /** @var group::gr_gid sl@0: group id sl@0: */ sl@0: sl@0: /** @var group::gr_mem sl@0: group members sl@0: */ sl@0: sl@0: /** @def _PATH_GROUP sl@0: @publishedAll sl@0: @released sl@0: */