envelope.h File Reference

Representation of an email header (envelope) More...

#include "config.h"
#include <stdbool.h>
#include "mutt/lib.h"
#include "address/lib.h"

Include dependency graph for envelope.h:

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

Go to the source code of this file.

Data Structures
struct	AutocryptHeader
	Parse Autocrypt header info. More...
struct	Envelope
	The header of an Email. More...

Macros
#define	MUTT_ENV_CHANGED_IRT   (1 << 0)
	In-Reply-To changed to link/break threads.
#define	MUTT_ENV_CHANGED_REFS   (1 << 1)
	References changed to break thread.
#define	MUTT_ENV_CHANGED_XLABEL   (1 << 2)
	X-Label edited.
#define	MUTT_ENV_CHANGED_SUBJECT   (1 << 3)
	Protected header update.

Enumerations
enum	NotifyEnvelope {   NT_ENVELOPE_BCC = 1 , NT_ENVELOPE_CC , NT_ENVELOPE_FCC , NT_ENVELOPE_FOLLOWUP_TO ,   NT_ENVELOPE_FROM , NT_ENVELOPE_MIXMASTER , NT_ENVELOPE_NEWSGROUPS , NT_ENVELOPE_REPLY_TO ,   NT_ENVELOPE_SUBJECT , NT_ENVELOPE_TO , NT_ENVELOPE_X_COMMENT_TO }
	Types of Envelope Event. More...

Functions
bool	mutt_env_cmp_strict (const struct Envelope *e1, const struct Envelope *e2)
	Strictly compare two Envelopes.
void	mutt_env_free (struct Envelope **ptr)
	Free an Envelope.
void	mutt_env_merge (struct Envelope *base, struct Envelope **extra)
	Merge the headers of two Envelopes.
struct Envelope *	mutt_env_new (void)
	Create a new Envelope.
bool	mutt_env_notify_send (struct Email *e, enum NotifyEnvelope type)
	Send an Envelope change notification.
int	mutt_env_to_intl (struct Envelope *env, const char **tag, char **err)
	Convert an Envelope's Address fields to Punycode format.
void	mutt_env_to_local (struct Envelope *env)
	Convert an Envelope's Address fields to local format.
struct AutocryptHeader *	mutt_autocrypthdr_new (void)
	Create a new AutocryptHeader.
void	mutt_autocrypthdr_free (struct AutocryptHeader **ptr)
	Free an AutocryptHeader.

Detailed Description

Representation of an email header (envelope)

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 envelope.h.

Macro Definition Documentation

MUTT_ENV_CHANGED_IRT

#define MUTT_ENV_CHANGED_IRT   (1 << 0)

In-Reply-To changed to link/break threads.

Definition at line 34 of file envelope.h.

MUTT_ENV_CHANGED_REFS

#define MUTT_ENV_CHANGED_REFS   (1 << 1)

References changed to break thread.

Definition at line 35 of file envelope.h.

MUTT_ENV_CHANGED_XLABEL

#define MUTT_ENV_CHANGED_XLABEL   (1 << 2)

X-Label edited.

Definition at line 36 of file envelope.h.

MUTT_ENV_CHANGED_SUBJECT

#define MUTT_ENV_CHANGED_SUBJECT   (1 << 3)

Protected header update.

Definition at line 37 of file envelope.h.

Enumeration Type Documentation

NotifyEnvelope

enum NotifyEnvelope

Types of Envelope Event.

Observers of NT_ENVELOPE will not be passed any Event data.

Notifications that an Envelope field has changed. Envelope doesn't support notifications, so events will be passed to the Email.

Enumerator
NT_ENVELOPE_BCC	"Bcc:" header has changed
NT_ENVELOPE_CC	"Cc:" header has changed
NT_ENVELOPE_FCC	"Fcc:" header has changed
NT_ENVELOPE_FOLLOWUP_TO	"Followup-To:" header has changed
NT_ENVELOPE_FROM	"From:" header has changed
NT_ENVELOPE_MIXMASTER	MixMaster chain has changed.
NT_ENVELOPE_NEWSGROUPS	"Newsgroups:" header has changed
NT_ENVELOPE_REPLY_TO	"Reply-To:" header has changed
NT_ENVELOPE_SUBJECT	"Subject:" header has changed
NT_ENVELOPE_TO	"To:" header has changed
NT_ENVELOPE_X_COMMENT_TO	"X-Comment-To:" header has changed

Definition at line 103 of file envelope.h.

{
  NT_ENVELOPE_BCC  = 1,        
  NT_ENVELOPE_CC,              
  NT_ENVELOPE_FCC,             
  NT_ENVELOPE_FOLLOWUP_TO,     
  NT_ENVELOPE_FROM,            
  NT_ENVELOPE_MIXMASTER,       
  NT_ENVELOPE_NEWSGROUPS,      
  NT_ENVELOPE_REPLY_TO,        
  NT_ENVELOPE_SUBJECT,         
  NT_ENVELOPE_TO,              
  NT_ENVELOPE_X_COMMENT_TO,    
};

Function Documentation

mutt_env_cmp_strict()

bool mutt_env_cmp_strict	(	const struct Envelope *	e1,
		const struct Envelope *	e2
	)

Strictly compare two Envelopes.

Parameters

e1	First Envelope
e2	Second Envelope

Return values

true	Envelopes are strictly identical

Definition at line 258 of file envelope.c.

{
  if (e1 && e2)
  {
    if (!mutt_str_equal(e1->message_id, e2->message_id) ||
        !mutt_str_equal(e1->subject, e2->subject) ||
        !mutt_list_compare(&e1->references, &e2->references) ||
        !mutt_addrlist_equal(&e1->from, &e2->from) ||
        !mutt_addrlist_equal(&e1->sender, &e2->sender) ||
        !mutt_addrlist_equal(&e1->reply_to, &e2->reply_to) ||
        !mutt_addrlist_equal(&e1->to, &e2->to) || !mutt_addrlist_equal(&e1->cc, &e2->cc) ||
        !mutt_addrlist_equal(&e1->return_path, &e2->return_path))
    {
      return false;
    }
    else
    {
      return true;
    }
  }
  else
  {
    return (!e1 && !e2);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_env_free()

void mutt_env_free

(

struct Envelope **

ptr

)

Free an Envelope.

Parameters

[out]

ptr

Envelope to free

Definition at line 97 of file envelope.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct Envelope *env = *ptr;
 
  mutt_addrlist_clear(&env->return_path);
  mutt_addrlist_clear(&env->from);
  mutt_addrlist_clear(&env->to);
  mutt_addrlist_clear(&env->cc);
  mutt_addrlist_clear(&env->bcc);
  mutt_addrlist_clear(&env->sender);
  mutt_addrlist_clear(&env->reply_to);
  mutt_addrlist_clear(&env->mail_followup_to);
  mutt_addrlist_clear(&env->x_original_to);
 
  FREE(&env->list_post);
  FREE(&env->list_subscribe);
  FREE(&env->list_unsubscribe);
  FREE(&env->subject);
  /* real_subj is just an offset to subject and shouldn't be freed */
  FREE(&env->disp_subj);
  FREE(&env->message_id);
  FREE(&env->supersedes);
  FREE(&env->date);
  FREE(&env->x_label);
  FREE(&env->organization);
#ifdef USE_NNTP
  FREE(&env->newsgroups);
  FREE(&env->xref);
  FREE(&env->followup_to);
  FREE(&env->x_comment_to);
#endif
 
  buf_dealloc(&env->spam);
 
  mutt_list_free(&env->references);
  mutt_list_free(&env->in_reply_to);
  mutt_list_free(&env->userhdrs);
 
#ifdef USE_AUTOCRYPT
  mutt_autocrypthdr_free(&env->autocrypt);
  mutt_autocrypthdr_free(&env->autocrypt_gossip);
#endif
 
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_env_merge()

void mutt_env_merge	(	struct Envelope *	base,
		struct Envelope **	extra
	)

Merge the headers of two Envelopes.

Parameters

[in]	base	Envelope destination for all the headers
[out]	extra	Envelope to copy from

Any fields that are missing from base will be copied from extra. extra will be freed afterwards.

Definition at line 166 of file envelope.c.

{
  if (!base || !extra || !*extra)
    return;
 
/* copies each existing element if necessary, and sets the element
 * to NULL in the source so that mutt_env_free doesn't leave us
 * with dangling pointers. */
#define MOVE_ELEM(member)                                                      \
  if (!base->member)                                                           \
  {                                                                            \
    base->member = (*extra)->member;                                           \
    (*extra)->member = NULL;                                                   \
  }
 
#define MOVE_STAILQ(member)                                                    \
  if (STAILQ_EMPTY(&base->member))                                             \
  {                                                                            \
    STAILQ_SWAP(&base->member, &(*extra)->member, ListNode);                   \
  }
 
#define MOVE_ADDRESSLIST(member)                                               \
  if (TAILQ_EMPTY(&base->member))                                              \
  {                                                                            \
    TAILQ_SWAP(&base->member, &(*extra)->member, Address, entries);            \
  }
 
#define MOVE_BUFFER(member)                                                    \
  if (buf_is_empty(&base->member))                                             \
  {                                                                            \
    memcpy(&base->member, &(*extra)->member, sizeof(struct Buffer));           \
    buf_init(&(*extra)->member);                                               \
  }
 
  MOVE_ADDRESSLIST(return_path);
  MOVE_ADDRESSLIST(from);
  MOVE_ADDRESSLIST(to);
  MOVE_ADDRESSLIST(cc);
  MOVE_ADDRESSLIST(bcc);
  MOVE_ADDRESSLIST(sender);
  MOVE_ADDRESSLIST(reply_to);
  MOVE_ADDRESSLIST(mail_followup_to);
  MOVE_ELEM(list_post);
  MOVE_ELEM(list_subscribe);
  MOVE_ELEM(list_unsubscribe);
  MOVE_ELEM(message_id);
  MOVE_ELEM(supersedes);
  MOVE_ELEM(date);
  MOVE_ADDRESSLIST(x_original_to);
  if (!(base->changed & MUTT_ENV_CHANGED_XLABEL))
  {
    MOVE_ELEM(x_label);
  }
  if (!(base->changed & MUTT_ENV_CHANGED_REFS))
  {
    MOVE_STAILQ(references);
  }
  if (!(base->changed & MUTT_ENV_CHANGED_IRT))
  {
    MOVE_STAILQ(in_reply_to);
  }
 
  /* real_subj is subordinate to subject */
  if (!base->subject)
  {
    base->subject = (*extra)->subject;
    base->real_subj = (*extra)->real_subj;
    base->disp_subj = (*extra)->disp_subj;
    (*extra)->subject = NULL;
    (*extra)->real_subj = NULL;
    (*extra)->disp_subj = NULL;
  }
  /* spam and user headers should never be hashed, and the new envelope may
   * have better values. Use new versions regardless. */
  buf_dealloc(&base->spam);
  mutt_list_free(&base->userhdrs);
  MOVE_BUFFER(spam);
  MOVE_STAILQ(userhdrs);
#undef MOVE_ELEM
#undef MOVE_STAILQ
#undef MOVE_ADDRESSLIST
#undef MOVE_BUFFER
 
  mutt_env_free(extra);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_env_new()

struct Envelope * mutt_env_new

(

void

)

Create a new Envelope.

Return values

ptr	New Envelope

Definition at line 43 of file envelope.c.

{
  struct Envelope *env = mutt_mem_calloc(1, sizeof(struct Envelope));
  TAILQ_INIT(&env->return_path);
  TAILQ_INIT(&env->from);
  TAILQ_INIT(&env->to);
  TAILQ_INIT(&env->cc);
  TAILQ_INIT(&env->bcc);
  TAILQ_INIT(&env->sender);
  TAILQ_INIT(&env->reply_to);
  TAILQ_INIT(&env->mail_followup_to);
  TAILQ_INIT(&env->x_original_to);
  STAILQ_INIT(&env->references);
  STAILQ_INIT(&env->in_reply_to);
  STAILQ_INIT(&env->userhdrs);
  return env;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_env_notify_send()

bool mutt_env_notify_send	(	struct Email *	e,
		enum NotifyEnvelope	type
	)

Send an Envelope change notification.

Parameters

e	Email
type	Notification type, e.g. NT_ENVELOPE_SUBJECT

Return values

true	Successfully sent

Definition at line 152 of file envelope.c.

{
  struct EventEmail ev_e = { 1, &e };
  return notify_send(e->notify, NT_ENVELOPE, type, &ev_e);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_env_to_intl()

int mutt_env_to_intl	(	struct Envelope *	env,
		const char **	tag,
		char **	err
	)

Convert an Envelope's Address fields to Punycode format.

Parameters

[in]	env	Envelope to modify
[out]	tag	Name of the failed field
[out]	err	Failed address

Return values

0	Success, all addresses converted
1	Error, tag and err will be set

Run mutt_addrlist_to_intl() on each of the Address fields in the Envelope.

Definition at line 328 of file envelope.c.

{
  if (!env)
    return 1;
 
  int rc = 0;
  H_TO_INTL(return_path);
  H_TO_INTL(from);
  H_TO_INTL(to);
  H_TO_INTL(cc);
  H_TO_INTL(bcc);
  H_TO_INTL(reply_to);
  H_TO_INTL(mail_followup_to);
  return rc;
}

Here is the caller graph for this function:

mutt_env_to_local()

void mutt_env_to_local

(

struct Envelope *

env

)

Convert an Envelope's Address fields to local format.

Parameters

env	Envelope to modify

Run mutt_addrlist_to_local() on each of the Address fields in the Envelope.

Definition at line 290 of file envelope.c.

{
  if (!env)
    return;
 
  mutt_addrlist_to_local(&env->return_path);
  mutt_addrlist_to_local(&env->from);
  mutt_addrlist_to_local(&env->to);
  mutt_addrlist_to_local(&env->cc);
  mutt_addrlist_to_local(&env->bcc);
  mutt_addrlist_to_local(&env->reply_to);
  mutt_addrlist_to_local(&env->mail_followup_to);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_autocrypthdr_new()

struct AutocryptHeader * mutt_autocrypthdr_new

(

void

)

Create a new AutocryptHeader.

Return values

ptr	New AutocryptHeader

Definition at line 66 of file envelope.c.

{
  return mutt_mem_calloc(1, sizeof(struct AutocryptHeader));
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_autocrypthdr_free()

void mutt_autocrypthdr_free

(

struct AutocryptHeader **

ptr

)

Free an AutocryptHeader.

Parameters

ptr	AutocryptHeader to free

Definition at line 75 of file envelope.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct AutocryptHeader *cur = NULL;
 
  while (*ptr)
  {
    cur = *ptr;
    *ptr = (*ptr)->next;
    FREE(&cur->addr);
    FREE(&cur->keydata);
    FREE(&cur);
  }
}

Here is the caller graph for this function: