account.c File Reference

A group of associated Mailboxes. More...

#include "config.h"
#include <stddef.h>
#include "mutt/lib.h"
#include "config/lib.h"
#include "account.h"
#include "mailbox.h"
#include "neomutt.h"

Include dependency graph for account.c:

Go to the source code of this file.

Functions
struct Account *	account_new (const char *name, struct ConfigSubset *sub)
	Create a new Account.
bool	account_mailbox_add (struct Account *a, struct Mailbox *m)
	Add a Mailbox to an Account.
void	account_mailbox_remove (struct Account *a, struct Mailbox *m)
	Remove a Mailbox from an Account.
void	account_mailboxes_free (struct Account *a)
	Free all the Mailboxes on an Account.
void	account_free (struct Account **ptr)
	Free an Account.

Detailed Description

A group of associated Mailboxes.

Authors

• Richard Russon
• Pietro Cerutti

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

Function Documentation

account_new()

struct Account * account_new	(	const char *	name,
		struct ConfigSubset *	sub )

Create a new Account.

Parameters

name	Name for the Account
sub	Parent Config Subset

Return values

ptr	New Account

Definition at line 44 of file account.c.

{
  if (!sub)
    return NULL;
 
  struct Account *a = MUTT_MEM_CALLOC(1, struct Account);
 
  ARRAY_INIT(&a->mailboxes);
  a->notify = notify_new();
  a->name = mutt_str_dup(name);
  a->sub = cs_subset_new(name, sub, a->notify);
  a->sub->cs = sub->cs;
  a->sub->scope = SET_SCOPE_ACCOUNT;
 
  return a;
}

Here is the call graph for this function:

Here is the caller graph for this function:

account_mailbox_add()

bool account_mailbox_add	(	struct Account *	a,
		struct Mailbox *	m )

Add a Mailbox to an Account.

Parameters

a	Account
m	Mailbox to add

Return values

true	Mailbox was added

Definition at line 67 of file account.c.

{
  if (!a || !m)
    return false;
 
  if (a->type == MUTT_UNKNOWN)
    a->type = m->type;
 
  m->account = a;
  ARRAY_ADD(&a->mailboxes, m);
  mailbox_set_subset(m, a->sub);
  notify_set_parent(m->notify, a->notify);
 
  mutt_debug(LL_NOTIFY, "NT_MAILBOX_ADD: %s %p\n",
             mailbox_get_type_name(m->type), (void *) m);
  struct EventMailbox ev_m = { m };
  notify_send(a->notify, NT_MAILBOX, NT_MAILBOX_ADD, &ev_m);
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

account_mailbox_remove()

void account_mailbox_remove	(	struct Account *	a,
		struct Mailbox *	m )

Remove a Mailbox from an Account.

Parameters

a	Account
m	Mailbox to remove

Note

The mailbox is removed from the Account but not FREE'd

Definition at line 94 of file account.c.

{
  if (!a || !m || ARRAY_EMPTY(&a->mailboxes))
    return;
 
  struct Mailbox **mp = NULL;
  ARRAY_FOREACH(mp, &a->mailboxes)
  {
    if (*mp != m)
      continue;
 
    ARRAY_REMOVE(&a->mailboxes, mp);
 
    m->account = NULL;
    notify_set_parent(m->notify, NeoMutt->notify);
    break;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

account_mailboxes_free()

void account_mailboxes_free

(

struct Account *

a

)

Free all the Mailboxes on an Account.

Parameters

a

Account

All the Mailboxes will be removed and FREE'd.

Definition at line 119 of file account.c.

{
  if (!a)
    return;
 
  if (!ARRAY_EMPTY(&a->mailboxes))
  {
    mutt_debug(LL_NOTIFY, "NT_MAILBOX_DELETE_ALL\n");
    struct EventMailbox ev_m = { NULL };
    notify_send(a->notify, NT_MAILBOX, NT_MAILBOX_DELETE_ALL, &ev_m);
 
    struct Mailbox **mp = NULL;
    ARRAY_FOREACH(mp, &a->mailboxes)
    {
      struct Mailbox *m = *mp;
 
      // we make it invisible here to force the deletion of the mailbox
      m->visible = false;
      mailbox_free(&m);
    }
  }
 
  ARRAY_FREE(&a->mailboxes);
}

Here is the call graph for this function:

Here is the caller graph for this function:

account_free()

void account_free

(

struct Account **

ptr

)

Free an Account.

Parameters

[out]

ptr

Account to free

Definition at line 148 of file account.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct Account *a = *ptr;
 
  mutt_debug(LL_NOTIFY, "NT_ACCOUNT_DELETE: %s %p\n",
             mailbox_get_type_name(a->type), (void *) a);
  struct EventAccount ev_a = { a };
  notify_send(a->notify, NT_ACCOUNT, NT_ACCOUNT_DELETE, &ev_a);
 
  account_mailboxes_free(a);
 
  if (a->adata && a->adata_free)
    a->adata_free(&a->adata);
 
  cs_subset_free(&a->sub);
  FREE(&a->name);
  notify_free(&a->notify);
 
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function: