# LWN contribution

source: [elixir_wwan_page](https://elixir.bootlin.com/linux/v7.0.11/source/drivers/net/wwan)

Document: Fix missing reference pages

Today, my friend and I are discussing a wwan driver produced by
Mediatek. I am reading the related document and reference link,
then I found the page is missing. So after a short search I am
giving the better link and test the two pages with my bash
program for more dead links. It turns out only this one. I check
the page and the following documents. Details are covered in
this markdown [page](https://hackmd.io/@Urbaner/lk_patch_doc).

https://duckduckgo.com/?q=WWAN+Driver+Core+t7xx&t=brave&ia=web

[lwn2022news](https://lwn.net/Articles/894277/)
[googlegit](https://kernel.googlesource.com/pub/scm/linux/kernel/git/torvalds/linux/+/master/Documentation/networking/device_drivers/wwan/t7xx.rst)
linux/master/./Documentation/networking/device_drivers/wwan/t7xx.rst

[pagemj](https://mjmwired.net/kernel/Documentation/networking/device_drivers/wwan/t7xx.rst) source text; [doc_kernel](https://docs.kernel.org/networking/device_drivers/wwan/t7xx.html) 正式文件

[網頁死去超連結檢查](https://hackmd.io/@Urbaner/dead_link)

user@device:~/Downloads/apps$ ./check_links.sh https://docs.kernel.org/networking/device_drivers/wwan/t7xx.html
正在下載目標網頁: https://docs.kernel.org/networking/device_drivers/wwan/t7xx.html

失效代號定義:
C01 URL 無法被瀏覽器辨識為有效網址
C02 主機名稱或網域無法解析
C03 網路層無法找到下一跳或目的地
C04 ARP 或區域網路尋址失敗
C05 TCP Socket 或連線建立失敗
C06 TLS / HTTPS 握手失敗
C07 封包遺失、逾時或網路壅塞導致請求無法完成
C08 HTTP 請求無法被伺服器正確處理
C09 伺服器沒有對應的內容或資源
C10 HTML 中引用的外部資源失效；本程式檢查 <a href> 超連結時，通常不使用此代號

結果    連結文字                                HTTP    URL
--------        ----------------------------------------        -----   ----------------------------------------
C09             https://www.usb.org/document-library/           404     https://www.usb.org/document-library/

檢查完成: 共檢查 43 個超連結，發現 1 個疑似失效連結。

[Dead Link Checker](https://hackmd.io/@Urbaner/dead_link) is a Chinese AI bash program.
translation by DeepL:

user@device:~/Downloads/apps$ ./check_links.sh https://docs.kernel.org/networking/device_drivers/wwan/t7xx.html
Downloading target page: https://docs.kernel.org/networking/device_drivers/wwan/t7xx.html

Error Code Definitions:
C01 The URL cannot be recognized as a valid address by the browser
C02 The hostname or domain cannot be resolved
C03 The network layer cannot find the next hop or destination
C04 ARP or local network addressing failed
C05 TCP socket or connection establishment failed
C06 TLS/HTTPS handshake failed
C07 Request could not be completed due to packet loss, timeout, or network congestion
C08 HTTP request could not be processed correctly by the server
C09 The server does not have the corresponding content or resource
C10 External resource referenced in HTML is invalid; this code is not typically used when this program checks <a href> hyperlinks

Result    Link Text                                HTTP    URL
--------        ----------------------------------------        -----   --------------------------------------- -
C09             https://www.usb.org/document-library/           404     https://www.usb.org/document-library/

Check complete: A total of 43 hyperlinks were checked, and 1 suspected broken link was found.

Translated with DeepL.com (free version)

search with keyword of reference page, which is "MBIM (Mobile Broadband Interface Model) Errata-1", with duckduckgo. THe first related to origin link is [usborg_link](http://usb.org/document-library/mobile-broadband-interface-model-v10-errata-1-and-adopters-agreement).
Download the file in the page ,MBIM10Errata1_073013.zip, and extract it:

user@device:~/Documents/Temp_work2$ unzip MBIM10Errata1_073013.zip 
Archive:  MBIM10Errata1_073013.zip
  inflating: MBIM10Errata1/Compare-MBIM-v1.0-to-MBIM-v1.0-errata-1.pdf  
  inflating: MBIM10Errata1/MBIM v1 0 - errata-1.pdf  
  inflating: MBIM10Errata1/MBIMv1.0 ADOPTERS AGREEMENT - Device Class Spec.pdf  

Based on the file name and the content, I would say the pdf document suffices the origin reference link of the

Search result also mention this [page](https://www.kernel.org/doc/html/v7.1-rc3/networking/device_drivers/wwan/iosm.html), so we may consider apply the link to this page, [usborg_link].

Check [github](https://github.com/torvalds/linux/blob/master/Documentation/networking/device_drivers/wwan/t7xx.rst) link status, which matches the above page.

https://hackmd.io/@ericisgood/nth-kernel-patch

user@device:~/linux$ ./scripts/get_maintainer.pl 0001-Document-Fix-missing-reference-pages.patch 
"David S. Miller" <[e-mail]> (maintainer:NETWORKING [GENERAL])
Eric Dumazet <[e-mail]> (maintainer:NETWORKING [GENERAL])
Jakub Kicinski <[e-mail]> (maintainer:NETWORKING [GENERAL])
Paolo Abeni <[e-mail]> (maintainer:NETWORKING [GENERAL])
Simon Horman <[e-mail]> (reviewer:NETWORKING [GENERAL])
Jonathan Corbet <[e-mail]> (maintainer:DOCUMENTATION)
Shuah Khan <[e-mail]> (reviewer:DOCUMENTATION)
"[Ko Han Chen]" <[e-mail]> (commit_signer:1/1=100%,authored:1/1=100%,added_lines:1/1=100%,removed_lines:1/1=100%)
[e-mail] (open list:NETWORKING [GENERAL])
[e-mail] (open list:DOCUMENTATION)
[e-mail] (open list)

16:44 UTC+8 [result](https://lore.kernel.org/all/[e-mail]/)
到 [lkml.org](https://lore.kernel.org/) 看

user@device:~$ git clone https://kernel.googlesource.com/pub/scm/linux/kernel/git/torvalds/linux
Cloning into 'linux'...
remote: Sending approximately 2.29 GiB ...
remote: Counting objects: 6840, done
remote: Finding sources: 100% (1266/1266)
remote: Total 11556596 (delta 9779741), reused 11556111 (delta 9779741)
Receiving objects: 100% (11556596/11556596), 2.28 GiB | 23.88 MiB/s, done.
Resolving deltas: 100% (9779741/9779741), done.
Updating files: 100% (93708/93708), done.

...

user@device:~/linux$ make menuconfig
  HOSTCC  scripts/basic/fixdep
*
* Unable to find the ncurses package.
* Install ncurses (ncurses-devel or libncurses-dev
* depending on your distribution).
*
* You may also need to install pkg-config to find the
* ncurses installed in a non-default location.
*
make[2]: *** [scripts/kconfig/Makefile:234: scripts/kconfig/mconf-libs] Error 1
make[1]: *** [/home/urbaner/linux/Makefile:757: menuconfig] Error 2
make: *** [Makefile:248: __sub-make] Error 2