| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687 |
- .. SPDX-License-Identifier: GPL-2.0+:
- tftpput command
- ===============
- Synopsis
- --------
- ::
- tftpput address size [[hostIPaddr:]filename]
- Description
- -----------
- The tftpput command is used to transfer a file to a TFTP server.
- By default the destination port is 69 and the source port is pseudo-random.
- If CONFIG_TFTP_PORT=y, the environment variable *tftpsrcp* can be used to set
- the source port and the environment variable *tftpdstp* can be used to set
- the destination port.
- address
- memory address where the data starts
- size
- number of bytes to be transferred
- hostIPaddr
- IP address of the TFTP server, defaults to the value of environment
- variable *serverip*
- filename
- path of the file to be written. If not provided, the client's IP address is
- used to construct a default file name, e.g. C0.A8.00.28.img for IP address
- 192.168.0.40.
- Example
- -------
- In the example the following steps are executed:
- * setup client network address
- * load a file from the SD-card
- * send the file via TFTP to a server
- ::
- => setenv autoload no
- => dhcp
- BOOTP broadcast 1
- DHCP client bound to address 192.168.1.40 (7 ms)
- => load mmc 0:1 $loadaddr test.txt
- 260096 bytes read in 13 ms (19.1 MiB/s)
- => tftpput $loadaddr $filesize 192.168.1.3:upload/test.txt
- Using ethernet@1c30000 device
- TFTP to server 192.168.1.3; our IP address is 192.168.1.40
- Filename 'upload/test.txt'.
- Save address: 0x42000000
- Save size: 0x3f800
- Saving: #################
- 4.4 MiB/s
- done
- Bytes transferred = 260096 (3f800 hex)
- =>
- Configuration
- -------------
- The command is only available if CONFIG_CMD_TFTPPUT=y.
- CONFIG_TFTP_BLOCKSIZE defines the size of the TFTP blocks sent. It defaults
- to 1468 matching an ethernet MTU of 1500.
- If CONFIG_TFTP_PORT=y, the environment variables *tftpsrcp* and *tftpdstp* can
- be used to set the source and the destination ports.
- CONFIG_TFTP_WINDOWSIZE can be used to set the TFTP window size of transmits
- after which an ACK response is required. The window size defaults to 1.
- If CONFIG_TFTP_TSIZE=y, the progress bar is limited to 50 '#' characters.
- Otherwise an '#' is written per UDP package which may decrease performance.
- Return value
- ------------
- The return value $? is 0 (true) on success and 1 (false) otherwise.
|
