gsasl2.h File Reference

GNU SASL authentication support. More...

#include <gsasl.h>

Include dependency graph for gsasl2.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
void	mutt_gsasl_client_finish (Gsasl_session **sctx)
	Free a GNU SASL client.
int	mutt_gsasl_client_new (struct Connection *conn, const char *mech, Gsasl_session **sctx)
	Create a new GNU SASL client.
void	mutt_gsasl_cleanup (Gsasl **ctx)
	Shutdown GNU SASL library.
const char *	mutt_gsasl_get_mech (const char *requested_mech, const char *server_mechlist)
	Pick a connection mechanism.

Detailed Description

GNU SASL authentication support.

Authors

• Richard Russon

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file gsasl2.h.

Function Documentation

mutt_gsasl_client_finish()

void mutt_gsasl_client_finish

(

Gsasl_session **

sctx

)

Free a GNU SASL client.

Parameters

sctx	GNU SASL Session

Definition at line 225 of file gsasl.c.

{
  gsasl_finish(*sctx);
  *sctx = NULL;
}

Here is the caller graph for this function:

mutt_gsasl_client_new()

int mutt_gsasl_client_new	(	struct Connection *	conn,
		const char *	mech,
		Gsasl_session **	sctx )

Create a new GNU SASL client.

Parameters

conn	Connection to a server
mech	Mechanisms to use
sctx	GNU SASL Session

Return values

0	Success
-1	Error

Definition at line 203 of file gsasl.c.

{
  if (!mutt_gsasl_init())
    return -1;
 
  struct ConnModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_CONN);
  int rc = gsasl_client_start(mod_data->mutt_gsasl_ctx, mech, sctx);
  if (rc != GSASL_OK)
  {
    *sctx = NULL;
    mutt_debug(LL_DEBUG1, "gsasl_client_start failed (%d): %s\n", rc, gsasl_strerror(rc));
    return -1;
  }
 
  gsasl_session_hook_set(*sctx, conn);
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_gsasl_cleanup()

void mutt_gsasl_cleanup

(

Gsasl **

ctx

)

Shutdown GNU SASL library.

Parameters

ctx	GNU SASL context to clean up

Definition at line 151 of file gsasl.c.

{
  if (!ctx || !*ctx)
    return;
 
  gsasl_done(*ctx);
  *ctx = NULL;
}

Here is the caller graph for this function:

mutt_gsasl_get_mech()

const char * mutt_gsasl_get_mech	(	const char *	requested_mech,
		const char *	server_mechlist )

Pick a connection mechanism.

Parameters

requested_mech	Requested mechanism
server_mechlist	Server's list of mechanisms

Return values

ptr	Selected mechanism string

Definition at line 166 of file gsasl.c.

{
  if (!mutt_gsasl_init())
    return NULL;
 
  struct ConnModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_CONN);
 
  /* libgsasl does not do case-independent string comparisons,
   * and stores its methods internally in uppercase. */
  char *uc_server_mechlist = mutt_str_dup(server_mechlist);
  if (uc_server_mechlist)
    mutt_str_upper(uc_server_mechlist);
 
  char *uc_requested_mech = mutt_str_dup(requested_mech);
  if (uc_requested_mech)
    mutt_str_upper(uc_requested_mech);
 
  const char *sel_mech = NULL;
  if (uc_requested_mech)
    sel_mech = gsasl_client_suggest_mechanism(mod_data->mutt_gsasl_ctx, uc_requested_mech);
  else
    sel_mech = gsasl_client_suggest_mechanism(mod_data->mutt_gsasl_ctx, uc_server_mechlist);
 
  FREE(&uc_requested_mech);
  FREE(&uc_server_mechlist);
 
  return sel_mech;
}

Here is the call graph for this function:

Here is the caller graph for this function: