All of lore.kernel.org
 help / color / mirror / Atom feed
From: Alejandro Colomar <alx@kernel.org>
To: Don Brace <don.brace@microchip.com>
Cc: linux-man@vger.kernel.org
Subject: Re: [PATCH v4 3/5] smartpqi: update host attribute descriptions
Date: Tue, 3 Oct 2023 02:28:11 +0200	[thread overview]
Message-ID: <ZRtgG396-1Cj4gn2@debian> (raw)
In-Reply-To: <20231002195404.153182-4-don.brace@microchip.com>

[-- Attachment #1: Type: text/plain, Size: 2234 bytes --]

Hi Don,

On Mon, Oct 02, 2023 at 02:54:02PM -0500, Don Brace wrote:
> Minor description changes for host attributes.
> 
> Just some small changes to the host attribute descriptions.
> Remove the "version" sysfs entry. This entry was changed
> to two sysfs entries: driver_version and firmware_version.

Should we add a HISTORY section and document the old "version" sysfs
entry there, saying that it has been replaced by those two entries?

Thanks,
Alex

> 
> Reviewed-by: Scott Benesh <scott.benesh@microchip.com>
> Reviewed-by: Scott Teel <scott.teel@microchip.com>
> Reviewed-by: Mike McGowen <mike.mcgowen@microchip.com>
> Reviewed-by: Kevin Barnett <kevin.barnett@microchip.com>
> Signed-off-by: Don Brace <don.brace@microchip.com>
> ---
>  man4/smartpqi.4 | 21 ++-------------------
>  1 file changed, 2 insertions(+), 19 deletions(-)
> 
> diff --git a/man4/smartpqi.4 b/man4/smartpqi.4
> index 34864e60755b..c51405c8b9cc 100644
> --- a/man4/smartpqi.4
> +++ b/man4/smartpqi.4
> @@ -135,29 +135,12 @@ The host
>  attribute is a write-only attribute.
>  Writing to this attribute will cause the driver to scan for new,
>  changed, or removed devices (e.g., hot-plugged tape drives, or newly
> -configured or deleted logical drives) and notify the SCSI mid-layer of
> +configured or deleted logical volumes) and notify the SCSI mid-layer of
>  any changes detected.
>  Usually this action is triggered automatically by configuration
>  changes, so the user should not normally have to write to this file.
>  Doing so may be useful when hot-plugging devices such as tape drives or
> -entire storage boxes containing pre-configured logical drives.
> -.TP
> -.IR /sys/class/scsi_host/host * /version
> -The host
> -.I version
> -attribute is a read-only attribute.
> -This attribute contains the driver version and the controller firmware
> -version.
> -.IP
> -For example:
> -.IP
> -.in +4n
> -.EX
> -$ \c
> -.B cat /sys/class/scsi_host/host1/version
> -driver: 1.1.2\-126
> -firmware: 1.29\-112
> -.EE
> +entire storage boxes containing pre-configured logical volumes.
>  .in
>  .TP
>  .IR /sys/class/scsi_host/host * /lockup_action
> -- 
> 2.42.0.296.g493f462273
> 

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

  reply	other threads:[~2023-10-03  0:28 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-10-02 19:53 [PATCH v4 0/5] smartpqi man page updates Don Brace
2023-10-02 19:54 ` [PATCH v4 1/5] smartpqi: add module parameter ctrl_ready_timeout Don Brace
2023-10-03  0:24   ` Alejandro Colomar
2023-10-02 19:54 ` [PATCH v4 2/5] smartpqi: update FILES section Don Brace
2023-10-02 19:54 ` [PATCH v4 3/5] smartpqi: update host attribute descriptions Don Brace
2023-10-03  0:28   ` Alejandro Colomar [this message]
2023-10-02 19:54 ` [PATCH v4 4/5] smartpqi: add host attributes Don Brace
2023-10-02 19:54 ` [PATCH v4 5/5] smartpqi: add device attributes Don Brace

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=ZRtgG396-1Cj4gn2@debian \
    --to=alx@kernel.org \
    --cc=don.brace@microchip.com \
    --cc=linux-man@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.