utils/mountd/mountd.man

   1 .\"
   2 .\" mountd(8)
   3 .\"
   4 .\" Copyright (C) 1999 Olaf Kirch <okir@monad.swb.de>
   5 .TH rpc.mountd 8 "25 Aug 2000"
   6 .SH NAME
   7 rpc.mountd \- NFS mount daemon
   8 .SH SYNOPSIS
   9 .BI "/usr/sbin/rpc.mountd [" options "]"
  10 .SH DESCRIPTION
  11 The
  12 .B rpc.mountd
  13 program implements the NFS mount protocol. When receiving a MOUNT
  14 request from an NFS client, it checks the request against the list of
  15 currently exported file systems. If the client is permitted to mount
  16 the file system,
  17 .B rpc.mountd
  18 obtains a file handle for requested directory and returns it to
  19 the client.
  20 .SS Exporting NFS File Systems
  21 Making file systems available to NFS clients is called
  22 .IR exporting .
  23 .P
  24 Usually, a file system and the hosts it should be made available to
  25 are listed in the
  26 .B /etc/exports
  27 file, and invoking
  28 .B exportfs -a
  29 whenever the system is booted. The
  30 .BR exportfs (8)
  31 command makes export information available to both the kernel NFS
  32 server module and the
  33 .B rpc.mountd
  34 daemon.
  35 .P
  36 Alternatively, you can export individual directories temporarily
  37 using
  38 .BR exportfs 's
  39 .IB host : /directory
  40 syntax.
  41 .SS The rmtab File
  42 For every mount request received from an NFS client,
  43 .B rpc.mountd
  44 adds an entry to the
  45 .B /var/lib/nfs/rmtab
  46 file. When receiving an unmount request, that entry is removed.
  47 .P
  48 However, this file is mostly ornamental. One, the client can continue
  49 to use the file handle even after calling
  50 .B rpc.mountd 's
  51 UMOUNT procedure. And two, if a client reboots without notifying
  52 .B rpc.mountd ,
  53 a stale entry will remain in
  54 .BR rmtab .
  55 .SH OPTIONS
  56 .TP
  57 .B \-d kind " or " \-\-debug kind
  58 Turn on debugging. Valid kinds are: all, auth, call, general and parse.
  59 .TP
  60 .B \-F " or " \-\-foreground
  61 Run in foreground (do not daemonize)
  62 .TP
  63 .B \-f " or " \-\-exports-file
  64 This option specifies the exports file, listing the clients that this
  65 server is prepared to serve and parameters to apply to each
  66 such mount (see
  67 .BR exports (5)).
  68 By default, export information is read from
  69 .IR /etc/exports .
  70 .TP
  71 .B \-h " or " \-\-help
  72 Display usage message.
  73 .TP
  74 .B \-o num " or " \-\-descriptors num
  75 Set the limit of the number of open file descriptors to num. The
  76 default is to leave the limit unchanged.
  77 .TP
  78 .B \-N " or " \-\-no-nfs-version
  79 This option can be used to request that
  80 .B rpc.mountd
  81 do not offer certain versions of NFS. The current version of
  82 .B rpc.mountd
  83 can support both NFS version 2 and the newer version 3. If the
  84 NFS kernel module was compiled without support for NFSv3,
  85 .B rpc.mountd
  86 must be invoked with the option
  87 .B "\-\-no-nfs-version 3" .
  88 .TP
  89 .B \-n " or " \-\-no-tcp
  90 Don't advertise TCP for mount.
  91 .TP
  92 .B \-P
  93 Ignored (compatibility with unfsd??).
  94 .TP
  95 .B \-p " or " \-\-port num
  96 Force
  97 .B rpc.mountd
  98 to bind to the specified port num, instead of using the random port
  99 number assigned by the portmapper.
 100 .TP
 101 .B \-V " or " \-\-nfs-version
 102 This option can be used to request that
 103 .B rpc.mountd
 104 offer certain versions of NFS. The current version of
 105 .B rpc.mountd
 106 can support both NFS version 2 and the newer version 3.
 107 .TP
 108 .B \-v " or " \-\-version
 109 Print the version of
 110 .B rpc.mountd
 111 and exit.
 112
 113 .SH TCP_WRAPPERS SUPPORT
 114 This
 115 .B rpc.mountd
 116 version is protected by the
 117 .B tcp_wrapper
 118 library. You have to give the clients access to
 119 .B rpc.mountd
 120 if they should be allowed to use it. To allow connects from clients of
 121 the .bar.com domain you could use the following line in /etc/hosts.allow:
 122
 123 mountd: .bar.com
 124
 125 You have to use the daemon name
 126 .B mountd
 127 for the daemon name (even if the binary has a different name).
 128
 129 For further information please have a look at the
 130 .BR tcpd (8)
 131 and
 132 .BR hosts_access (5)
 133 manual pages.
 134
 135 .SH SEE ALSO
 136 .BR rpc.nfsd (8),
 137 .BR exportfs (8),
 138 .BR exports (5),
 139 .BR rpc.rquotad (8).
 140 .SH FILES
 141 .BR /etc/exports ,
 142 .BR /var/lib/nfs/xtab .
 143 .SH AUTHOR
 144 Olaf Kirch, H. J. Lu, G. Allan Morris III, and a host of others.