Bug 213026 - ixgbe(4) driver name is now ix
Summary: ixgbe(4) driver name is now ix
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Kevin Bowling
URL: https://reviews.freebsd.org/D32531
Keywords: needs-qa, patch
Depends on:
Blocks:
 
Reported: 2016-09-27 19:00 UTC by Sergey Akhmatov
Modified: 2024-10-30 01:03 UTC (History)
7 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Sergey Akhmatov 2016-09-27 19:00:25 UTC
% man 4 ix
NAME
     ixgbe – Intel(R) 10Gb Ethernet driver for the FreeBSD operating system

SYNOPSIS
     To compile this driver into the kernel, place the following line in your
     kernel configuration file:

           device ixgbe

     Alternatively, to load the driver as a module at boot time, place the
     following line in loader.conf(5):

           if_ixgbe_load="YES"
---
r280182 comments:
        - The driver loadables will now match the device names, something that
          has been requested for some time.
        - Rather than a modules/ixgbe there is now modules/ix and modules/ixv
---
sys/amd64/conf/GENERIC:
 device          ix                      # Intel PRO/10GbE PCIE PF Ethernet
 device          ixv                     # Intel PRO/10GbE PCIE VF Ethernet
---
Since r280182 there is no more device named ixgbe, so the manpage name and the statements from manpage are invalid:
device ixgbe  # for kernel configuration file
if_ixgbe_load="YES" # for loader.conf(5)
Comment 1 Ofloo 2018-01-20 12:49:30 UTC
# make -j9 buildkernel
--- buildkernel ---
--- buildkernel ---

--------------------------------------------------------------
>>> Kernel build for OFL started on Sat Jan 20 13:45:58 CET 2018
--------------------------------------------------------------
===> OFL
mkdir -p /usr/obj/usr/src/sys
--------------------------------------------------------------
>>> stage 1: configuring the kernel
--------------------------------------------------------------
cd /usr/src/sys/amd64/conf;  PATH=/usr/obj/usr/src/tmp/legacy/usr/sbin:/usr/obj/usr/src/tmp/legacy/usr/bin:/usr/obj/usr/src/tmp/legacy/bin:/usr/obj/usr/src/tmp/usr/sbin:/usr/obj/usr/src/tmp/usr/bin:/sbin:/bin:/usr/sbin:/usr/bin  config  -d /usr/obj/usr/src/sys/OFL  -I '/usr/src/sys/amd64/conf' '/usr/src/sys/amd64/conf/OFL'
config: Error: device "ixgbe" is unknown
config: 1 errors
*** [buildkernel] Error code 1

make[1]: stopped in /usr/src
1 error

make[1]: stopped in /usr/src
*** [buildkernel] Error code 2

make: stopped in /usr/src
1 error

make: stopped in /usr/src
Comment 2 Kristian 2019-04-16 12:21:58 UTC
Would be great to add relevant module parameters to the man page as well.

For example, I would assume that:

hw.ixgbe.unsupported_sfp="1"

No longer has any effect and should be replaced with:

hw.ix.unsupported_sfp="1"
Comment 3 Felix Johnson 2021-10-17 03:50:30 UTC
I created a Phabricator review for this patch:
https://reviews.freebsd.org/D32531

I don't have an ix device, so I can't tell if the diagnostic error messages
have moved from ixgbe to ix.
Comment 4 commit-hook freebsd_committer freebsd_triage 2024-10-27 09:09:01 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=a340b4649621f0dbc0607115217889909ce33bd1

commit a340b4649621f0dbc0607115217889909ce33bd1
Author:     Felix Johnson <felix.the.red@gmail.com>
AuthorDate: 2024-10-27 00:46:41 +0000
Commit:     Kevin Bowling <kbowling@FreeBSD.org>
CommitDate: 2024-10-27 09:01:35 +0000

    ix.4: document LOADER TUNABLES

    PR:             213026
    MFC after:      3 days
    Co-authored-by: Alexander Ziaee <concussious@runbox.com>

 share/man/man4/ix.4 | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)
Comment 5 commit-hook freebsd_committer freebsd_triage 2024-10-27 09:09:06 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=d8b48a267fc0f737a13cb52dc1071981ecb1e003

commit d8b48a267fc0f737a13cb52dc1071981ecb1e003
Author:     Felix Johnson <felix.the.red@gmail.com>
AuthorDate: 2024-10-27 00:26:34 +0000
Commit:     Kevin Bowling <kbowling@FreeBSD.org>
CommitDate: 2024-10-27 09:00:43 +0000

    ixgbe.4: rename to ix.4

    PR:             213026
    MFC after:      3 days
    Reported by:    Sergey Akhmatov <sergey@akhmatov.ru>
    Co-authored-by: Alexander Ziaee <concussious@runbox.com>

 share/man/man4/Makefile          |  8 ++++----
 share/man/man4/{ixgbe.4 => ix.4} | 14 +++++++-------
 2 files changed, 11 insertions(+), 11 deletions(-)
Comment 6 commit-hook freebsd_committer freebsd_triage 2024-10-30 01:02:48 UTC
A commit in branch stable/14 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=30a9cf87d3261ace3d05844fa9d89f675d0ef474

commit 30a9cf87d3261ace3d05844fa9d89f675d0ef474
Author:     Felix Johnson <felix.the.red@gmail.com>
AuthorDate: 2024-10-27 00:26:34 +0000
Commit:     Kevin Bowling <kbowling@FreeBSD.org>
CommitDate: 2024-10-30 01:01:19 +0000

    ixgbe.4: rename to ix.4

    PR:             213026
    Reported by:    Sergey Akhmatov <sergey@akhmatov.ru>
    Co-authored-by: Alexander Ziaee <concussious@runbox.com>

    (cherry picked from commit d8b48a267fc0f737a13cb52dc1071981ecb1e003)

 share/man/man4/Makefile          |  8 ++++----
 share/man/man4/{ixgbe.4 => ix.4} | 14 +++++++-------
 2 files changed, 11 insertions(+), 11 deletions(-)
Comment 7 commit-hook freebsd_committer freebsd_triage 2024-10-30 01:02:51 UTC
A commit in branch stable/14 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=2e0d2f95fe602fb746e4369bc6d8e2c3a836afa4

commit 2e0d2f95fe602fb746e4369bc6d8e2c3a836afa4
Author:     Felix Johnson <felix.the.red@gmail.com>
AuthorDate: 2024-10-27 00:46:41 +0000
Commit:     Kevin Bowling <kbowling@FreeBSD.org>
CommitDate: 2024-10-30 01:01:30 +0000

    ix.4: document LOADER TUNABLES

    PR:             213026
    Co-authored-by: Alexander Ziaee <concussious@runbox.com>

    (cherry picked from commit a340b4649621f0dbc0607115217889909ce33bd1)

 share/man/man4/ix.4 | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)
Comment 8 commit-hook freebsd_committer freebsd_triage 2024-10-30 01:03:52 UTC
A commit in branch stable/13 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=923e8f418cb804385e0bdc3ce102abb534fdf948

commit 923e8f418cb804385e0bdc3ce102abb534fdf948
Author:     Felix Johnson <felix.the.red@gmail.com>
AuthorDate: 2024-10-27 00:46:41 +0000
Commit:     Kevin Bowling <kbowling@FreeBSD.org>
CommitDate: 2024-10-30 01:03:09 +0000

    ix.4: document LOADER TUNABLES

    PR:             213026
    Co-authored-by: Alexander Ziaee <concussious@runbox.com>

    (cherry picked from commit a340b4649621f0dbc0607115217889909ce33bd1)

 share/man/man4/ix.4 | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)
Comment 9 commit-hook freebsd_committer freebsd_triage 2024-10-30 01:03:54 UTC
A commit in branch stable/13 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=c07626eaa21aadf07592f3d261151ad6c36e4360

commit c07626eaa21aadf07592f3d261151ad6c36e4360
Author:     Felix Johnson <felix.the.red@gmail.com>
AuthorDate: 2024-10-27 00:26:34 +0000
Commit:     Kevin Bowling <kbowling@FreeBSD.org>
CommitDate: 2024-10-30 01:02:57 +0000

    ixgbe.4: rename to ix.4

    PR:             213026
    Reported by:    Sergey Akhmatov <sergey@akhmatov.ru>
    Co-authored-by: Alexander Ziaee <concussious@runbox.com>

    (cherry picked from commit d8b48a267fc0f737a13cb52dc1071981ecb1e003)

 share/man/man4/Makefile          |  8 ++++----
 share/man/man4/{ixgbe.4 => ix.4} | 14 +++++++-------
 2 files changed, 11 insertions(+), 11 deletions(-)