getauthdb or getauthdb_r Subroutine
Purpose
Finds the current administrative domain.
Library
Standard C Library (libc.a)
Syntax
#include <usersec.h>
int getauthdb (Value)
authdb_t *Value;
int getauthdb_r (Value)
authdb_t *Value;
Description
The getauthdb and getauthdb_r subroutines return the value of the current authentication domain in the Value parameter. The getauthdb subroutine returns the value of the current process-wide authentication domain. The getauthdb_r subroutine returns the authentication domain for the current thread if one has been set. The subroutines return -1 if no administrative domain has been set.
Parameters
| Item | Description |
|---|---|
| Value | A pointer to a variable of type authdb_t. The authdb_t type is a 16-character array that contains the name of a loadable authentication module. |
Return Values
| Item | Description |
|---|---|
| 1 | The value returned is from the process-wide data. |
| 0 | The value returned is from the thread-specific data. An authentication database module has been specified by an earlier call to the setauthdb subroutine. The name of the current database module has been copied to the Value parameter. |
| -1 | The subroutine failed. An authentication database module has not been specified by an earlier call to the setauthdb subroutine. |