[PATCH V2 0/5] nvme: Refactor and expose per-controller timeout configuration
Maurizio Lombardi
mlombard at redhat.com
Fri Feb 20 04:51:03 PST 2026
This patchset tries to address some limitations in how the NVMe driver handles
command timeouts.
Currently, the driver relies heavily on global module parameters
(NVME_IO_TIMEOUT and NVME_ADMIN_TIMEOUT), making it difficult for users to
tune timeouts for specific controllers that may have very different
characteristics. Also, in some cases, manual changes to sysfs timeout values
are ignored by the driver logic.
For example this patchset removes the unconditional timeout assignment in
nvme_init_request. This allows the block layer to correctly apply the request
queue's timeout settings, ensuring that user-initiated changes via sysfs
are actually respected for all requests.
It introduces new sysfs attributes (admin_timeout and io_timeout) to the NVMe
controller. This allows users to configure distinct timeout requirements for
different controllers rather than relying on global module parameters.
Some examples:
Changes to the controller's io_timeout gets propagated to all
the associated namespaces' queues:
# find /sys -name 'io_timeout'
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n1/queue/io_timeout
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n2/queue/io_timeout
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n3/queue/io_timeout
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/io_timeout
# echo 27000 > /sys/devices/virtual/nvme-fabrics/ctl/nvme0/io_timeout
# cat /sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n1/queue/io_timeout
27000
# cat /sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n2/queue/io_timeout
27000
# cat /sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n3/queue/io_timeout
27000
When adding a namespace target-side, the io_timeout is inherited from
the controller's preferred timeout:
* target side *
# nvmetcli
/> cd subsystems/test-nqn/namespaces/4
/subsystems/t.../namespaces/4> enable
The Namespace has been enabled.
************
* Host-side *
nvme nvme0: rescanning namespaces.
# find /sys -name 'io_timeout'
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n1/queue/io_timeout
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n2/queue/io_timeout
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n3/queue/io_timeout
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n4/queue/io_timeout <-- new namespace
/sys/devices/virtual/nvme-fabrics/ctl/nvme0/io_timeout
# cat /sys/devices/virtual/nvme-fabrics/ctl/nvme0/nvme0c0n4/queue/io_timeout
27000
***********
io_timeout and admin_timeout module parameters are used as default
values for new controllers:
# nvme connect -t tcp -a 10.37.153.138 -s 8000 -n test-nqn2
connecting to device: nvme1
# cat /sys/devices/virtual/nvme-fabrics/ctl/nvme1/nvme1c1n1/queue/io_timeout
30000
# cat /sys/devices/virtual/nvme-fabrics/ctl/nvme1/admin_timeout
60000
V2: Drop the RFC tag
apply the timeout settings to fabrics_q and connect_q too
Code style fixes
remove unnecessary check for null admin_q in __nvme_delete_io_queues()
Use DEVICE_ATTR() macro
Heyne, Maximilian (1):
nvme: Let the blocklayer set timeouts for requests
Maurizio Lombardi (4):
nvme: add sysfs attribute to change admin timeout per nvme controller
nvme: pci: use admin queue timeout over NVME_ADMIN_TIMEOUT
nvme: add sysfs attribute to change IO timeout per nvme controller
nvme: use per controller timeout waits over depending on global
default
drivers/nvme/host/apple.c | 2 +-
drivers/nvme/host/core.c | 9 ++---
drivers/nvme/host/nvme.h | 3 +-
drivers/nvme/host/pci.c | 5 +--
drivers/nvme/host/rdma.c | 2 +-
drivers/nvme/host/sysfs.c | 74 +++++++++++++++++++++++++++++++++++++++
drivers/nvme/host/tcp.c | 2 +-
7 files changed, 87 insertions(+), 10 deletions(-)
--
2.53.0
More information about the Linux-nvme
mailing list