NeoMutt  2023-03-22-27-g3cb248
Teaching an old dog new tricks
multipart.c File Reference

Manipulate multipart Emails. More...

#include "config.h"
#include <stddef.h>
#include <stdbool.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.


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

Detailed Description

Manipulate multipart Emails.

  • Michael R. Elkins
  • Pietro Cerutti

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

Definition in file multipart.c.

Function Documentation

◆ get_toplevel_encoding()

static int get_toplevel_encoding ( struct Body a)

Find the most restrictive encoding type.

aBody to examine
Return values
numEncoding type, e.g. ENC_7BIT

Definition at line 43 of file multipart.c.

45 int e = ENC_7BIT;
47 for (; a; a = a->next)
48 {
49 if (a->encoding == ENC_BINARY)
50 return ENC_BINARY;
51 if (a->encoding == ENC_8BIT)
52 e = ENC_8BIT;
53 }
55 return e;
7-bit text
Definition: mime.h:49
Definition: mime.h:53
8-bit text
Definition: mime.h:50
struct Body * next
next attachment in the list
Definition: body.h:71
unsigned int encoding
content-transfer-encoding, ContentEncoding
Definition: body.h:41
+ Here is the caller graph for this function:

◆ check_boundary()

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

Check for duplicate boundary.

boundaryBoundary to look for
bBody parts to check
Return values
trueDuplicate found

Definition at line 64 of file multipart.c.

66 char *p = NULL;
68 if (b->parts && check_boundary(boundary, b->parts))
69 return true;
71 if (b->next && check_boundary(boundary, b->next))
72 return true;
74 p = mutt_param_get(&b->parameter, "boundary");
75 if (p && mutt_str_equal(p, boundary))
76 {
77 return true;
78 }
79 return false;
static bool check_boundary(const char *boundary, struct Body *b)
Check for duplicate boundary.
Definition: multipart.c:64
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition: string.c:807
char * mutt_param_get(const struct ParameterList *pl, const char *s)
Find a matching Parameter.
Definition: parameter.c:84
struct Body * parts
parts of a multipart or message/rfc822
Definition: body.h:72
struct ParameterList parameter
Parameters of the content-type.
Definition: body.h:62
+ 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.

plMIME part

Definition at line 86 of file multipart.c.

88 char rs[MUTT_RANDTAG_LEN + 1];
90 mutt_rand_base32(rs, sizeof(rs) - 1);
91 rs[MUTT_RANDTAG_LEN] = 0;
92 mutt_param_set(pl, "boundary", rs);
void mutt_param_set(struct ParameterList *pl, const char *attribute, const char *value)
Set a Parameter.
Definition: parameter.c:110
void mutt_rand_base32(char *buf, size_t buflen)
Fill a buffer with a base32-encoded random string.
Definition: random.c:102
Definition: sendlib.h:35
+ 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.

bBody of email to start
Return values
ptrNewly allocated Body

Definition at line 100 of file multipart.c.

102 struct Body *new_body = mutt_body_new();
103 new_body->type = TYPE_MULTIPART;
104 new_body->subtype = mutt_str_dup("mixed");
105 new_body->encoding = get_toplevel_encoding(b);
106 do
107 {
109 if (check_boundary(mutt_param_get(&new_body->parameter, "boundary"), b))
110 mutt_param_delete(&new_body->parameter, "boundary");
111 } while (!mutt_param_get(&new_body->parameter, "boundary"));
112 new_body->use_disp = false;
113 new_body->disposition = DISP_INLINE;
114 new_body->parts = b;
116 return new_body;
struct Body * mutt_body_new(void)
Create a new Body.
Definition: body.c:43
Type: 'multipart/*'.
Definition: mime.h:37
Content is inline.
Definition: mime.h:62
static int get_toplevel_encoding(struct Body *a)
Find the most restrictive encoding type.
Definition: multipart.c:43
void mutt_generate_boundary(struct ParameterList *pl)
Create a unique boundary id for a MIME part.
Definition: multipart.c:86
char * mutt_str_dup(const char *str)
Copy a string, safely.
Definition: string.c:250
void mutt_param_delete(struct ParameterList *pl, const char *attribute)
Delete a matching Parameter.
Definition: parameter.c:142
The body of an email.
Definition: body.h:36
bool use_disp
Content-Disposition uses filename= ?
Definition: body.h:47
unsigned int disposition
content-disposition, ContentDisposition
Definition: body.h:42
char * subtype
content-type subtype
Definition: body.h:60
unsigned int type
content-type primary type, ContentType
Definition: body.h:40
+ 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.

bBody to alter
Return values
ptrThe parts of the Body
The original Body is freed

Definition at line 126 of file multipart.c.

128 struct Body *t = NULL;
130 if (b->parts)
131 {
132 t = b;
133 b = b->parts;
134 t->parts = NULL;
135 mutt_body_free(&t);
136 }
137 return b;
void mutt_body_free(struct Body **ptr)
Free a Body.
Definition: body.c:57
+ Here is the call graph for this function:
+ Here is the caller graph for this function: