SYNOPSIS

int MGOchkprincipal (Subscription *sub)

DESCRIPTION

The MGOchkprincipal() function checks to see if the uwnetid principal is valid with respect to Kerberos. The required fields are:

• sub.uwnetid
• sub.subscription_data

sub.uwnetid is the uwnetid name. sub.subscription_data is the plaintext password.

RETURN VALUE

Returns 1 upon success or -1 if an error occurred (in which case MGOerrno and MGOerrmsg are set appropriately).

ERRORS

• MGO_E_MAR - One or more of the required arguments were missing
• MGO_E_IAR - Invalid or ambiguous argument
• MGO_E_PMD - Permission denied. See access control
• MGO_E_KRE - A Kerberos error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

rmango

SEE ALSO

MGOaddprincipal(), MGOsetpassword(), MGOzero()