Bug 290812 - config: Error: device "iwx" is unknown
Summary: config: Error: device "iwx" is unknown
Status: Closed FIXED
Alias: None
Product: Base System
Classification: Unclassified
Component: wireless (show other bugs)
Version: 15.0-STABLE
Hardware: amd64 Any
: --- Affects Only Me
Assignee: Alexander Ziaee
URL:
Keywords:
Depends on:
Blocks: 278175
  Show dependency treegraph
 
Reported: 2025-11-05 10:35 UTC by Dmitry Lukhtionov
Modified: 2025-11-21 18:37 UTC (History)
4 users (show)

See Also:
des: mfc-stable15+


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Dmitry Lukhtionov 2025-11-05 10:35:25 UTC
man iwx
```
IWX(4)             FreeBSD Kernel Interfaces Manual (amd64)             IWX(4)

NAME
     iwx – Intel WiFi 6 IEEE 802.11ax wireless network driver

SYNOPSIS
     device iwx
     device wlan
```

when I put `device iwx` in my config file, kernel stop build with error:

config: Error: device "iwx" is unknown
Comment 1 Bjoern A. Zeeb freebsd_committer freebsd_triage 2025-11-05 13:36:19 UTC
I would think this is a documentation error in the man page based on iwm or OpenBSD?


I strongly believe anything which we do not need to boot a system to multi-user (and you cannot netboot over wifi for us) should be auto-loaded as a module and not be part of the kernel anymore.

There are two exceptions: (a) people who want a monolithic kernel and (b) people setting security sysctls that you cannot load modules anymore.

Maybe we should make it possible to add it to the kernel but not advertise it and not add it to any GENERIC or NOTES?  I wonder if loading firmware in that case would even work (probably would need to be pre-loaded as well again from loader)?
Comment 2 Alexander Ziaee freebsd_committer freebsd_triage 2025-11-07 12:36:28 UTC
> config: Error: device "iwx" is unknown

Rofl nobody caught this all this time >.< I'll take a look at this today.

> I strongly believe anything which we do not need to boot a system to multi-user (and you cannot netboot over wifi for us) should be auto-loaded as a module and not be part of the kernel anymore.

Yes, which is why we do that out of the box. The reference manual must contain instructions for compiling. Being able to build things in or out is important. FreeBSD sees a lot more use as a toolkit to build deployments, than it sees GENERIC deployments. We should not degrade our core market. The reference manual for the language the reference manual is written in says that synopsis should contain the device configuration. The FDP primer says device driver manuals should be modeled after vt(4), which is written this way.
Comment 3 commit-hook freebsd_committer freebsd_triage 2025-11-14 15:06:12 UTC
A commit in branch main references this bug:

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

commit b0c1ead2b9be0f6aa5a715d849b9ca7af093b513
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-14 15:04:45 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-11-14 15:06:04 +0000

    iwx.4: Fix SYNOPSIS

    PR:             290812
    MFC after:      3 days
    Fixes:          27c41b28b1d7 (iwx.4: Initial manual page)
    Reported by:    Dimitry Lukhtionov <dimitryluhtionov@gmail.com>

 share/man/man4/iwx.4 | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)
Comment 4 commit-hook freebsd_committer freebsd_triage 2025-11-15 03:19:44 UTC
A commit in branch main references this bug:

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

commit a615ded5bf2dd7f563eed6766d32fc063ae36f92
Author:     Dag-Erling Smørgrav <des@FreeBSD.org>
AuthorDate: 2025-11-15 03:18:45 +0000
Commit:     Dag-Erling Smørgrav <des@FreeBSD.org>
CommitDate: 2025-11-15 03:18:45 +0000

    sys/conf/files: Add iwx driver

    PR:             290812
    Fixes:          2ad0f7e91582 ("Import iwx as ported from OpenBSD by Future Crew.")
    Reviewed by:    emaste
    Differential Revision:  https://reviews.freebsd.org/D53758

 sys/conf/files | 4 ++++
 1 file changed, 4 insertions(+)
Comment 5 commit-hook freebsd_committer freebsd_triage 2025-11-20 11:23:39 UTC
A commit in branch stable/15 references this bug:

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

commit 0f9ab6c5232b5f748a21d22849dcf84b4b0bbab5
Author:     Dag-Erling Smørgrav <des@FreeBSD.org>
AuthorDate: 2025-11-15 03:18:45 +0000
Commit:     Dag-Erling Smørgrav <des@FreeBSD.org>
CommitDate: 2025-11-20 11:22:33 +0000

    sys/conf/files: Add iwx driver

    PR:             290812
    Fixes:          2ad0f7e91582 ("Import iwx as ported from OpenBSD by Future Crew.")
    Reviewed by:    emaste
    Differential Revision:  https://reviews.freebsd.org/D53758

    (cherry picked from commit a615ded5bf2dd7f563eed6766d32fc063ae36f92)

 sys/conf/files | 4 ++++
 1 file changed, 4 insertions(+)
Comment 6 commit-hook freebsd_committer freebsd_triage 2025-11-20 11:23:40 UTC
A commit in branch stable/15 references this bug:

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

commit b94750f6055250d1e2a0a9406e8eae8f16883803
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-14 15:04:45 +0000
Commit:     Dag-Erling Smørgrav <des@FreeBSD.org>
CommitDate: 2025-11-20 11:22:34 +0000

    iwx.4: Fix SYNOPSIS

    PR:             290812
    MFC after:      3 days
    Fixes:          27c41b28b1d7 (iwx.4: Initial manual page)
    Reported by:    Dimitry Lukhtionov <dimitryluhtionov@gmail.com>

    (cherry picked from commit b0c1ead2b9be0f6aa5a715d849b9ca7af093b513)

 share/man/man4/iwx.4 | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)
Comment 7 Dmitry Lukhtionov 2025-11-21 13:35:20 UTC
When I build kernel with `device iwx`

iwlwifi-cc-a0-77.ucode: could not load firmware image, error 6


Fatal trap 12: page fault while in kernel mode
cpuid = 3; apic id = 06
fault virtual address   = 0x4
fault code              = supervisor read data, page not present
instruction pointer     = 0x20:0xffffffff8072eeae
stack pointer           = 0x28:0xfffffe008b4ec9a0
frame pointer           = 0x28:0xfffffe008b4eca60
code segment            = base rx0, limit 0xfffff, type 0x1b
                        = DPL 0, pres 1, long 1, def32 0, gran 1
processor eflags        = interrupt enabled, resume, IOPL = 0
current process         = 0 (firmware taskq)
rdi: 0000000000000001 rsi: fffff80001e13c00 rdx: fffff80001e13c01
rcx: fffff80001e13c00  r8: fffffe008b4eccf0  r9: fffffe008b4ecd70
rax: 0000000000000000 rbx: fffffe008b4eccf0 rbp: fffffe008b4eca60
r10: fffff8000132f910 r11: 0000000000000c00 r12: fffffe008b4eca74
r13: fffffe008b4ece00 r14: fffffe008b4ecd60 r15: fffffe008b4eca74
trap number             = 12
panic: page fault
cpuid = 3
time = 1
KDB: stack backtrace:
#0 0xffffffff806b87cd at kdb_backtrace+0x5d
#1 0xffffffff80672ad6 at vpanic+0x136
#2 0xffffffff80672993 at panic+0x43
#3 0xffffffff80a4c66f at trap_pfault+0x3cf
#4 0xffffffff80a2555e at calltrap+0x8
#5 0xffffffff8073c333 at namei+0xd3
#6 0xffffffff80760082 at vn_open_cred+0x552
#7 0xffffffff806b4aec at loadimage+0x23c
#8 0xffffffff806ce0d2 at taskqueue_run_locked+0x162
#9 0xffffffff806cefd2 at taskqueue_thread_loop+0xb2
#10 0xffffffff80638483 at fork_exit+0x73
#11 0xffffffff80a2658e at fork_trampoline+0xe
Uptime: 1s
Automatic reboot in 15 seconds - press a key on the console to abort
Comment 8 Dmitry Lukhtionov 2025-11-21 13:40:08 UTC
# ls /boot/firmware/iwlwifi-cc-a0-77.ucode 
/boot/firmware/iwlwifi-cc-a0-77.ucode


When I load if_iwx as module

Nov  5 13:58:26 acer kernel: iwlwifi-cc-a0-77.ucode: could not load firmware image, error 8
Nov  5 13:58:26 acer kernel: iwx0: hw rev 0x340, fw 77.0b4c06ad.0, address dc:41:a9:e6:7e:54
Nov  5 13:58:26 acer kernel: iwx0: 11a rates: 6Mbps 9Mbps 12Mbps 18Mbps 24Mbps 36Mbps 48Mbps 54Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11b rates: 1Mbps 2Mbps 5.5Mbps 11Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11g rates: 1Mbps 2Mbps 5.5Mbps 11Mbps 6Mbps 9Mbps 12Mbps 18Mbps 24Mbps 36Mbps 48Mbps 54Mbps
Nov  5 13:58:26 acer kernel: iwx0: 2T2R
Nov  5 13:58:26 acer kernel: iwx0: 11na MCS 20MHz
Nov  5 13:58:26 acer kernel: iwx0: MCS 0-7: 6.5Mbps - 65Mbps
Nov  5 13:58:26 acer kernel: iwx0: MCS 8-15: 13Mbps - 130Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11na MCS 20MHz SGI
Nov  5 13:58:26 acer kernel: iwx0: MCS 0-7: 7Mbps - 72Mbps
Nov  5 13:58:26 acer kernel: iwx0: MCS 8-15: 14.5Mbps - 144.5Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11na MCS 40MHz:
Nov  5 13:58:26 acer kernel: iwx0: MCS 0-7: 13.5Mbps - 135Mbps
Nov  5 13:58:26 acer kernel: iwx0: MCS 8-15: 27Mbps - 270Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11na MCS 40MHz SGI:
Nov  5 13:58:26 acer kernel: iwx0: MCS 0-7: 15Mbps - 150Mbps
Nov  5 13:58:26 acer kernel: iwx0: MCS 8-15: 30Mbps - 300Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11ng MCS 20MHz
Nov  5 13:58:26 acer kernel: iwx0: MCS 0-7: 6.5Mbps - 65Mbps
Nov  5 13:58:26 acer kernel: iwx0: MCS 8-15: 13Mbps - 130Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11ng MCS 20MHz SGI
Nov  5 13:58:26 acer kernel: iwx0: MCS 0-7: 7Mbps - 72Mbps
Nov  5 13:58:26 acer kernel: iwx0: MCS 8-15: 14.5Mbps - 144.5Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11ng MCS 40MHz:
Nov  5 13:58:26 acer kernel: iwx0: MCS 0-7: 13.5Mbps - 135Mbps
Nov  5 13:58:26 acer kernel: iwx0: MCS 8-15: 27Mbps - 270Mbps
Nov  5 13:58:26 acer kernel: iwx0: 11ng MCS 40MHz SGI:
Nov  5 13:58:26 acer kernel: iwx0: MCS 0-7: 15Mbps - 150Mbps
Nov  5 13:58:26 acer kernel: iwx0: MCS 8-15: 30Mbps - 300Mbps
Nov  5 13:58:26 acer kernel: iwx0: [VHT] Channel Widths: 20MHz, 40MHz, 80MHz
Nov  5 13:58:26 acer kernel: iwx0: [VHT] Features: 31800020<SHORTGI80>
Nov  5 13:58:26 acer kernel: iwx0: [VHT] NSS 1: TX MCS 0..9, RX MCS 0..9
Nov  5 13:58:26 acer kernel: iwx0: [VHT] NSS 2: TX MCS 0..9, RX MCS 0..9
Nov  5 13:58:26 acer kernel: wlan0: Ethernet address: dc:41:a9:e6:7e:54
Comment 9 Dag-Erling Smørgrav freebsd_committer freebsd_triage 2025-11-21 13:44:24 UTC
One issue per PR, please.
Comment 10 Alexander Ziaee freebsd_committer freebsd_triage 2025-11-21 13:51:46 UTC
Weeeellll, this issue is caused by the commit linked to this PR.
Comment 11 Dag-Erling Smørgrav freebsd_committer freebsd_triage 2025-11-21 13:57:43 UTC
No, it's a pre-existing issue which was revealed by the change in this PR.  Please file a separate PR for it.