1 .. SPDX-License-Identifier: GPL-2.0+:
11 tftpput address size [[hostIPaddr:]filename]
16 The tftpput command is used to transfer a file to a TFTP server.
18 By default the destination port is 69 and the source port is pseudo-random.
19 If CONFIG_TFTP_PORT=y, the environment variable *tftpsrcp* can be used to set
20 the source port and the environment variable *tftpdstp* can be used to set
24 memory address where the data starts
27 number of bytes to be transferred
30 IP address of the TFTP server, defaults to the value of environment
34 path of the file to be written. If not provided, the client's IP address is
35 used to construct a default file name, e.g. C0.A8.00.28.img for IP address
41 In the example the following steps are executed:
43 * setup client network address
44 * load a file from the SD-card
45 * send the file via TFTP to a server
52 DHCP client bound to address 192.168.1.40 (7 ms)
53 => load mmc 0:1 $loadaddr test.txt
54 260096 bytes read in 13 ms (19.1 MiB/s)
55 => tftpput $loadaddr $filesize 192.168.1.3:upload/test.txt
56 Using ethernet@1c30000 device
57 TFTP to server 192.168.1.3; our IP address is 192.168.1.40
58 Filename 'upload/test.txt'.
59 Save address: 0x42000000
61 Saving: #################
64 Bytes transferred = 260096 (3f800 hex)
70 The command is only available if CONFIG_CMD_TFTPPUT=y.
72 CONFIG_TFTP_BLOCKSIZE defines the size of the TFTP blocks sent. It defaults
73 to 1468 matching an ethernet MTU of 1500.
75 If CONFIG_TFTP_PORT=y, the environment variables *tftpsrcp* and *tftpdstp* can
76 be used to set the source and the destination ports.
78 CONFIG_TFTP_WINDOWSIZE can be used to set the TFTP window size of transmits
79 after which an ACK response is required. The window size defaults to 1.
81 If CONFIG_TFTP_TSIZE=y, the progress bar is limited to 50 '#' characters.
82 Otherwise an '#' is written per UDP package which may decrease performance.
87 The return value $? is 0 (true) on success and 1 (false) otherwise.