tftp.md

# tftp
## Command Function
Trivial File Transfer Protocol \(TFTP\) is a protocol in the TCP/IP protocol suite for transferring files between clients and servers. TFTP provides simple and low-overhead file transfer services. The port number is 69.
The **tftp** command is used to download files from the TFTP server.
## Syntax
tftp _<-g/-p\>_ _-l_ _\[FullPathLocalFile\] -r \[RemoteFile\] \[Host\]_
## Parameter Description
**Table 1** Parameters

Parameter	Description	Value Range
-g/-p	Indicates the file transfer direction. -g: downloads files from the TFTP server. -p: uploads files to the TFTP server.	N/A
-l FullPathLocalFile	Indicates the complete path of a local file.	N/A
-r RemoteFile	Indicates the file name on the server.	N/A
Host	Indicates the server IP address.	N/A

## Usage
1. Deploy a TFTP server on the server and configure the TFTP server correctly.
2. Use the **tftp** command to upload and download files on the OpenHarmony board.
3. The size of the file to be transferred cannot exceed 32 MB.
> **NOTICE:**
>TFTP is under debugging and disabled by default. Do not use it in formal products.
## Example
Download the **out** file from the server.
## Output
```
OHOS # tftp -g -l /nfs/out -r out 192.168.1.2
TFTP transfer finish
```
After the **tftp** command is executed, **TFTP transfer finish** is displayed if the file transfer is complete. If the file transfer fails, other information is displayed to help locate the fault.