NeoMutt  2025-12-11-980-ge38c27
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
body.c
Go to the documentation of this file.
1
23
29
30#include "config.h"
31#include <stdbool.h>
32#include <unistd.h>
33#include "mutt/lib.h"
34#include "body.h"
35#include "email.h"
36#include "envelope.h"
37#include "mime.h"
38#include "parameter.h"
39
44struct Body *mutt_body_new(void)
45{
46 struct Body *p = MUTT_MEM_CALLOC(1, struct Body);
47
49 p->use_disp = true;
51 return p;
52}
53
58void mutt_body_free(struct Body **ptr)
59{
60 if (!ptr || !*ptr)
61 return;
62
63 struct Body *a = *ptr;
64 struct Body *b = NULL;
65
66 while (a)
67 {
68 b = a;
69 a = a->next;
70
72 if (b->filename)
73 {
74 if (b->unlink)
75 unlink(b->filename);
76 mutt_debug(LL_DEBUG1, "%sunlinking %s\n", b->unlink ? "" : "not ", b->filename);
77 }
78
79 FREE(&b->content_id);
80 FREE(&b->filename);
81 FREE(&b->d_filename);
82 FREE(&b->charset);
83 FREE(&b->content);
84 FREE(&b->xtype);
85 FREE(&b->subtype);
86 FREE(&b->language);
87 FREE(&b->description);
88 FREE(&b->form_name);
89
90 if (b->email)
91 {
92 /* Don't free twice (b->email->body = b->parts) */
93 b->email->body = NULL;
94 email_free(&b->email);
95 }
96
99 FREE(&b);
100 }
101
102 *ptr = NULL;
103}
104
111bool mutt_body_cmp_strict(const struct Body *b1, const struct Body *b2)
112{
113 if (!b1 || !b2)
114 return false;
115
116 if ((b1->type != b2->type) || (b1->encoding != b2->encoding) ||
117 !mutt_str_equal(b1->subtype, b2->subtype) ||
119 !mutt_param_cmp_strict(&b1->parameter, &b2->parameter) || (b1->length != b2->length))
120 {
121 return false;
122 }
123 return true;
124}
125
134char *mutt_body_get_charset(struct Body *b, char *buf, size_t buflen)
135{
136 char *p = NULL;
137
138 if (b && (b->type != TYPE_TEXT))
139 return NULL;
140
141 if (b)
142 p = mutt_param_get(&b->parameter, "charset");
143
144 if (p)
145 mutt_ch_canonical_charset(buf, buflen, p);
146 else
147 mutt_str_copy(buf, "us-ascii", buflen);
148
149 return buf;
150}
void mutt_body_free(struct Body **ptr)
Free a Body.
Definition body.c:58
struct Body * mutt_body_new(void)
Create a new Body.
Definition body.c:44
char * mutt_body_get_charset(struct Body *b, char *buf, size_t buflen)
Get a body's character set.
Definition body.c:134
bool mutt_body_cmp_strict(const struct Body *b1, const struct Body *b2)
Strictly compare two email Body's.
Definition body.c:111
Representation of the body of an email.
void email_free(struct Email **ptr)
Free an Email.
Definition email.c:46
Representation of an email.
void mutt_env_free(struct Envelope **ptr)
Free an Envelope.
Definition envelope.c:125
Representation of an email header (envelope)
#define mutt_debug(LEVEL,...)
Definition logging2.h:91
@ LL_DEBUG1
Log at debug level 1.
Definition logging2.h:45
#define FREE(x)
Free memory and set the pointer to NULL.
Definition memory.h:68
#define MUTT_MEM_CALLOC(n, type)
Definition memory.h:52
Constants and macros for managing MIME encoding.
@ TYPE_TEXT
Type: 'text/*'.
Definition mime.h:38
@ DISP_ATTACH
Content is attached.
Definition mime.h:63
void mutt_ch_canonical_charset(char *buf, size_t buflen, const char *name)
Canonicalise the charset of a string.
Definition charset.c:361
Convenience wrapper for the library headers.
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition string.c:666
size_t mutt_str_copy(char *dest, const char *src, size_t dsize)
Copy a string into a buffer (guaranteeing NUL-termination)
Definition string.c:587
bool mutt_param_cmp_strict(const struct ParameterList *pl1, const struct ParameterList *pl2)
Strictly compare two ParameterLists.
Definition parameter.c:166
char * mutt_param_get(const struct ParameterList *pl, const char *s)
Find a matching Parameter.
Definition parameter.c:85
void mutt_param_free(struct ParameterList *pl)
Free a ParameterList.
Definition parameter.c:62
Store attributes associated with a MIME part.
#define TAILQ_INIT(head)
Definition queue.h:822
The body of an email.
Definition body.h:36
char * language
content-language (RFC8255)
Definition body.h:78
char * content_id
Content-Id (RFC2392)
Definition body.h:58
char * d_filename
filename to be used for the content-disposition header If NULL, filename is used instead.
Definition body.h:56
struct Body * parts
parts of a multipart or message/rfc822
Definition body.h:73
char * xtype
content-type if x-unknown
Definition body.h:62
bool unlink
If true, filename should be unlink()ed before free()ing this structure.
Definition body.h:68
struct Envelope * mime_headers
Memory hole protected headers.
Definition body.h:76
LOFF_T length
length (in bytes) of attachment
Definition body.h:53
char * charset
Send mode: charset of attached file as stored on disk.
Definition body.h:79
struct ParameterList parameter
Parameters of the content-type.
Definition body.h:63
bool use_disp
Content-Disposition uses filename= ?
Definition body.h:47
struct Email * email
header information for message/rfc822
Definition body.h:74
char * description
content-description
Definition body.h:55
unsigned int disposition
content-disposition, ContentDisposition
Definition body.h:42
struct Content * content
Detailed info about the content of the attachment.
Definition body.h:70
struct Body * next
next attachment in the list
Definition body.h:72
char * subtype
content-type subtype
Definition body.h:61
unsigned int encoding
content-transfer-encoding, ContentEncoding
Definition body.h:41
char * form_name
Content-Disposition form-data name param.
Definition body.h:60
unsigned int type
content-type primary type, ContentType
Definition body.h:40
char * filename
When sending a message, this is the file to which this structure refers.
Definition body.h:59
struct Body * body
List of MIME parts.
Definition email.h:69