set_auth_method Subroutine
Purpose
Sets the authentication methods for the rcmds for this system.
Library
Authentication Methods Library (libauthm.a)
Syntax
int set_auth_method (uint ** authm)Description
This method configures the authentication methods for the system. The authentication methods should be passed to the function in the order in which they should be attempted in the unsigned integer pointer in which the user passed.
The list is an array of unsigned integers terminated by a zero. Each integer identifies an authentication method. The order that a client should attempt to authenticate is defined by the order of the list.
The flags identifying the authentication methods are defined in the /usr/include/authm.h file.
Any undefined bits in the input parameter invalidate the entire command. If the same authentication method is specified twice or if any authentication method is specified after Standard AIX®, the command fails.
The user must have root authority or this method fails.
Parameter
| Item | Description |
|---|---|
| authm | Points to an array of unsigned integers. The list of authentication methods to be set is terminated by a zero. |
Return Values
Upon successful completion, the set_auth_method subroutine returns a zero.
Upon unsuccessful completion, the set_auth_method subroutine returns an errno.