06-FTP and TFTP Commands
Chapters Download (127.32 KB)
Table of Contents
FTP Server Configuration Commands
FTP Client Configuration Commands
display ftp client configuration
TFTP Client Configuration Commands
display tftp client configuration
Syntax
display ftp-server
View
Any view
Default Level
3: Manage level
Parameters
None
Description
Use the display ftp-server command to display the FTP server configuration.
After configuring FTP server parameters, you may verify them with this command.
Related commands: ftp server enable, ftp timeout, ftp update.
Examples
# Display the FTP server configuration.
<Sysname> display ftp-server
FTP server is running
Max user number: 1
User count: 1
Timeout value(in minute): 30
Put Method: fast
Table 1-1 display ftp-server command output description
|
Field |
Description |
|
Max user number |
Maximum number of login users at a time |
|
User count |
Number of the current login users |
|
Timeout value (in minute) |
Allowed idle time of an FTP connection. If there is no packet exchange between the FTP server and client during the whole period, the FTP connection will be disconnected. |
|
Put Method |
File update method of the FTP server, including: l fast: Fast update l normal: Normal update |
Syntax
display ftp-user
View
Any view
Default Level
3: Manage level
Parameters
None
Description
Use the display ftp-user command to display the detailed information of current FTP users.
Examples
# Display the detailed information of FTP users.
<Sysname> display ftp-user
UserName HostIP Port Idle HomeDir
ftp 192.168.1.54 1190 0 flash:
# If the name of the logged-in user exceeds 10 characters, the exceeded characters will be displayed in the next line and right justified, for example, if the logged-in user name is administrator, the information is displayed as follows:
<Sysname> display ftp-user
UserName HostIP Port Idle HomeDir
administra
tor 192.168.0.152 1031 0 flash:
Table 1-2 display ftp-user command output description
|
Field |
Description |
|
UserName |
Name of the currently logged-in user |
|
HostIP |
IP address of the currently logged-in user |
|
Port |
Port which the currently logged-in user is using |
|
Idle |
Duration time of the current FTP connection, in minutes |
|
HomeDir |
Authorized path of the present logged-in user |
Syntax
free ftp user username
View
User view
Default Level
3: Manage level
Parameters
username: Username. You can use the display ftp-user command to view the logged-in user name of the current FTP connection.
Description
Use the free ftp user command to manually release the FTP connection established with the specified username.
Note that if the user to be released is transmitting a file, the connection between the user and the FTP server is terminated after the file transmission.
Examples
# Manually release the FTP connection established with username ftpuser.
<Sysname> free ftp user ftpuser
Are you sure to free FTP user ftpuser? [Y/N]:y
<Sysname>
Syntax
ftp server acl acl-number
undo ftp server acl
View
System view
Default Level
3: Manage level
Parameters
acl-number: Basic access control list (ACL) number, in the range 2000 to 2999.
Description
Use the ftp server acl command to control FTP clients’ access to the device using an ACL.
Use the undo ftp server acl command to restore the default.
By default, no ACL is used to control FTP clients’ access to the device.
Associated with an ACL, the FTP server can deny the FTP requests of some FTP clients and only permit the access of clients allowed by the ACL rules. This configuration only filters the FTP connections to be established, and has no effect on the established FTP connections and operations. If you execute the command for multiple times, the last specified ACL takes effect.
Examples
# Associate the FTP service with ACL 2001 to allow only the client 1.1.1.1 to access the device through FTP.
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule 0 permit source 1.1.1.1 0
[Sysname-acl-basic-2001] rule 1 deny source any
[Sysname-acl-basic-2001] quit
[Sysname] ftp server acl 2001
Syntax
ftp server enable
undo ftp server
View
System view
Default Level
3: Manage level
Parameters
None
Description
Use the ftp server enable command to enable the FTP server and allow the login of FTP users.
Use the undo ftp server command to disable the FTP server.
By default, the FTP server is disabled to prevent attacks.
Examples
# Enable the FTP server.
<Sysname> system-view
[Sysname] ftp server enable
Syntax
ftp timeout minute
undo ftp timeout
View
System view
Default Level
3: Manage level
Parameters
minute: Idle-timeout timer in minutes, in the range 1 to 35791.
Description
Use the ftp timeout command to set the idle-timeout timer.
Use the undo ftp timeout command to restore the default.
By default, the FTP idle time is 30 minutes.
After you log in to an FTP server, if the connection is disrupted and the FTP server is not notified, the system will maintain the connection, which will cause the occupation of the system resources and affect the login of other FTP users. To address this problem, you can set an idle-timeout timer so that the FTP server can disconnect from the user if no information is received or/and transmitted before the timer expires.
Examples
# Set the idle-timeout timer to 36 minutes.
<Sysname> system-view
[Sysname] ftp timeout 36
Syntax
ftp update { fast | normal }
undo ftp update
View
System view
Default Level
3: Manage level
Parameters
fast: Fast update.
normal: Normal update.
Description
Use the ftp update command to set the file update mode that the FTP server uses while receiving data.
Use the undo ftp update command to restore the default, namely, the normal mode.
Examples
# Set the FTP update mode to normal.
<Sysname> system-view
[Sysname] ftp update normal
l In this section, the configuration procedure of entering FTP client view is omitted. You must use the ftp command to enter FTP client view for configurations under this view. For details, refer to ftp.
l Before executing the FTP client configuration commands in this section, make sure you have configured the proper authority for users on the FTP server, such as view the files under the current directory, read/download the specified file, create directory/upload files, rename/remove files, and so on.
Syntax
ascii
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the ascii command to set the file transfer mode to ASCII.
By default, the file transfer mode is ASCII.
The carriage return characters vary with operating systems. For example, to indicate the end of a line and transfer to the next line, the H3C device system and Windows system use characters /r/n, and the Linux system uses characters /n. Therefore, after the file transmission between two systems that use different carriage return characters, such as Linux system and H3C device system, the FTP transmission mode must be applied to ensure the correct resolution of the files.
FTP transfers files in two modes:
l Binary mode: for program file or picture transmission.
l ASCII mode: for text file transmission.
Related commands: binary.
Examples
# Set the file transfer mode to ASCII.
[ftp] ascii
200 Type set to A.
Syntax
binary
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the binary command to set the file transfer mode to binary (also called flow mode).
By default, the transfer mode is ASCII mode.
Related commands: ascii.
Examples
# Set the file transfer mode to binary.
[ftp] binary
200 Type set to I.
Syntax
bye
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the bye command to disconnect from the remote FTP server and return to user view. If the device establishes no connection with the remote FTP server, you will return to user view directly.
Related commands: close, disconnect, quit.
Examples
# Terminate the connection with the remote FTP server and return to user view.
[ftp] bye
221 Server closing.
Syntax
cd { directory | .. | / }
View
FTP client view
Default Level
3: Manage level
Parameters
directory: Name of the target directory, in the format of [drive:/]path. For the detailed explanation of the drive and path arguments, refer to File System Management Configuration in the System Volume. If no drive information is provided, the argument represents a folder or subfolder under the current directory.
..: Returns to an upper directory. If the current working directory is the root directory, or no upper directory exists, the current working directory does not change when the cd .. command is executed. This argument does not support command online help.
/: Returns to the root directory of the storage medium. The keyword does not support command line online help.
Description
Use the cd command to change the current working directory on the remote FTP server.
You can use this command to access another authorized directory on the FTP server.
Related commands: pwd.
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 authorized directory.
[ftp] cd /folder
250 CWD command successful.
Syntax
cdup
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the cdup command to exit the current directory and enter the upper directory of the FTP server.
Execution of this command will not change the working directory if the current directory is already the authorized directory (that is, work-directory).
Related commands: cd, pwd.
Examples
# Change the current working directory path 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.
Syntax
close
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the close command to terminate the connection to the FTP server, but remain in FTP client view.
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]
Syntax
debugging
undo debugging
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the debugging command to enable FTP client debugging.
Use the undo debugging command to disable FTP client debugging.
By default, FTP client debugging is disabled.
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] debugging
[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-3 debugging command output description
|
Field |
Description |
|
---> PORT |
Give an FTP order, with data port numbers being… |
|
The parsed reply is |
The 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. |
Syntax
delete remotefile
View
FTP client view
Default Level
3: Manage level
Parameters
remotefile: File name.
Description
Use the delete command to permanently delete a specified file on the remote FTP server. A deleted file cannot be restored.
To do this, you must be a user with the delete permission on the FTP server.
Examples
# Delete file temp.c.
[ftp] delete temp.c
250 DELE command successful.
Syntax
dir [ remotefile [ localfile ] ]
View
FTP client view
Default Level
3: Manage level
Parameters
remotefile: Name of the file or directory on the remote FTP server.
localfile: Name of the local file to save the displayed information.
Description
Use the dir command to view the detailed information of the files and subdirectories under the current directory on the remote FTP server.
Use the dir remotefile command to display the detailed information of the specified file or directory on the remote FTP server.
Use the dir remotefile localfile command to display the detailed information of the specified file or directory on the remote FTP server, and save the displayed information into a local file specified by the localfile argument.
You can use the dir command to display the folder- and file-related information, such as the size, and the date they were created. If you only need to view the name of all the files and subdirectories under the current directory, you can use the Is command.
Examples
# View the detailed information of the files and subdirectories under the current directory on the remote 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]
# View the information of the file ar-router.cfg, and save the result to aa.txt.
[ftp] dir ar-router.cfg aa.txt
227 Entering Passive Mode (192,168,1,50,17,158).
125 ASCII mode data connection already open, transfer starting for /ar-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 ar-router.cfg
Syntax
disconnect
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the disconnect command to disconnect from the remote FTP server but remain in FTP client view.
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.
Syntax
display ftp client configuration
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display ftp client configuration command to display the configuration information of the FTP client.
Currently this command displays the configured source IP address or source interface of the FTP client.
Related commands: ftp client source.
Examples
# Display the current configuration information of the FTP client.
<Sysname> display ftp client configuration
The source IP address is 192.168.0.123
Syntax
ftp [ server-address [ service-port ] [ source { interface interface-type interface-number | ip source-ip-address } ] ]
View
User view
Default Level
3: Manage level
Parameters
server-address: IP address or host name (a string of 1 to 20 characters) of a remote FTP server.
service-port: TCP port number of the remote FTP server, in the range 0 to 65535. The default value is 21.
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 packets. If no primary IP address is configured on the source interface, the connection fails.
ip source-ip-address: The source IP address of the current FTP client. This source address must be the one that has been configured on the device.
Description
Use the ftp command to log in to the remote FTP server and enter FTP client view.
Note that:
l This command applies to IPv4 networks.
l If you use this command without specifying any parameters, you will simply enter the FTP client view without logging in to the FTP server.
l If you specify the parameters, you will be prompted to enter the username and password for accessing the FTP server.
l The priority of the source address specified with this command is higher than that with the ftp client source command. If you specify the source address with the ftp client source command first and then with the ftp command, the source address specified with the ftp command is used to communicate with the FTP server.
Related commands: ftp client source.
Examples
# Log in from the current device Sysname1 to the device Sysname2 with the IP address of 192.168.0.211. The source IP address of the packets sent is 192.168.0.212.
<Sysname> 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]
Syntax
ftp client source { interface interface-type interface-number | ip source-ip-address }
undo ftp client source
View
System view
Default Level
2: System level
Parameters
interface interface-type interface-number: Source interface for the FTP connection, including interface type and interface number. The primary IP address configured on the source interface is the source IP address of the packets sent by FTP. If no primary IP address is configured on the source interface, the connection fails.
ip source-ip-address: Source IP address of the FTP connection. It must be an IP address that has been configured on the device.
Description
Use the ftp client source command to configure the source address of the transmitted FTP packets from the FTP client.
Use the undo ftp client source command to restore the default.
By default, a device uses the IP address of the interface determined by the matched route as the source IP address to communicate with an FTP server.
Note that:
l The source address can be specified as the source interface and the source IP address. If you use the ftp client source command to specify the source interface and then the source IP address, the newly specified source IP address overwrites the configured source interface and vice versa.
l If the source address is specified with the ftp client source command and then with the ftp command, the source address specified with the latter one is used to communicate with the FTP server.
l The source address specified with the ftp client source command is valid for all FTP connections and the source address specified with the ftp command is valid only for the current FTP connection.
Related commands: display ftp client configuration.
Examples
# Specify the source IP address of the FTP client as 2.2.2.2.
<Sysname> system-view
[Sysname] ftp client source ip 2.2.2.2
# Specify the source interface of the FTP client as Vlan-interface1.
<Sysname> system-view
[Sysname] ftp client source interface vlan-interface1
Syntax
get remotefile [ localfile ]
View
FTP client view
Default Level
3: Manage level
Parameters
remotefile: Name of the file to be downloaded.
localfile: File name used after a file is downloaded and saved locally. If this argument is not specified, the file is saved locally using the source file name to the current working directory, namely the directory where the user executes the ftp command.
Description
Use the get command to download a file from a remote FTP server and save it.
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.
Syntax
lcd
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the lcd command to display the local working directory of the FTP client.
Examples
# Display the local working directory.
[ftp] lcd
FTP: Local directory now flash:/clienttemp.
The above information indicates that the working directory of the FTP client before execution of the ftp command is flash:/clienttemp.
Syntax
ls [ remotefile [ localfile ] ]
View
FTP client view
Default 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.
Description
Use the ls command to view the information of all the files and subdirectories under the current directory of the remote FTP server. The file names and subdirectory names are displayed.
Use the ls remotefile command to view the information of a specified file or subdirectory.
Use the ls remotefile localfile command to view the information of a specified file or subdirectory, and save the result to a local file specified by the localfile argument.
The Is command can only display the names of files and directories on the FTP server, whereas the dir command can display other related information of the files and directories, such as the size, and the date they were created.
Examples
# View the information of all files and subdirectories under 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 /*.
ar-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.
# View the information of directory logfile, and save the result to file aa.txt.
[ftp] ls logfile aa.txt
227 Entering Passive Mode (192,168,1,46,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
<Sysname> more aa.txt
.
..
logfile.log
Syntax
mkdir directory
View
FTP client view
Default Level
3: Manage level
Parameters
directory: Name of the directory to be created.
Description
Use the mkdir command to create a subdirectory under the current directory on the remote FTP server.
To do this, you must be a user with the permission on the FTP server.
Examples
# Create subdirectory mytest on the current directory of the remote FTP server.
[ftp] mkdir mytest
257 "/mytest" new directory created.
Syntax
open server-address [ service-port ]
View
FTP client view
Default 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 0 to 65535, with the default value of 21.
Description
Use the open command to log in to the IPv4 FTP server under FTP client view.
At login, you will be asked to enter the username and password for accessing the FTP server. If your input is correct, the login succeeds; otherwise, it fails.
If you have logged in to the IPv4 FTP server currently, you cannot use the open command to log in to another server. You need to disconnect with the current server first, and then try to connect with another one.
Related commands: close.
Examples
# In FTP client view, log in to the FTP server with the IP address of 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]
Syntax
passive
undo passive
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the passive command to set the data transmission mode to passive.
Use the undo passive command to set the data transmission mode to active.
The default transmission mode is passive.
Data transmission modes fall into the passive mode and the active mode. The active mode means that the data connection request is initiated by a server. The passive mode means that the data connection request is initiated by a client. This command is mainly used in conjunction with a firewall to restrict the FTP session connection between private and public network users.
Examples
# Set the data transmission mode to passive.
[ftp] passive
FTP: passive is on
Syntax
put localfile [ remotefile ]
View
FTP client view
Default 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.
Description
Use the put command to upload a file on the client to the remote FTP server.
If no name is assigned to the file to be saved on the FTP server, the name of the source file is used by default. After a file is uploaded, it will be saved under the user’s authorized directory, which can be set with the authorization-attribute command.
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.
Syntax
pwd
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the pwd command to display the currently accessed directory on the remote FTP server.
Examples
# Display the currently accessed directory on the remote FTP server.
[ftp] cd servertemp
[ftp] pwd
257 "/servertemp" is current directory.
The above information indicates that the servertemp folder under the root directory of the remote FTP server is being accessed by the user.
Syntax
quit
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the quit command to disconnect from the remote FTP server and exit to user view.
Examples
# Disconnect from the remote FTP server and exit to user view.
[ftp] quit
221 Server closing.
<Sysname>
Syntax
remotehelp [ protocol-command ]
View
FTP client view
Default Level
3: Manage level
Parameters
protocol-command: FTP command.
Description
Use the remotehelp command to display the help information of FTP-related commands supported by the remote FTP server.
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 1-4 remotehelp command output description
|
Field |
Description |
|
214-Here is a list of available ftp commands |
The following is an available FTP command list. |
|
Those with '*' are not yet implemented. |
Those commands with “*” are not yet implemented. |
|
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 CUP |
|
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 |
Syntax
rmdir directory
View
FTP client view
Default Level
3: Manage level
Parameters
directory: Directory name on the remote FTP server.
Description
Use the rmdir command to remove a specified directory from the FTP server.
Note that only authorized users are allowed to use this command.
Note that:
l The directory to be deleted must be empty, meaning you should delete all files and subdirectories under the directory before you delete a directory. For the deletion of files, refer to the delete command.
l After you execute the rmdir command successfully, the files in the remote recycle bin under the directory will be automatically deleted.
Examples
# Delete the temp1 directory from the authorized directory on the FTP server.
[ftp] rmdir /temp1
200 RMD command successful.
Syntax
user username [ password ]
View
FTP client view
Default Level
3: Manage level
Parameters
username: Login username.
password: Login password. You can input this argument after the username argument plus a space; or you can input this argument when the “Password:” prompt appears after you input the username and then press Enter.
Description
Use the user command to relog in to the currently accessed FTP server with another username.
Before using this command, you must configure the corresponding username and password on the FTP server; otherwise, your login fails and the FTP connection is closed.
Examples
# User ftp1 has logged in to the FTP server. Use username ftp2 to log in to the current FTP server. (Suppose username ftp2 and password 123123123123 have been configured on the FTP server).
l Method 1
[ftp] user ftp2
331 Password required for ftp2.
Password:
230 User logged in.
[ftp]
l Method 2
[ftp] user ftp2 123123123123
331 Password required for ftp.
230 User logged in.
[ftp]
Syntax
verbose
undo verbose
View
FTP client view
Default Level
3: Manage level
Parameters
None
Description
Use the verbose command to enable the protocol information function to display detailed prompt information.
Use the undo verbose command to disable the protocol information function.
By default, the protocol information function is enabled.
Examples
# Enable the protocol information function.
[ftp] verbose
FTP: verbose is on
# Disable the protocol information function and perform the 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 the protocol information function and perform the 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.
Syntax
display tftp client configuration
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display tftp client configuration command to display the configuration information of the TFTP client.
Related commands: tftp client source.
Examples
# Display the current configuration information of the TFTP client.
<Sysname> display tftp client configuration
The source IP address is 192.168.0.123
Currently this command displays the configured source IP address or source interface of the TFTP client.
Syntax
tftp-server acl acl-number
undo tftp-server acl
View
System view
Default Level
3: Manage level
Parameters
acl-number: Number of a basic ACL, in the range 2000 to 2999.
Description
Use the tftp server acl command to control the device’s access to a specific TFTP server using an ACL.
Use the undo tftp server acl command to restore the default.
By default, no ACL is used to control the device’s access to TFTP servers.
You can use the rules in an ACL to allow or permit the device’s access to a specific TFTP server in a network.
For more information about ACL, refer to ACL Configuration and ACL Commands in the Security Volume.
Examples
# Allow the device to access the TFTP server with the IP address of 1.1.1.1 only.
<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
Syntax
tftp server-address { get | put | sget } source-filename [ destination-filename ] [ source { interface interface-type interface-number | ip source-ip-address } ]
View
User view
Default 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.
source: Configures parameters for source address binding.
l 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.
l 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.
Description
Use the tftp command to upload files from the local device to a TFTP server or download files from the TFTP server to the local device.
l If no destination file name is specified, a file is saved using the same name as that on the remote FTP server to the current working directory of the user (namely, the working directory where the tftp command is executed).
l The priority of the source address specified with this command is higher than that specified with the tftp client source command. If you use the tftp client source command to specify the source address first and then with the tftp command, the latter one is adopted.
This command applies to IPv4 networks.
Related commands: tftp client source.
Examples
# Download the config.cfg file from the TFTP server with the IP address of 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 with the IP address of 192.168.0.98 and save it as config.bak. Specify the source IP interface to be Vlan-interface1.
<Sysname> tftp 192.168.0.98 put config.cfg config.bak source interface vlan-interface1
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.
Syntax
tftp client source { interface interface-type interface-number | ip source-ip-address }
undo tftp client source
View
System view
Default Level
2: System level
Parameters
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: The source IP address of TFTP connections. It must be an IP address that has been configured on the device.
Description
Use the tftp client source command to configure the source address of the TFTP packets from the TFTP client.
Use the undo telnet client source command to restore the default.
By default, a device uses the IP address of the interface determined by the matched route as the source IP address to communicate with a TFTP server.
Note that:
l The source address can be specified as the source interface and the source IP; if you use the tftp client source command to specify the source interface and then the source IP, the newly specified source IP overwrites the configured source interface and vice versa.
l If the source address is specified with the tftp client source command and then with the tftp command, the source address specified with the latter one is used to communicate with the TFTP server.
l The source address specified with the tftp client source command is valid for all tftp connections and the source address specified with the tftp command is valid for the current tftp command.
Related commands: display tftp client configuration.
Examples
# Specify the source IP address of the TFTP client as 2.2.2.2.
<Sysname> system-view
[Sysname] tftp client source ip 2.2.2.2
# Specify the source interface of the TFTP client as Vlan-interface1.
<Sysname> system-view
[Sysname] tftp client source interface vlan-interface1
