@@ -6,7 +6,8 @@ callback modules in the OTP style. The goal is to make it easy to send and
receive email in Erlang without the hassle of POP/IMAP. This is *not* a true
mailserver - although you could build one with it.
-The SMTP server supports PLAIN, LOGIN, CRAM-MD5 authentication as well as TLS.
+The SMTP server/client supports PLAIN, LOGIN, CRAM-MD5 authentication as well
+as STARTTLS and SSL (port 465).
Also included is a MIME encoder/decoder, sorta according to RFC204{5,6,7}.
@@ -14,4 +15,25 @@ Current Participants
====================
+ Andrew Thompson (andrew@hijacked.us)
-+ Jack Danger Canty (code@jackcanty.com)
\ No newline at end of file
++ Jack Danger Canty (code@jackcanty.com)a
+
+Example
+=======
+
+Here's an example usage of the client:
+
+<pre>
+gen_smtp_client:send({"whatever@test.com", ["andrew@hijacked.us"],
+ "Subject: testing\r\nFrom: Andrew Thompson <andrew@hijacked.us>\r\nTo: Some Dude <foo@bar.com>\r\n\r\nThis is the email body"},
+ [{relay, "smtp.gmail.com"}, {username, "me@gmail.com"}, {password, "mypassword"}]).
+</pre>
+
+The From and To addresses will be wrapped in <>s if they aren't already,
+TLS will be auto-negotiated if available (unless you pass `{tls, never}`) and
+authentication will by attempted by default since a username/password were
+specified (`{auth, never}` overrides this).
+
+If you want to mandate tls or auth, you can pass `{tls, always}` or `{auth,
+always}` as one of the options. You can specify an alternate port with `{port,
+2525}` (default is 25) or you can indicate that the server is listening for SSL
+connections using `{ssl, true}` (port defaults to 465 with this option).
README.markdown
00ea91acdef8009c664479a61f29f32308dff3d9
Andrew Thompson
andrew@thraddash.mgmt
http://github.com/Vagabond/gen_smtp/commit/31642bd2b3263de09cd2e890e552b3ef1371ff66
31642bd2b3263de09cd2e890e552b3ef1371ff66
2009-09-04T13:08:55-07:00
2009-09-04T13:08:55-07:00
Update the readme with a client example
fca19aa9f73a5510498218b885e5f435fcf6e43a
Andrew Thompson
andrew@thraddash.mgmt