package sendmail

  1. Overview
  2. Docs
Implementation of the sendmail command

Install 

dune-project
 Dependency

github.com Readme Changelog Edit opam file Versions (18)

Authors

  1. G
    Gwenaëlle Lecat
  2. R
    Romain Calascibetta <romain.calascibetta@gmail.com>

Maintainers

  1. G
    Gwenaëlle Lecat
  2. R
    Romain Calascibetta <romain.calascibetta@gmail.com>

Sources

colombe-0.13.1.tbz
sha256=ddf59cca3e06370d6a830f46829de518f29f1cfa607ab4f9fb96e623f08cc906
sha512=52186b217ad80f2fbcf243020e3e09e3f5358b9596816a749229fe3f8267bbf2750568de0e46ddc6f76ee864f8cf9103b90a4f548c9a911c9866a7f1ea2e2cb8

doc/sendmail.starttls/Sendmail_with_starttls/index.html

Module Sendmail_with_starttlsSource

Sourcemodule Context_with_tls : sig ... end
Sourcemodule type VALUE = sig ... end
Sourcemodule Value : sig ... end
Sourcemodule type S = sig ... end
Sourcetype reverse_path = Colombe.Reverse_path.t
Sourcetype forward_path = Colombe.Forward_path.t
Sourcetype mechanism = Sendmail.mechanism
Sourcetype authentication = Sendmail.authentication
Sourcetype ('a, 's) stream = ('a, 's) Sendmail.stream
Sourcetype tmp_error = [
  1. | `Mailbox_unavailable
  2. | `Error_processing
  3. | `Action_ignored
  4. | `Unable_to_accomodate_parameters
]
Sourcetype error = [
  1. | `Protocol of [ Value.error | `Tls_alert of Tls.Packet.alert_type | `Tls_failure of Tls.Engine.failure | `Tls_closed ]
  2. | `Unsupported_mechanism
  3. | `Encryption_required
  4. | `Weak_mechanism
  5. | `Authentication_rejected
  6. | `Authentication_failed
  7. | `Authentication_required
  8. | `STARTTLS_unavailable
  9. | `Temporary_failure of tmp_error
]
Sourceval pp_error : error Fmt.t
Sourcetype 's streams = (string * int * int, 's) stream Seq.t
Sourceval sendmail : 's Colombe.Sigs.impl -> ('flow, 's) Colombe.Sigs.rdwr -> 'flow -> Context_with_tls.t -> Tls.Config.client -> ?authentication:authentication -> domain:Colombe.Domain.t -> reverse_path -> forward_path list -> (string * int * int, 's) stream -> ((unit, error) result, 's) Colombe.Sigs.io

sendmail impl rdwr flow ctx tls_config ?authentication ~domain sender recipients mail where:

  • impl is the scheduler (unix, lwt or async)
  • rdwr read/write syscall
  • flow witness of the flow (can be a socket)
  • ctx context used by the process
  • tls_config TLS configuration used by STARTTLS
  • authentication authentication information used by the process
  • sender sender of the mail
  • recipients recipients of the mail
  • mail stream of the mail

This process tries to send a mail according RFC4409. It ensures to use STARTTLS (eg. RFC3207) while the process according TLS configuration tls_config. If authentication is given, it does the authentication only while TLS flow. Mail is sended only while TLS flow.

The stream mail must respects same assumptions as Sendmail_lwt.sendmail.

Sourceval many : 's Colombe.Sigs.impl -> ('flow, 's) Colombe.Sigs.rdwr -> 'flow -> Context_with_tls.t -> Tls.Config.client -> ?authentication:authentication -> domain:Colombe.Domain.t -> (reverse_path * forward_path) list -> (string * int * int, 's) stream Seq.t -> (((reverse_path * forward_path * (unit, error) result) list, error) result, 's) Colombe.Sigs.io

many impl rdwr flow ctx tls_config ?authentication ~domain transactions sends multiple emails over a single TCP+STARTTLS connection. Each transaction is a (sender, recipients, mail) tuple. The connection is set up once (EHLO, STARTTLS, AUTH), then for each transaction: MAIL FROM, RCPT TO, DATA, body, DOT, RSET. Returns a list of results, one per transaction. If a transaction fails, the connection is reset and the next transaction is attempted.