NeoMutt  2025-05-10
Teaching an old dog new tricks
 		DOXYGEN
Loading...
Searching...
No Matches
Functions
mutt_body.h File Reference

Representation of the body of an email. More...

#include <stdio.h>
+ Include dependency graph for mutt_body.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions

int mutt_body_copy (FILE *fp, struct Body **b_dst, struct Body *b_src)
 Create a send-mode duplicate from a receive-mode body.
 

Detailed Description

Representation of the body of an email.

Authors
  • 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 mutt_body.h.

Function Documentation

◆ mutt_body_copy()

int mutt_body_copy ( FILE *  fp,
struct Body **  b_dst,
struct Body *  b_src 
)

Create a send-mode duplicate from a receive-mode body.

Parameters
[in]fpFILE pointer to attachments
[out]b_dstNew Body will be saved here
[in]b_srcSource Body to copy
Return values
0Success
-1Failure

Definition at line 49 of file mutt_body.c.

50{
51 if (!b_dst || !b_src)
52 return -1;
53
54 struct Body *b = NULL;
55 bool use_disp;
56 struct Buffer *tmp = buf_pool_get();
57
58 if (b_src->filename)
59 {
60 use_disp = true;
61 buf_strcpy(tmp, b_src->filename);
62 }
63 else
64 {
65 use_disp = false;
66 }
67
68 mutt_adv_mktemp(tmp);
69 if (mutt_save_attachment(fp, b_src, buf_string(tmp), MUTT_SAVE_NO_FLAGS, NULL) == -1)
70 {
71 buf_pool_release(&tmp);
72 return -1;
73 }
74
75 *b_dst = mutt_body_new();
76 b = *b_dst;
77
78 memcpy(b, b_src, sizeof(struct Body));
79 TAILQ_INIT(&b->parameter);
80 b->parts = NULL;
81 b->next = NULL;
82
83 b->content_id = mutt_str_dup(b->content_id);
84 b->filename = buf_strdup(tmp);
85 b->use_disp = use_disp;
86 b->unlink = true;
87
88 if (mutt_is_text_part(b))
89 b->noconv = true;
90
91 b->xtype = mutt_str_dup(b->xtype);
92 b->subtype = mutt_str_dup(b->subtype);
93 b->form_name = mutt_str_dup(b->form_name);
94 b->d_filename = mutt_str_dup(b->d_filename);
95 /* mutt_adv_mktemp() will mangle the filename in tmp,
96 * so preserve it in d_filename */
97 if (!b->d_filename && use_disp)
98 b->d_filename = mutt_str_dup(b_src->filename);
99 b->description = mutt_str_dup(b->description);
100
101 b->language = mutt_str_dup(b->language);
102 b->charset = mutt_str_dup(b->charset);
103
104 b->content = NULL;
105 b->aptr = NULL;
106 b->mime_headers = NULL;
107
108 /* we don't seem to need the Email structure currently.
109 * XXX this may change in the future */
110 b->email = NULL;
111
112 /* copy parameters */
113 struct Parameter *np = NULL, *new_param = NULL;
114 TAILQ_FOREACH(np, &b_src->parameter, entries)
115 {
116 new_param = mutt_param_new();
117 new_param->attribute = mutt_str_dup(np->attribute);
118 new_param->value = mutt_str_dup(np->value);
119 TAILQ_INSERT_HEAD(&b->parameter, new_param, entries);
120 }
121
122 mutt_stamp_attachment(b);
123 buf_pool_release(&tmp);
124 return 0;
125}
buf_strcpy
size_t buf_strcpy(struct Buffer *buf, const char *s)
Copy a string into a Buffer.
Definition: buffer.c:395
buf_strdup
char * buf_strdup(const struct Buffer *buf)
Copy a Buffer's string.
Definition: buffer.c:571
buf_string
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition: buffer.h:96
mutt_body_new
struct Body * mutt_body_new(void)
Create a new Body.
Definition: body.c:44
mutt_str_dup
char * mutt_str_dup(const char *str)
Copy a string, safely.
Definition: string.c:254
mutt_save_attachment
int mutt_save_attachment(FILE *fp, struct Body *b, const char *path, enum SaveAttach opt, struct Email *e)
Save an attachment.
Definition: mutt_attach.c:905
MUTT_SAVE_NO_FLAGS
@ MUTT_SAVE_NO_FLAGS
Overwrite existing file (the default)
Definition: mutt_attach.h:58
mutt_is_text_part
bool mutt_is_text_part(const struct Body *b)
Is this part of an email in plain text?
Definition: muttlib.c:407
mutt_adv_mktemp
void mutt_adv_mktemp(struct Buffer *buf)
Create a temporary file.
Definition: muttlib.c:84
mutt_param_new
struct Parameter * mutt_param_new(void)
Create a new Parameter.
Definition: parameter.c:40
buf_pool_get
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition: pool.c:82
buf_pool_release
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition: pool.c:96
TAILQ_FOREACH
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:782
TAILQ_INIT
#define TAILQ_INIT(head)
Definition: queue.h:822
TAILQ_INSERT_HEAD
#define TAILQ_INSERT_HEAD(head, elm, field)
Definition: queue.h:853
mutt_stamp_attachment
void mutt_stamp_attachment(struct Body *b)
Timestamp an Attachment.
Definition: sendlib.c:410
Body
The body of an email.
Definition: body.h:36
Body::language
char * language
content-language (RFC8255)
Definition: body.h:78
Body::content_id
char * content_id
Content-Id (RFC2392)
Definition: body.h:58
Body::d_filename
char * d_filename
filename to be used for the content-disposition header If NULL, filename is used instead.
Definition: body.h:56
Body::parts
struct Body * parts
parts of a multipart or message/rfc822
Definition: body.h:73
Body::xtype
char * xtype
content-type if x-unknown
Definition: body.h:62
Body::noconv
bool noconv
Don't do character set conversion.
Definition: body.h:46
Body::unlink
bool unlink
If true, filename should be unlink()ed before free()ing this structure.
Definition: body.h:68
Body::mime_headers
struct Envelope * mime_headers
Memory hole protected headers.
Definition: body.h:76
Body::charset
char * charset
Send mode: charset of attached file as stored on disk.
Definition: body.h:79
Body::parameter
struct ParameterList parameter
Parameters of the content-type.
Definition: body.h:63
Body::aptr
struct AttachPtr * aptr
Menu information, used in recvattach.c.
Definition: body.h:75
Body::use_disp
bool use_disp
Content-Disposition uses filename= ?
Definition: body.h:47
Body::email
struct Email * email
header information for message/rfc822
Definition: body.h:74
Body::description
char * description
content-description
Definition: body.h:55
Body::content
struct Content * content
Detailed info about the content of the attachment.
Definition: body.h:70
Body::next
struct Body * next
next attachment in the list
Definition: body.h:72
Body::subtype
char * subtype
content-type subtype
Definition: body.h:61
Body::form_name
char * form_name
Content-Disposition form-data name param.
Definition: body.h:60
Body::filename
char * filename
When sending a message, this is the file to which this structure refers.
Definition: body.h:59
Buffer
String manipulation buffer.
Definition: buffer.h:36
Parameter
Attribute associated with a MIME part.
Definition: parameter.h:33
Parameter::attribute
char * attribute
Parameter name.
Definition: parameter.h:34
Parameter::value
char * value
Parameter value.
Definition: parameter.h:35
+ Here is the call graph for this function:
+ Here is the caller graph for this function: