NeoMutt  2021-02-05-666-ge300cd
Teaching an old dog new tricks
DOXYGEN
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.

Functions

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.

Authors
  • 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 http://www.gnu.org/licenses/.

Definition in file multipart.c.

Function Documentation

◆ get_toplevel_encoding()

static int get_toplevel_encoding ( struct Body a)
static

Find the most restrictive encoding type.

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

Definition at line 43 of file multipart.c.

44 {
45  int e = ENC_7BIT;
46 
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  }
54 
55  return e;
56 }
7-bit text
Definition: mime.h:49
struct Body * next
next attachment in the list
Definition: body.h:53
8-bit text
Definition: mime.h:50
unsigned int encoding
content-transfer-encoding, ContentEncoding
Definition: body.h:66
Binary.
Definition: mime.h:53
+ Here is the caller graph for this function:

◆ check_boundary()

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

check for duplicate boundary

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

Definition at line 64 of file multipart.c.

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

Definition at line 86 of file multipart.c.

87 {
88  char rs[MUTT_RANDTAG_LEN + 1];
89 
90  mutt_rand_base32(rs, sizeof(rs) - 1);
91  rs[MUTT_RANDTAG_LEN] = 0;
92  mutt_param_set(pl, "boundary", rs);
93 }
#define MUTT_RANDTAG_LEN
Definition: sendlib.h:35
void mutt_rand_base32(char *buf, size_t buflen)
Fill a buffer with a base32-encoded random string.
Definition: random.c:103
void mutt_param_set(struct ParameterList *pl, const char *attribute, const char *value)
Set a Parameter.
Definition: parameter.c:110
+ 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
bBody of email to start
Return values
ptrNewly allocated Body

Definition at line 100 of file multipart.c.

101 {
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  {
108  mutt_generate_boundary(&new_body->parameter);
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;
115 
116  return new_body;
117 }
char * mutt_str_dup(const char *str)
Copy a string, safely.
Definition: string.c:370
The body of an email.
Definition: body.h:34
unsigned int disposition
content-disposition, ContentDisposition
Definition: body.h:67
struct Body * mutt_body_new(void)
Create a new Body.
Definition: body.c:43
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
unsigned int encoding
content-transfer-encoding, ContentEncoding
Definition: body.h:66
char * subtype
content-type subtype
Definition: body.h:37
void mutt_param_delete(struct ParameterList *pl, const char *attribute)
Delete a matching Parameter.
Definition: parameter.c:142
static bool check_boundary(const char *boundary, struct Body *b)
check for duplicate boundary
Definition: multipart.c:64
struct Body * parts
parts of a multipart or message/rfc822
Definition: body.h:54
unsigned int type
content-type primary type, ContentType
Definition: body.h:65
Type: &#39;multipart/*&#39;.
Definition: mime.h:37
bool use_disp
Content-Disposition uses filename= ?
Definition: body.h:68
char * mutt_param_get(const struct ParameterList *pl, const char *s)
Find a matching Parameter.
Definition: parameter.c:84
Content is inline.
Definition: mime.h:62
struct ParameterList parameter
parameters of the content-type
Definition: body.h:39
+ 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
bBody to alter
Return values
ptrThe parts of the Body
Note
The original Body is freed

Definition at line 126 of file multipart.c.

127 {
128  struct Body *t = NULL;
129 
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;
138 }
The body of an email.
Definition: body.h:34
struct Body * parts
parts of a multipart or message/rfc822
Definition: body.h:54
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: