ref: 75c92428225428c8fde2d015f010e608a0b12f1d
dir: purgatorio/man/2/smtp
.TH SMTP 2
.SH NAME
smtp \- Simple Mail Transfer Protocol
.SH SYNOPSIS
.EX
include "smtp.m";
smtp := load Smtp Smtp->PATH;
open: fn(server: string): (int, string);
sendmail: fn(fromwhom: string,
towhom: list of string,
cc: list of string,
msg: list of string): (int, string);
close: fn(): (int, string);
.EE
.SH DESCRIPTION
.B Smtp
provides an interface to the mail transport protocol SMTP.
.PP
.B Open
opens a connection to the given SMTP
.IR server .
If
.I server
is nil,
.B open
uses the
default mail server
.BR $smtp ,
which must be defined in
.IR ndb (6).
It returns -1 and an error message if the connection fails.
.PP
.B Sendmail
sends mail to the SMTP server for subsequent delivery.
The first argument names the sender, the list
.I towhom
names the
recipients,
.I cc
is a list of CC's,
and
.I msg
has the text of the message. The latter
may simply be a list of one item containing the whole message, a list of lines of the message
or any intermediate format. It returns -1 and an error message on failure.
.PP
.B Close
closes the connection to the SMTP server.
.SH SOURCE
.B /appl/lib/smtp.b
.SH SEE ALSO
.IR sendmail (1),
.IR acme (1)
.SH BUGS
Too much copying of strings is done, especially with large messages.