From: Don Brace <don.brace@microchip.com>
To: <alx@kernel.org>
Cc: <linux-man@vger.kernel.org>
Subject: [PATCH v4 0/5] smartpqi man page updates
Date: Mon, 2 Oct 2023 14:53:59 -0500 [thread overview]
Message-ID: <20231002195404.153182-1-don.brace@microchip.com> (raw)
These patches are based the man page content found in
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
The Linux man page smartpqi.4 is out-of-date with the man page provided
by our out-of-box driver. This patch series brings the Linux man page up
to date.
The changes are:
smarpqi-update-copyright-and-email-addresses
The copyright, email, and URLs have changed to Microchip.
smartpqi-update-module-parameter-descriptions
We changed some descriptions of some of our module parameters.
Clarifies what their default values are.
smartpqi-add-module-parameter_disable_managed_interrupts
We added a new module parameter to allow users to disable how
interrupts are managed allowing them to change affinity.
smartpqi-add-module-parameter_ctrl_ready_timeout
We added a new module parameter to allow users to change how
long the driver waits for the controller becomes ready. The
default is 180 seconds and can be changed from 30-1800 seconds.
The longer wait times are useful for large configurations.
smartpqi-update_FILES_section
Minor change to the FILES section. The word "Logical" was changed to
"Disk" since HBA disks are also supported.
smartpqi-update-host-attribute-descriptions
Updated the descriptions of existing host attributes accessed through
sysfs.
smartpqi-update-device-attribute-descriptions
Updated the descriptions of existing device attributes accessed through
sysfs.
smartpqi-add-host-attributes
We added some new host attributes:
enable_stream_detection: For RAID5/6 sequential write operations, this
can help increase IOPS. Reduces Read/Modify/Write operations.
This is for AIO capable devices. (Volumes consisting of non-rotating
media).
enable_r5_writes: Send down RAID 5 write operations down the AIO path.
enable_r6_writes: Send down RAID 6 write operations down the AIO path.
smartpqi-add-device-attributes
We added some new device attributes:
lunid - SCSI LUN ID
unique_id - 16-byte ID that uniquely identifies the device within the controller.
path_info - Host:Bus:Target:Lun (h:b:t:l), device type, Active/Inactive
raid_bypass_cnt - Count of the number of request sent down the AIO path.
sas_ncq_prio_enable - Enables SATA NCQ priority support.
smartpqi-add-sg-entry-to-see_also
Simple addition of the sg(4) driver to the SEE ALSO section.
Changes since V3:
Updated content for the following pages due to reviews by:
Alejandro Colomar <alx@kernel.org>
smartpqi: add module parameter ctrl_ready_timeout
Link: https://lore.kernel.org/linux-man/axwssorupkp6fv3b7zqgjyd243exvhlw7rle2ftyy43jxhm4yf@woxzbz4hm766/
smartpqi: update FILES section
Link: https://lore.kernel.org/linux-man/fwpvmbussvf2zzug5bsqhrd7mvwcvdllvna6a4ngke3hw6w5am@b4icgpgirck4/
smartpqi: update host attribute descriptions
Link: https://lore.kernel.org/linux-man/ss7k5ooeoi7y56j6otvdpwhgd5yltzk6nt5l6ujiiupxzpmrdx@zrcvhw364ejx/
smartpqi: add host attributes
Link: https://lore.kernel.org/linux-man/nbt3jt7busx6akj7ykaxs7df6vlbbxtvcdy4ckvlp7saol3djl@rb6ckz3lzzot/
smartpqi: add device attributes
Link: https://lore.kernel.org/linux-man/ytcsqleu53iwpn5gsjmmuoqz2cy5oegvvafwlwxn422bcn3a5e@ne3khvixxzuq/
The other patches have already been applied and were removed from the
remaining patch set after a rebase.
Thanks for your attention and reviews for these patches.
Changes since V2:
Resending due to bad e-mail address for maintainer.
Changes since V1:
Broke up the large patch into multiple smaller patches due to review by:
Alejandro Colomar <alx@kernel.org>
Link: https://lore.kernel.org/all/096ed4d5-945f-5ac9-eba3-c9be5d32cfe8@kernel.org/
---
Don Brace (5):
smartpqi: add module parameter ctrl_ready_timeout
smartpqi: update FILES section
smartpqi: update host attribute descriptions
smartpqi: add host attributes
smartpqi: add device attributes
man4/smartpqi.4 | 182 ++++++++++++++++++++++++++++++++++++++++++------
1 file changed, 162 insertions(+), 20 deletions(-)
--
2.42.0.296.g493f462273
next reply other threads:[~2023-10-02 19:51 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-10-02 19:53 Don Brace [this message]
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
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=20231002195404.153182-1-don.brace@microchip.com \
--to=don.brace@microchip.com \
--cc=alx@kernel.org \
--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.