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/state/nfs/rmtab
  46 file. When receiving an unmount request, that entry is removed.
  47 user level part of the NFS service.
  48 .P
  49 However, this file is mostly ornamental. One, the client can continue
  50 to use the file handle even after calling
  51 .B rpc.mountd 's
  52 UMOUNT procedure. And two, if a client reboots without notifying
  53 .B rpc.mountd ,
  54 a stale entry will remain in
  55 .BR rmtab .
  56 .SH OPTIONS
  57 .TP
  58 .B \-d " or " \-\-debug
  59 Turn on debugging.
  60 .TP
  61 .B \-F " or " \-\-foreground
  62 Run in foreground (do not daemonize)
  63 .TP
  64 .B \-f " or " \-\-exports-file
  65 This option specifies the exports file, listing the clients that this
  66 server is prepared to serve and parameters to apply to each
  67 such mount (see
  68 .BR exports (5)).
  69 By default, export information is read from
  70 .IR /etc/exports .
  71 .TP
  72 .B \-h " or " \-\-help
  73 Display usage message.
  74 .TP
  75 .B \-N " or " \-\-no-nfs-version
  76 This option can be used to request that
  77 .B rpc.mountd
  78 do not offer certain versions of NFS. The current version of
  79 .B rpc.mountd
  80 can support both NFS version 2 and the newer version 3. If the
  81 NFS kernel module was compiled without support for NFSv3,
  82 .B rpc.mountd
  83 must be invoked with the option
  84 .B "\-\-no-nfs-version 3" .
  85 .TP
  86 .B \-P
  87 Ignored (compatibility with unfsd??).
  88 .TP
  89 .B \-p " or " \-\-port
  90 Force
  91 .B rpc.mountd
  92 to bind to the specified port, instead of using the random port
  93 number assigned by the portmapper.
  94 .TP
  95 .B \-V " or " \-\-nfs-version
  96 This option can be used to request that
  97 .B rpc.mountd
  98 offer certain versions of NFS. The current version of
  99 .B rpc.mountd
 100 can support both NFS version 2 and the newer version 3.
 101 .TP
 102 .B \-v " or " \-\-version
 103 Print the version of
 104 .B rpc.mountd
 105 and exit.
 106
 107 .SH TCP_WRAPPERS SUPPORT
 108 This
 109 .B rpc.mountd
 110 version is protected by the
 111 .B tcp_wrapper
 112 library. You have to give the clients access to
 113 .B rpc.mountd
 114 if they should be allowed to use it. To allow connects from clients of
 115 the .bar.com domain you could use the following line in /etc/hosts.allow:
 116
 117 mountd: .bar.com
 118
 119 You have to use the daemon name
 120 .B mountd
 121 for the daemon name (even if the binary has a different name). For the
 122 client names you can only use the keyword ALL or IP addresses (NOT
 123 host or domain names).
 124
 125 For further information please have a look at the
 126 .BR tcpd (8),
 127 .BR hosts_allow (5)
 128 and
 129 .BR hosts_access (5)
 130 manual pages.
 131
 132 .SH SEE ALSO
 133 .BR rpc.nfsd (8),
 134 .BR exportfs (8),
 135 .BR exports (5),
 136 .BR rpc.rquotad (8).
 137 .SH FILES
 138 .BR /etc/exports ,
 139 .BR /var/state/nfs/xtab .
 140 .SH AUTHOR
 141 Olaf Kirch, H. J. Lu, G. Allan Morris III, and a host of others.