utils/nfsd/nfsd.man

   1 .\"
   2 .\" nfsd(8)
   3 .\"
   4 .\" Copyright (C) 1999 Olaf Kirch <okir@monad.swb.de>
   5 .TH rpc.nfsd 8 "7 Aug 2006"
   6 .SH NAME
   7 rpc.nfsd \- NFS server process
   8 .SH SYNOPSIS
   9 .BI "/usr/sbin/rpc.nfsd [" options "]" " "nproc
  10 .SH DESCRIPTION
  11 The
  12 .B rpc.nfsd
  13 program implements the user level part of the NFS service. The
  14 main functionality is handled by the
  15 .B nfsd
  16 kernel module. The user space program merely specifies what sort of sockets
  17 the kernel service should listen on, what NFS versions it should support, and
  18 how many kernel threads it should use.
  19 .P
  20 The
  21 .B rpc.mountd
  22 server provides an ancillary service needed to satisfy mount requests
  23 by NFS clients.
  24 .SH OPTIONS
  25 .TP
  26 .B \-d " or " \-\-debug
  27 enable logging of debugging messages
  28 .TP
  29 .B \-H " or " \-\-host  hostname
  30 specify a particular hostname (or address) that NFS requests will
  31 be accepted on. By default,
  32 .B rpc.nfsd
  33 will accept NFS requests on all known network addresses.
  34 Note that
  35 .B lockd
  36 (which performs file locking services for NFS) may still accept
  37 request on all known network addresses.  This may change in future
  38 releases of the Linux Kernel.
  39 .TP
  40 .B \-p " or " \-\-port  port
  41 specify a diferent port to listen on for NFS requests. By default,
  42 .B rpc.nfsd
  43 will listen on port 2049.
  44 .TP
  45 .B \-N " or " \-\-no-nfs-version vers
  46 This option can be used to request that
  47 .B rpc.nfsd
  48 does not offer certain versions of NFS. The current version of
  49 .B rpc.nfsd
  50 can support both NFS version 2,3 and the newer version 4.
  51 .TP
  52 .B \-s " or " \-\-syslog
  53 By default,
  54 .B rpc.nfsd
  55 logs error messages (and debug messages, if enabled) to stderr. This option makes
  56 .B rpc.nfsd
  57 log these messages to syslog instead. Note that errors encountered during
  58 option processing will still be logged to stderr regardless of this option.
  59 .TP
  60 .B \-T " or " \-\-no-tcp
  61 Disable
  62 .B rpc.nfsd
  63 from accepting TCP connections from clients.
  64 .TP
  65 .B \-U " or " \-\-no-udp
  66 Disable
  67 .B rpc.nfsd
  68 from accepting UDP connections from clients.
  69 .TP
  70 .I nproc
  71 specify the number of NFS server threads. By default, just one
  72 thread is started. However, for optimum performance several threads
  73 should be used. The actual figure depends on the number of and the work
  74 load created by the NFS clients, but a useful starting point is
  75 8 threads. Effects of modifying that number can be checked using
  76 the
  77 .BR nfsstat (8)
  78 program.
  79 .P
  80 Note that if the NFS server is already running, then the options for
  81 specifying host, port, and protocol will be ignored.  The number of
  82 processes given will be the only option considered, and the number of
  83 active
  84 .B nfsd
  85 processes will be increased or decreased to match this number.
  86 In particular
  87 .B rpc.nfsd 0
  88 will stop all threads and thus close any open connections.
  89
  90 .SH NOTES
  91 If the program is built with TI-RPC support, it will enable any protocol and
  92 address family combinations that are marked visible in the
  93 .B netconfig
  94 database.
  95
  96 .SH SEE ALSO
  97 .BR rpc.mountd (8),
  98 .BR exports (5),
  99 .BR exportfs (8),
 100 .BR rpc.rquotad (8),
 101 .BR nfsstat (8),
 102 .BR netconfig(5).
 103 .SH AUTHOR
 104 Olaf Kirch, Bill Hawes, H. J. Lu, G. Allan Morris III,
 105 and a host of others.