autofs-5.1.0 - update man page autofs(8) for systemd
From: Ian Kent <ikent@redhat.com>
Update the autofs(8) man page to account for systems using systemd.
---
CHANGELOG | 1 +
man/autofs.8.in | 51 +++++++++++++++++++++++++++++++++++++--------------
2 files changed, 38 insertions(+), 14 deletions(-)
--- autofs-5.0.7.orig/CHANGELOG
+++ autofs-5.0.7/CHANGELOG
@@ -155,6 +155,7 @@
- fix reset amd lexer scan buffer.
- ignore multiple commas in options strings.
- clarify multiple mounts description.
+- update man page autofs(8) for systemd.
25/07/2012 autofs-5.0.7
=======================
--- autofs-5.0.7.orig/man/autofs.8.in
+++ autofs-5.0.7/man/autofs.8.in
@@ -1,23 +1,30 @@
.TH AUTOFS 8 "9 Sep 1997"
.SH NAME
-@@initdir@@/autofs \- Control Script for automounter
+Service control for the automounter
.SH SYNOPSIS
+If a SysV init script system is being used:
+.br
.B @@initdir@@/autofs
.I start|stop|restart|reload|status
+.P
+or if the systemd init system is being used:
+.br
+.B systemctl
+.I start|stop|restart|reload|status
+.B autofs.service
.SH "DESCRIPTION"
.B autofs
controls the operation of the
.BR automount (8)
-daemons running on the Linux system. Usually
+daemon(s) running on the Linux system. Usually
.B autofs
is invoked at system boot time with the
.I start
parameter and at shutdown time with the
.I stop
-parameter. The
-.B autofs
-script can also be manually invoked by the system administrator to shut
-down, restart or reload the automounters.
+parameter. Service control actions can also be manually invoked by
+the system administrator to shut down, restart, reload or obtain
+service status.
.P
.SH "OPERATION"
.B autofs
@@ -31,28 +38,44 @@ will mount and start a thread, with the
manage the mount point.
.P
.B @@initdir@@/autofs reload
-will check the current auto.master map against running daemons. It will kill
-those daemons whose entries have changed and then start daemons for new or
-changed entries.
+or
+.B systemctl autofs.service reload
+will check the current auto.master map against the current automount managed
+mounts. It will terminate those daemons or threads (depending on
+.B autofs
+version) whose entries have been removed, re-read the automount maps for
+entries that have changed and start new daemons or threads for entries
+that have been added.
.P
-If a map is modified then the change will become effective immediately. If
-the
+If an indirect map is modified then the change will become effective immediately.
+If an indirect map uses the
+.B browse
+option, the master map contains direct mount maps or the
.I auto.master
map is modified then the
.B autofs
-script must be rerun to activate the changes.
+service control reload action must be rerun to activate the changes.
.P
.B @@initdir@@/autofs status
+or
+.B systemctl autofs.service status
will display the status of,
.BR automount (8)
-,running or not.
+,running or not. When using the systemd init system the status output includes
+somewhat more information related to the service status.
+.P
+.B systemctl(1)
+has more functions than the actions mentioned here, see
+.B systemctl(1)
+for more information.
.SH "SEE ALSO"
.BR automount (8),
.BR autofs (5),
.BR autofs.conf (5),
.BR auto.master (5).
.BR autofs_ldap_auth.conf (5)
+.BR systemctl(1)
.SH AUTHOR
This manual page was written by Christoph Lameter <chris@waterf.org>,
for the Debi GNU/Linux system. Edited by H. Peter Anvin
-<hpa@transmeta.com>.
+<hpa@transmeta.com> and Ian Kent <raven@themaw.net>.