package tls

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

High-level API

package tls

tls
- Tls
  - Ciphersuite
    
    H
  - Config
    
    Ciphers
  - Control
    
    Monad
    
    Monad_ext
    
    Monad_ext_make
    
    M
    
    Option
    
    Or_error
    
    Or_error_make
    
    M
  - Core
    
    Cert
    
    SessionID
  - Crypto
    
    Ciphers
  - Engine
  - Explorator
  - Handshake_client
  - Handshake_common
  - Handshake_crypto
  - Handshake_server
  - Packet
  - Reader
  - State
    
    V_err
  - Tracing
  - Utils
    
    Cs
    
    List_set
  - Writer
tls.lwt
- Tls_lwt
  - Unix
- X509_lwt

Legend:
Library
Module
Module type
Parameter
Class
Class type

Effectful operations using Lwt for pure TLS.

The pure TLS is state and buffer in, state and buffer out. This module uses Lwt for communication over the network.

This module implements a high-level API and a low-level API (in Unix). Most applications should use the high-level API described below.

exception Tls_alert of Tls.Packet.alert_type

Tls_alert exception received from the other endpoint

exception Tls_failure of Tls.Engine.failure

Tls_failure exception while processing incoming data

type tracer = Sexplib.Sexp.t -> unit

tracing of TLS sessions

module Unix : sig ... end

Low-level API

High-level API

type ic = Lwt_io.input_channel

type oc = Lwt_io.output_channel

val accept_ext : 
  ?trace:tracer ->
  Tls.Config.server ->
  Lwt_unix.file_descr ->
  ((ic * oc) * Lwt_unix.sockaddr) Lwt.t

accept_ext ?trace server fd is (ic, oc), sockaddr, the input and output channel from an accepted connection on the given fd, after upgrading to TLS using the server configuration.

val accept : 
  ?trace:tracer ->
  Tls.Config.own_cert ->
  Lwt_unix.file_descr ->
  ((ic * oc) * Lwt_unix.sockaddr) Lwt.t

accept ?trace own_cert fd is (ic, oc), sockaddr, the input and output channel from the accepted connection on fd, using the default configuration with the given own_cert.

val connect_ext : 
  ?trace:tracer ->
  Tls.Config.client ->
  (string * int) ->
  (ic * oc) Lwt.t

connect_ext ?trace client (host, port) is ic, oc, the input and output channel of a TLS connection to host on port using the client configuration.

val connect : 
  ?trace:tracer ->
  X509_lwt.authenticator ->
  (string * int) ->
  (ic * oc) Lwt.t

connect ?trace authenticator (host, port) is ic, oc, the input and output channel of a TLS connection to host on port using the default configuration and the authenticator.

val of_t : ?close:(unit -> unit Lwt.t) -> Unix.t -> ic * oc

of_t t is ic, oc, the input and output channel. close defaults to !Unix.close.