From nobody Fri Aug 28 04:52:35 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4hWQx023X3z6q7MV for ; Fri, 28 Aug 2026 04:52:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR2" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hWQwz5bXdz3Yn6 for ; Fri, 28 Aug 2026 04:52:35 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1787892755; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=aQseZlkft8hcJ36BMovTPTgWQTdon3yX0UZuK0EIKMQ=; b=ddunoYlGc6LSnQ6b20LHzRvpEKwhtiq/DsmNJ+R8R51ovSfU3KbD+Rrbnx6zi0zns9JmLv JEwl4iCmVPg0BSOdHM8TiAh9oH8g3ET+YRFsVQGkJWYkY1CDwxiEqpRhVaBs20JOqjVOhu F9EVf0C0LneRWKkzivhwPKu87WwlZ/FsYuzFAm+oJiWIZ43Dio+rYrAg/pBSoJ6+ocsBEz H06HdvIwCMM5ORmwDaRW9TWV7/iql5ewtvAJ+17hCkm8deBktKOTpsKHJsPE/eSpiKkuVG A+r1fpZLv/LUWpkx5hBBNRUlySs/iw4oEboaP8Wqsalu7Yde15RB3OSHYyyARQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1787892755; a=rsa-sha256; cv=none; b=u6ATPK/DGdKCGpPtPRaBbPPe7raH/Dt6d+F0rry+Fi7gEL0F9DsNtCCEqqUgoFTDbG2vAW aFr/rmqD8jzemp28pvTpOXHeqted5ZDqukv55YjVVfaIk3y1iweQ6KvZUpUkkee2cj8ntS 8JsSsdoxIfhSz5hWOgUnNeOYu56PUp0BSHft7xrP7aw/D96K7GHaxENlYYfDFQTYQlacZ8 gjys1DM+G0HB7OieXloDYtpG5yr+BqKhUDAddRSPjpaqMLXewaTeDm9yv/M/2bvbQYvie/ 4pr+PGfw/9+9It/CG4TF9QcFPlJUu6uAW/A+pqPwDXrL4ozw6+G5ApVVKSuwIg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1787892755; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=aQseZlkft8hcJ36BMovTPTgWQTdon3yX0UZuK0EIKMQ=; b=s9xB4Oc/SrwgeAoM2mAd7+f+VzB6L2gbvh4MGjalRMec0xGyzNTSFHAMBgPjeiPc93Iwa1 Owh42Oqb6wlQi6GnzbcdoA1sKavJNrnPDlXYhdA+ivc6VI5j2Lnsudf89Me/0Db0EiSmL0 yX4wv1r4TZqKve3BWYDq/EH7MVieGvWznRyvJB6BxUErFsMe7I1GBOLAjQZhYNOUkWgLu7 /cYrpj+N6RV/peWEA5Oiq/L64R4xGGc+aITbNEWfaubBjUmE/hpJ5AtswfEEYj0FFhOyBO vKTZ6xARZ6JA89oEJtLiBlWPfVBgdf1qm8uwlnYuFYQXOWStHTOG78oPWp/4aA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hWQwz4JhvzwVq for ; Fri, 28 Aug 2026 04:52:35 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 443d4 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 28 Aug 2026 04:52:35 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 0c9cc6ce2f2f - stable/15 - nvme.4: Canonicalize SYNOPSIS List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 0c9cc6ce2f2f46e0ca16fad42f2c0e065f2ef6db Auto-Submitted: auto-generated Date: Fri, 28 Aug 2026 04:52:35 +0000 Message-Id: <6a911413.443d4.1d2b4e85@gitrepo.freebsd.org> The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=0c9cc6ce2f2f46e0ca16fad42f2c0e065f2ef6db commit 0c9cc6ce2f2f46e0ca16fad42f2c0e065f2ef6db Author: Alexander Ziaee AuthorDate: 2026-08-24 20:23:31 +0000 Commit: Alexander Ziaee CommitDate: 2026-08-28 04:52:06 +0000 nvme.4: Canonicalize SYNOPSIS MFC after: 3 days (cherry picked from commit b863d38437af11c18a88de656404af8cefa35e63) --- share/man/man4/nvme.4 | 56 ++++++++++++++++++++++++++++++++++----------------- 1 file changed, 38 insertions(+), 18 deletions(-) diff --git a/share/man/man4/nvme.4 b/share/man/man4/nvme.4 index dcd2ec86f5fa..73e5eec0062a 100644 --- a/share/man/man4/nvme.4 +++ b/share/man/man4/nvme.4 @@ -31,38 +31,49 @@ .\" .\" Author: Jim Harris .\" -.Dd June 6, 2020 +.Dd August 23, 2026 .Dt NVME 4 .Os .Sh NAME .Nm nvme .Nd NVM Express core driver .Sh SYNOPSIS -To compile this driver into your kernel, -place the following line in your kernel configuration file: -.Bd -ragged -offset indent -.Cd "device nvme" -.Ed +.Cd device nvme +.Cd options NVME_USE_NVD=0 +.Cd options NVME_2X_RESET .Pp -Or, to load the driver as a module at boot, place the following line in +In .Xr loader.conf 5 : -.Bd -literal -offset indent -nvme_load="YES" -.Ed +.Cd hw.nvme.per_cpu_io_queues= Ns Ar 0 +.Cd hw.nvme.min_cpus_per_ioq= Ns Aq Ar X +.Cd hw.nvme.force_intx= Ns Ar 1 +.Cd hw.nvme.hmb_max +.Cd hw.nvme.apst_enable= Ns Ar 1 +.Cd hw.nvme.apst_data +.Cd hw.nvme.use_nvd= Ns Ar 0 +.Cd nvme_load="YES" .Pp -Most users will also want to enable -.Xr nvd 4 +In +.Xr loader.conf 5 or -.Xr nda 4 -to expose NVM Express namespaces as disk devices which can be -partitioned. -Note that in NVM Express terms, a namespace is roughly equivalent to a -SCSI LUN. +.Xr sysctl.conf 5 : +.Cd dev.nvme.0.num_cpus_per_ioq +.Cd dev.nvme.0.int_coal_time +.Cd dev.nvme.0.int_coal_threshold +.Cd dev.nvme.0.ioq0.num_entries +.Cd dev.nvme.0.ioq0.num_tr +.Cd dev.nvme.0.ioq0.num_prp_list +.Cd dev.nvme.0.ioq0.sq_head +.Cd dev.nvme.0.ioq0.sq_tail +.Cd dev.nvme.0.ioq0.cq_head +.Cd dev.nvme.0.ioq0.num_cmds +.Cd dev.nvme.0.ioq0.dump_debug .Sh DESCRIPTION The .Nm driver provides support for NVM Express (NVMe) controllers, such as: -.Bl -bullet +.Pp +.Bl -bullet -compact .It Hardware initialization .It @@ -87,6 +98,15 @@ the format .Pa /dev/nvmeXnsY . Note that the NVM Express specification starts numbering namespaces at 1, not 0, and this driver follows that convention. +.Pp +Most users will also want to enable +.Xr nvd 4 +or +.Xr nda 4 +to expose NVM Express namespaces as disk devices which can be +partitioned. +Note that in NVM Express terms, a namespace is roughly equivalent to a +SCSI LUN. .Sh CONFIGURATION By default, .Nm