X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/ec18722d02bd307bd09f30715dc8ba4e1b8a6716..63621a81d16ab743de6b57d47578a9a2c670ad22:/h/oauth.h diff --git a/h/oauth.h b/h/oauth.h index 66da2f31..e6873df4 100644 --- a/h/oauth.h +++ b/h/oauth.h @@ -128,9 +128,9 @@ mh_oauth_do_xoauth(const char *user, const char *svc, unsigned char **oauth_res, * * Accesses global m_defs via context_find. * - * On error, return FALSE and set an error in ctx; ctx is always allocated. + * On error, return false and set an error in ctx; ctx is always allocated. */ -boolean +bool mh_oauth_new(mh_oauth_ctx **ctx, const char *svc_name); /* @@ -145,7 +145,7 @@ mh_oauth_free(mh_oauth_ctx *ctx); * Never returns NULL. */ const char * -mh_oauth_svc_display_name(const mh_oauth_ctx *ctx); +mh_oauth_svc_display_name(const mh_oauth_ctx *ctx) PURE; /* * Enable logging for subsequent operations on ctx. @@ -164,7 +164,7 @@ mh_oauth_log_to(FILE *log, mh_oauth_ctx *ctx); * Must not be called if an error was not indicated. */ mh_oauth_err_code -mh_oauth_get_err_code(const mh_oauth_ctx *ctx); +mh_oauth_get_err_code(const mh_oauth_ctx *ctx) PURE; /* * Return null-terminated error message after some function indicated an error. @@ -196,16 +196,16 @@ mh_oauth_authorize(const char *code, mh_oauth_ctx *ctx); /* * Refresh access (and maybe refresh) token if refresh token present. * - * On error, return FALSE and leave cred untouched. + * On error, return false and leave cred untouched. */ -boolean +bool mh_oauth_refresh(mh_oauth_cred *cred); /* * Return whether access token is present and not expired at time T. */ -boolean -mh_oauth_access_token_valid(time_t t, const mh_oauth_cred *cred); +bool +mh_oauth_access_token_valid(time_t t, const mh_oauth_cred *cred) PURE; /* * Free all resources associated with cred. @@ -226,9 +226,9 @@ mh_oauth_cred_fn(const char *svc_name); /* * Serialize OAuth tokens to file. * - * On error, return FALSE. + * On error, return false. */ -boolean +bool mh_oauth_cred_save(FILE *fp, mh_oauth_cred *cred, const char *user); /* @@ -257,6 +257,6 @@ mh_oauth_sasl_client_response(size_t *res_len, * Retrieve the various entries for the OAuth mechanism */ -boolean +bool mh_oauth_get_service_info(const char *svc_name, mh_oauth_service_info *svcinfo, char *errbuf, size_t errbuflen);