System.IO.Streams.TLS

This module provides convenience functions for interfacing tls.

This module is intended to be imported qualified, e.g.:

import           Data.Connection
import qualified System.IO.Streams.TLS as TLS

Documentation

type TLSConnection = Connection (Context, SockAddr)

Type alias for tls connection.

Normally you shouldn't use Context in connExtraInfo directly.

client

connect

Arguments

:: ClientParams

check Data.TLSSetting

-> Maybe String

Optional certificate subject name, if set to Nothing then we will try to verify HostName as subject name

-> HostName

hostname to connect to

-> PortNumber

port number to connect to

-> IO TLSConnection

Connect to server using TLS and return a Connection.

connectTLS

Arguments

:: ClientParams

check Data.TLSSetting

-> Maybe String

Optional certificate subject name, if set to Nothing then we will try to verify HostName as subject name

-> HostName

hostname to connect to

-> PortNumber

port number to connect to

-> IO (Context, SockAddr)

Convenience function for initiating an TLS connection to the given (HostName, PortNumber) combination.

This operation may throw TLSException on failure.

tLsToConnection

Arguments

:: (Context, SockAddr)

TLS connection / socket address pair

-> IO TLSConnection

Make a Connection from a Context.

server

accept

Arguments

:: ServerParams

check Data.TLSSetting

-> Socket

the listening Socket

-> IO TLSConnection

Accept a new TLS connection from remote client with listening socket.

This operation may throw TLSException on failure.

re-export

module Data.TLSSetting