Received: by 2002:a05:6a10:c604:0:0:0:0 with SMTP id y4csp892753pxt; Fri, 6 Aug 2021 17:11:41 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzEpXccoVHKjEofQeV4oa15XqnP3siixCxQGZtLDafS3qRb0IbqS4AEYsT/eZurG73K7ExL X-Received: by 2002:a05:6e02:1c23:: with SMTP id m3mr214175ilh.294.1628295101468; Fri, 06 Aug 2021 17:11:41 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1628295101; cv=none; d=google.com; s=arc-20160816; b=epIax+xcQ9A0ZhAvKc/tpG5v4T/fFZj+IwJSRzKkhBApVETbehiqA3462wL3MXVdx5 +G5DTYn2ZhWoG6dG0YPJH9hsbuLrYTppe6z9cQs3RPG7Pbiq0tTm7I+n2EA3RjbZereF rimwzeh8B/ARxk8VWWsKVSIO905qQV11U51fi84PNwQElmFtbOhT+3XAplepbeKbE6Ey z0lLSaRbvfv/pjBIuc7sHfdTfsvE6fCQgDCYaRwy4nZpJQETj2Yr9RkRh6gQ4U5M8oEQ iLs/JfhCT+rxJzM8Q1NXZFvGtdCNIHPUooC8bW+tIUD3vbR6NoyUXs3UC9DK3+sMSRG8 KfjQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from:sender :dkim-signature; bh=LfJF5ZM5m1VsjeWH4hRk9GjbL/OhCo3AfC51ULJ1aRk=; b=By3JnV0BFy51Q06M0UufvSKI3CdEjbZ5yK29ptrw4RKfUqiI6qi2IofYaMsPNAXRw6 iWa/xZOJ4HAeRL4IygmJDIT8REpbgUfVXRIiLdxhZKSd1zhZQsGAk51J3crkzf1AQu+n aFEvaSjDDvKyOcIhzLcEy0bwjD8mPCR9KnoGDPzjVZ/lgOyDIyta/a/o3WICwvFT2f02 w7lBBSuIma5ypTcrq6yl1dPLMgYMJZY2t+bcBy6/4aPZ7kb45aCqUqLcv3lSmAhvYPzl b2lRRwN+6efnf76IZlJMcV6xtRk32mypHrNVe7hPePceH2y3x76WUrpQwvApy+WP9IcZ pjhQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b="Cd/0n22a"; spf=pass (google.com: domain of linux-nfs-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-nfs-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id j17si10916150ilq.87.2021.08.06.17.11.29; Fri, 06 Aug 2021 17:11:41 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-nfs-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b="Cd/0n22a"; spf=pass (google.com: domain of linux-nfs-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-nfs-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S244856AbhHFUSG (ORCPT + 99 others); Fri, 6 Aug 2021 16:18:06 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52162 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S244866AbhHFUSG (ORCPT ); Fri, 6 Aug 2021 16:18:06 -0400 Received: from mail-qk1-x72a.google.com (mail-qk1-x72a.google.com [IPv6:2607:f8b0:4864:20::72a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1088EC061798 for ; Fri, 6 Aug 2021 13:17:50 -0700 (PDT) Received: by mail-qk1-x72a.google.com with SMTP id f12so10065681qkh.10 for ; Fri, 06 Aug 2021 13:17:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=LfJF5ZM5m1VsjeWH4hRk9GjbL/OhCo3AfC51ULJ1aRk=; b=Cd/0n22a2bWDMleFZfAdSbIoJe4qCJMwVNq+HO2PWMKWZiy6cEgcOpRslr56JERmUC 4jGl2pRlLkFEPB/XptBkwUo0cg7yJr8sS1FY/8x5Zi1p08WhViBL/eDe6LSf+pCvkFbC AF/EwtkgBUlGeJUH433OtAkV/LJaBEh1biEcayKsmkrZMnGSbN1XfQmpn92Vo+QWF5Ne CgQyPIAoRolEPsTI1R1XWtH8pBz1O7dwePRWz0WXTsy1CWjMDEBeVC+rZVt3SenMl0vX vnEMQVXb4LeYvNISEQRhhJgGT3b4hzYKVxGMuI25YE48ku2a0lcTFoAp7KuRdcLm9RsO NnpA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:content-transfer-encoding; bh=LfJF5ZM5m1VsjeWH4hRk9GjbL/OhCo3AfC51ULJ1aRk=; b=YycpcAndH7WVsDcKjTLEdVLoZWuH9Sf5vVMCD22f5GHnFFqeqDJrz0yOS/HC9S8CE9 PTPibs7KF/6BUN0I5L49Ypcds9iTwMz5phyAN354kx5QVmmhu8KhGRL3t79qNha7tR8R Y9qjeoKAz7DfzhXn7KbVoe2QbEXIuHe+POlaMCjeTzF6S3QifuZOjaOKl5ZmGkkcunhV bUNVpxd5tuw9wxKRCKeGyn4G4HHGtcXBma9r0DU/nJ9XtKXqiIryho8MkOO5k1FOKuAB LVPWS3R9W/xDQxy2P3gVQfSp+Gq8qLZXsLZs/pd2RGJEQvaATKtZB5IdHiLSiXaaXNte 713A== X-Gm-Message-State: AOAM533r/zHT+K0d2ahFlN+bXhnVWSlDrtSs0O1zt0leUKewdmu5qWC2 gwlnIWgHyX3CrTtn1PCU4p8= X-Received: by 2002:a37:688d:: with SMTP id d135mr9183484qkc.112.1628281069159; Fri, 06 Aug 2021 13:17:49 -0700 (PDT) Received: from localhost.localdomain ([2601:401:100:a3a:aa6d:aaff:fe2e:8a6a]) by smtp.gmail.com with ESMTPSA id g11sm3705720qtk.91.2021.08.06.13.17.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 06 Aug 2021 13:17:48 -0700 (PDT) Sender: Anna Schumaker From: schumaker.anna@gmail.com X-Google-Original-From: Anna.Schumaker@Netapp.com To: steved@redhat.com, linux-nfs@vger.kernel.org Cc: Anna.Schumaker@Netapp.com Subject: [PATCH v2 8/9] nfs-sysfs: Add a man page Date: Fri, 6 Aug 2021 16:17:38 -0400 Message-Id: <20210806201739.472806-9-Anna.Schumaker@Netapp.com> X-Mailer: git-send-email 2.32.0 In-Reply-To: <20210806201739.472806-1-Anna.Schumaker@Netapp.com> References: <20210806201739.472806-1-Anna.Schumaker@Netapp.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org From: Anna Schumaker Signed-off-by: Anna Schumaker --- tools/nfs-sysfs/nfs-sysfs.man | 88 +++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 tools/nfs-sysfs/nfs-sysfs.man diff --git a/tools/nfs-sysfs/nfs-sysfs.man b/tools/nfs-sysfs/nfs-sysfs.man new file mode 100644 index 000000000000..3ebbeaf93eaa --- /dev/null +++ b/tools/nfs-sysfs/nfs-sysfs.man @@ -0,0 +1,88 @@ +.\" +.\" nfs-sysfs(8) +.\" +.TH nfs-sysfs 8 "05 Aug 2021" +.SH NAME +nfs-sysfs \- Displays NFS & SunRPC connection information +.SH SYNOPSIS +.B nfs-sysfs +.RB [ \-h | \-\-help ] +.P +.B nfs-sysfs rpc-client +.RB [ \-h | \-\-help ] +.RB [ \--id +.IR ID ] +.P +.B nfs-sysfs xprt-switch +.RB [ \-h | \-\-help ] +.RB [ \--id +.IR ID ] +.P +.B nfs-sysfs xprt-switch set +.RB [ \-h | \-\-help ] +.RB [ \--id +.IR ID ] +.RB [ \--dstaddr +.IR dstaddr] +.P +.B nfs-sysfs xprt +.RB [ \-h | \-\-help ] +.RB [ \--id +.IR ID ] +.P +.B nfs-sysfs xprt set +.RB [ \-h | \-\-help ] +.RB [ \--id +.IR ID ] +.RB [ \--dstaddr +.IR dstaddr] +.RB [ --offline ] +.RB [ --online ] +.RB [ --remove ] +.P +.SH DESCRIPTION +.RB "The " nfs-sysfs " command displays information collected in the SunRPC sysfs files about the system's SunRPC objects. +.P +.SS Objects +Valid +.BR nfs-sysfs (8) +objects are: +.IP "\fBrpc-client\fP" +Display information about this system's RPC clients. +.IP "\fBxprt-switch\fP" +Display information about groups of transports. +.IP "\fBxprt\fP" +Display detailed information about each transport that exists on the system. +.SH OPTIONS +.SS Options valid for all objects +.TP +.B \-h, \-\-help +Show the help message and exit +.TP +.B \-\-id \fIID +Set or display properties for the object with the given +.IR ID. +This option is mandatory for setting properties. +.SS Options specific to the `xprt-switch set` sub-command +.TP +.B \-\-dstaddr \fIdstaddr +Change the destination address of all transports in the xprt-switch to +.IR dstaddr +.SS Options specific to the `xprt set` sub-command +.TP +.B \-\-dstaddr \fIdstaddr +Change the destination address of this specific transport to +.TP +.B \-\-offline +Change the transport state from online to offline +.TP +.B \-\-online +Change the transport state from offline to online +.TP +.B \-\-remove +Removes the transport from the xprt-switch. Note that "main" transports cannot be removed. +.SH DIRECTORY +.TP +.B /sys/kernel/sunrpc/ +.SH AUTHOR +Anna Schumaker -- 2.32.0