mirror of
https://source.denx.de/u-boot/u-boot.git
synced 2025-12-19 16:31:27 +01:00
11da3403e9
For nearly all commands in U-Boot the '?' variable is handled the same way with 0 meaning success, 1 meaning any failure. Explain this in the general rules section of the cmdline documentation (with a link to a counter example) and then remove the redundant wording from most commands. We retain a section about the return value in a number of places where we are doing something such as always returning a specific value or we have useful additional information to go along with the normal return codes. Signed-off-by: Tom Rini <trini@konsulko.com> Reviewed-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
82 lines
1.8 KiB
ReStructuredText
82 lines
1.8 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+:
|
|
|
|
.. index::
|
|
single: cp (command)
|
|
|
|
cp command
|
|
==========
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
::
|
|
|
|
cp source target count
|
|
cp.b source target count
|
|
cp.w source target count
|
|
cp.l source target count
|
|
cp.q source target count
|
|
|
|
Description
|
|
-----------
|
|
|
|
The cp command is used to copy *count* chunks of memory from the *source*
|
|
address to the *target* address. If the *target* address points to NOR flash,
|
|
the flash is programmed. When the *target* address points at ordinary memory,
|
|
memmove() is used, so the two regions may overlap.
|
|
|
|
The number bytes in one chunk is defined by the suffix defaulting to 4 bytes:
|
|
|
|
====== ==========
|
|
suffix chunk size
|
|
====== ==========
|
|
.b 1 byte
|
|
.w 2 bytes
|
|
.l 4 bytes
|
|
.q 8 bytes
|
|
<none> 4 bytes
|
|
====== ==========
|
|
|
|
source
|
|
source address, hexadecimal
|
|
|
|
target
|
|
target address, hexadecimal
|
|
|
|
count
|
|
number of words to be copied, hexadecimal
|
|
|
|
Examples
|
|
--------
|
|
|
|
The example device has a NOR flash where the lower part of the flash is
|
|
protected. We first copy to RAM, then to unprotected flash. Last we try to
|
|
write to protectd flash.
|
|
|
|
::
|
|
|
|
=> mtd list
|
|
List of MTD devices:
|
|
* nor0
|
|
- device: flash@0
|
|
- parent: root_driver
|
|
- driver: cfi_flash
|
|
- path: /flash@0
|
|
- type: NOR flash
|
|
- block size: 0x20000 bytes
|
|
- min I/O: 0x1 bytes
|
|
- 0x000000000000-0x000002000000 : "nor0"
|
|
=> cp.b 4020000 5000000 200000
|
|
=> cp.b 4020000 1e00000 20000
|
|
Copy to Flash... done
|
|
=> cp.b 4020000 0 20000
|
|
Copy to Flash... Can't write to protected Flash sectors
|
|
=>
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The cp command is available if CONFIG_CMD_MEMORY=y. Support for 64 bit words
|
|
(cp.q) is only available on 64-bit targets. Copying to flash depends on
|
|
CONFIG_MTD_NOR_FLASH=y.
|