From patchwork Tue Apr 24 02:56:36 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chris Novakovic X-Patchwork-Id: 903255 X-Patchwork-Delegate: davem@davemloft.net Return-Path: X-Original-To: patchwork-incoming-netdev@ozlabs.org Delivered-To: patchwork-incoming-netdev@ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=netdev-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=chrisn.me.uk Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=chrisn.me.uk header.i=@chrisn.me.uk header.b="FD9X4rZX"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 40VSfy5ZJKz9rx7 for ; Tue, 24 Apr 2018 12:57:30 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932870AbeDXC52 (ORCPT ); Mon, 23 Apr 2018 22:57:28 -0400 Received: from mail-wr0-f174.google.com ([209.85.128.174]:36779 "EHLO mail-wr0-f174.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932722AbeDXC5D (ORCPT ); Mon, 23 Apr 2018 22:57:03 -0400 Received: by mail-wr0-f174.google.com with SMTP id u18-v6so19128418wrg.3 for ; Mon, 23 Apr 2018 19:57:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chrisn.me.uk; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=P8/EV6JnrY/2N+1LsimdI0irACHvSsoVadlHSi81sfU=; b=FD9X4rZXFq4FizbY4DZACEulkAw+oXV7R4rW+u3Ar+Xz88NZzolB40Q5TD8Z728KrC 6VquPrRKlkvPoZ9uwcSLfEmWdecHDo1tXWX7sFgEzm6LPcm7FsxEz+MdLta2M61jeoms 9QwhcBVrk8bW8QQcpcwwq2yLWjU/gCOkBucfc= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=P8/EV6JnrY/2N+1LsimdI0irACHvSsoVadlHSi81sfU=; b=ZYpFora3dyuKYGmrT3AnrSKUzG4GgM6rdVwrW4ZbpX74vz+2sLxlWNXLb0frtQdd7e HuXFMyf7jGUhopUC+F+khjVtHm8pp4mWEm+MpJoir3hyOXGPMgpksOPE1tbWwvcR7nKP s/q8Amcr96SR0XndhsCuvPd/0dPAt/CQSgqTWBuZcrQEYqVvcTd+S5KHdbRj8VqcCydQ N0yzh/2d6TFVVmDMu9nPc7J6mz01woOChBcWBFaWCVTcho6Bxn6j/6trnRraGKQhlBpv xr6kK8NE1h+tRO/8zl/TezO3umiztPPhvfPtNEH78cuHNznI29eMaQdA4kG7Iv8/38I1 mTqw== X-Gm-Message-State: ALQs6tC6qc/TgAHPt17U+UT/wL9sG4Hn860mpnALhCZdJk9T2sxkJciF xwBWqTmruO+TIvg61mjIi/CVBlm6 X-Google-Smtp-Source: AB8JxZoXrMfOMtNT/cql3MOVSzv1nUpXqoys4G2gtd64khrMbxaMDNnxCtEvE+0KHlTY8BNRGsJdRw== X-Received: by 10.28.85.129 with SMTP id j123mr11565407wmb.124.1524538622567; Mon, 23 Apr 2018 19:57:02 -0700 (PDT) Received: from stronghold.base.iphq.net (cpc83449-wolv18-2-0-cust181.16-1.cable.virginm.net. [82.32.71.182]) by smtp.gmail.com with ESMTPSA id b18-v6sm17407241wrb.55.2018.04.23.19.57.01 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 23 Apr 2018 19:57:02 -0700 (PDT) From: Chris Novakovic To: "David S. Miller" , netdev@vger.kernel.org Cc: Chris Novakovic Subject: [PATCH v2 5/8] ipconfig: Document /proc/net/pnp Date: Tue, 24 Apr 2018 03:56:36 +0100 Message-Id: <20180424025639.2228-6-chris@chrisn.me.uk> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20180424025639.2228-1-chris@chrisn.me.uk> References: <20180424025639.2228-1-chris@chrisn.me.uk> Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fully document the format used by the /proc/net/pnp file written by ipconfig, explain where its values originate from, and clarify that the tertiary name server IP and DNS domain name are only written to the file when autoconfiguration is used. Signed-off-by: Chris Novakovic --- Documentation/filesystems/nfs/nfsroot.txt | 34 ++++++++++++++++++++++++++----- 1 file changed, 29 insertions(+), 5 deletions(-) diff --git a/Documentation/filesystems/nfs/nfsroot.txt b/Documentation/filesystems/nfs/nfsroot.txt index 1513e5d663fd..a1030bea60d3 100644 --- a/Documentation/filesystems/nfs/nfsroot.txt +++ b/Documentation/filesystems/nfs/nfsroot.txt @@ -110,6 +110,9 @@ ip=::::::: will not be triggered if it is missing and NFS root is not in operation. + Value is exported to /proc/net/pnp with the prefix "bootserver " + (see below). + Default: Determined using autoconfiguration. The address of the autoconfiguration server is used. @@ -165,12 +168,33 @@ ip=::::::: Default: any - IP address of first nameserver. - Value gets exported by /proc/net/pnp which is often linked - on embedded systems by /etc/resolv.conf. + IP address of primary nameserver. + Value is exported to /proc/net/pnp with the prefix "nameserver " + (see below). + + Default: None if not using autoconfiguration; determined + automatically if using autoconfiguration. + + IP address of secondary nameserver. + See . + + After configuration (whether manual or automatic) is complete, a file is + created at /proc/net/pnp in the following format; lines are omitted if + their respective value is empty following configuration. + + #PROTO: (depending on configuration method) + domain (if autoconfigured, the DNS domain) + nameserver (primary name server IP) + nameserver (secondary name server IP) + nameserver (tertiary name server IP) + bootserver (NFS server IP) + + and are requested during autoconfiguration; they + cannot be specified as part of the "ip=" kernel command line parameter. - IP address of second nameserver. - Same as above. + Because the "domain" and "nameserver" options are recognised by DNS + resolvers, /etc/resolv.conf is often linked to /proc/net/pnp on systems + that use an NFS root filesystem. nfsrootdebug