sbin/mount_autofs/mount_autofs.8

   1 .\" Copyright (c) 2018 The DragonFly Project
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
  14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
  17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  23 .\" SUCH DAMAGE.
  24 .\"
  25 .Dd November 24, 2019
  26 .Dt MOUNT_AUTOFS 8
  27 .Os
  28 .Sh NAME
  29 .Nm mount_autofs
  30 .Nd mount autofs
  31 .Sh SYNOPSIS
  32 .Nm
  33 .Op Fl f Ar from
  34 .Op Fl o Ar options
  35 .Op Fl O Ar master_options
  36 .Op Fl p Ar master_prefix
  37 .Ar autofs
  38 .Ar mount_point
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 command should not usually be called by admins.
  43 Use
  44 .Xr automount 8
  45 instead.
  46 .Xr autofs 5
  47 is mountable using
  48 .Xr automount 8 ,
  49 which incorporates an
  50 .Xr auto_master 5
  51 parser, without having to specify
  52 .Xr autofs 5
  53 mount options via command line.
  54 .\" and that was the original intention of FreeBSD/autofs.
  55 .\" This is a low level version without auto_master(5) involved.
  56 .Pp
  57 The
  58 .Nm
  59 command attaches the automounter filesystem on the
  60 .Ar autofs
  61 device on to the file system tree at point
  62 .Ar mount_point .
  63 Both
  64 .Ar autofs
  65 and
  66 .Ar mount_point
  67 are converted to absolute paths before use.
  68 .Pp
  69 This command is normally executed by
  70 .Xr automount 8 .
  71 The options are as follows:
  72 .Bl -tag -width Ds
  73 .It Fl f
  74 Set the
  75 .Ar from
  76 location for
  77 .Xr autofs 5 .
  78 This argument is usually read from
  79 .Pa /etc/auto_master
  80 by
  81 .Xr automount 8 .
  82 .It Fl o
  83 Set the mount options.
  84 See the
  85 .Xr mount 8
  86 man page for possible options and their meanings.
  87 .It Fl O
  88 Set the
  89 .Xr autofs 5
  90 options.
  91 See the
  92 .Op Fl Ar options
  93 in
  94 .Sx AUTO_MASTER SYNTAX
  95 of
  96 .Xr auto_master 5 .
  97 .It Fl p
  98 Set the
  99 .Xr autofs 5
 100 prefix, below which the file system(s) will be mounted.
 101 .El
 102 .Sh SEE ALSO
 103 .Xr autofs 5 ,
 104 .Xr auto_master 5 ,
 105 .Xr fstab 5 ,
 106 .Xr automount 8 ,
 107 .Xr mount 8
 108 .Sh HISTORY
 109 The
 110 .Nm
 111 utility first appeared in
 112 .Nx 9.0 .
 113 The
 114 .Nm
 115 utility first appeared in
 116 .Dx 5.1 .
 117 .Sh AUTHORS
 118 The
 119 .Nm
 120 was ported to
 121 .Dx
 122 by
 123 .An Tomohiro Kusumi Aq Mt tkusumi@netbsd.org .