canoeboot
/
cbwww
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

document ./mk inject setmac on the nvmutil page 

Canoeboot's version doesn't handle vendor files like
the Libreboot version, but the setmac syntax is the same.

Signed-off-by: Leah Rowe <leah@libreboot.org>
master
Leah Rowe 2025-01-07 08:33:39 +00:00
parent 194329d33c
commit 6fc8553cd1
1 changed files with 33 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
site/docs/install/nvmutil.md
View File

@ -39,6 +39,39 @@ you how to dump or otherwise acquire that file; the second
half of this README then tells you how to operate on it,
using `nvmutil`.
Automatic MAC address changer
-----------------------------
Instead of running nvmutil manually, like below, you can
also use the inject command, like so (examples):
./mk inject canoeboot-RELEASE_targetname.tar.xz
./mk inject canoeboot-RELEASE_targetname.tar.xz setmac
./mk inject canoeboot-RELEASE_targetname.tar.xz setmac 00:1f:16:00:11:22
./mk inject canoeboot-RELEASE_targetname.tar.xz setmac 00:??:16:0?:1?:22
./mk inject canoeboot-RELEASE_targetname.tar.xz setmac restore
This writes the MAC address on the GbE region of the image. You must do this
on the tarball, from the ROM image release archives, and then extract the
archive.
This *only* changes the MAC address. It doesn't inject vendor files or download
them, and doesn't support the `nuke` command, like on Libreboot's version.
Without argument after the tarball, it behaves the same as `setmac`. If `setmac`
is provided without argument, or no argument is given, the MAC address is
randomised. Otherwise, you can specify an arbitrary address.
The `?` character is random, and you can specify that any of them be random,
while setting others (or all of them) arbitrarily.
The `restore` option restores the original one. The command works by using a
reference GbE image file present in Canoeboot's build system, for the given
mainboard.
The Canoeboot version is designed to throw an error, if you run it on a Libreboot
tarball.
How to download newer versions
==============================