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.