SYNOPSIS

int MGOinssuperuser (Admin *adm)

DESCRIPTION

The MGOinssuperuser() function inserts a new superuser record. Information is passed through adm. The required fields are:

• adm.principal
• adm.comment

adm.principal is the principal name. adm.comment is the comment field, used to state why the principal was added, etc.

RETURN VALUE

Returns the number of records inserted 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_EXI - Record already exists
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

MGOdelsuperuser(), MGOselsuperuser(), MGOupdsuperuser(), MGOzero()