Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 03-FTP and TFTP Commands | 150.00 KB |
FTP client configuration commands
display ftp client configuration
display tftp client configuration
FTP client configuration commands
Before executing FTP client configuration commands, make sure you have made proper authority configurations for users on the FTP server. Authorized operations include view the files under the current directory, read/download the specified files, create directory/upload files, and rename/remove files.
The prompt information in the following examples varies with FTP server types.
ascii
Use ascii to set the file transfer mode to ASCII.
Syntax
ascii
Default
The file transfer mode is ASCII.
Views
FTP client view
Default command level
3: Manage level
Usage guidelines
The carriage return characters vary with operating systems. For example, H3C and Windows use characters /r/n, and Linux uses characters /n. To transfer files between two systems that use different carriage return characters, determine FTP transfer mode according to the file type.
FTP transfers files in either of the following modes:
· Binary mode—Transfers image files or pictures.
· ASCII mode—Transfers text files.
Examples
# Set the file transfer mode to ASCII.
[ftp] ascii
200 Type set to A.
[ftp]
binary
binary
Use binary to set the file transfer mode to binary, which is also called the "flow mode".
Syntax
binary
Default
The transfer mode is ASCII mode.
Views
FTP client view
Default command level
3: Manage level
Examples
# Set the file transfer mode to binary.
[ftp] binary
200 Type set to I.
[ftp]
ascii
bye
Use bye to disconnect from the remote FTP server and return to user view.
Syntax
bye
Views
FTP client view
Default command level
3: Manage level
Usage guidelines
If no connection is established between the device and the remote FTP server, use this command to return to user view.
Examples
# Terminate the connection with the remote FTP server and return to user view.
[ftp] bye
221 Server closing.
<Sysname>
Related commands
· close
· disconnect
· quit
cd
Use cd to change the current working directory to another directory on the FTP server.
Syntax
cd { directory | .. | / }
Views
FTP client view
Default command level
3: Manage level
Parameters
directory: Name of the target directory, in the format [drive:][/]path, where drive represents the storage medium name, typically Flash or CF. If the target directory does not exist, the cd command does not change the current working directory. If no drive information is provided, the argument represents a folder or subfolder in the current directory. For more information about the drive and path arguments, see Fundamentals Configuration Guide.
..: Returns to the upper directory. Executing the cd .. command is the same as executing the cdup command. If the current working directory is the FTP root directory, the cd .. command does not change the current working directory. This option does not support command line online help.
/: Returns to the FTP root directory. This option does not support command line online help.
Examples
# Change the working directory to the sub-directory logfile of the current directory.
[ftp] cd logfile
250 CWD command successful.
# Change the working directory to the sub-directory folder of the FTP root directory.
[ftp] cd /folder
250 CWD command successful.
# Change the working directory to the upper directory of the current directory.
[ftp] cd ..
250 CWD command successful.
# Change the working directory to the FTP root directory.
[ftp] cd /
250 CWD command successful.
[ftp]
pwd
cdup
Use cdup to enter the upper directory of the FTP server.
Syntax
cdup
Views
FTP client view
Default command level
3: Manage level
Usage guidelines
This command does not change the working directory if the current directory is the FTP root directory.
Examples
# Change the working directory to the upper directory.
[ftp] pwd
257 "/ftp/subdir" is current directory.
[ftp] cdup
200 CDUP command successful.
[ftp] pwd
257 "/ftp" is current directory.
[ftp]
· cd
· pwd
close
Use close to terminate the connection to the FTP server, but remain in FTP client view.
Syntax
close
Views
FTP client view
Default command level
3: Manage level
Usage guidelines
This command is equal to the disconnect command.
Examples
# Terminate the connection to the FTP server and remain in FTP client view.
[ftp] close
221 Server closing.
[ftp]
debugging
Use debugging to enable FTP client debugging.
Use undo debugging to disable FTP client debugging.
Syntax
debugging
undo debugging
Default
FTP client debugging is disabled.
Views
FTP client view
Default command level
1: Monitor level
Examples
# The device serves as the FTP client. Enable FTP client debugging and use the active mode to download file sample.file from the current directory of the FTP server.
<Sysname> terminal monitor
<Sysname> terminal debugging
<Sysname> ftp 192.168.1.46
Trying 192.168.1.46 ...
Press CTRL+K to abort
Connected to 192.168.1.46.
220 FTP service ready.
User(192.168.1.46:(none)):ftp
331 Password required for ftp.
Password:
230 User logged in.
[ftp]undo passive
FTP: passive is off
[ftp] debugging
FTP: debugging switch is on
[ftp] get sample.file
---> PORT 192,168,1,44,4,21
200 Port command okay.
The parsed reply is 200
---> RETR sample.file
150 Opening ASCII mode data connection for /sample.file.
The parsed reply is 150
FTPC: File transfer started with the signal light turned on.
FTPC: File transfer completed with the signal light turned off.
.226 Transfer complete.
FTP: 3304 byte(s) received in 4.889 second(s), 675.00 byte(s)/sec.
[ftp]
Table 1 Command output
|
Field |
Description |
|
---> PORT 192,168,1,44,4,21 |
FTP command. 192,168,1,44 specifies the destination IP address, and 4,21 is used to calculate the data port number by using the formula 4*256+21. |
|
The parsed reply is |
Received reply code, which is defined in RFC 959. |
|
---> RETR |
Download the file. |
|
FTPC: File transfer started with the signal light turned on. |
File transfer starts, and the signal light is turned on. |
|
FTPC: File transfer completed with the signal light turned off. |
File transfer is completed, and the signal light is turned off. |
delete
Use delete to permanently delete a specified file on the remote FTP server.
Syntax
delete remotefile
Views
FTP client view
Default command level
3: Manage level
Parameters
remotefile: File name.
Usage guidelines
To perform this operation, you must have delete permission on the FTP server.
Examples
# Delete file temp.c.
[ftp] delete temp.c
250 DELE command successful.
[ftp]
dir
Use dir to display detailed information about the files and subdirectories under the current directory on the FTP server.
Use dir remotefile to display detailed information about a specific file or directory on the FTP server.
Use dir remotefile localfile to save detailed information about a specific file or directory on the FTP server to a local file.
Syntax
dir [ remotefile [ localfile ] ]
Views
FTP client view
Default command level
3: Manage level
Parameters
remotefile: Name of the file or directory on the remote FTP server.
localfile: Name of the local file used to save the displayed information.
Usage guidelines
The Is command displays only the names of files and directories. The dir command displays more information about the files and directories, such as the size and the creation date.
Examples
# Display detailed information about the files and subdirectories under the current directory on the FTP server.
[ftp] dir
227 Entering Passive Mode (192,168,1,46,5,68).
125 ASCII mode data connection already open, transfer starting for /*.
drwxrwxrwx 1 noone nogroup 0 Aug 08 2006 logfile
-rwxrwxrwx 1 noone nogroup 20471748 May 11 10:21 test.bin
-rwxrwxrwx 1 noone nogroup 4001 Dec 08 2007 config.cfg
-rwxrwxrwx 1 noone nogroup 3608 Jun 13 2007 startup.cfg
drwxrwxrwx 1 noone nogroup 0 Dec 03 2007 test
-rwxrwxrwx 1 noone nogroup 299 Oct 15 2007 key.pub
226 Transfer complete.
FTP: 394 byte(s) received in 0.189 second(s), 2.00K byte(s)/sec.
[ftp]
# Save detailed information about file router.cfg to aa.txt.
[ftp] dir router.cfg aa.txt
227 Entering Passive Mode (192,168,1,50,17,158).
125 ASCII mode data connection already open, transfer starting for /router.cfg.
....226 Transfer complete.
FTP: 67 byte(s) received in 4.600 second(s), 14.00 byte(s)/sec.
# View the content of aa.txt.
[ftp] quit
<Sysname> more aa.txt
-rwxrwxrwx 1 noone nogroup 3077 Jun 20 15:34 router.cfg
disconnect
Use disconnect to disconnect from the remote FTP server but remain in FTP client view.
Syntax
disconnect
Views
FTP client view
Default command level
3: Manage level
Usage guidelines
This command is equal to the close command.
Examples
# Disconnect from the remote FTP server but remain in FTP client view.
[ftp] disconnect
221 Server closing.
[ftp]
display ftp client configuration
Use display ftp client configuration to display the source IP address configuration of the FTP client.
Syntax
display ftp client configuration [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If the specified source IP address is active, this command displays the source IP address. If the specified source interface is active, this command displays the source interface.
Examples
# Display the source IP address configuration of the FTP client.
<Sysname> display ftp client configuration
The source IP address is 192.168.0.123
ftp client source
ftp
Use ftp to log in to an FTP server and enter FTP client view.
Syntax
ftp [ server-address [ service-port ] [ source { interface interface-type interface-number | ip source-ip-address } ] ]
Views
User view
Default command level
3: Manage level
Parameters
server-address: IP address or host name of the FTP server, a string of 1 to 20 characters.
service-port: TCP port number of the FTP server, in the range of 0 to 65535. The default value is 21.
source { interface interface-type interface-number | ip source-ip-address }: Specifies the source address used to establish the FTP connection.
· interface interface-type interface-number: Specifies the source interface by its type and number. The primary IP address configured on this interface is the source address of the transmitted FTP packets. If no primary IP address is configured on the source interface, the connection cannot be established.
· ip source-ip-address: The source IP address of the transmitted FTP packets. This source address must be the one that has been configured on the device.
Usage guidelines
This command is applicable to IPv4 networks only.
If no parameters are specified, this command enters the FTP client view without logging in to the FTP server.
If the server parameters are specified, you are prompted to type the username and password for accessing the FTP server.
Examples
# Log in the server 192.168.0.211 and specify the source IP address of sent FTP packets as 192.168.0.212.
<Sysname1> ftp 192.168.0.211 source ip 192.168.0.212
Trying 192.168.0.211 ...
Press CTRL+K to abort
Connected to 192.168.0.211.
220 FTP Server ready.
User(192.168.0.211:(none)):abc
331 Password required for abc
Password:
230 User logged in.
[ftp]
ftp client source
Use ftp client source to specify a source IP address for outgoing FTP packets.
Use undo ftp client source to restore the default.
Syntax
ftp client source { interface interface-type interface-number | ip source-ip-address }
undo ftp client source
Default
The primary IP address of the output interface is used as the source IP address.
Views
System view
Default command level
2: System level
Parameters
interface interface-type interface-number: Specifies a source interface for outgoing FTP packets.
ip source-ip-address: Specifies a source IP address for outgoing FTP packets. This IP address must be one of the IP addresses of the device.
Usage guidelines
You can use the ftp client source command to specify a source IP address or source interface for the FTP packets sent by the device. If a source interface (typically a loopback interface) is specified, its primary IP address is used as the source IP address for the FTP packets sent by the device. The source interface setting and the source IP address setting overwrite each other.
|
|
IMPORTANT: To avoid FTP connection failures, when you specify a source interface for FTP packets, make sure the interface has been assigned a primary IP address. |
The ftp client source command setting applies to all FTP sessions. When you set up an FTP session by using the ftp or ftp ipv6 command, you can also specify a different source IP address for the FTP session.
Examples
# Specify 2.2.2.2 as the source IP address for outgoing FTP packets.
<Sysname> system-view
[Sysname] ftp client source ip 2.2.2.2
Related commands
display ftp client configuration
ftp ipv6
Use ftp ipv6 to log in to an FTP server and enter FTP client view.
Syntax
ftp ipv6 [ server-address [ service-port ] [ source ipv6 source-ipv6-address ] [ -i interface-type interface-number ] ]
Views
User view
Default command level
3: Manage level
Parameters
server-address: IP address or host name of the remote FTP server.
service-port: TCP port number of the FTP server, in the range of 0 to 65535. The default value is 21.
source ipv6 source-ipv6-address: Specifies a source IPv6 address for transmitted FTP packets. This address must be an IPv6 address that has been configured on the device.
-i interface-type interface-number: Specifies an output interface by its type and number. This parameter can be used only when the FTP server address is a link local address and the specified output interface has a link local address. For the configuration of link local addresses, see Layer 3 Configuration Guide.
Usage guidelines
This command is applicable only to IPv6 networks.
If no parameters are specified, this command enters the FTP client view without logging in to an FTP server.
If the FTP server parameters are specified, you also need to enter the username and password for accessing the FTP server.
Examples
# Log in to the FTP server at 3000::200.
<Sysname> ftp ipv6 3000::200
Trying 3000::200 ...
Press CTRL+K to abort
Connected to 3000::200.
220 Welcome!
User(3000::200:(none)): MY_NAME
331 Please specify the password.
Password:
230 Login successful.
[ftp]
get
Use get to download a file from the FTP server and save it.
Syntax
get remotefile [ localfile ]
Views
FTP client view
Default command level
3: Manage level
Parameters
remotefile: Name of the file to be downloaded.
localfile: Name for the downloaded file. If this argument is not specified, the original name is used.
Examples
# Download file testcfg.cfg and save it as aa.cfg.
[ftp] get testcfg.cfg aa.cfg
227 Entering Passive Mode (192,168,1,50,17,163).
125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.
.....226 Transfer complete.
FTP: 5190 byte(s) received in 7.754 second(s), 669.00 byte(s)/sec.
lcd
Use lcd to display the local working directory of the FTP client.
Syntax
lcd
Views
FTP client view
Default command level
3: Manage level
Examples
# Display the local working directory.
[ftp] lcd
FTP: Local directory now flash:/clienttemp.
The output shows that the working directory of the FTP client before execution of the ftp command is flash:/clienttemp.
ls
Use ls to list files and subdirectories in the current directory of the FTP server.
Use ls remotefile to list files under a specific subdirectory or verify the existence of a file in the current directory of the FTP server.
Use ls remotefile localfile to save the name of a file or the list of files under a specific subdirectory to a local file.
Syntax
ls [ remotefile [ localfile ] ]
Views
FTP client view
Default command level
3: Manage level
Parameters
remotefile: Filename or directory on the remote FTP server.
localfile: Name of a local file used to save the displayed information.
Usage guidelines
The ls command displays only the names of files and directories on the FTP server. The dir command displays more information about the files and directories, such as the size and the creation date.
Examples
# List all files and subdirectories in the current directory of the FTP server.
[ftp] ls
227 Entering Passive Mode (192,168,1,50,17,165).
125 ASCII mode data connection already open, transfer starting for /*.
router.cfg
logfile
mainar.bin
arbasicbtm.bin
ftp
test
bb.cfg
testcfg.cfg
226 Transfer complete.
FTP: 87 byte(s) received in 0.132 second(s) 659.00 byte(s)/sec.
# List all files in subdirectory logfile.
[ftp] ls logfile
227 Entering Passive Mode (192,168,1,50,10,49).
125 ASCII mode data connection already open, transfer starting for /logfile/*.
logfile.log
a.cfg
226 Transfer complete.
FTP: 20 byte(s) received in 0.075 second(s), 266.00 byte(s)/sec. .
# Save the names of all files in subdirectory logfile to file aa.txt.
[ftp] ls logfile aa.txt
227 Entering Passive Mode (192,168,1,50,4,3).
125 ASCII mode data connection already open, transfer starting for /logfile/*.
....226 Transfer complete.
FTP: 20 byte(s) received in 3.962 second(s), 5.00 byte(s)/sec.
# View the content of file aa.txt.
[ftp] quit
221 Server closing.
<Sysname> more aa.txt
logfile.log
a.cfg
<Sysname>
mkdir
Use mkdir to create a subdirectory in the current directory on the remote FTP server.
Syntax
mkdir directory
Views
FTP client view
Default command level
3: Manage level
Parameters
directory: Name of the directory to be created.
Usage guidelines
You must have permissions to perform this operation on the FTP server.
Examples
# Create subdirectory mytest in the current directory of the remote FTP server.
[ftp] mkdir mytest
257 "/mytest" new directory created.
[ftp]
open
Use open to log in to the IPv4 FTP server under FTP client view.
Syntax
open server-address [ service-port ]
Views
FTP client view
Default command level
3: Manage level
Parameters
server-address: IP address or host name of a remote FTP server.
service-port: Port number of the remote FTP server, in the range of 0 to 65535. The default value is 21.
Usage guidelines
At login, enter the username and password. If your input is correct, the login succeeds.
If you have logged in to the IPv4 FTP server, you cannot use the open command to log in to another server. To do so, you must disconnect from the current server first.
Examples
# In FTP client view, log in to the FTP server at 192.168.1.50.
<Sysname> ftp
[ftp] open 192.168.1.50
Trying 192.168.1.50 ...
Press CTRL+K to abort
Connected to 192.168.1.50.
220 FTP service ready.
User(192.168.1.50:(none)):aa
331 Password required for aa.
Password:
230 User logged in.
[ftp]
close
open ipv6
Use open ipv6 to log in to the IPv6 FTP server in FTP client view.
Syntax
open ipv6 server-address [ service-port ] [ -i interface-type interface-number ]
Views
FTP client view
Default command level
3: Manage level
Parameters
server-address: IP address or host name of the remote FTP server.
service-port: Port number of the remote FTP server, in the range of 0 to 65535. The default value is 21.
-i interface-type interface-number: Specifies an output interface by its type and number. This parameter can be used only when the FTP server address is a link local address and the specified output interface has a link local address. For the configuration of link local addresses, see Layer 3 Configuration Guide.
Usage guidelines
At login, enter the username and password for accessing the FTP server. If your input is correct, the login succeeds.
Examples
# Log in to the FTP server at 3000::200 in FTP client view.
<Sysname> ftp
[ftp] open ipv6 3000::200
Trying 3000::200 ...
Press CTRL+K to abort
Connected to 3000::200.
220 Welcome!
User(3000::200:(none)): MY_NAME
331 Please specify the password.
Password:
230 Login successful.
[ftp]
close
passive
Use passive to set the FTP operation mode to passive.
Use undo passive to set the FTP operation mode to active.
Syntax
passive
undo passive
Default
The FTP operation mode is passive.
Views
FTP client view
Default command level
3: Manage level
Usage guidelines
FTP can operate in either of the following modes:
· Active mode—The FTP server initiates the TCP connection.
· Passive mode—The FTP client initiates the TCP connection.
Examples
# Set the FTP operation mode to passive.
[ftp] passive
FTP: passive is on
[ftp]
put
Use put to upload a file on the client to the remote FTP server.
Syntax
put localfile [ remotefile ]
Default
If no name is assigned to the file to be saved on the FTP server, the name of the source file is used.
Views
FTP client view
Default command level
3: Manage level
Parameters
localfile: Name of the local file to be uploaded.
remotefile: File name used after a file is uploaded and saved on the FTP server.
Usage guidelines
When a file is uploaded, it is saved in the user's authorized directory, which can be set with the authorization-attribute command on the remote server.
Examples
# Upload source file cc.txt to the remote FTP server and save it as dd.txt.
[ftp] put cc.txt dd.txt
227 Entering Passive Mode (192,168,1,50,17,169).
125 ASCII mode data connection already open, transfer starting for /dd.txt.
226 Transfer complete.
FTP: 9 byte(s) sent in 0.112 second(s), 80.00 byte(s)/sec.
pwd
Use pwd to display the currently accessed directory on the remote FTP server.
Syntax
pwd
Views
FTP client view
Default command level
3: Manage level
Examples
# Display the currently accessed directory on the remote FTP server.
[ftp] cd servertemp
[ftp] pwd
257 "/servertemp" is current directory.
The output shows that the servertemp folder in the FTP root directory is being accessed by the user.
quit
Use quit to disconnect the FTP client from the remote FTP server and exit to user view.
Syntax
quit
Views
FTP client view
Default command level
3: Manage level
Examples
# Disconnect from the remote FTP server and exit to user view.
[ftp] quit
221 Server closing.
<Sysname>
remotehelp
Use remotehelp to display the help information of FTP-related commands supported by the remote FTP server.
Syntax
remotehelp [ protocol-command ]
Views
FTP client view
Default command level
3: Manage level
Parameters
protocol-command: FTP command.
Usage guidelines
If no argument is specified, FTP-related commands supported by the remote FTP server are displayed.
Examples
# Display FTP commands supported by the remote FTP server.
[ftp] remotehelp
214-Here is a list of available ftp commands
Those with '*' are not yet implemented.
USER PASS ACCT* CWD CDUP SMNT* QUIT REIN*
PORT PASV TYPE STRU* MODE* RETR STOR STOU*
APPE* ALLO* REST* RNFR* RNTO* ABOR* DELE RMD
MKD PWD LIST NLST SITE* SYST STAT* HELP
NOOP* XCUP XCWD XMKD XPWD XRMD
214 Direct comments to H3C company.
# Display the help information for the user command.
[ftp] remotehelp user
214 Syntax: USER <sp> <username>.
[ftp]
Table 2 Command output
|
Field |
Description |
|
USER |
Username. |
|
PASS |
Password. |
|
CWD |
Change the current working directory. |
|
CDUP |
Change to parent directory. |
|
SMNT* |
File structure setting. |
|
QUIT |
Quit. |
|
REIN* |
Re-initialization. |
|
PORT |
Port number. |
|
PASV |
Passive mode. |
|
TYPE |
Request type. |
|
STRU* |
File structure. |
|
MODE* |
Transmission mode. |
|
RETR |
Download a file. |
|
STOR |
Upload a file. |
|
STOU* |
Store unique. |
|
APPE* |
Appended file. |
|
ALLO* |
Allocation space. |
|
REST* |
Restart. |
|
RNFR* |
Rename the source. |
|
RNTO* |
Rename the destination. |
|
ABOR* |
Abort the transmission. |
|
DELE |
Delete a file. |
|
RMD |
Delete a folder. |
|
MKD |
Create a folder. |
|
PWD |
Print working directory. |
|
LIST |
List files. |
|
NLST |
List file description. |
|
SITE* |
Locate a parameter. |
|
SYST |
Display system parameters. |
|
STAT* |
State. |
|
HELP |
Help. |
|
NOOP* |
No operation. |
|
XCUP |
Extension command, the same meaning as CDUP. |
|
XCWD |
Extension command, the same meaning as CWD. |
|
XMKD |
Extension command, the same meaning as MKD. |
|
XPWD |
Extension command, the same meaning as PWD. |
|
XRMD |
Extension command, the same meaning as RMD. |
|
Syntax: USER <sp> <username>. |
Syntax of the user command: user (keyword) + space + username. |
rmdir
Use rmdir to remove a specified directory from the FTP server.
Syntax
rmdir directory
Views
FTP client view
Default command level
3: Manage level
Parameters
directory: Directory name on the remote FTP server.
Usage guidelines
Only authorized users are allowed to use this command.
Delete all files and subdirectories under a directory before you delete the directory. For how to delete files, see the delete command.
When you execute the rmdir command, the files in the remote recycle bin in the directory will be automatically deleted.
Examples
# Delete the temp1 directory from the FTP root directory.
[ftp] rmdir /temp1
200 RMD command successful.
[ftp]
user
Use user to switch to another user account.
Syntax
user username [ password ]
Views
FTP client view
Default command level
3: Manage level
Parameters
username: Login username.
password: Login password. You can input this argument a space after the username argument; or you can input this argument when the "Password:" prompt appears after you input the username and then press Enter.
Usage guidelines
Before using this command, you must configure the corresponding username and password on the FTP server or the login will fail and the FTP connection will close.
Examples
# After logged in to the FTP server using the username ftp1, use the username ftp2 to relog in to the FTP server: (Assume the username ftp2 and password 123123123123 have been configured on the FTP server.)
· Method 1:
[ftp] user ftp2
331 Password required for ftp2.
Password:
230 User logged in.
[ftp]
· Method 2:
[ftp] user ftp2 123123123123
331 Password required for ftp.
230 User logged in.
[ftp]
verbose
Use verbose to enable display of detailed prompt information received from the server.
Use undo verbose to disable display of detailed prompt information.
Syntax
verbose
undo verbose
Default
The display of detailed prompt information is enabled.
Views
FTP client view
Default command level
3: Manage level
Examples
# Enable display of detailed prompt information.
[ftp] verbose
FTP: verbose is on
# Disable display of detailed prompt information. and perform a Get operation.
[ftp] undo verbose
FTP: verbose is off
[ftp] get startup.cfg bb.cfg
FTP: 3608 byte(s) received in 0.052 second(s), 69.00K byte(s)/sec.
[ftp]
# Enable display of detailed prompt information. and perform a Get operation.
[ftp] verbose
FTP: verbose is on
[ftp] get startup.cfg aa.cfg
227 Entering Passive Mode (192,168,1,46,5,85).
125 ASCII mode data connection already open, transfer starting for /startup.cfg.
226 Transfer complete.
FTP: 3608 byte(s) received in 0.193 second(s), 18.00K byte(s)/sec.
display tftp client configuration
Use display tftp client configuration to display source IP address configuration of the TFTP client.
Syntax
display tftp client configuration [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
The display tftp client configuration command displays the source IP address configuration of the TFTP client. If the specified source IP address is active, this command displays the source IP address. If the specified source interface is active, this command displays the source interface.
Examples
# Display the source IP address configuration of the TFTP client.
<Sysname> display tftp client configuration
The source IP address is 192.168.0.123
Related commands
tftp client source
tftp-server acl
Use tftp-server acl to use an ACL to control the device' access to a specific TFTP server.
Use undo tftp-server acl to restore the default.
Syntax
tftp-server [ ipv6 ] acl acl-number
undo tftp-server [ ipv6 ] acl
Default
No ACL is used to control the device's access to a TFTP server.
Views
System view
Default command level
3: Manage level
Parameters
ipv6: References an IPv6 ACL. If it is not specified, an IPv4 ACL is referenced.
acl-number: Number of a basic ACL, in the range of 2000 to 2999.
Usage guidelines
You can use an ACL to deny or permit the device's access to a specific TFTP server.
For more information about ACL, see ACL and QoS Configuration Guide.
Examples
# Allow the device to access only the TFTP server at 1.1.1.1.
<Sysname> system-view
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 1.1.1.1 0
[Sysname-acl-basic-2000] quit
[Sysname] tftp-server acl 2000
# Allow the device to access only the TFTP server at 2001::1 only.
<Sysname> system-view
[Sysname] acl ipv6 number 2001
[Sysname-acl6-basic-2001] rule permit source 2001::1/128
[Sysname-acl6-basic-2001] quit
[Sysname] tftp-server ipv6 acl 2001
[Sysname]
tftp
Use tftp to download a specified file from the TFTP server to the local device or upload a specified local file to the TFTP server in an IPv4 network.
Syntax
tftp server-address { get | put | sget } source-filename [ destination-filename ] [ source { interface interface-type interface-number | ip source-ip-address } ]
Views
User view
Default command level
3: Manage level
Parameters
server-address: IP address or host name of a TFTP server.
get: Downloads a file in normal mode.
put: Uploads a file.
sget: Downloads a file in secure mode.
source-filename: Source file name.
destination-filename: Destination file name. If this argument is not specified, the file uses the source file name, and is saved in the directory where the user performed the TFTP operation.
source: Configures parameters for source address binding.
interface interface-type interface-number: Specifies the source interface by its type and number. The primary IP address configured on the source interface is the source IP address of the packets sent by TFTP. If no primary IP address is configured on the source interface, the transmission fails.
ip source-ip-address: Specifies the source IP address for the current TFTP client to transmit packets. This source address must be an IP address that has been configured on the device.
Examples
# Download the config.cfg file from the TFTP server at 192.168.0.98 and save it as config.bak. Specify the source IP address to be 192.168.0.92.
<Sysname> tftp 192.168.0.98 get config.cfg config.bak source ip 192.168.0.92
...
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait....
TFTP: 372800 bytes received in 1 second(s)
File downloaded successfully.
# Upload the config.cfg file from the local device to the default path of the TFTP server at 192.168.0.98 and save it as config.bak. Specify the source IP interface to be VLAN-interface 2.
<Sysname> tftp 192.168.0.98 put config.cfg config.bak source interface vlan-interface 2
File will be transferred in binary mode
Sending file to remote TFTP server. Please wait...
TFTP: 345600 bytes sent in 1 second(s).
File uploaded successfully.
tftp client source
Use tftp client source to specify a source IP address for outgoing TFTP packets.
Use undo tftp client source to restore the default.
Syntax
tftp client source { interface interface-type interface-number | ip source-ip-address }
undo tftp client source
Default
The primary IP address of the output interface is used as the source IP address for outgoing TFTP packets.
Views
System view
Default command level
2: System level
Parameters
interface interface-type interface-number: Specifies a source interface for outgoing TFTP packets.
ip source-ip-address: Specifies a source IP address for outgoing TFTP packets. This IP address must be one of the IP addresses configured on the device.
Usage guidelines
You can use the tftp client source command to specify a source IP address or source interface for the TFTP packets sent by the device. If a source interface (typically, a loopback interface) is specified, its primary IP address is used as the source IP address for the TFTP packets. The source interface setting and the source IP address setting overwrite each other.
|
|
IMPORTANT: To avoid TFTP connection failures, when you specify a source interface for TFTP packets, make sure the interface has been assigned a primary IP address. |
The tftp client source command setting applies to all TFTP sessions. When you set up a TFTP session with the tftp command, you can also specify a different source IP address for the TFTP session.
Examples
# Specify 2.2.2.2 as the source IP address for outgoing TFTP packets.
<Sysname> system-view
[Sysname] tftp client source ip 2.2.2.2
Related commands
display tftp client configuration
tftp ipv6
Use tftp ipv6 to download a specified file from a TFTP server or upload a specified local file to a TFTP server in an IPv6 network.
Syntax
tftp ipv6 tftp-ipv6-server [ -i interface-type interface-number ] { get | put } source-filename [ destination-filename ]
Views
User view
Default command level
3: Manage level
Parameters
tftp-ipv6-server: IPv6 address or host name of a TFTP server, a string of 1 to 46 characters.
-i interface-type interface-number: Specifies an output interface by its type and number. This parameter can be used only when the TFTP server address is a link local address and the specified output interface has a link local address. For the configuration of a link local address, see Layer 3 Configuration Guide.
get: Downloads a file.
put: Uploads a file.
source-file: Source filename.
destination-file: Destination filename. If this argument is not specified, the file uses the source file name.
Examples
# Download filetoget.txt from the TFTP server.
<Sysname> tftp ipv6 fe80::250:daff:fe91:e058 -i vlan-interface 2 get filetoget.txt
...
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait....
TFTP: 411100 bytes received in 2 second(s)
