NeoMutt  2024-03-23-147-g885fbc
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
multipart.h File Reference

Manipulate multipart Emails. More...

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

Go to the source code of this file.

Functions

void mutt_generate_boundary (struct ParameterList *pl)
 Create a unique boundary id for a MIME part.
 
struct Bodymutt_make_multipart (struct Body *b)
 Create a multipart email.
 
struct Bodymutt_remove_multipart (struct Body *b)
 Extract the multipart body if it exists.
 

Detailed Description

Manipulate multipart Emails.

Authors
  • Richard Russon

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

Function Documentation

◆ 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}
void mutt_param_set(struct ParameterList *pl, const char *attribute, const char *value)
Set a Parameter.
Definition: parameter.c:111
void mutt_rand_base32(char *buf, size_t buflen)
Fill a buffer with a base32-encoded random string.
Definition: random.c:105
#define MUTT_RANDTAG_LEN
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.

Parameters
bBody of email to start
Return values
ptrNewly allocated Body

Definition at line 100 of file multipart.c.

101{
102 struct Body *b_new = mutt_body_new();
103 b_new->type = TYPE_MULTIPART;
104 b_new->subtype = mutt_str_dup("mixed");
106 do
107 {
109 if (check_boundary(mutt_param_get(&b_new->parameter, "boundary"), b))
110 mutt_param_delete(&b_new->parameter, "boundary");
111 } while (!mutt_param_get(&b_new->parameter, "boundary"));
112 b_new->use_disp = false;
113 b_new->disposition = DISP_INLINE;
114 b_new->parts = b;
115
116 return b_new;
117}
struct Body * mutt_body_new(void)
Create a new Body.
Definition: body.c:44
@ TYPE_MULTIPART
Type: 'multipart/*'.
Definition: mime.h:37
@ DISP_INLINE
Content is inline.
Definition: mime.h:62
static int get_toplevel_encoding(struct Body *b)
Find the most restrictive encoding type.
Definition: multipart.c:43
static bool check_boundary(const char *boundary, struct Body *b)
Check for duplicate boundary.
Definition: multipart.c:64
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:253
char * mutt_param_get(const struct ParameterList *pl, const char *s)
Find a matching Parameter.
Definition: parameter.c:85
void mutt_param_delete(struct ParameterList *pl, const char *attribute)
Delete a matching Parameter.
Definition: parameter.c:143
The body of an email.
Definition: body.h:36
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
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 encoding
content-transfer-encoding, ContentEncoding
Definition: body.h:41
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.

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}
void mutt_body_free(struct Body **ptr)
Free a Body.
Definition: body.c:58
+ Here is the call graph for this function:
+ Here is the caller graph for this function: