README 1.91 KB
Newer Older
Jan Idzikowski's avatar
Jan Idzikowski committed
1
2
3
4

CL-SMTP is a simple lisp smtp client. 
It works in ACL, SBCL, CMUCL, OPENMCL, LISPWORKS and CLISP.

5
6
new with authentication support for PLAIn and LOGIN authentication method

Jan Idzikowski's avatar
Jan Idzikowski committed
7
8
9
10
11
12
See INSTALL for prerequisites and build details.

To use cl-smtp:

(asdf:operate 'asdf:load-op 'cl-smtp)

13
14
15
16
17
18
19
20
For use cl-smtp with authentication support you need cl-base64 package and
add :cl-smtp-authentication to features

(push :cl-smtp-authentication *features*)
(asdf:operate 'asdf:load-op 'cl-smtp)

------------------------------------------------

Jan Idzikowski's avatar
Jan Idzikowski committed
21
(cl-smtp:send-email host from to subject message
22
                    &key (port 25) cc bcc reply-to extra-headers authentication)
Jan Idzikowski's avatar
Jan Idzikowski committed
23
24
25
26
27
28
29
30
31
32
33

 Arguments:
  - host (String)                  : hostname or ip-adress of the smtpserver
  - from (String)                  : email adress 
  - to (String or Cons of Strings) : email adress 
  - subject (String)               : subject text
  - message (String)               : message body
  keywords:
  - cc (String or Cons of Strings) : email adress carbon copy
  - bcc (String or Cons of Strings): email adress blind carbon copy
  - reply-to (String)              : email adress
34
  - displayname (String)           : displayname of the sender
Jan Idzikowski's avatar
Jan Idzikowski committed
35
  - extra-headers (Cons)           : extra headers as alist
36
37
38
  - authentication (Cons)          : list with 3 elements
                                     (:method "username" "password")
                                     method is a keyword :plain or :login
Jan Idzikowski's avatar
Jan Idzikowski committed
39
40
41
42
43
44
45
46
47
48
49
50
51

Returns nil or error with message

For debug output set the parameter *debug* to t (default nil)
(setf cl-smtp::*debug* t)

CL-SMTP set automaticly the Date header and the X-Mailer header.
X-Mailer: cl-smtp ((lisp-implementation-type) (lisp-implementation-version))

You can change this with setting the parameter *x-mailer*
(setf cl-smtp::*x-mailer* "my x-mailer string)

If you find bugs or want to send patches for enhancements, by email to
52
Jan Idzikowski <jidzikowski@common-lisp.net>