]> git.ipfire.org Git - thirdparty/freeradius-server.git/commitdiff
Update sample winbind config to reflect slab parameters
authorNick Porter <nick@portercomputing.co.uk>
Thu, 5 Dec 2024 11:35:41 +0000 (11:35 +0000)
committerNick Porter <nick@portercomputing.co.uk>
Thu, 5 Dec 2024 11:35:41 +0000 (11:35 +0000)
raddb/mods-available/winbind

index dd77a90957554f1a9a1119b6677ff003f72c129e..ae8da461de0d32f2f45956716d93d8cf69b0be7e 100644 (file)
@@ -65,106 +65,28 @@ winbind {
        }
 
        #
-       #  pool { ... }::
+       #  .Reusable Handles
        #
-       #  Information for the `winbind` connection pool.
+       #  Reusable connection handles are allocated in blocks.  These
+       #  parameters allow for tuning how that is done.
        #
-       #  The configuration items below are the same for all modules which
-       #  use the new connection pool.
-       #
-       pool {
-               #
-               #  start:: Connections to create during module instantiation.
-               #
-               #  If the server cannot create specified number of
-               #  connections during instantiation it will exit.
-               #  Set to `0` to allow the server to start without the
-               #  external service being available.
-               #
-               start = 0
-
-               #
-               #  min:: Minimum number of connections to keep open.
-               #
-               min = 0
-
-               #
-               #  max:: Maximum number of connections.
-               #
-               #  If these connections are all in use and a new one
-               #  is requested, the request will NOT get a connection.
-               #
-               #  Setting `max` to *LESS* than the number of threads means
-               #  that some threads may starve, and you will see errors
-               #  like _No connections available and at max connection limit_.
-               #
-               #  Setting `max` to MORE than the number of threads means
-               #  that there are more connections than necessary.
-               #
-               #  If `max` is not specified, then it defaults to the number
-               #  of workers configured.
-               #
-#              max =
-
-               #
-               #  spare:: Spare connections to be left idle.
-               #
-               #  NOTE: Idle connections WILL be closed if `idle_timeout`
-               #  is set. This should be less than or equal to `max` above.
-               #
-               spare = 1
-
-               #
-               #  uses:: Number of uses before the connection is closed.
-               #
-               #  NOTE: A setting of 0 means infinite (no limit).
-               #
-               uses = 0
-
-               #
-               #  retry_delay:: The number of seconds to wait after the server tries
-               #  to open a connection, and fails.
-               #
-               #  During this time, no new connections will be opened.
-               #
-               retry_delay = 30
-
+       reuse {
                #
-               #  lifetime:: The lifetime (in seconds) of the connection.
+               #  min:: The minimum number of connection handles to
+               #  keep allocated
                #
-               #  NOTE: A setting of 0 means infinite (no limit).
-               #
-               lifetime = 86400
+#              min = 10
 
                #
-               #  cleanup_interval:: The pool is checked for free connections every
-               #  `cleanup_interval`.
-               #
-               #  If there are free connections, then one of them is closed.
+               #  max:: The maximum number of reusable connection
+               #  handles to allocate.
                #
-               cleanup_interval = 300
+#              max = 100
 
                #
-               #  idle_timeout:: The idle timeout (in seconds).
-               #
-               #  A connection which is unused for this length of time will be closed.
-               #
-               #  NOTE: A setting of 0 means infinite (no timeout).
-               #
-               idle_timeout = 600
-
-               #
-               #  [NOTE]
-               #  ====
-               #  All configuration settings are enforced.  If a connection is closed because of
-               #  `idle_timeout`, `uses`, or `lifetime`, then the total
-               #  number of connections MAY fall below `min`.
-               #
-               #  When that happens, it will open a new connection. It will also log a *WARNING* message.
-               #
-               #  The solution is to either lower the "min" connections, or
-               #  increase lifetime/idle_timeout.
-               #  ====
+               #  cleanup_interval:: How often to free un-used
+               #  connection handles.
                #
+#              cleanup_interval = 30s
        }
 }