Modulesnap-server-1.1.2.1Haskell2010

Snap.Http.Server.Config

This module exports the Config datatype, which you can use to configure the Snap HTTP server.

4 types
52 values

Packagesnap-server-1.1.2.1
Exports56
LanguageHaskell2010
LicenceBSD-3-Clause
SourceConfig.hs

datadata Config (m :: Type -> Type) a

A record type which represents partial configurations (for httpServe) by wrapping all of its fields in a Maybe. Values of this type are usually constructed via its Monoid instance by doing something like:

setPort 1234 mempty

Any fields which are unspecified in the Config passed to httpServe (and this is the norm) are filled in with default values from defaultConfig.

Instances3Show, Semigroup, Monoid

Show (Config m a)Defined in snap-server-1.1.2.1 · Snap.Internal.Http.Server.Config
Semigroup (Config m a)Defined in snap-server-1.1.2.1 · Snap.Internal.Http.Server.Config
Monoid (Config m a)Defined in snap-server-1.1.2.1 · Snap.Internal.Http.Server.Config

datadata ConfigLog

Data type representing the configuration of a logging target

Constructors

ConfigNoLog
no logging
ConfigFileLog FilePath
log to text file
ConfigIoLog (ByteString -> IO ())
log custom IO handler

Instances1Show

Show ConfigLogDefined in snap-server-1.1.2.1 · Snap.Internal.Http.Server.Config

datadata ProxyType

FIXME

Note: this type changed in snap-server 1.0.0.0.

Instances2Eq, Show

Eq ProxyTypeDefined in snap-server-1.1.2.1 · Snap.Internal.Http.Server.Config
Show ProxyTypeDefined in snap-server-1.1.2.1 · Snap.Internal.Http.Server.Config

valueemptyConfig :: Config m a

Returns a completely empty Config. Equivalent to mempty from Config's Monoid instance.

valuedefaultConfig :: MonadSnap m => Config m a

These are the default values for the options

valuecommandLineConfig

:: MonadSnap m
=> Config m a
default configuration. This is combined with defaultConfig to obtain default values to use if the given parameter is specified on the command line. Usually it is fine to use emptyConfig here.
-> IO (Config m a)

Returns a Config obtained from parsing command-line options, using the default Snap OptDescr set.

On Unix systems, the locale is read from the LANG environment variable.

valueextendedCommandLineConfig

:: MonadSnap m
=> [OptDescr (Maybe (Config m a))]
Full list of command line options (combine yours with optDescrs to extend Snap's default set of options)
-> (a -> a -> a)
State for multiple invoked user command-line options will be combined using this function.
-> Config m a
default configuration. This is combined with Snap's defaultConfig to obtain default values to use if the given parameter is specified on the command line. Usually it is fine to use emptyConfig here.
-> IO (Config m a)

Returns a Config obtained from parsing command-line options, using the default Snap OptDescr set as well as a list of user OptDescrs. User OptDescrs use the "other" field (accessible using getOther and setOther) to store additional command-line option state. These are combined using a user-defined combining function.

On Unix systems, the locale is read from the LANG environment variable.

valuecompleteConfig :: MonadSnap m => Config m a -> IO (Config m a)

valueoptDescrs

:: MonadSnap m
=> Config m a
the configuration defaults.
-> [OptDescr (Maybe (Config m a))]

Returns a description of the snap command line options suitable for use with System.Console.GetOpt.

valuefmapOpt :: (a -> b) -> OptDescr a -> OptDescr b

valuegetAccessLog :: Config m a -> Maybe ConfigLog

Path to the access log

valuegetBind :: Config m a -> Maybe ByteString

Returns the address to bind to (for http)

valuegetCompression :: Config m a -> Maybe Bool

If set and set to True, compression is turned on when applicable

valuegetDefaultTimeout :: Config m a -> Maybe Int

valuegetErrorHandler :: Config m a -> Maybe (SomeException -> m ())

A MonadSnap action to handle 500 errors

valuegetErrorLog :: Config m a -> Maybe ConfigLog

Path to the error log

valuegetHostname :: Config m a -> Maybe ByteString

The hostname of the HTTP server. This field has the same format as an HTTP Host header; if a Host header came in with the request, we use that, otherwise we default to this value specified in the configuration.

valuegetLocale :: Config m a -> Maybe String

Gets the locale to use. Locales are used on Unix only, to set the LANG/LC_ALL/etc. environment variable. For instance if you set the locale to "en_US", we'll set the relevant environment variables to "en_US.UTF-8".

valuegetOther :: Config m a -> Maybe a

valuegetPort :: Config m a -> Maybe Int

Returns the port to listen on (for http)

valuegetProxyType :: Config m a -> Maybe ProxyType

valuegetSSLBind :: Config m a -> Maybe ByteString

Returns the address to bind to (for https)

valuegetSSLCert :: Config m a -> Maybe FilePath

Path to the SSL certificate file

valuegetSSLKey :: Config m a -> Maybe FilePath

Path to the SSL key file

valuegetSSLChainCert :: Config m a -> Maybe Bool

Path to the SSL certificate file

valuegetSSLPort :: Config m a -> Maybe Int

Returns the port to listen on (for https)

valuegetVerbose :: Config m a -> Maybe Bool

Whether to write server status updates to stderr

valuegetStartupHook :: Config m a -> Maybe (StartupInfo m a -> IO ())

A startup hook is run after the server initializes but before user request processing begins. The server passes, through a StartupInfo object, the startup hook a list of the sockets it is listening on and the final Config object completed after command-line processing.

valuegetUnixSocket :: Config m a -> Maybe FilePath

File path to unix socket. Must be absolute path, but allows for symbolic links.

valuegetUnixSocketAccessMode :: Config m a -> Maybe Int

Access mode for unix socket, by default is system specific. This should only be used to grant additional permissions to created socket file, and not to remove permissions set by default. The only portable way to limit access to socket is creating it in a directory with proper permissions set.

Most BSD systems ignore access permissions on unix sockets.

Note: This uses umask. There is a race condition if process creates other files at the same time as opening a unix socket with this option set.

valuesetAccessLog :: ConfigLog -> Config m a -> Config m a

valuesetBind :: ByteString -> Config m a -> Config m a

valuesetCompression :: Bool -> Config m a -> Config m a

valuesetDefaultTimeout :: Int -> Config m a -> Config m a

valuesetErrorHandler :: (SomeException -> m ()) -> Config m a -> Config m a

valuesetErrorLog :: ConfigLog -> Config m a -> Config m a

valuesetHostname :: ByteString -> Config m a -> Config m a

valuesetLocale :: String -> Config m a -> Config m a

valuesetOther :: a -> Config m a -> Config m a

valuesetPort :: Int -> Config m a -> Config m a

valuesetProxyType :: ProxyType -> Config m a -> Config m a

valuesetSSLBind :: ByteString -> Config m a -> Config m a

valuesetSSLCert :: FilePath -> Config m a -> Config m a

valuesetSSLKey :: FilePath -> Config m a -> Config m a

valuesetSSLChainCert :: Bool -> Config m a -> Config m a

valuesetSSLPort :: Int -> Config m a -> Config m a

valuesetVerbose :: Bool -> Config m a -> Config m a

valuesetUnixSocket :: FilePath -> Config m a -> Config m a

valuesetUnixSocketAccessMode :: Int -> Config m a -> Config m a

valuesetStartupHook :: (StartupInfo m a -> IO ()) -> Config m a -> Config m a

datadata StartupInfo (m :: Type -> Type) a

Arguments passed to setStartupHook.

valuegetStartupSockets :: StartupInfo m a -> [Socket]

The Sockets opened by the server. There will be two Sockets for SSL connections, and one otherwise.

valuegetStartupConfig :: StartupInfo m a -> Config m a

Proxy protocol selection

3 declarations

valuenoProxy :: ProxyType

Configure Snap in direct / non-proxying mode.

valuexForwardedFor :: ProxyType

Assert that Snap is running behind an HTTP proxy, and that the proxied connection information will be stored in the "X-Forwarded-For" or "Forwarded-For" HTTP headers.

valuehaProxy :: ProxyType

Assert that Snap is running behind a proxy running the HaProxy protocol (see http://haproxy.1wt.eu/download/1.5/doc/proxy-protocol.txt). In this mode connections that don't obey the proxy protocol are rejected.