autofs-5.0.9 - update man page autofs(8) for systemd From: Ian Kent 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(-) diff --git a/CHANGELOG b/CHANGELOG index f14fb1b..e707045 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -14,6 +14,7 @@ - fix typo in flagdir configure option. - clarify multiple mounts description. - gaurd against incorrect umount return. +- update man page autofs(8) for systemd. 28/03/2014 autofs-5.0.9 ======================= diff --git a/man/autofs.8.in b/man/autofs.8.in index fae0b00..602fd77 100644 --- a/man/autofs.8.in +++ b/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,27 +38,43 @@ will mount and start a thread, with the appropriate parameters, to 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 auto.master (5). .BR autofs_ldap_auth.conf (5) +.BR systemctl(1) .SH AUTHOR This manual page was written by Christoph Lameter , for the Debi GNU/Linux system. Edited by H. Peter Anvin -. + and Ian Kent .