From owner-freebsd-doc@freebsd.org  Thu May 25 12:11:23 2017
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id B6849D802E9
 for <freebsd-doc@mailman.ysv.freebsd.org>;
 Thu, 25 May 2017 12:11:23 +0000 (UTC)
 (envelope-from canine.matt@gmail.com)
Received: from mail-io0-x230.google.com (mail-io0-x230.google.com
 [IPv6:2607:f8b0:4001:c06::230])
 (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
 (Client CN "smtp.gmail.com",
 Issuer "Google Internet Authority G2" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 8388A17D9
 for <freebsd-doc@freebsd.org>; Thu, 25 May 2017 12:11:23 +0000 (UTC)
 (envelope-from canine.matt@gmail.com)
Received: by mail-io0-x230.google.com with SMTP id k91so135102518ioi.1
 for <freebsd-doc@freebsd.org>; Thu, 25 May 2017 05:11:23 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=mime-version:from:date:message-id:subject:to;
 bh=UBwCuW5vFP7mxmWqYVhD5nYV7Dv8PWDRlO6ERYmc6fk=;
 b=LMG1fmSbzIHlsL6RieASTvtZAhYEboOF9XzvRqxf4RMBRKna0yjb324cPyDLv+a3Py
 +KppTXswJeVFZcHURsOaGswQ3tUweyu0V9ZIfNuFpUfVV6mAxZX1ynLMJV0Zy4C8Wrm3
 cA8DO7WioyuAjrNnB1gUPvYYKwYrG9ddG+7PmpLC/dJz8r9R+P1SDIzjQYw2JhWJaStD
 T+If9yEjL/Y/gOeMVrQj6R3IUUCvhz0UyoKZOllQ4nXOvCMbBoHfPT6PmXv3awFzDSNg
 s5J5fDULxa7MUud916zcYv7h6ZR0rE6qnyXHLQ4Iqc3Idh4U6X/pTBdwMDfE+aB/lgkO
 CJtw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:mime-version:from:date:message-id:subject:to;
 bh=UBwCuW5vFP7mxmWqYVhD5nYV7Dv8PWDRlO6ERYmc6fk=;
 b=mRvyQxP/O1m0dBL49ajY7cZqpwBIS7LOWuppHLAmTX6odIMgzT0wmt7/Hwcur9wZQs
 wSIlzPFV3x1SAaeEyEgF34v6EUvEtwy5f7hfA0TtSQ0sNzL/c7Gd4NmcjKB62V0Qo6al
 xQI3k27vRHWmBqVR7eIwUBm7yx1RCh75TSYTlGWQOoOVyWXO6pHYRU2/4P5apYw/Gke4
 rnuyId3AP8Wt1FghLxMEAG/hf7IBZbrnkhZekQACyK53YCYlFvITlW2FHG/L0npGwK12
 1QZIyMQw+FG39pmqSvjGErV9X4KvtnL6OdNWlHt0mZ9Itz54aTbVyXkUegkunjFZ85wo
 qkrg==
X-Gm-Message-State: AODbwcCcmC5QYGmRabZbJXeX5GGDvVQ2t4bbr+oQDrBZJRvqHLaQ3Kvr
 3rFdlLEoiMZ7ZdfKr6wQucXHFPPhafkK
X-Received: by 10.107.17.134 with SMTP id 6mr35997176ior.177.1495714282714;
 Thu, 25 May 2017 05:11:22 -0700 (PDT)
MIME-Version: 1.0
From: Matthew Kelly <canine.matt@gmail.com>
Date: Thu, 25 May 2017 12:11:12 +0000
Message-ID: <CAM008vMaBreo1GCWp6D8SEPoHYCjQ9eYXUH6Bq_h3Dy-N0hWEA@mail.gmail.com>
Subject: NFS documentation addition
To: freebsd-doc@freebsd.org
Content-Type: text/plain; charset="UTF-8"
X-Content-Filtered-By: Mailman/MimeDel 2.1.23
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 25 May 2017 12:11:23 -0000

Something I think should be added to the NFS section of the handbook is a
note that when setting up new shares or otherwise configuring your
/etc/exports, the order in which the services are started or restarted
matters. It took me a lot of time to figure that out (finally ending with
it being pointed out to me on the freebsd.org forums), but it isn't
mentioned anywhere in the NFS section of the handbook. The three daemons
are listed, but they aren't even listed in the order that they need to be
started.

So I would like to see that section of the handbook modified to either
explicitly state that they have to be restarted in the right order for NFS
to work, or to at least have the little daemon list reordered to
rpcbind>nfsd>mountd.

Thank you.