group.c File Reference

Handling for email address groups. More...

#include "config.h"
#include <stdbool.h>
#include <stdlib.h>
#include "group.h"
#include "address.h"

Include dependency graph for group.c:

Go to the source code of this file.

Functions
static void	group_free (struct Group **ptr)
	Free an Address Group.
static struct Group *	group_new (const char *pat)
	Create a new Address Group.
static void	group_hash_free (int type, void *obj, intptr_t data)
	Free our hash table data - Implements hash_hdata_free_t -.
void	mutt_grouplist_init (void)
	Initialize the GroupList singleton.
void	mutt_grouplist_cleanup (void)
	Free GroupList singleton resource.
struct Group *	mutt_pattern_group (const char *pat)
	Match a pattern to a Group.
static void	group_remove (struct Group *g)
	Remove a Group from the Hash Table.
void	mutt_grouplist_clear (struct GroupList *gl)
	Clear a GroupList.
static bool	empty_group (struct Group *g)
	Is a Group empty?
void	mutt_grouplist_add (struct GroupList *gl, struct Group *group)
	Add a Group to a GroupList.
void	mutt_grouplist_destroy (struct GroupList *gl)
	Free a GroupList.
static void	group_add_addrlist (struct Group *g, const struct AddressList *al)
	Add an Address List to a Group.
static int	group_add_regex (struct Group *g, const char *s, uint16_t flags, struct Buffer *err)
	Add a Regex to a Group.
static int	group_remove_regex (struct Group *g, const char *s)
	Remove a Regex from a Group.
void	mutt_grouplist_add_addrlist (struct GroupList *gl, struct AddressList *al)
	Add Address list to a GroupList.
int	mutt_grouplist_remove_addrlist (struct GroupList *gl, struct AddressList *al)
	Remove an AddressList from a GroupList.
int	mutt_grouplist_add_regex (struct GroupList *gl, const char *s, uint16_t flags, struct Buffer *err)
	Add matching Addresses to a GroupList.
int	mutt_grouplist_remove_regex (struct GroupList *gl, const char *s)
	Remove matching addresses from a GroupList.
bool	mutt_group_match (struct Group *g, const char *s)
	Does a string match an entry in a Group?

Variables
static struct HashTable *	Groups = NULL
	Hash Table: "group-name" -> Group.

Detailed Description

Handling for email address groups.

Authors

• Richard Russon
• Bo Yu
• Pietro Cerutti
• Federico Kircheis

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 group.c.

Function Documentation

group_free()

static void group_free ( struct Group ** ptr )

static

Free an Address Group.

Parameters

ptr	Group to free

Definition at line 49 of file group.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct Group *g = *ptr;
 
  mutt_addrlist_clear(&g->al);
  mutt_regexlist_free(&g->rs);
  FREE(&g->name);
 
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

group_new()

static struct Group * group_new ( const char * pat )

static

Create a new Address Group.

Parameters

pat

Pattern

Return values

ptr	New Address Group

Note

The pattern will be copied

Definition at line 70 of file group.c.

{
  struct Group *g = MUTT_MEM_CALLOC(1, struct Group);
 
  g->name = mutt_str_dup(pat);
  STAILQ_INIT(&g->rs);
  TAILQ_INIT(&g->al);
 
  return g;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_grouplist_init()

void mutt_grouplist_init

(

void

)

Initialize the GroupList singleton.

This is called once from init.c when initializing the global structures.

Definition at line 95 of file group.c.

{
  Groups = mutt_hash_new(1031, MUTT_HASH_NO_FLAGS);
 
  mutt_hash_set_destructor(Groups, group_hash_free, 0);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_grouplist_cleanup()

void mutt_grouplist_cleanup

(

void

)

Free GroupList singleton resource.

This is called once from init.c when deinitializing the global resources.

Definition at line 107 of file group.c.

{
  mutt_hash_free(&Groups);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_pattern_group()

struct Group * mutt_pattern_group

(

const char *

pat

)

Match a pattern to a Group.

Parameters

pat	Pattern to match

Return values

ptr	Matching Group, or new Group (if no match)

Definition at line 117 of file group.c.

{
  if (!pat)
    return NULL;
 
  struct Group *g = mutt_hash_find(Groups, pat);
  if (!g)
  {
    mutt_debug(LL_DEBUG2, "Creating group %s\n", pat);
    g = group_new(pat);
    mutt_hash_insert(Groups, g->name, g);
  }
 
  return g;
}

Here is the call graph for this function:

Here is the caller graph for this function:

group_remove()

static void group_remove ( struct Group * g )

static

Remove a Group from the Hash Table.

Parameters

g	Group to remove

Definition at line 137 of file group.c.

{
  if (!g)
    return;
  mutt_hash_delete(Groups, g->name, g);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_grouplist_clear()

void mutt_grouplist_clear

(

struct GroupList *

gl

)

Clear a GroupList.

Parameters

gl	GroupList to clear

Definition at line 148 of file group.c.

{
  if (!gl)
    return;
 
  struct GroupNode *np = STAILQ_FIRST(gl);
  struct GroupNode *next = NULL;
  while (np)
  {
    group_remove(np->group);
    next = STAILQ_NEXT(np, entries);
    FREE(&np);
    np = next;
  }
  STAILQ_INIT(gl);
}

Here is the call graph for this function:

Here is the caller graph for this function:

empty_group()

static bool empty_group ( struct Group * g )

static

Is a Group empty?

Parameters

g	Group to test

Return values

true	The Group is empty

Definition at line 170 of file group.c.

{
  if (!g)
    return true;
  return TAILQ_EMPTY(&g->al) && STAILQ_EMPTY(&g->rs);
}

Here is the caller graph for this function:

mutt_grouplist_add()

void mutt_grouplist_add	(	struct GroupList *	gl,
		struct Group *	group )

Add a Group to a GroupList.

Parameters

gl	GroupList to add to
group	Group to add

Definition at line 182 of file group.c.

{
  if (!gl || !group)
    return;
 
  struct GroupNode *np = NULL;
  STAILQ_FOREACH(np, gl, entries)
  {
    if (np->group == group)
      return;
  }
  np = MUTT_MEM_CALLOC(1, struct GroupNode);
  np->group = group;
  STAILQ_INSERT_TAIL(gl, np, entries);
}

Here is the caller graph for this function:

mutt_grouplist_destroy()

void mutt_grouplist_destroy

(

struct GroupList *

gl

)

Free a GroupList.

Parameters

gl	GroupList to free

Definition at line 202 of file group.c.

{
  if (!gl)
    return;
 
  struct GroupNode *np = STAILQ_FIRST(gl);
  struct GroupNode *next = NULL;
  while (np)
  {
    next = STAILQ_NEXT(np, entries);
    FREE(&np);
    np = next;
  }
  STAILQ_INIT(gl);
}

Here is the caller graph for this function:

group_add_addrlist()

static void group_add_addrlist ( struct Group * g, const struct AddressList * al )

static

Add an Address List to a Group.

Parameters

g	Group to add to
al	Address List

Definition at line 223 of file group.c.

{
  if (!g || !al)
    return;
 
  struct AddressList al_new = TAILQ_HEAD_INITIALIZER(al_new);
  mutt_addrlist_copy(&al_new, al, false);
  mutt_addrlist_remove_xrefs(&g->al, &al_new);
  struct Address *a = NULL, *tmp = NULL;
  TAILQ_FOREACH_SAFE(a, &al_new, entries, tmp)
  {
    TAILQ_REMOVE(&al_new, a, entries);
    mutt_addrlist_append(&g->al, a);
  }
  ASSERT(TAILQ_EMPTY(&al_new));
}

Here is the call graph for this function:

Here is the caller graph for this function:

group_add_regex()

static int group_add_regex ( struct Group * g, const char * s, uint16_t flags, struct Buffer * err )

static

Add a Regex to a Group.

Parameters

g	Group to add to
s	Regex string to add
flags	Flags, e.g. REG_ICASE
err	Buffer for error message

Return values

0	Success
-1	Error

Definition at line 249 of file group.c.

{
  return mutt_regexlist_add(&g->rs, s, flags, err);
}

Here is the call graph for this function:

Here is the caller graph for this function:

group_remove_regex()

static int group_remove_regex ( struct Group * g, const char * s )

static

Remove a Regex from a Group.

Parameters

g	Group to modify
s	Regex string to match

Return values

0	Success
-1	Error

Definition at line 261 of file group.c.

{
  return mutt_regexlist_remove(&g->rs, s);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_grouplist_add_addrlist()

void mutt_grouplist_add_addrlist	(	struct GroupList *	gl,
		struct AddressList *	al )

Add Address list to a GroupList.

Parameters

gl	GroupList to add to
al	Address list to add

Definition at line 271 of file group.c.

{
  if (!gl || !al)
    return;
 
  struct GroupNode *np = NULL;
  STAILQ_FOREACH(np, gl, entries)
  {
    group_add_addrlist(np->group, al);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_grouplist_remove_addrlist()

int mutt_grouplist_remove_addrlist	(	struct GroupList *	gl,
		struct AddressList *	al )

Remove an AddressList from a GroupList.

Parameters

gl	GroupList to remove from
al	AddressList to remove

Return values

0	Success
-1	Error

Definition at line 290 of file group.c.

{
  if (!gl || !al)
    return -1;
 
  struct GroupNode *gnp = NULL;
  STAILQ_FOREACH(gnp, gl, entries)
  {
    struct Address *a = NULL;
    TAILQ_FOREACH(a, al, entries)
    {
      mutt_addrlist_remove(&gnp->group->al, buf_string(a->mailbox));
    }
    if (empty_group(gnp->group))
    {
      group_remove(gnp->group);
    }
  }
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_grouplist_add_regex()

int mutt_grouplist_add_regex	(	struct GroupList *	gl,
		const char *	s,
		uint16_t	flags,
		struct Buffer *	err )

Add matching Addresses to a GroupList.

Parameters

gl	GroupList to add to
s	Address to match
flags	Flags, e.g. REG_ICASE
err	Buffer for error message

Return values

0	Success
-1	Error

Definition at line 321 of file group.c.

{
  if (!gl || !s)
    return -1;
 
  int rc = 0;
 
  struct GroupNode *np = NULL;
  STAILQ_FOREACH(np, gl, entries)
  {
    rc = group_add_regex(np->group, s, flags, err);
    if (rc)
      return rc;
  }
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_grouplist_remove_regex()

int mutt_grouplist_remove_regex	(	struct GroupList *	gl,
		const char *	s )

Remove matching addresses from a GroupList.

Parameters

gl	GroupList to remove from
s	Address to match

Return values

0	Success
-1	Error

Definition at line 346 of file group.c.

{
  if (!gl || !s)
    return -1;
 
  int rc = 0;
  struct GroupNode *np = NULL;
  STAILQ_FOREACH(np, gl, entries)
  {
    rc = group_remove_regex(np->group, s);
    if (empty_group(np->group))
      group_remove(np->group);
    if (rc)
      return rc;
  }
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_group_match()

bool mutt_group_match	(	struct Group *	g,
		const char *	s )

Does a string match an entry in a Group?

Parameters

g	Group to match against
s	String to match

Return values

true	There's a match

Definition at line 370 of file group.c.

{
  if (!g || !s)
    return false;
 
  if (mutt_regexlist_match(&g->rs, s))
    return true;
  struct Address *a = NULL;
  TAILQ_FOREACH(a, &g->al, entries)
  {
    if (a->mailbox && mutt_istr_equal(s, buf_string(a->mailbox)))
      return true;
  }
 
  return false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

Groups

struct HashTable* Groups = NULL

static

Hash Table: "group-name" -> Group.

A set of all the Address Groups.

Definition at line 43 of file group.c.