multipart.c File Reference

Manipulate multipart Emails. More...

#include "config.h"
#include <stdbool.h>
#include <stddef.h>
#include "mutt/lib.h"
#include "email/lib.h"
#include "multipart.h"
#include "sendlib.h"

Include dependency graph for multipart.c:

Go to the source code of this file.

Macros
#define	BOUNDARY_MAX_DEPTH   50
	Maximum MIME nesting depth for boundary checking.

Functions
static int	get_toplevel_encoding (struct Body *b)
	Find the most restrictive encoding type.
static bool	check_boundary (const char *boundary, struct Body *b, int depth)
	Check for duplicate boundary.
void	mutt_generate_boundary (struct ParameterList *pl)
	Create a unique boundary id for a MIME part.
struct Body *	mutt_make_multipart (struct Body *b)
	Create a multipart email.
struct Body *	mutt_remove_multipart (struct Body *b)
	Extract the multipart body if it exists.

Detailed Description

Manipulate multipart Emails.

Authors

• Pietro Cerutti
• 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 multipart.c.

Macro Definition Documentation

BOUNDARY_MAX_DEPTH

#define BOUNDARY_MAX_DEPTH   50

Maximum MIME nesting depth for boundary checking.

Definition at line 59 of file multipart.c.

Function Documentation

get_toplevel_encoding()

static int get_toplevel_encoding ( struct Body * b )

static

Find the most restrictive encoding type.

Parameters

b	Body to examine

Return values

num	Encoding type, e.g. ENC_7BIT

Definition at line 43 of file multipart.c.

{
  int e = ENC_7BIT;
 
  for (; b; b = b->next)
  {
    if (b->encoding == ENC_BINARY)
      return ENC_BINARY;
    if (b->encoding == ENC_8BIT)
      e = ENC_8BIT;
  }
 
  return e;
}

Here is the caller graph for this function:

check_boundary()

static bool check_boundary ( const char * boundary, struct Body * b, int depth )

static

Check for duplicate boundary.

Parameters

boundary	Boundary to look for
b	Body parts to check
depth	Current recursion depth

Return values

true	Duplicate found

Definition at line 68 of file multipart.c.

{
  if (depth >= BOUNDARY_MAX_DEPTH)
    return false;
 
  char *p = NULL;
 
  if (b->parts && check_boundary(boundary, b->parts, depth + 1))
    return true;
 
  if (b->next && check_boundary(boundary, b->next, depth))
    return true;
 
  p = mutt_param_get(&b->parameter, "boundary");
  if (p && mutt_str_equal(p, boundary))
  {
    return true;
  }
  return false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_generate_boundary()

void mutt_generate_boundary

(

struct ParameterList *

pl

)

Create a unique boundary id for a MIME part.

Parameters

pl

MIME part

Definition at line 93 of file multipart.c.

{
  char rs[MUTT_RANDTAG_LEN + 1];
 
  mutt_rand_base32(rs, sizeof(rs) - 1);
  rs[MUTT_RANDTAG_LEN] = 0;
  mutt_param_set(pl, "boundary", rs);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_make_multipart()

struct Body * mutt_make_multipart

(

struct Body *

b

)

Create a multipart email.

Parameters

b	Body of email to start

Return values

ptr	Newly allocated Body

Definition at line 107 of file multipart.c.

{
  struct Body *b_new = mutt_body_new();
  b_new->type = TYPE_MULTIPART;
  b_new->subtype = mutt_str_dup("mixed");
  b_new->encoding = get_toplevel_encoding(b);
  do
  {
    mutt_generate_boundary(&b_new->parameter);
    if (check_boundary(mutt_param_get(&b_new->parameter, "boundary"), b, 0))
      mutt_param_delete(&b_new->parameter, "boundary");
  } while (!mutt_param_get(&b_new->parameter, "boundary"));
  b_new->use_disp = false;
  b_new->disposition = DISP_INLINE;
  b_new->parts = b;
 
  return b_new;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_remove_multipart()

struct Body * mutt_remove_multipart

(

struct Body *

b

)

Extract the multipart body if it exists.

Parameters

b	Body to alter

Return values

ptr	The parts of the Body

Note

The original Body is freed

Definition at line 133 of file multipart.c.

{
  struct Body *t = NULL;
 
  if (b->parts)
  {
    t = b;
    b = b->parts;
    t->parts = NULL;
    mutt_body_free(&t);
  }
  return b;
}

Here is the call graph for this function:

Here is the caller graph for this function: