-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | http-client backend using the OpenSSL library.
--   
--   Hackage documentation generation is not reliable. For up to date
--   documentation, please see:
--   <a>http://www.stackage.org/package/http-client</a>.
@package http-client-openssl
@version 0.3.3


-- | Support for making connections via the OpenSSL library.
module Network.HTTP.Client.OpenSSL

-- | Computation of <tt><a>withOpenSSL</a> action</tt> initializes the
--   OpenSSL library as necessary, and computes <tt>action</tt>. Every
--   application that uses HsOpenSSL must wrap any operations involving
--   OpenSSL with <a>withOpenSSL</a>, or they might crash:
--   
--   <pre>
--   module Main where
--   import OpenSSL
--   
--   main :: IO ()
--   main = withOpenSSL $
--          do ...
--   </pre>
--   
--   Since 0.10.3.5, <a>withOpenSSL</a> is safe to be applied redundantly.
--   Library authors may wish to wrap their functions not to force their
--   users to think about initialization:
--   
--   <pre>
--   get :: URI -&gt; IO Response
--   get uri = withOpenSSL $ internalImplementationOfGet uri
--   </pre>
withOpenSSL :: IO a -> IO a

-- | Create a new <a>Manager</a> using <a>opensslManagerSettings</a> and
--   <a>defaultMakeContext</a> with <a>defaultOpenSSLSettings</a>.
newOpenSSLManager :: MonadIO m => m Manager

-- | Note that it is the caller's responsibility to pass in an appropriate
--   context.
opensslManagerSettings :: IO SSLContext -> ManagerSettings
defaultMakeContext :: OpenSSLSettings -> IO SSLContext
data OpenSSLSettings
OpenSSLSettings :: [SSLOption] -> VerificationMode -> String -> (SSLContext -> IO ()) -> OpenSSLSettings
[osslSettingsOptions] :: OpenSSLSettings -> [SSLOption]
[osslSettingsVerifyMode] :: OpenSSLSettings -> VerificationMode
[osslSettingsCiphers] :: OpenSSLSettings -> String
[osslSettingsLoadCerts] :: OpenSSLSettings -> SSLContext -> IO ()

-- | Default OpenSSL settings. In particular:
--   
--   <ul>
--   <li>SSLv2 and SSLv3 are disabled</li>
--   <li>Hostname validation</li>
--   <li><tt>DEFAULT</tt> cipher list</li>
--   <li>Certificates loaded from OS-specific store</li>
--   </ul>
--   
--   Note that these settings might change in the future.
defaultOpenSSLSettings :: OpenSSLSettings