]> git.ipfire.org Git - thirdparty/u-boot.git/commitdiff
doc: Switch from printenv to env print
authorMarek Vasut <marek.vasut+renesas@mailbox.org>
Sat, 18 Jul 2026 23:45:49 +0000 (01:45 +0200)
committerHeinrich Schuchardt <heinrich.schuchardt@canonical.com>
Mon, 27 Jul 2026 16:50:28 +0000 (18:50 +0200)
The "env" command is the recommended environment management command,
its "print" subcommand is the equivalent replacement for legacy "printenv"
command. Update the documentation to use the contemporary "env print"
command instead of legacy "printenv" command.

Note that the "printenv" command is unlikely to be removed from U-Boot
in the near future due to it being integral part of the command line
ABI.

Implemented using:
$ sed -i 's@\<printenv\>@env print@g' $(git grep -li '\<printenv\>' doc/) README

Signed-off-by: Marek Vasut <marek.vasut+renesas@mailbox.org>
README
doc/README.odroid
doc/android/ab.rst
doc/usage/cmd/askenv.rst
doc/usage/cmd/memsize.rst

diff --git a/README b/README
index f7ac319c72063dbcb697757ba5f998bb18fc5cda..d6dd6c746195f5609571d926f4070933daad6802 100644 (file)
--- a/README
+++ b/README
@@ -754,7 +754,7 @@ The following options need to be configured:
                directly type `$name' at the command prompt.
 
                Global environment variables are those you use
-               env set/printenv to work with. To run a command stored
+               env set/env print to work with. To run a command stored
                in such a variable, you need to use the run command,
                and you must not use the '$' sign to access them.
 
@@ -1655,15 +1655,15 @@ The "bootm" command is used to boot an application that is stored in
 memory (RAM or Flash). In case of a Linux kernel image, the contents
 of the "bootargs" environment variable is passed to the kernel as
 parameters. You can check and modify this variable using the
-"printenv" and "env set" commands:
+"env print" and "env set" commands:
 
 
-       => printenv bootargs
+       => env print bootargs
        bootargs=root=/dev/ram
 
        => env set bootargs root=/dev/nfs rw nfsroot=10.0.0.2:/LinuxPPC nfsaddrs=10.0.0.99:10.0.0.2
 
-       => printenv bootargs
+       => env print bootargs
        bootargs=root=/dev/nfs rw nfsroot=10.0.0.2:/LinuxPPC nfsaddrs=10.0.0.99:10.0.0.2
 
        => bootm 40020000
index f0592dd57fc6a43fc0050580a09a2fdfcb435e64..8fe226cf4cf0bd75d89a3dd3ae829c1b2453b9af 100644 (file)
@@ -200,7 +200,7 @@ Odroid #
 Note that this automatically sets the many IP address related variables in
 U-Boot that is obtained from the DHCP server.
 
-Odroid # printenv ipaddr netmask gatewayip dnsip
+Odroid # env print ipaddr netmask gatewayip dnsip
 ipaddr=192.168.1.10
 netmask=255.255.255.0
 gatewayip=192.168.1.1
@@ -256,7 +256,7 @@ Loading: ####
         40 KiB/s
 done
 Bytes transferred = 46935 (b757 hex)
-Odroid # printenv bootargs
+Odroid # env print bootargs
 bootargs=Please use defined boot
 Odroid # env set bootargs console=ttySAC1,115200n8 root=/dev/mmcblk0p2 rootwait
 Odroid # bootz 40080000 - 42000000
index 7fd4aeb6a724b839de9be5e9a8843ade2ad3667e..b0123db28e4edcbc3be1c414d5a93e119be1e86e 100644 (file)
@@ -54,7 +54,7 @@ or::
 
 Result::
 
-    => printenv slot_name
+    => env print slot_name
     slot_name=a
 
 Based on this slot information, the current boot partition should be defined,
index a8867ce4d266a83bb37b3ac45bb69128e8e6268c..0aebc70214f15c5d463f3eea0d1a40da5bca8f57 100644 (file)
@@ -44,7 +44,7 @@ Value of a environment variable env1 without message and size parameters:
 
     => askenv env1
     Please enter 'env1': val1
-    => printenv env1
+    => env print env1
     env1=val1
 
 Value of a environment variable env2 with message and size parameters:
@@ -53,7 +53,7 @@ Value of a environment variable env2 with message and size parameters:
 
     => askenv env2 Please type-in a value for env2: 10
     Please type-in a value for env2: 1234567890123
-    => printenv env2
+    => env print env2
     env2=1234567890
 
 Value of a environment variable env3 with size parameter only:
@@ -62,7 +62,7 @@ Value of a environment variable env3 with size parameter only:
 
     => askenv env3 10
     Please enter 'env3': val3
-    => printenv env3
+    => env print env3
     env3=val3
 
 Configuration
index 6e99d7c1d33fac678c6fcb98c9ef036adfe87530..9ebeefc58fa43ecfd40bed4b752bd740a2218a93 100644 (file)
@@ -34,7 +34,7 @@ This second example shows assign ram size to environment variable:
 ::
 
   => memsize memsz
-  => printenv memsz
+  => env print memsz
   memsz=8192
 
 Return value