Ian Kent 92f44e
autofs-5.0.7 - document browse option in man page
Ian Kent 92f44e
Ian Kent 92f44e
From: Ian Kent <raven@themaw.net>
Ian Kent 92f44e
Ian Kent 92f44e
The "browse" option has remained undocumented for a long time.
Ian Kent 92f44e
Finally add a section for it to auto.master(5) making special
Ian Kent 92f44e
note of the potential performance implications.
Ian Kent 92f44e
---
Ian Kent 92f44e
 CHANGELOG            |    1 +
Ian Kent 92f44e
 man/auto.master.5.in |   11 +++++++++++
Ian Kent 92f44e
 2 files changed, 12 insertions(+)
Ian Kent 92f44e
Ian Kent 92f44e
diff --git a/CHANGELOG b/CHANGELOG
Ian Kent 92f44e
index ecdea0b..d8e4049 100644
Ian Kent 92f44e
--- a/CHANGELOG
Ian Kent 92f44e
+++ b/CHANGELOG
Ian Kent 92f44e
@@ -36,6 +36,7 @@
Ian Kent 92f44e
 - fix requires in spec file.
Ian Kent 92f44e
 - fix libtirpc build option to require libtirpc-devel if needed.
Ian Kent 92f44e
 - fix systemd unidir in spec file.
Ian Kent 92f44e
+- document browse option in man page.
Ian Kent 92f44e
 
Ian Kent 92f44e
 25/07/2012 autofs-5.0.7
Ian Kent 92f44e
 =======================
Ian Kent 92f44e
diff --git a/man/auto.master.5.in b/man/auto.master.5.in
Ian Kent 92f44e
index bbea43a..c552e56 100644
Ian Kent 92f44e
--- a/man/auto.master.5.in
Ian Kent 92f44e
+++ b/man/auto.master.5.in
Ian Kent 92f44e
@@ -147,6 +147,17 @@ multiple file systems should be mounted (`multimounts'). If this option
Ian Kent 92f44e
 is given, no file system is mounted at all if at least one file system
Ian Kent 92f44e
 can't be mounted.
Ian Kent 92f44e
 .TP
Ian Kent 92f44e
+.I "[no]browse"
Ian Kent 92f44e
+This is an autofs specific option that is a pseudo mount option and
Ian Kent 92f44e
+so is given without a leading dash. Use of the browse option pre-creates
Ian Kent 92f44e
+mount point directories for indirect mount maps so the map keys can be
Ian Kent 92f44e
+seen in a directory listing without being mounted. Use of this option
Ian Kent 92f44e
+can cause performance problem if the indirect map is large so it should
Ian Kent 92f44e
+be used with caution. The internal program default is to enable browse
Ian Kent 92f44e
+mode for indirect mounts but the default installed configuration overrides
Ian Kent 92f44e
+this by setting BROWSE_MODE to "no" because of the potential performance
Ian Kent 92f44e
+problem.
Ian Kent 92f44e
+.TP
Ian Kent 92f44e
 .I "nobind"
Ian Kent 92f44e
 This is an autofs specific option that is a pseudo mount option and
Ian Kent 92f44e
 so is given without a leading dash. It may be used either in the master