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


-- | Let systemd bind the server's socket for you
--   
--   "Socket activation" is the a feature of systemd.
--   
--   
--   <a>https://www.freedesktop.org/software/systemd/man/sd_listen_fds_with_names.html</a>
--   
--   We use it for web servers, to avoid the momentary downtime that
--   otherwise occurs while restarting processes. Because the socket is
--   manged by systemd, not by our process, the socket remains even while
--   our process is down. Requests to the socket are queued until our
--   process comes back up to respond.
@package systemd-socket-activation
@version 1

module SocketActivation
getMySocketByName :: Name -> IO Socket

-- | The name of a socket, corresponding to the socket's FileDescriptorName
--   in the systemd config.
newtype Name
NameText :: Text -> Name
[nameText] :: Name -> Text
data VarName
LISTEN_PID :: VarName
LISTEN_FDS :: VarName
LISTEN_FDNAMES :: VarName

-- | Basic type for a socket.
data Socket
data Error
Missing :: VarName -> Error
Invalid :: VarName -> Error
WrongProcess :: Error
NoSuchName :: Name -> Error