1 /* vi: set sw=4 ts=4: */
3 * makemime: create MIME-encoded message
4 * reformime: parse MIME-encoded message
6 * Copyright (C) 2008 by Vladimir Dronnikov <dronnikov@gmail.com>
8 * Licensed under GPLv2, see file LICENSE in this source tree.
11 //kbuild:lib-$(CONFIG_MAKEMIME) += makemime.o mail.o
17 # define dbg_error_msg(...) bb_error_msg(__VA_ARGS__)
19 # define dbg_error_msg(...) ((void)0)
23 makemime -c type [-o file] [-e encoding] [-C charset] [-N name] \
24 [-a "Header: Contents"] file
25 -m [ type ] [-o file] [-e encoding] [-a "Header: Contents"] file
26 -j [-o file] file1 file2
29 file: filename - read or write from filename
30 - - read or write from stdin or stdout
31 &n - read or write from file descriptor n
32 \( opts \) - read from child process, that generates [ opts ]
35 -c type - create a new MIME section from "file" with this
36 Content-Type: (default is application/octet-stream).
37 -C charset - MIME charset of a new text/plain section.
38 -N name - MIME content name of the new mime section.
39 -m [ type ] - create a multipart mime section from "file" of this
40 Content-Type: (default is multipart/mixed).
41 -e encoding - use the given encoding (7bit, 8bit, quoted-printable,
42 or base64), instead of guessing. Omit "-e" and use
43 -c auto to set Content-Type: to text/plain or
44 application/octet-stream based on picked encoding.
45 -j file1 file2 - join mime section file2 to multipart section file1.
46 -o file - write the result to file, instead of stdout (not
47 allowed in child processes).
48 -a header - prepend an additional header to the output.
50 @file - read all of the above options from file, one option or
52 {which version of makemime is this? What do we support?}
56 * -c TYPE: create a (non-multipart) MIME section with Content-Type: TYPE
57 * makemime -c TYPE [-e ENCODING] [-o OUTFILE] [-C CHARSET] [-N NAME] [-a HEADER...] FILE
58 * The -C option sets the MIME charset attribute for text/plain content.
59 * The -N option sets the name attribute for Content-Type:
60 * Encoding must be one of the following: 7bit, 8bit, quoted-printable, or base64.
62 * -m multipart/TYPE: create a multipart MIME collection with Content-Type: multipart/TYPE
63 * makemime -m multipart/TYPE [-e ENCODING] [-o OUTFILE] [-a HEADER...] FILE
64 * Type must be either "multipart/mixed", "multipart/alternative", or some other MIME multipart content type.
65 * Additionally, encoding can only be "7bit" or "8bit", and will default to "8bit" if not specified.
66 * Finally, filename must be a MIME-formatted section, NOT a regular file.
67 * The -m option creates an initial multipart MIME collection, that contains only one MIME section, taken from filename.
68 * The collection is written to standard output, or the pipe or to outputfile.
70 * -j FILE1: add a section to a multipart MIME collection
71 * makemime -j FILE1 [-o OUTFILE] FILE2
72 * FILE1 must be a MIME collection that was previously created by the -m option.
73 * FILE2 must be a MIME section that was previously created by the -c option.
74 * The -j options adds the MIME section in FILE2 to the MIME collection in FILE1.
78 /* In busybox 1.15.0.svn, makemime generates output like this
79 * (empty lines are shown exactly!):
80 {headers added with -a HDR}
82 Content-Type: multipart/mixed; boundary="24269534-2145583448-1655890676"
84 --24269534-2145583448-1655890676
85 Content-Type: {set by -c, e.g. text/plain}; charset={set by -C, e.g. us-ascii}
86 Content-Disposition: inline; filename="A"
87 Content-Transfer-Encoding: base64
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="B"
93 Content-Transfer-Encoding: base64
96 --24269534-2145583448-1655890676--
99 * For reference: here is an example email to LKML which has
100 * 1st unnamed part (so it serves as an email body)
101 * and one attached file:
103 Content-Type: multipart/mixed; boundary="=-tOfTf3byOS0vZgxEWcX+"
109 --=-tOfTf3byOS0vZgxEWcX+
110 Content-Type: text/plain
111 Content-Transfer-Encoding: 7bit
117 --=-tOfTf3byOS0vZgxEWcX+
118 Content-Disposition: attachment; filename="xyz"
119 Content-Type: text/plain; name="xyz"; charset="UTF-8"
120 Content-Transfer-Encoding: 7bit
125 --=-tOfTf3byOS0vZgxEWcX+--
127 ...random junk added by mailing list robots and such...
130 //usage:#define makemime_trivial_usage
131 //usage: "[OPTIONS] [FILE]..."
132 //usage:#define makemime_full_usage "\n\n"
133 //usage: "Create multipart MIME-encoded message from FILEs\n"
134 /* //usage: "Transfer encoding is base64, disposition is inline (not attachment)\n" */
135 //usage: "\n -o FILE Output. Default: stdout"
136 //usage: "\n -a HDR Add header. Examples:"
137 //usage: "\n \"From: user@host.org\", \"Date: `date -R`\""
138 //usage: "\n -c CT Content type. Default: text/plain"
139 //usage: "\n -C CS Charset. Default: " CONFIG_FEATURE_MIME_CHARSET
140 /* //usage: "\n -e ENC Transfer encoding. Ignored. base64 is assumed" */
142 //usage: "\nOther options are silently ignored"
144 int makemime_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
145 int makemime_main(int argc UNUSED_PARAM, char **argv)
147 llist_t *opt_headers = NULL, *l;
148 const char *opt_output;
149 #define boundary opt_output
152 OPT_c = 1 << 0, // create (non-multipart) section
153 OPT_e = 1 << 1, // Content-Transfer-Encoding. Ignored. Assumed base64
154 OPT_o = 1 << 2, // output to
155 OPT_C = 1 << 3, // charset
156 OPT_N = 1 << 4, // COMPAT
157 OPT_a = 1 << 5, // additional headers
158 //OPT_m = 1 << 6, // create mutipart section
159 //OPT_j = 1 << 7, // join section to multipart section
165 opt_complementary = "a::";
166 opts = getopt32(argv,
167 "c:e:o:C:N:a", //:m:j:",
168 &G.content_type, NULL, &opt_output, &G.opt_charset, NULL, &opt_headers //, NULL, NULL
175 freopen(opt_output, "w", stdout);
177 // no files given on command line? -> use stdin
179 *--argv = (char *)"-";
181 // put additional headers
182 for (l = opt_headers; l; l = l->link)
185 // make a random string -- it will delimit message parts
186 srand(monotonic_us());
187 boundary = xasprintf("%u-%u-%u",
188 (unsigned)rand(), (unsigned)rand(), (unsigned)rand());
190 // put multipart header
192 "Mime-Version: 1.0\n"
193 "Content-Type: multipart/mixed; boundary=\"%s\"\n"
201 "Content-Type: %s; charset=%s\n"
202 "Content-Disposition: inline; filename=\"%s\"\n"
203 "Content-Transfer-Encoding: base64\n"
207 , bb_get_last_path_component_strip(*argv)
209 encode_base64(*argv++, (const char *)stdin, "");
212 // put multipart footer
213 printf("\n--%s--\n" "\n", boundary);