@@ -154,10 +154,11 @@ connect :: ConnectInfo -> IO Connection
154connect = connectPostgreSQL . postgreSQLConnectionString
154connect = connectPostgreSQL . postgreSQLConnectionString
156-- | Attempt to make a connection based on a libpq connection string.
156-- | Attempt to make a connection based on a libpq connection string.
157−-- See <http://www.postgresql.org/docs/9.3/static/libpq-connect.html#LIBPQ-CONNSTRING>
157+-- See <https://www.postgresql.org/docs/9.5/static/libpq-connect.html#LIBPQ-CONNSTRING>
158-- for more information. Also note that environment variables also affect
158-- for more information. Also note that environment variables also affect
159-- parameters not provided, parameters provided as the empty string, and a
159-- parameters not provided, parameters provided as the empty string, and a
160+-- few other things; see
160−-- few other things; see <http://www.postgresql.org/docs/9.3/static/libpq-envars.html>
161+-- <https://www.postgresql.org/docs/9.5/static/libpq-envars.html>
161-- for details. Here is an example with some of the most commonly used
162-- for details. Here is an example with some of the most commonly used
162-- parameters:
163-- parameters:
@@ -188,7 +189,7 @@ connect = connectPostgreSQL . postgreSQLConnectionString
188-- Omitting @password@ will default to an appropriate password found
189-- Omitting @password@ will default to an appropriate password found
189-- in the @pgpass@ file, or no password at all if a matching line is
190-- in the @pgpass@ file, or no password at all if a matching line is
190-- not found. See
191-- not found. See
191−-- <http://www.postgresql.org/docs/9.3/static/libpq-pgpass.html> for
192+-- <https://www.postgresql.org/docs/9.5/static/libpq-pgpass.html> for
192-- more information regarding this file.
193-- more information regarding this file.
194-- As all parameters are optional and the defaults are sensible, the
195-- As all parameters are optional and the defaults are sensible, the
@@ -206,18 +207,20 @@ connect = connectPostgreSQL . postgreSQLConnectionString
206-- or production machines, or you will need to use a @pgpass@ file
207-- or production machines, or you will need to use a @pgpass@ file
207-- with the @password@ or @md5@ authentication methods.
208-- with the @password@ or @md5@ authentication methods.
209−-- See <http://www.postgresql.org/docs/9.3/static/client-authentication.html>
210+-- See <https://www.postgresql.org/docs/9.5/static/client-authentication.html>
210-- for more information regarding the authentication process.
211-- for more information regarding the authentication process.
212-- SSL/TLS will typically "just work" if your postgresql server supports or
213-- SSL/TLS will typically "just work" if your postgresql server supports or
213-- requires it. However, note that libpq is trivially vulnerable to a MITM
214-- requires it. However, note that libpq is trivially vulnerable to a MITM
214−-- attack without setting additional SSL parameters in the connection string.
215+-- attack without setting additional SSL connection parameters. In
215−-- In particular, @sslmode@ needs to be set to @require@, @verify-ca@, or
216+-- particular, @sslmode@ needs to be set to @require@, @verify-ca@, or
216-- @verify-full@ in order to perform certificate validation. When @sslmode@
217-- @verify-full@ in order to perform certificate validation. When @sslmode@
217-- is @require@, then you will also need to specify a @sslrootcert@ file,
218-- is @require@, then you will also need to specify a @sslrootcert@ file,
218-- otherwise no validation of the server's identity will be performed.
219-- otherwise no validation of the server's identity will be performed.
219-- Client authentication via certificates is also possible via the
220-- Client authentication via certificates is also possible via the
220−-- @sslcert@ and @sslkey@ parameters.
221+-- @sslcert@ and @sslkey@ parameters. See
222+-- <https://www.postgresql.org/docs/9.5/static/libpq-ssl.html>
223+-- for detailed information regarding libpq and SSL.
222connectPostgreSQL :: ByteString -> IO Connection
225connectPostgreSQL :: ByteString -> IO Connection
223connectPostgreSQL connstr = do
226connectPostgreSQL connstr = do