blob: 78f78bbcc07f0954a8d5dff06f2e91155d96acfc
1 | /* vi: set sw=4 ts=4: */ |
2 | /* |
3 | * makemime: create MIME-encoded message |
4 | * |
5 | * Copyright (C) 2008 by Vladimir Dronnikov <dronnikov@gmail.com> |
6 | * |
7 | * Licensed under GPLv2, see file LICENSE in this source tree. |
8 | */ |
9 | //config:config MAKEMIME |
10 | //config: bool "makemime" |
11 | //config: default y |
12 | //config: help |
13 | //config: Create MIME-formatted messages. |
14 | |
15 | //applet:IF_MAKEMIME(APPLET(makemime, BB_DIR_BIN, BB_SUID_DROP)) |
16 | |
17 | //kbuild:lib-$(CONFIG_MAKEMIME) += makemime.o mail.o |
18 | |
19 | #include "libbb.h" |
20 | #include "mail.h" |
21 | |
22 | #if 0 |
23 | # define dbg_error_msg(...) bb_error_msg(__VA_ARGS__) |
24 | #else |
25 | # define dbg_error_msg(...) ((void)0) |
26 | #endif |
27 | |
28 | /* |
29 | makemime -c type [-o file] [-e encoding] [-C charset] [-N name] \ |
30 | [-a "Header: Contents"] file |
31 | -m [ type ] [-o file] [-e encoding] [-a "Header: Contents"] file |
32 | -j [-o file] file1 file2 |
33 | @file |
34 | |
35 | file: filename - read or write from filename |
36 | - - read or write from stdin or stdout |
37 | &n - read or write from file descriptor n |
38 | \( opts \) - read from child process, that generates [ opts ] |
39 | |
40 | Options: |
41 | -c type - create a new MIME section from "file" with this |
42 | Content-Type: (default is application/octet-stream). |
43 | -C charset - MIME charset of a new text/plain section. |
44 | -N name - MIME content name of the new mime section. |
45 | -m [ type ] - create a multipart mime section from "file" of this |
46 | Content-Type: (default is multipart/mixed). |
47 | -e encoding - use the given encoding (7bit, 8bit, quoted-printable, |
48 | or base64), instead of guessing. Omit "-e" and use |
49 | -c auto to set Content-Type: to text/plain or |
50 | application/octet-stream based on picked encoding. |
51 | -j file1 file2 - join mime section file2 to multipart section file1. |
52 | -o file - write the result to file, instead of stdout (not |
53 | allowed in child processes). |
54 | -a header - prepend an additional header to the output. |
55 | |
56 | @file - read all of the above options from file, one option or |
57 | value on each line. |
58 | {which version of makemime is this? What do we support?} |
59 | */ |
60 | /* man makemime: |
61 | |
62 | * -c TYPE: create a (non-multipart) MIME section with Content-Type: TYPE |
63 | * makemime -c TYPE [-e ENCODING] [-o OUTFILE] [-C CHARSET] [-N NAME] [-a HEADER...] FILE |
64 | * The -C option sets the MIME charset attribute for text/plain content. |
65 | * The -N option sets the name attribute for Content-Type: |
66 | * Encoding must be one of the following: 7bit, 8bit, quoted-printable, or base64. |
67 | |
68 | * -m multipart/TYPE: create a multipart MIME collection with Content-Type: multipart/TYPE |
69 | * makemime -m multipart/TYPE [-e ENCODING] [-o OUTFILE] [-a HEADER...] FILE |
70 | * Type must be either "multipart/mixed", "multipart/alternative", or some other MIME multipart content type. |
71 | * Additionally, encoding can only be "7bit" or "8bit", and will default to "8bit" if not specified. |
72 | * Finally, filename must be a MIME-formatted section, NOT a regular file. |
73 | * The -m option creates an initial multipart MIME collection, that contains only one MIME section, taken from filename. |
74 | * The collection is written to standard output, or the pipe or to outputfile. |
75 | |
76 | * -j FILE1: add a section to a multipart MIME collection |
77 | * makemime -j FILE1 [-o OUTFILE] FILE2 |
78 | * FILE1 must be a MIME collection that was previously created by the -m option. |
79 | * FILE2 must be a MIME section that was previously created by the -c option. |
80 | * The -j options adds the MIME section in FILE2 to the MIME collection in FILE1. |
81 | */ |
82 | |
83 | |
84 | /* In busybox 1.15.0.svn, makemime generates output like this |
85 | * (empty lines are shown exactly!): |
86 | {headers added with -a HDR} |
87 | Mime-Version: 1.0 |
88 | Content-Type: multipart/mixed; boundary="24269534-2145583448-1655890676" |
89 | |
90 | --24269534-2145583448-1655890676 |
91 | Content-Type: {set by -c, e.g. text/plain}; charset={set by -C, e.g. us-ascii} |
92 | Content-Disposition: inline; filename="A" |
93 | Content-Transfer-Encoding: base64 |
94 | |
95 | ...file A contents... |
96 | --24269534-2145583448-1655890676 |
97 | Content-Type: {set by -c, e.g. text/plain}; charset={set by -C, e.g. us-ascii} |
98 | Content-Disposition: inline; filename="B" |
99 | Content-Transfer-Encoding: base64 |
100 | |
101 | ...file B contents... |
102 | --24269534-2145583448-1655890676-- |
103 | |
104 | * |
105 | * For reference: here is an example email to LKML which has |
106 | * 1st unnamed part (so it serves as an email body) |
107 | * and one attached file: |
108 | ...other headers... |
109 | Content-Type: multipart/mixed; boundary="=-tOfTf3byOS0vZgxEWcX+" |
110 | ...other headers... |
111 | Mime-Version: 1.0 |
112 | ...other headers... |
113 | |
114 | |
115 | --=-tOfTf3byOS0vZgxEWcX+ |
116 | Content-Type: text/plain |
117 | Content-Transfer-Encoding: 7bit |
118 | |
119 | ...email text... |
120 | ...email text... |
121 | |
122 | |
123 | --=-tOfTf3byOS0vZgxEWcX+ |
124 | Content-Disposition: attachment; filename="xyz" |
125 | Content-Type: text/plain; name="xyz"; charset="UTF-8" |
126 | Content-Transfer-Encoding: 7bit |
127 | |
128 | ...file contents... |
129 | ...file contents... |
130 | |
131 | --=-tOfTf3byOS0vZgxEWcX+-- |
132 | |
133 | ...random junk added by mailing list robots and such... |
134 | */ |
135 | |
136 | //usage:#define makemime_trivial_usage |
137 | //usage: "[OPTIONS] [FILE]..." |
138 | //usage:#define makemime_full_usage "\n\n" |
139 | //usage: "Create multipart MIME-encoded message from FILEs\n" |
140 | /* //usage: "Transfer encoding is base64, disposition is inline (not attachment)\n" */ |
141 | //usage: "\n -o FILE Output. Default: stdout" |
142 | //usage: "\n -a HDR Add header(s). Examples:" |
143 | //usage: "\n \"From: user@host.org\", \"Date: `date -R`\"" |
144 | //usage: "\n -c CT Content type. Default: application/octet-stream" |
145 | //usage: "\n -C CS Charset. Default: " CONFIG_FEATURE_MIME_CHARSET |
146 | /* //usage: "\n -e ENC Transfer encoding. Ignored. base64 is assumed" */ |
147 | //usage: "\n" |
148 | //usage: "\nOther options are silently ignored" |
149 | |
150 | /* |
151 | * -c [Content-Type] should create just one MIME section |
152 | * with "Content-Type:", "Content-Transfer-Encoding:", and HDRs from "-a HDR". |
153 | * NB: without "Content-Disposition:" auto-added, unlike we do now |
154 | * NB2: -c has *optional* param which nevertheless _can_ be specified after a space :( |
155 | * |
156 | * -m [multipart/mixed] should create multipart MIME section |
157 | * with "Content-Type:", "Content-Transfer-Encoding:", and HDRs from "-a HDR", |
158 | * and add FILE to it _verbatim_: |
159 | * HEADERS |
160 | * |
161 | * --=_1_1321709112_1605 |
162 | * FILE_CONTENTS |
163 | * --=_1_1321709112_1605 |
164 | * without any encoding of FILE_CONTENTS. (Basically, it expects that FILE |
165 | * is the result of "makemime -c"). |
166 | * |
167 | * -j MULTIPART_FILE1 SINGLE_FILE2 should output MULTIPART_FILE1 + SINGLE_FILE2 |
168 | * |
169 | * Our current behavior is a mutant "-m + -c + -j" one: we create multipart MIME |
170 | * and we put "-c" encoded FILEs into many multipart sections. |
171 | */ |
172 | |
173 | int makemime_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE; |
174 | int makemime_main(int argc UNUSED_PARAM, char **argv) |
175 | { |
176 | llist_t *opt_headers = NULL, *l; |
177 | const char *opt_output; |
178 | const char *content_type = "application/octet-stream"; |
179 | #define boundary opt_output |
180 | enum { |
181 | OPT_c = 1 << 0, // create (non-multipart) section |
182 | OPT_e = 1 << 1, // Content-Transfer-Encoding. Ignored. Assumed base64 |
183 | OPT_o = 1 << 2, // output to |
184 | OPT_C = 1 << 3, // charset |
185 | OPT_N = 1 << 4, // COMPAT |
186 | OPT_a = 1 << 5, // additional headers |
187 | //OPT_m = 1 << 6, // create mutipart section |
188 | //OPT_j = 1 << 7, // join section to multipart section |
189 | }; |
190 | |
191 | INIT_G(); |
192 | |
193 | // parse options |
194 | opts = getopt32(argv, |
195 | "c:e:o:C:N:a:*", // "m:j:", |
196 | &content_type, NULL, &opt_output, &G.opt_charset, NULL, &opt_headers //, NULL, NULL |
197 | ); |
198 | //argc -= optind; |
199 | argv += optind; |
200 | |
201 | // respect -o output |
202 | if (opts & OPT_o) |
203 | freopen(opt_output, "w", stdout); |
204 | |
205 | // no files given on command line? -> use stdin |
206 | if (!*argv) |
207 | *--argv = (char *)"-"; |
208 | |
209 | // put additional headers |
210 | for (l = opt_headers; l; l = l->link) |
211 | puts(l->data); |
212 | |
213 | // make a random string -- it will delimit message parts |
214 | srand(monotonic_us()); |
215 | boundary = xasprintf("%u-%u-%u", |
216 | (unsigned)rand(), (unsigned)rand(), (unsigned)rand()); |
217 | |
218 | // put multipart header |
219 | printf( |
220 | "Mime-Version: 1.0\n" |
221 | "Content-Type: multipart/mixed; boundary=\"%s\"\n" |
222 | , boundary |
223 | ); |
224 | |
225 | // put attachments |
226 | while (*argv) { |
227 | printf( |
228 | "\n--%s\n" |
229 | "Content-Type: %s; charset=%s\n" |
230 | "Content-Disposition: inline; filename=\"%s\"\n" |
231 | "Content-Transfer-Encoding: base64\n" |
232 | , boundary |
233 | , content_type |
234 | , G.opt_charset |
235 | , bb_get_last_path_component_strip(*argv) |
236 | ); |
237 | encode_base64(*argv++, (const char *)stdin, ""); |
238 | } |
239 | |
240 | // put multipart footer |
241 | printf("\n--%s--\n" "\n", boundary); |
242 | |
243 | return EXIT_SUCCESS; |
244 | #undef boundary |
245 | } |
246 |