Network.CommSec

Types

data Connection

A connection is a secure bidirectional communication channel.

Constructors

Conn

Fields

inCtx :: MVar InContext

outCtx :: MVar OutContext

socket :: Socket

data CommSecError

Errors that can be returned by the decoding/receicing operations.

Constructors

OldContext

DuplicateSeq

InvalidICV

BadPadding

Instances

Enum CommSecError

Eq CommSecError

Data CommSecError

Ord CommSecError

Show CommSecError

Typeable CommSecError

Exception CommSecError

Send and receive operations

send :: Connection -> ByteString -> IO ()

recv :: Connection -> IO ByteString

sendPtr :: Connection -> Ptr Word8 -> Int -> IO ()

Sends a message over the connection.

recvPtr :: Connection -> Ptr Word8 -> Int -> IO Int

Blocks till it receives a valid message, placing the resulting plaintext in the provided buffer. If the incoming message is larger that the provided buffer then the message is truncated. This process also incurs an additional copy.

Establishing a connection from a shared secret

accept :: ByteString -> PortNumber -> IO Connection

Expands the provided 128 (or more) bit secret into two keys to create a connection.

ex: accept ent 3134

connect :: ByteString -> HostName -> PortNumber -> IO Connection

Expands the provided 128 (or more) bit secret into two keys to create a connection.

Establishing a connection from a public identity (PKI)

Utility

expandSecret :: ByteString -> Int -> ByteString