Civetweb API Reference

mg_modify_passwords_file( passwords_file_name, domain, user, password );


passwords_file_nameconst char *The path to the passwords file
realmconst char *The authentication realm (domain) of the user record
userconst char *Username of the record to be added, changed or deleted
passwordconst char *Password associated with the user or NULL if the record must be deleted

Return Value

intSuccess or error code


The function mg_modify_passwords_file() allows an application to manipulate .htpasswd files on the fly by adding, deleting and changing user records. This is one of the several ways to implement authentication on the server side.

If the password parameter is not NULL an entry is added to the password file. An existing records is modified in that case. If NULL is used as the password the enrty is removed from the file.

The function returns 1 when successful and 0 if an error occurs.

See Also