9. System Databases Manager — RTEMS POSIX API Guide 5.4-rc2 (21st August 2026) documentation

# 9. System Databases Manager

## 9.1. Introduction

The system databases manager is …

The directives provided by the system databases manager are:

- getgrgid - Get Group File Entry for ID

- getgrgid_r - Reentrant Get Group File Entry

- getgrnam - Get Group File Entry for Name

- getgrnam_r - Reentrant Get Group File Entry for Name

- getpwuid - Get Password File Entry for UID

- getpwuid_r - Reentrant Get Password File Entry for UID

- getpwnam - Get Password File Entry for Name

- getpwnam_r - Reentrant Get Password File Entry for Name

## 9.2. Background

There is currently no text in this section.

## 9.3. Operations

There is currently no text in this section.

## 9.4. Directives

This section details the system databases manager’s directives. A subsection is dedicated to each of this manager’s directives and describes the calling sequence, related constants, usage, and status codes.

### 9.4.1. getgrgid - Get Group File Entry for ID

CALLING SEQUENCE:

    #include <grp.h>
    struct group *getgrgid(
        gid_t gid
    );

STATUS CODES:

`E` | The

DESCRIPTION:

NOTES:

### 9.4.2. getgrgid_r - Reentrant Get Group File Entry

CALLING SEQUENCE:

    #include <grp.h>
    int getgrgid_r(
        gid_t gid,
        struct group *grp,
        char *buffer,
        size_t bufsize,
        struct group **result
    );

STATUS CODES:

`E` | The

DESCRIPTION:

NOTES:

### 9.4.3. getgrnam - Get Group File Entry for Name

CALLING SEQUENCE:

    #include <grp.h>
    struct group *getgrnam(
        const char *name
    );

STATUS CODES:

`E` | The

DESCRIPTION:

NOTES:

### 9.4.4. getgrnam_r - Reentrant Get Group File Entry for Name

CALLING SEQUENCE:

    #include <grp.h>
    int getgrnam_r(
        const char *name,
        struct group *grp,
        char *buffer,
        size_t bufsize,
        struct group **result
    );

STATUS CODES:

`E` | The

DESCRIPTION:

NOTES:

### 9.4.5. getpwuid - Get Password File Entry for UID

CALLING SEQUENCE:

    #include <pwd.h>
    struct passwd *getpwuid(
        uid_t uid
    );

STATUS CODES:

`E` | The

DESCRIPTION:

NOTES:

### 9.4.6. getpwuid_r - Reentrant Get Password File Entry for UID

CALLING SEQUENCE:

    #include <pwd.h>
    int getpwuid_r(
        uid_t uid,
        struct passwd *pwd,
        char *buffer,
        size_t bufsize,
        struct passwd **result
    );

STATUS CODES:

`E` | The

DESCRIPTION:

NOTES:

### 9.4.7. getpwnam - Password File Entry for Name

CALLING SEQUENCE:

    #include <pwd.h>
    struct passwd *getpwnam(
        const char *name
    );

STATUS CODES:

`E` | The

DESCRIPTION:

NOTES:

### 9.4.8. getpwnam_r - Reentrant Get Password File Entry for Name

CALLING SEQUENCE:

    #include <pwd.h>
    int getpwnam_r(
        const char *name,
        struct passwd *pwd,
        char *buffer,
        size_t bufsize,
        struct passwd **result
    );

STATUS CODES:

`E` | The

DESCRIPTION:

NOTES: