|
 |
306fa1 |
autofs-5.1.1 - update map_hash_table_size description
|
|
|
306fa1 |
|
|
|
306fa1 |
From: Ian Kent <raven@themaw.net>
|
|
|
306fa1 |
|
|
|
306fa1 |
The configuration parameter map_hash_table_size has been ommitted
|
|
|
306fa1 |
from the autofs.conf(5) man page and it's description in the
|
|
|
306fa1 |
configuration file comments is poor.
|
|
|
306fa1 |
|
|
|
306fa1 |
Add a description of the parameter to autofs.conf(5) and update
|
|
|
306fa1 |
the configuration file comments to direct people to the map page
|
|
|
306fa1 |
for more information.
|
|
|
306fa1 |
|
|
|
306fa1 |
Signed-off-by: Ian Kent <raven@themaw.net>
|
|
|
306fa1 |
---
|
|
|
306fa1 |
CHANGELOG | 1 +
|
|
|
306fa1 |
man/autofs.conf.5.in | 31 +++++++++++++++++++++++++++++++
|
|
|
306fa1 |
redhat/autofs.conf.default.in | 6 ++++--
|
|
|
306fa1 |
samples/autofs.conf.default.in | 6 ++++--
|
|
|
306fa1 |
4 files changed, 40 insertions(+), 4 deletions(-)
|
|
|
306fa1 |
|
|
|
306fa1 |
--- autofs-5.0.7.orig/CHANGELOG
|
|
|
306fa1 |
+++ autofs-5.0.7/CHANGELOG
|
|
|
306fa1 |
@@ -180,6 +180,7 @@
|
|
|
306fa1 |
- fix return handling of do_reconnect() in ldap module.
|
|
|
306fa1 |
- fix direct mount stale instance flag reset.
|
|
|
306fa1 |
- fix direct map expire not set for initail empty map.
|
|
|
306fa1 |
+- update map_hash_table_size description.
|
|
|
306fa1 |
|
|
|
306fa1 |
25/07/2012 autofs-5.0.7
|
|
|
306fa1 |
=======================
|
|
|
306fa1 |
--- autofs-5.0.7.orig/man/autofs.conf.5.in
|
|
|
306fa1 |
+++ autofs-5.0.7/man/autofs.conf.5.in
|
|
|
306fa1 |
@@ -80,6 +80,37 @@ user setting these standard environment
|
|
|
306fa1 |
potential user privilege escalation when the program map is written in a
|
|
|
306fa1 |
language that can load components from, for example, a user home directory
|
|
|
306fa1 |
(program default "no").
|
|
|
306fa1 |
+.TP
|
|
|
306fa1 |
+.B map_hash_table_size
|
|
|
306fa1 |
+.br
|
|
|
306fa1 |
+This configuration option may be used to change the number of hash
|
|
|
306fa1 |
+table slots (default 1024).
|
|
|
306fa1 |
+
|
|
|
306fa1 |
+This configuration option affects the overhead of searching the map
|
|
|
306fa1 |
+entry cache for map entries when there are a large number of entries.
|
|
|
306fa1 |
+It affects the number of entries that must be looked at to locate a
|
|
|
306fa1 |
+map entry in the map entry cache. For example, the default of 1024
|
|
|
306fa1 |
+and a direct map with 8000 entries would result in each slot
|
|
|
306fa1 |
+containing an average of 8 entries, which should be acceptable.
|
|
|
306fa1 |
+
|
|
|
306fa1 |
+However, if excessive CPU usage is observed during automount lookups
|
|
|
306fa1 |
+increasing this option can reduce the CPU overhead considerably becuase
|
|
|
306fa1 |
+it reduces the length of the search chains.
|
|
|
306fa1 |
+
|
|
|
306fa1 |
+Note that the number of entries in a map doesn't necessarily relate
|
|
|
306fa1 |
+to the number of entries used in the map entry cache.
|
|
|
306fa1 |
+
|
|
|
306fa1 |
+There are three distinct cases, direct maps and indirect maps that
|
|
|
306fa1 |
+use the "browse" option must be read in their entirity at program
|
|
|
306fa1 |
+start so, in these two cases the map size does retate directly to
|
|
|
306fa1 |
+the map entry cache size.
|
|
|
306fa1 |
+
|
|
|
306fa1 |
+For indirect maps that do not use the "browse" option entries are
|
|
|
306fa1 |
+added to the map entry cache at lookup so the number of active cache
|
|
|
306fa1 |
+entries, in this case, is usually much less than the number of entries
|
|
|
306fa1 |
+in the map. In this last case it would be unusual for the map entry
|
|
|
306fa1 |
+cache to grow large enough to warrant increasing the default before
|
|
|
306fa1 |
+an event that cleans stale entries, a map re-read for example.
|
|
|
306fa1 |
.SS LDAP Configuration
|
|
|
306fa1 |
.P
|
|
|
306fa1 |
Configuration settings available are:
|
|
|
306fa1 |
--- autofs-5.0.7.orig/redhat/autofs.conf.default.in
|
|
|
306fa1 |
+++ autofs-5.0.7/redhat/autofs.conf.default.in
|
|
|
306fa1 |
@@ -135,8 +135,10 @@ mount_nfs_default_protocol = 4
|
|
|
306fa1 |
#auth_conf_file = @@autofsmapdir@@/autofs_ldap_auth.conf
|
|
|
306fa1 |
#
|
|
|
306fa1 |
# map_hash_table_size - set the map cache hash table size.
|
|
|
306fa1 |
-# Should be a power of 2 with a ratio roughly
|
|
|
306fa1 |
-# between 1:10 and 1:20 for each map.
|
|
|
306fa1 |
+# Should be a power of 2 with a ratio of
|
|
|
306fa1 |
+# close to 1:8 for acceptable performance
|
|
|
306fa1 |
+# with maps up to around 8000 entries.
|
|
|
306fa1 |
+# See autofs.conf(5) for more details.
|
|
|
306fa1 |
#
|
|
|
306fa1 |
#map_hash_table_size = 1024
|
|
|
306fa1 |
#
|
|
|
306fa1 |
--- autofs-5.0.7.orig/samples/autofs.conf.default.in
|
|
|
306fa1 |
+++ autofs-5.0.7/samples/autofs.conf.default.in
|
|
|
306fa1 |
@@ -134,8 +134,10 @@ browse_mode = no
|
|
|
306fa1 |
#auth_conf_file = @@autofsmapdir@@/autofs_ldap_auth.conf
|
|
|
306fa1 |
#
|
|
|
306fa1 |
# map_hash_table_size - set the map cache hash table size.
|
|
|
306fa1 |
-# Should be a power of 2 with a ratio roughly
|
|
|
306fa1 |
-# between 1:10 and 1:20 for each map.
|
|
|
306fa1 |
+# Should be a power of 2 with a ratio of
|
|
|
306fa1 |
+# close to 1:8 for acceptable performance
|
|
|
306fa1 |
+# with maps up to around 8000 entries.
|
|
|
306fa1 |
+# See autofs.conf(5) for more details.
|
|
|
306fa1 |
#
|
|
|
306fa1 |
#map_hash_table_size = 1024
|
|
|
306fa1 |
#
|