libreboot / lbwww (public) (License: Unspecified) (since 2023-04-11) (hash sha1)
libreboot website (markdown files). https://libreboot.org/
Clone URLs: https://rocketgit.com/user/libreboot/lbwww ssh://rocketgit@ssh.rocketgit.com/user/libreboot/lbwww git://git.rocketgit.com/user/libreboot/lbwww
25.04 25.06 master
List of commits:
Subject Hash Author Date (UTC)
nvmutil: add notes about 16/128 kb gbe files 138b3e306f24aa8f4fd365e25dbfdc524267b44f Leah Rowe 2025-01-24 13:25:17
make text color a bit brighter 755666a238881968b2fd94684987b6ffb2ad214a Leah Rowe 2025-01-22 12:07:04
make the title section a link to the homepage 51b53dc54ff6451775df5e90d3cd9938b68b9462 Leah Rowe 2025-01-22 11:25:40
homepage: use u-boot screenshot, not t1650 grub e073938b8b22d809480c10bf1fae070250c9cc65 Leah Rowe 2025-01-21 16:53:18
adapt canoeboot css but with libreboot colours 4eaaccbd0aeac2f859a888c08d941583866e28cc Leah Rowe 2025-01-21 16:49:38
better english description in meta tags d9c07032e962516af7cc365ad79e3d8faf7a11e2 Leah Rowe 2025-01-21 04:26:54
grammar 73e9255f700404851c37649503a90c84fde18935 Leah Rowe 2025-01-21 02:18:11
remove obsolete paragraph (images available now) 0fc65e4fac94d76af95a6d12bfb9aec72df394b4 Leah Rowe 2025-01-20 15:48:43
add ps1 bios download link 71228ffa0d20d007d1169a11bafe464ed5d84116 Leah Rowe 2025-01-20 15:45:22
clarify ownership 3ec8d5abb60113fdb03aead1fd2c5719d0954bc7 Leah Rowe 2025-01-20 15:36:12
mayumi pic on the ps1 page d1921809b865e4aa883a3762b55ed0db44f594cf Leah Rowe 2025-01-20 15:33:07
improve the ps1 page title 57c5edbbf55b3d7fc62d54a4f9d046fb8ff15208 Leah Rowe 2025-01-20 14:59:33
improved a bunch of page titles 246820568f1938251d16b3c8ef6cfa70d9551e99 Leah Rowe 2025-01-20 13:41:54
css: make h3/h4 smaller in proportion 72121b918442f0d0986140c3603e9b42ef5410ec Leah Rowe 2025-01-20 11:43:14
use more searchable homepage title 2276bb3183ef2d33aa99f216d34de1528783426f Leah Rowe 2025-01-20 11:00:12
fix wrongful credit 07b4c69883d3a3696af0883d06c37edfc15bfac4 Leah Rowe 2025-01-19 19:53:22
fix wrong fact b80d5e04ad473302c2a69a8b550dae8b548f67f9 Leah Rowe 2025-01-19 19:33:59
grammar 016bdaf4c40bcf54e45882c4fbfc1afe35b554dc Leah Rowe 2025-01-19 19:29:18
typo: superfically should be superficially 125c88f2add68ad08b9b95d1bf4d844ecce0451e Leah Rowe 2025-01-19 19:14:42
docs/index: improve link/bsd link titles 3257c1393648b1eb73d4280cdff95ffc4587faf3 Leah Rowe 2025-01-19 19:12:45
Commit 138b3e306f24aa8f4fd365e25dbfdc524267b44f - nvmutil: add notes about 16/128 kb gbe files
Signed-off-by: Leah Rowe <leah@libreboot.org>
Author: Leah Rowe
Author date (UTC): 2025-01-24 13:25
Committer name: Leah Rowe
Committer date (UTC): 2025-01-24 13:25
Parent(s): 755666a238881968b2fd94684987b6ffb2ad214a
Signer:
Signing key:
Signing status: N
Tree: 682943091cd4bd2cdfd3bf4c606f5059da33d0a2
File Lines added Lines deleted
site/docs/install/nvmutil.md 18 6
File site/docs/install/nvmutil.md changed (mode: 100644) (index 2c22e03..92fffc7)
... ... fact work nicely, but software such as Linux will check
112 112 that this is correct. If the checksum is invalid, your that this is correct. If the checksum is invalid, your
113 113 kernel will refuse to make use of the NIC. kernel will refuse to make use of the NIC.
114 114
115 This NVM section is the first 128 bytes of a 4KB region in flash.
116 This 4KB region is then repeated, to make an 8KB region in
115 This NVM section is the first 128 bytes of a *block size* KB region in flash.
116 This *block size* KB region is then repeated, to make an *block size multipled
117 by two* KB region in
117 118 flash, known as the *GbE region*. In `nvmutil`, the first part flash, known as the *GbE region*. In `nvmutil`, the first part
118 119 is referred to as *part 0* and the second part as *part 1*. is referred to as *part 0* and the second part as *part 1*.
119 120
121 The block size can be 4KB, 8KB or 64KB, meaning that GbE files can
122 be 8KB, 16KB or 128KB; the first half is part 0 and the second half is part 1.
123 The first 4KB of each part is what we are concerned with; and in each 4KB part
124 is the 128-byte NVM area at the very start, containing our configuration.
125
126 **NOTE: Support for 16KB and 128KB files was only added *after* the
127 Libreboot 20241206 release. It will be available in all releases after that,
128 or you can simply compile nvmutil from the Libreboot Git repository lbmk,
129 from directory `util/nvmutil/` - on the older releases, and older versions of
130 nvmutil, only 8KB GbE files are supported, but we mostly only use 8KB files
131 anyway (you're very unlikely to encounter 16KB or 128KB files).**
132
120 133 ### Known compatible PHYs ### Known compatible PHYs
121 134
122 135 TODO: write a full list her ofe what actual PHYs are known to work. TODO: write a full list her ofe what actual PHYs are known to work.
 
... ... command only requires read access on files. Where sufficient permission
378 391 is not given (read and/or write), nvmutil will exit with non-zero status. is not given (read and/or write), nvmutil will exit with non-zero status.
379 392
380 393 Non-zero status will also be returned, if the target file is *not* Non-zero status will also be returned, if the target file is *not*
381 of size *8KB*.
394 of size *8KB*, *16KB* or *128KB*.
382 395
383 396 Additional rules regarding exit status shall apply, depending on Additional rules regarding exit status shall apply, depending on
384 397 what command you use. Commands are documented in the following sections: what command you use. Commands are documented in the following sections:
 
... ... will exit with non-zero status.
469 482 This command requires read *and* write access on files. This command requires read *and* write access on files.
470 483
471 484 The `nvm` program can copy one NVM part to another. It copies The `nvm` program can copy one NVM part to another. It copies
472 the *entire* 4KB part, within the 8KB file.
485 the *entire* *block size* KB part, within the *two blocks* KB file.
473 486
474 487 Overwrite part 0 with the contents of part 1: Overwrite part 0 with the contents of part 1:
475 488
 
... ... zero status.
488 501
489 502 This command requires read *and* write access on files. This command requires read *and* write access on files.
490 503
491 The `nvm` program can swap both 4KB parts in the GbE
504 The `nvm` program can swap both *block size* KB parts in the GbE
492 505 file. It does this, via simple XOR swaps. file. It does this, via simple XOR swaps.
493 506
494 507 How to use: How to use:
 
... ... provided only for reference; it may be useful for future auditing.
587 600 TODO TODO
588 601 ---- ----
589 602
590 * Support higher block sizes e.g. 8KB blocks for GbE part sections
591 603 * Adapt this into a manpage (useful for Linux package repositories / BSD ports) * Adapt this into a manpage (useful for Linux package repositories / BSD ports)
592 604 * Send nvmutil upstream to coreboot, for inclusion under `util/` * Send nvmutil upstream to coreboot, for inclusion under `util/`
593 605 * In addition to the manpage, when sending to coreboot, also adapt this page * In addition to the manpage, when sending to coreboot, also adapt this page
Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/libreboot/lbwww

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/libreboot/lbwww

Clone this repository using git:
git clone git://git.rocketgit.com/user/libreboot/lbwww

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main