attach.c File Reference

Handling of email attachments. More...

#include "config.h"
#include <string.h>
#include "mutt/lib.h"
#include "email/lib.h"
#include "attach.h"

Include dependency graph for attach.c:

Go to the source code of this file.

Functions
struct AttachPtr *	mutt_aptr_new (void)
	Create a new Attachment Pointer.
void	mutt_aptr_free (struct AttachPtr **ptr)
	Free an Attachment Pointer.
void	mutt_actx_add_attach (struct AttachCtx *actx, struct AttachPtr *attach)
	Add an Attachment to an Attachment Context.
void	mutt_actx_ins_attach (struct AttachCtx *actx, struct AttachPtr *attach, int aidx)
	Insert an Attachment into an Attachment Context at Specified Index.
void	mutt_actx_add_fp (struct AttachCtx *actx, FILE *fp_new)
	Save a File handle to the Attachment Context.
void	mutt_actx_add_body (struct AttachCtx *actx, struct Body *b)
	Add an email body to an Attachment Context.
void	mutt_actx_entries_free (struct AttachCtx *actx)
	Free entries in an Attachment Context.
struct AttachCtx *	mutt_actx_new (void)
	Create a new Attachment Context.
void	mutt_actx_free (struct AttachCtx **ptr)
	Free an Attachment Context.

Detailed Description

Handling of email attachments.

Authors

• Richard Russon
• David Purton

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

Function Documentation

mutt_aptr_new()

struct AttachPtr * mutt_aptr_new

(

void

)

Create a new Attachment Pointer.

Return values

ptr	New Attachment Pointer

Definition at line 40 of file attach.c.

{
  return MUTT_MEM_CALLOC(1, struct AttachPtr);
}

Here is the caller graph for this function:

mutt_aptr_free()

void mutt_aptr_free

(

struct AttachPtr **

ptr

)

Free an Attachment Pointer.

Parameters

[out]

ptr

Attachment Pointer

Definition at line 49 of file attach.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct AttachPtr *aptr = *ptr;
  FREE(&aptr->tree);
 
  FREE(ptr);
}

Here is the caller graph for this function:

mutt_actx_add_attach()

void mutt_actx_add_attach	(	struct AttachCtx *	actx,
		struct AttachPtr *	attach )

Add an Attachment to an Attachment Context.

Parameters

actx	Attachment context
attach	Attachment to add

Definition at line 65 of file attach.c.

{
  const int grow = 5;
 
  if (!actx || !attach)
    return;
 
  if (actx->idxlen == actx->idxmax)
  {
    actx->idxmax += grow;
    MUTT_MEM_REALLOC(&actx->idx, actx->idxmax, struct AttachPtr *);
    MUTT_MEM_REALLOC(&actx->v2r, actx->idxmax, short);
 
    memset(&actx->idx[actx->idxlen], 0, grow * sizeof(struct AttachPtr *));
    memset(&actx->v2r[actx->idxlen], 0, grow * sizeof(short));
  }
 
  actx->idx[actx->idxlen++] = attach;
}

Here is the caller graph for this function:

mutt_actx_ins_attach()

void mutt_actx_ins_attach	(	struct AttachCtx *	actx,
		struct AttachPtr *	attach,
		int	aidx )

Insert an Attachment into an Attachment Context at Specified Index.

Parameters

actx	Attachment context
attach	Attachment to insert
aidx	Index to insert attachment at

Definition at line 91 of file attach.c.

{
  if (!actx || !attach)
    return;
 
  if ((aidx < 0) || (aidx > actx->idxmax))
    return;
 
  if (actx->idxlen == actx->idxmax)
  {
    actx->idxmax += 5;
    MUTT_MEM_REALLOC(&actx->idx, actx->idxmax, struct AttachPtr *);
    MUTT_MEM_REALLOC(&actx->v2r, actx->idxmax, short);
    for (int i = actx->idxlen; i < actx->idxmax; i++)
      actx->idx[i] = NULL;
  }
 
  actx->idxlen++;
 
  for (int i = actx->idxlen - 1; i > aidx; i--)
    actx->idx[i] = actx->idx[i - 1];
 
  actx->idx[aidx] = attach;
}

Here is the caller graph for this function:

mutt_actx_add_fp()

void mutt_actx_add_fp	(	struct AttachCtx *	actx,
		FILE *	fp_new )

Save a File handle to the Attachment Context.

Parameters

actx	Attachment context
fp_new	File handle to save

Definition at line 121 of file attach.c.

{
  if (!actx || !fp_new)
    return;
 
  if (actx->fp_len == actx->fp_max)
  {
    actx->fp_max += 5;
    MUTT_MEM_REALLOC(&actx->fp_idx, actx->fp_max, FILE *);
    for (int i = actx->fp_len; i < actx->fp_max; i++)
      actx->fp_idx[i] = NULL;
  }
 
  actx->fp_idx[actx->fp_len++] = fp_new;
}

Here is the caller graph for this function:

mutt_actx_add_body()

void mutt_actx_add_body	(	struct AttachCtx *	actx,
		struct Body *	b )

Add an email body to an Attachment Context.

Parameters

actx	Attachment context
b	Email Body to add

Definition at line 142 of file attach.c.

{
  if (!actx || !b)
    return;
 
  if (actx->body_len == actx->body_max)
  {
    actx->body_max += 5;
    MUTT_MEM_REALLOC(&actx->body_idx, actx->body_max, struct Body *);
    for (int i = actx->body_len; i < actx->body_max; i++)
      actx->body_idx[i] = NULL;
  }
 
  actx->body_idx[actx->body_len++] = b;
}

Here is the caller graph for this function:

mutt_actx_entries_free()

void mutt_actx_entries_free

(

struct AttachCtx *

actx

)

Free entries in an Attachment Context.

Parameters

actx	Attachment context

Definition at line 162 of file attach.c.

{
  if (!actx)
    return;
 
  for (int i = 0; i < actx->idxlen; i++)
  {
    if (actx->idx[i]->body)
      actx->idx[i]->body->aptr = NULL;
    mutt_aptr_free(&actx->idx[i]);
  }
  actx->idxlen = 0;
  actx->vcount = 0;
 
  for (int i = 0; i < actx->fp_len; i++)
    mutt_file_fclose(&actx->fp_idx[i]);
  actx->fp_len = 0;
 
  for (int i = 0; i < actx->body_len; i++)
    mutt_body_free(&actx->body_idx[i]);
  actx->body_len = 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_actx_new()

struct AttachCtx * mutt_actx_new

(

void

)

Create a new Attachment Context.

Return values

ptr	New Attachment Context

Definition at line 189 of file attach.c.

{
  return MUTT_MEM_CALLOC(1, struct AttachCtx);
}

Here is the caller graph for this function:

mutt_actx_free()

void mutt_actx_free

(

struct AttachCtx **

ptr

)

Free an Attachment Context.

Parameters

[out]

ptr

Attachment context

Definition at line 198 of file attach.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct AttachCtx *actx = *ptr;
 
  mutt_actx_entries_free(actx);
  FREE(&actx->idx);
  FREE(&actx->v2r);
  FREE(&actx->fp_idx);
  FREE(&actx->body_idx);
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function: