Field	Description
Max user number	Maximum number of concurrent logged-in users.
User count	Number of the current logged-in users.
Idle-timeout timer (in minutes)	If no packet is exchanged between the FTP server and client during this period, the FTP connection is broken.

Related commands

· ftp server enable

· ftp timeout

display ftp-user

Use display ftp-user to display detailed information about logged-in FTP users.

Syntax

display ftp-user

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display detailed information about logged-in FTP users.

<Sysname> display ftp-user

UserName HostIP Port HomeDir

user2 2000:2000:2000: 1499 flash:/user2

2000:2000:2000:

2000:2000

administra 100.100.100.100 10001 flash:/123456789/123456789/12345678

tor 9/123456789/123456789/123456789/123

456789/123456789

Table 2 Command output

Field	Description
UserName	Name of the user.
HostIP	IP address of the user.
Port	Port number of the user.
HomeDir	Authorized directory for the user.

free ftp user

Use free ftp user to manually release the FTP connection that was established by using a specific user account.

Syntax

free ftp user username

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

username: Specifies a username. You can use the display ftp-user command to display FTP user information.

Examples

# Manually release the FTP connection that was established by using the user account named ftpuser.

<Sysname> free ftp user ftpuser

Are you sure to free FTP connection? [Y/N]:y

free ftp user-ip

Use free ftp user-ip to manually release the FTP connection that was established from a specific IPv4 address.

Syntax

free ftp user-ip ipv4-address [ port port ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv4-address: Specifies the source IP address of an FTP connection to be released. You can use the display ftp-user command to view the source IP address of the FTP connection.

port port: Specifies the source port of an FTP connection to be released. You can use the display ftp-user command to view the source port of the FTP connection.

Examples

# Manually release the FTP connection that was established from IP address 192.168.20.184.

<Sysname> free ftp user-ip 192.168.20.184

Are you sure to free FTP connection? [Y/N]:y

free ftp user-ip ipv6

Use free ftp user-ip ipv6 to manually release the FTP connection that was established from a specific IPv6 address.

Syntax

free ftp user-ip ipv6 ipv6-address [ port port ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv6-address: Specifies the source IPv6 address of an FTP connection to be released. You can use the display ftp-user command to view the source IPv6 address of the FTP connection.

port port: Specifies the source port of an FTP connection to be released. You can use the display ftp-user command to view the source port of the FTP connection.

Examples

# Manually release the FTP connection that was established from IPv6 address 2000::154.

<Sysname> free ftp user-ip ipv6 2000::154

Are you sure to free FTP connection? [Y/N]:y

ftp server acl

Use ftp server acl to use an ACL to control FTP clients' access to the FTP server.

Use undo ftp server acl to restore the default.

Syntax

ftp server acl { acl-number | ipv6 acl-number6 }

undo ftp server acl [ ipv6 ]

Default

No ACL is used to control FTP clients' access to the FTP server.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

acl-number: Specifies an IPv4 ACL number in the range of 2000 to 3999.

ipv6 acl-number6: Specifies an IPv6 ACL number in the range of 2000 to 3999.

Usage guidelines

You can use this command to permit only FTP requests from specific FTP clients. This configuration takes effect only for FTP connections to be established. It does not impact existing FTP connections. If you execute the command multiple times, the last specified ACL takes effect.

Examples

# Use ACL 2001 to allow only client 1.1.1.1 to access the FTP server.

<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

ftp server enable

Use ftp server enable to enable the FTP server.

Use undo ftp server enable to disable the FTP server.

Syntax

ftp server enable

undo ftp server enable

Default

The FTP server is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable the FTP server.

<Sysname> system-view

[Sysname] ftp server enable

ftp timeout

Use ftp timeout to set the idle-timeout interval for FTP connections.

Use undo ftp timeout to restore the default.

Syntax

ftp timeout minute

undo ftp timeout

Default

The FTP idle-timeout interval is 30 minutes.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

Minute: Specifies an idle-timeout interval in the range of 1 to 35791 minutes.

Usage guidelines

If no packet is exchanged on an FTP connection within the idle-timeout interval, the FTP server breaks the FTP connection to release resources.

Examples

# Set the idle-timeout interval to 36 minutes.

<Sysname> system-view

[Sysname] ftp timeout 36

FTP client commands

Before executing FTP client configuration commands, make sure you have configured authorization settings for users on the FTP server. Authorized operations include view the files under the working directory, read/download specified files, create directories, upload files, and rename/remove files.

The FTP client commands in this section are supported by the device, but whether they can be executed successfully depends on the FTP server.

append

Use append to add the content of a file on the FTP client to a file on the FTP server.

Syntax

append localfile [ remotefile ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

localfile: Specifies a local file on the FTP client.

remotefile: Specifies a remote file on the FTP server.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Append the content of the local a.txt file to the b.txt file on the FTP server.

ftp> append a.txt b.txt

227 Entering Passive Mode (192,168,3,51,7,40)

150 "D:\test\a.txt" file ready to receive in ASCII mode

226 Transfer finished successfully.

2749 bytes sent in 0.000239 seconds (10.97 Mbyte/s)

ascii

Use ascii to set the file transfer mode to ASCII.

Syntax

ascii

Default

The file transfer mode is ASCII.

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You can perform this operation only after you log in to the FTP server.

The carriage return characters vary with operating systems. For example, H3C and Windows use /r/n, and Linux uses /n. To transfer files between two systems that use different carriage return characters, select the 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 is ASCII

Related commands

binary

Use binary to set the file transfer mode to binary, which is also called the "flow mode".

Syntax

binary

Default

The file transfer mode is ASCII.

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You can perform this operation only after you log in to the FTP server.

The carriage return characters vary with operating systems. For example, H3C and Windows use /r/n, and Linux uses /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 the following modes:

· Binary mode—Transfers program file or pictures.

· ASCII mode—Transfers text files.

Examples

# Set the file transfer mode to binary.

ftp> binary

200 Type is Image (Binary)

Related commands

ascii

bye

Use bye to terminate the connection to the FTP server and return to user view.

If no connection is established between the device and the remote FTP server, use this command to return to user view.

Syntax

bye

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Examples

# Terminate the connection to the FTP server and return to user view.

ftp> bye

221 Windows FTP Server (WFTPD, by Texas Imperial Software) says goodbye

Related commands

quit

cd

Use cd to change the current working directory to another directory on the FTP server.

Syntax

cd { directory | .. | / }

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

directory: Specifies the 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.

/: Returns to the FTP root directory.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

The directory that can be accessed must be authorized by the FTP server.

Examples

# Change the working directory to the subdirectory logfile of the current directory.

ftp> cd logfile

250 "D:\test\logfile " is current directory

# Change the working directory to the subdirectory folder of the FTP root directory.

ftp> cd /folder

250 "D:\folder" is current directory

# Change the working directory to the upper directory of the current directory.

ftp> cd ..

250 "D:\test" is current directory

# Change the working directory to the FTP root directory.

ftp> cd /

250 "D:\" is current directory

Related commands

· cdup

· pwd

cdup

Use cdup to enter the upper directory of the FTP server.

This command does not change the working directory if the current directory is the FTP root directory.

Syntax

cdup

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Change the working directory to the upper directory.

ftp> pwd

257 "D:\test" is current directory

ftp> cdup

250 "D:\" is current directory

ftp> pwd

257 "D:\" is current directory

Related commands

· cd

· pwd

close

Use close to terminate the connection to the FTP server without exiting FTP client view.

Syntax

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Terminate the connection to the FTP server without exiting the FTP client view.

ftp> close

221 Windows FTP Server (WFTPD, by Texas Imperial Software) says goodbye

ftp>

Related commands

disconnect

debug

Use debug to enable or disable FTP client debugging.

Syntax

debug

Default

FTP client debugging is disabled.

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

When FTP client debugging is enabled, executing this command disables FTP client debugging.

When FTP client debugging is disabled, executing this command enables FTP client debugging.

Examples

# Enable and then disable FTP client debugging.

ftp> debug

Debugging on (debug=1).

ftp> debug

Debugging off (debug=0).

# When the device serves as the FTP client, enable FTP client debugging and download file a.txt from the current directory of the FTP server.

ftp> debug

Debugging on (debug=1).

ftp> get a.txt

---> PASV

227 Entering Passive Mode (192,168,3,51,7,145)

---> RETR a.txt

150 "D:\test\a.txt" file ready to send (83916 bytes) in ASCII mode

226 Transfer finished successfully.

83916 bytes received in 0.228 seconds (359.4 kbyte/s)

Table 3 Command output

Field	Description
---> PASV	FTP command.
227 Entering Passive Mode (192,168,3,51,7,145)	Received the FTP reply code 227 and entering passive mode.
---> RETR a.txt	FTP command for downloading file a.txt.

delete

Use delete to permanently delete a file on the FTP server.

Syntax

delete remotefile

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

remotefile: Specifies the name of a file on the FTP server.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

To perform this operation, you must have delete permission on the FTP server.

Examples

# Delete file b.txt.

ftp> delete b.txt

250 File deleted from remote host.

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

Predefined user roles

network-admin

mdc-admin

Parameters

remotefile: Specifies the name of a file or directory on the FTP server.

localfile: Specifies the name of the local file used for saving the displayed information.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

In FTP client view, executing the dir command is the same as executing the ls command.

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,3,51,7,40)

150 File Listing Follows in ASCII mode

drwxrwxrwx 1 noone nogroup 0 Jun 11 16:18 .

drwxrwxrwx 1 noone nogroup 0 Jun 11 16:18 ..

-rwxrwxrwx 1 noone nogroup 439291 Jan 12 14:50 a.txt

-rwxrwxrwx 1 noone nogroup 0 Oct 14 2011 bintest.txt

-rwxrwxrwx 1 noone nogroup 439291 Jan 12 14:50 diatest.txt

226 Transfer finished successfully.

# Save detailed information about file a.txt to s.txt.

ftp> dir a.txt s.txt

output to local-file: s.txt ? [Y/N]:y

227 Entering Passive Mode (192,168,3,51,7,40)

150 File Listing Follows in ASCII mode

226 Transfer finished successfully.

# Display the content of file s.txt.

ftp> bye

221 Windows FTP Server (WFTPD, by Texas Imperial Software) says goodbye

<Sysname> more s.txt

-rwxrwxrwx 1 noone nogroup 439291 Jan 12 14:50 s.txt

Related commands

disconnect

Use disconnect to terminate the connection to the FTP server without exiting FTP client view.

Syntax

disconnect

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Terminate the connection to the FTP server without exiting the FTP client view.

ftp> disconnect

221 Windows FTP Server (WFTPD, by Texas Imperial Software) says goodbye

ftp>

Related commands

display ftp client source

Use display ftp client source to display the source address settings on the FTP client.

Syntax

display ftp client source

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display the source address settings on the FTP client.

<Sysname> display ftp client source

The source IP address of the FTP client is 1.1.1.1.

The source IPv6 address of the FTP client is 2001::1.

ftp

Use ftp to log in to the FTP server and enter FTP client view.

Syntax

ftp [ server-address [ service-port ] [ vpn-instance vpn-instance-name ] [ source { interface interface-type interface-number | ip source-ip-address } ] ]

Views

User view

Parameters

server-address: Specifies the IP address or host name (a string of 1 to 20 characters) of the FTP server.

service-port: Specifies the TCP port number of the FTP server, in the range of 0 to 65535. The default value is 21.

vpn-instance vpn-instance-name: Specifies the MPLS L3VPN that the FTP server belongs to. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the FTP server is on the public network, do not specify this option.

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 of this interface is the source address for sent FTP packets. If no primary IP address is configured on the source interface, the connection cannot be established.

· ip source-ip-address: Specifies the source IP address for sent FTP packets. This source address must be an address that has been configured on the device.

Usage guidelines

This command is only applicable to IPv4 networks.

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 enter the username and password for logging in to the FTP server.

Examples

# Log in to the FTP server 192.168.0.211, and specify the source IP address of sent FTP packets as 192.168.0.212.

<Sysname>ftp 192.168.0.211 source ip 192.168.0.212

Connected to 192.168.3.51 (192.168.3.51).

220 WFTPD 2.0 service (by Texas Imperial Software) ready for new user

User (192.168.3.51:(none)): abc

331 Give me your password, please

Password:

230 Logged in successfully

Remote system type is MSDOS.

ftp>

ftp client source

Use ftp client source to specify the source IPv4 address for FTP packets sent by the FTP client.

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

No source IP address is configured for sent FTP packets. The device uses the primary IP address of the output interface of the route to the server as the source IP address.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface interface-type interface-number: Specifies the source interface for establishing FTP connections. The primary IP address of the source interface is used as the source IP address of packets sent to a FTP server. Make sure the interface is up and has the primary IP address configured. Otherwise, the transmission fails.

ip source-ip-address: Specifies the source IP address of sent FTP packets. The source address must be an IP address that has been configured on the device, and its interface must be up. Otherwise, the transmission fails.

Usages guidelines

If you execute this command multiple times, the most recent configuration takes effect.

The source address specified with the ftp command takes precedence over the one specified with the ftp client source command.

The source IP address specified with the ftp client source command applies to all FTP connections while the one specified with the ftp command applies only to the current FTP connection.

Examples

# Specify the source IP address for sent FTP packets as 192.168.20.222.

<Sysname> system-view

[Sysname] ftp client source ip 192.168.20.222

Related commands

ftp

ftp client ipv6 source

Use ftp client ipv6 source to specify the source address for FTP packets sent by the IPv6 FTP client.

Use undo ftp client ipv6 source to restore the default.

Syntax

ftp client ipv6 source { interface interface-type interface-number | ipv6 source-ipv6-address }

undo ftp client ipv6 source

Default

No source address is configured. The device automatically selects a source IPv6 address as defined in RFC 3484.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface interface-type interface-number: Specifies the source interface by its type and number. The IPv6 address configured on the source interface is the source address of sent FTP packets. Make sure the interface is up. Otherwise, the transmission fails.

ip source-ip-address: Specifies the source IPv6 address for sent FTP packets. The source address must be an IPv6 address that has been configured on the device, and its interface must be up. Otherwise, the transmission fails.

Usages guidelines

If you execute this command multiple times, the most recent configuration takes effect.

The source IPv6 address specified with the ftp ipv6 command takes precedence over the one specified with the ftp client ipv6 source command.

The source IPv6 address specified with the ftp client ipv6 source command applies to all FTP connections while the one specified with the ftp ipv6 command applies only to the current FTP connection.

Examples

# Specify source IPv6 address 2000::1 for sent FTP packets.

<Sysname> system–view

[Sysname] ftp client ipv6 source ipv6 2000::1

Related commands

ftp ipv6

Use ftp ipv6 to log in to the FTP server and enter FTP client view.

Syntax

ftp ipv6 [ server-address [ service-port ] [ vpn-instance vpn-instance-name ] [ source { ipv6 source-ipv6-address | interface interface-type interface-number } ] [ -i interface-type interface-number ] ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

server-address: Specifies the IP address or host name of the FTP server.

service-port: Specifies the 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 the source IPv6 address for sent FTP packets. This address must be an IPv6 address that has been configured on the device.

source interface interface-type interface-number: Specifies a source 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 more information about link local addresses, see Layer 3—IP Services Configuration Guide.

vpn-instance vpn-instance-name: Specifies the MPLS L3VPN to which the FTP server belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the FTP server is on the public network, do not specify this option.

-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.

Usage guidelines

This command is only applicable to IPv6 networks.

If no parameters are specified, this command enters the FTP client view.

If the FTP server parameters are specified, you are prompted to enter the username and password for logging in to the FTP server.

Examples

# Log in to the FTP server 2000::154.

<Sysname> ftp ipv6 2000::154

Connected to 2000::154 (2000::154)..

220 FTP service ready.

User (2000::154): root

331 Password required for root.

Password:

230 User logged in

Remote system type is H3C

get

Use get to download a file from the FTP server and save the file.

Syntax

get remotefile [ localfile ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

remotefile: Specifies the name of the file to be downloaded.

localfile: Specifies a name for the downloaded file.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

To save the downloaded file to the working directory accessed by the ftp command, the localfile argument must specify a file name such as a.cfg. If you do not provide the localfile argument, the downloaded file uses its original name.

To save the downloaded file to some other directory, the localfile argument must specify the target directory plus the file name such as flash:/subdirectory/a.cfg. Otherwise, the command fails to take effect.

Examples

# Download file a.txt and save it as b.txt in the working directory accessed by the ftp command.

ftp> get a.txt b.txt

227 Entering Passive Mode (192,168,3,51,6,249)

150 "D:\test\a.txt" file ready to send (1 bytes) in ASCII mode

226 Transfer finished successfully.

1 bytes received in 0.0012 seconds (835 byte/s)

Related commands

put

help

Use help to display all commands supported by an FTP client.

Use help command-name to display the help information of a specific command.

Syntax

help [ command-name ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

command-name: Specifies a command supported by the FTP client.

Usage guidelines

In FTP client view, executing the help command is the same as entering?.

Examples

# Display all commands supported by the FTP client.

ftp> help

Commands may be abbreviated. Commands are:

append delete ls quit rmdir

ascii debug mkdir reget status

binary dir newer rstatus system

bye disconnect open rhelp user

cd get passive rename verbose

cdup help put reset ?

close lcd pwd restart

# Display the help information for the dir command.

ftp> help dir

dir list contents of remote directory

Related commands

lcd

Use lcd to display the local working directory of the FTP client.

Use lcd directory to change the local working directory of the FTP client to the specified directory.

Use lcd / to change the local working directory of the FTP client to the local root directory.

Syntax

lcd [ directory | / ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

directory: Specifies a local directory of the FTP client. There must be a slash sign (/) before the name of the storage medium, for example, /flash:/logfile.

/: Specifies the root directory of the FTP client.

Examples

# Display the local working directory.

ftp> lcd

Local directory now /flash:

# Change the local working directory to flash:/logfile.

ftp> lcd /flash:/logfile

Local directory now /flash:/logfile

ls

Use ls to display detailed information about the files and subdirectories under the current directory on the FTP server.

Use ls remotefile to display detailed information about a specific file or directory on the FTP server.

Use ls remotefile localfile to save detailed information about a specific file or directory on the FTP server to a local file.

Syntax

ls [ remotefile [ localfile ] ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

remotefile: Specifies the file name or directory on the FTP server.

localfile: Specifies the local file used to save the displayed information.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

In FTP client view, executing the ls command is the same as executing the dir command.

Examples

# Display detailed information about the files and subdirectories under the current directory on the FTP server.

ftp> ls

227 Entering Passive Mode (192,168,3,51,6,116)

150 File Listing Follows in ASCII mode

drwxrwxrwx 1 noone nogroup 0 Jun 11 16:18 .

drwxrwxrwx 1 noone nogroup 0 Jun 11 16:18 ..

-rwxrwxrwx 1 noone nogroup 439291 Jan 12 14:50 a.txt

-rwxrwxrwx 1 noone nogroup 0 Oct 14 2011 bintest.txt

-rwxrwxrwx 1 noone nogroup 439291 Jan 12 14:50 diatest.txt

226 Transfer finished successfully.

# Save detailed information about file a.txt to s.txt.

ftp> ls a.txt s.txt

output to local-file: s.txt ? [Y/N]:y

227 Entering Passive Mode (192,168,3,51,6,139)

150 File Listing Follows in ASCII mode

226 Transfer finished successfully.

# Display the content of file s.txt.

ftp> bye

221 Windows FTP Server (WFTPD, by Texas Imperial Software) says goodbye

<Sysname> more s.txt

-rwxrwxrwx 1 noone nogroup 439291 Jan 12 14:50 s.txt

Related commands

dir

mkdir

Use mkdir to create a subdirectory in the current directory on the FTP server.

Syntax

mkdir directory

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

directory: Specifies the name of the directory to be created.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

You must have permissions to perform this operation on the FTP server.

Examples

# Create subdirectory newdir in the current directory of the remote FTP server.

ftp> mkdir newdir

257 "newdir" directory created

newer

Use newer to update a local file by using a remote file on the FTP server.

Syntax

newer remotefile [ localfile ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

remotefile: Specifies the name of the remote file on the FTP server.

localfile: Specifies the name of the local file to be updated.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

If the local file does not exist, this command downloads the file from the FTP server and saves it locally.

If the remote file on the FTP server is not newer than the local file, this command does not update the local file.

Examples

# Update the local file with the file a.txt on the FTP server.

ftp> newer a.txt

500 Unidentified command MDTM a.txt

open

Use open to log in to the FTP server in FTP client view.

Syntax

open server-address [ service-port ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

server-address: Specifies the IP address or host name of the FTP server.

service-port: Specifies the TCP port number of the FTP server, in the range of 0 to 65535. The default value is 21.

Usage guidelines

After you issue this command, you are prompted to enter the username and password. You must provide correct username and password before you can log in to the server.

If you have logged in to an FTP server, you cannot use the open command to log in to another server. To do so, you must first disconnect from the current server.

Examples

# In FTP client view, log in to the FTP server 192.168.3.51.

<Sysname> ftp

ftp> open 192.168.3.51

Connected to 192.168.3.51 (192.168.3.51).

220 WFTPD 2.0 service (by Texas Imperial Software) ready for new user

User (192.168.3.51:(none)): root

331 Give me your password, please

Password:

230 Logged in successfully

Remote system type is MSDOS.

ftp>

passive

Use passive to set the FTP operation mode to passive.

Syntax

passive

Default

The FTP operation mode is passive.

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

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.

You can use this command multiple times to change between active and passive modes.

This command is mainly used together with a firewall to control FTP session establishment between private network users and public network users.

Examples

# Set the FTP operation mode to passive.

ftp> passive

Passive mode on.

ftp> passive

Passive mode off.

put

Use put to upload a file on the client to the remote FTP server.

Syntax

put localfile [ remotefile ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

localfile: Specifies the name of the local file to be uploaded.

remotefile: Specifies the file name for saving the uploaded file on the FTP server.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

To upload a file in the working directory accessed by the ftp command, the localfile argument must specify a file name such as a.cfg.

To upload a file in some other directory, the localfile argument must specify the target directory plus the file name such as flash:/subdirectory/a.cfg. Otherwise, the command fails to take effect.

Examples

# Upload the file a.txt in the working directory accessed by the ftp command and save the file as b.txt on the FTP server.

ftp> put a.txt b.txt

227 Entering Passive Mode (192,168,3,51,7,100)

150 "D:\test\b.txt" file ready to receive in ASCII mode

226 Transfer finished successfully.

2749 bytes sent in 0.000284 seconds (9.23 Mbyte/s)

Related commands

get

pwd

Use pwd to display the currently accessed directory on the FTP server.

Syntax

pwd

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Display the currently accessed directory on the remote FTP server.

ftp> pwd

257 "D:\test" is current directory

quit

Use quit to terminate the connection to the FTP server and return to user view.

Syntax

quit

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Examples

# Terminate the connection to the FTP server and return to user view

ftp> quit

221 Windows FTP Server (WFTPD, by Texas Imperial Software) says goodbye

Related commands

bye

reget

Use reget to get the missing part of a file from the FTP server.

Syntax

reget remotefile [ localfile ]

Views

FTP client view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

remotefile: Specifies the name of the file on the FTP server.

localfile: Specifies the name of the local file.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

If a file download is not completed due to network problems or insufficient storage space, you can use the reget command to get the missing part of the file from the FTP server after you solve the problem.

Examples

# Get the part of the s.bin file that is missing due to transmission interruption.

ftp> reget s.bin

350 Restarting at 1749706

150-Connecting to port 47429

150 38143.3 kbytes to download

226 File successfully transferred

39058742 bytes received in 66.2 seconds (576.1 kbyte/s)

rename

Use rename to rename a file.

Syntax

rename [ oldfilename [ newfilename ] ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

oldfilename: Specifies the original file name.

newfilename: Specifies the new file name.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Rename the file a.txt as b.txt

Method 1:

ftp> rename

(from-name) a.txt

(to-name) b.txt

350 Enter the name to rename it to...

250 File renamed successfully

Method 2:

ftp> rename a.txt

(to-name) b.txt

350 Enter the name to rename it to...

250 File renamed successfully

Method 3:

ftp> rename a.txt b.txt

350 Enter the name to rename it to...

250 File renamed successfully

reset

Use reset to clear the reply information received from the FTP server in the buffer.

Syntax

reset

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Examples

# Clear the reply information received from the FTP server.

ftp> reset

restart

Use restart to specify the marker to retransmit a file.

Syntax

restart marker

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

marker: Specifies the retransmit marker.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Retransmit the file h.c (82 bytes) from 2 bytes.

ftp> restart 2

restarting at 2. execute get, put or append to initiate transfer

ftp> put h.c h.c

227 Entering Passive Mode (192,168,3,51,6,157)

150 "D:\test\h.c" file ready to receive in ASCII mode

226 Transfer finished successfully.

61 bytes sent in 0.000139 seconds (428.6 kbyte/s)

ftp> dir

227 Entering Passive Mode (192,168,3,51,6,159)

150 File Listing Follows in ASCII mode

drwxrwxrwx 1 noone nogroup 0 Jun 11 17:04 .

drwxrwxrwx 1 noone nogroup 0 Jun 11 17:04 ..

-rwxrwxrwx 1 noone nogroup 439291 Jan 12 14:50 a.txt

-rwxrwxrwx 1 noone nogroup 439291 Jun 11 16:58 b1.txt

-rwxrwxrwx 1 noone nogroup 0 Oct 14 2011 bintest.txt

-rwxrwxrwx 1 noone nogroup 439291 Jan 12 14:50 diatest.txt

drwxrwxrwx 1 noone nogroup 0 Jun 11 16:53 newdir

-rwxrwxrwx 1 noone nogroup 61 Jun 11 17:04 s2.txt

226 Transfer finished successfully.

rhelp

Use rhelp to display the FTP-related commands supported by the FTP server.

Use rhelp protocol-command to display the help information of an FTP-related command supported by the FTP server.

Syntax

rhelp [ protocol-command ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

protocol-command: Specifies an FTP-related command.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Display the FTP-related commands supported by the FTP.

ftp> rhelp

214-The following commands are recognized (* =>'s unimplemented).

USER PORT STOR MSAM* RNTO NLST MKD CDUP

PASS PASV APPE MRSQ* ABOR SITE* XMKD XCUP

ACCT TYPE MLFL* MRCP* DELE SYST RMD STOU

SMNT* STRU MAIL* ALLO* CWD STAT XRMD SIZE*

REIN MODE MSND* REST* XCWD HELP PWD MDTM*

QUIT RETR MSOM* RNFR LIST NOOP XPWD

214 Direct comments about WFTPD to [email protected].

Table 4 Command output

Field	Description
USER	Username, corresponding to the xx command in FTP client view.
PASS	Password.
NOOP	Null operation.
SYST	System parameters.
TYPE	Request type.
CWD	Changes the current working directory.
XCWD	Extended command with the meaning of CWD.
PWD	Prints the working directory.
CDUP	Changes the directory to the upper directory.
XCUP	Extended command with the meaning of CDUP.
XPWD	Extended command with the meaning of PWD.
LIST	Lists files.
NLST	Lists brief file description.
MLSD	Lists file content.
PORT	Active mode (IPv4).
EPRT	Active mode (IPv6).
PASV	Passive mode (IPv4).
EPSV	Passive mode (IPv6).
REST	Restarts.
RETR	Downloads files.
STOR	Uploads files.
APPE	Appends uploading.
DELE	Deletes files.
MKD	Creates folders.
XMKD	Extended command with the meaning of MKD.
RMD	Removes folders.
XRMD	Extended command with the meaning of RMD.
ABOR	Aborts the transmission.
SIZE	Size of the transmission file.
RNFR	Original name.
RNTO	New name.

rmdir

Use rmdir to permanently delete a directory on the FTP server.

Syntax

rmdir directory

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

directory: Specifies the name of a directory on the remote FTP server.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

To perform this operation, you must have delete permissions on the FTP server.

Delete all files and subdirectories under a directory before you delete the directory. For more information about how to delete files, see the delete command.

Executing the rmdir command also deletes the files in the recycle bin of the specified directory.

Examples

# Delete the empty directory subdir1.

ftp>rmdir subdir1

200 Directory subdir1 removed

Related commands

delete

rstatus

Use rstatus to display FTP server status.

Use rstatus remotefile to display detailed information about a specific directory or file on the FTP server.

Syntax

rstatus [ remotefile ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

remotefile: Specifies a directory or file on the FTP server.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Display FTP server status.

ftp> rstatus

211- FTP server status:

WFTPD (by Texas Imperial Software) 32-bit version 2.03 12/3/1995

Connected to 192.168.3.125

Logged in as root

TYPE: ASCII, FORM: Nonprint; STRUcture: File; transfer MODE: Stream

Server type: WFTPD by Texas Imperial Software

211 End of status

# Display file a.txt.

ftp> rstatus a.txt

211- FTP server status:

WFTPD (by Texas Imperial Software) 32-bit version 2.03 12/3/1995

Connected to 192.168.3.125

Logged in as root

TYPE: ASCII, FORM: Nonprint; STRUcture: File; transfer MODE: Stream

Server type: WFTPD by Texas Imperial Software

211 End of status

status

Use status to display FTP status.

Syntax

status

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Examples

# Display FTP status.

ftp> status

Connected to 192.168.3.51.

No proxy connection.

Not using any security mechanism.

Mode: stream; Type: ascii; Form: non-print; Structure: file

Verbose: on; Bell: off; Prompting: on; Globbing: off

Store unique: off; Receive unique: off

Case: off; CR stripping: on

Ntrans: off

Nmap: off

Hash mark printing: off; Use of PORT cmds: on

Table 5 Command output

Field	Description
Connected to 192.168.3.51.	IP address of the FTP server that is connected to the FTP client.
Verbose: on; Bell: off; Prompting: on; Globbing: off	Displays debugging information.
Store unique: off; Receive unique: off	The name of the file on the FTP server is unique and the name of the local file is unique.
Case: off; CR stripping: on	Does not support obtaining multiple files once and deletes "\r" when downloading text files.
Ntrans: off	Does not use the input-output transmission table.
Nmap: off	The file name does not use the input-to-output mapping template.
Hash mark printing: off; Use of PORT cmds: on	Does not end with a pound sign (#) and uses "PORT" data transmission.

system

Use system to display the system information of the FTP server.

Syntax

system

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You can perform this operation only after you log in to the FTP server.

Examples

# Display the system information of the FTP server.

ftp> system

215 MSDOS A N (WFTPD by Texas Imperial Software)

user

Use user to switch to another user account after login.

Syntax

user [ username [ password ] ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

username: Specifies the username of the target user account.

password: Specifies the password of the target user account.

Usage guidelines

You can perform this operation only after you log in to the FTP server.

The username and password of the target user account must have been configured. Otherwise, switch to the target user account fails and the FTP connection is closed.

Examples

# After logging in to the FTP server, use the username ftp and password 123456 to re-log in to the FTP server (the output might vary by the FTP server):

· Method 1

ftp> user ftp 123456

331 Give me your password, please

230 Logged in successfully

· Method 2

ftp> user ftp

331 Give me your password, please

Password:

230 Logged in successfully

· Method 3:

ftp> user

(username) ftp

331 Give me your password, please

Password:

230 Logged in successfully

verbose

Use verbose to enable or disable the device to display FTP operation information.

Syntax

verbose

Default

The device displays FTP operation information.

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Examples

# Disable and then enable the device to display FTP operation information.

ftp> verbose

Verbose mode off.

ftp> verbose

Verbose mode on.

# Execute the get command when FTP operation information display is disabled.

ftp> verbose

Verbose mode off.

ftp> get a.txt

# Execute the get command when FTP operation information display is enabled.

ftp> verbose

Verbose mode on.

ftp> get a.txt

227 Entering Passive Mode (192,168,3,51,6,249)

150 "D:\test\a.txt" file ready to send (1 bytes) in ASCII mode

226 Transfer finished successfully.

1 bytes received in 0.0012 seconds (835 byte/s)

?

Use ? to display all commands supported by an FTP client.

Use ? command-name to display the help information for a specific command.

Syntax

? [ command-name ]

Views

FTP client view

Predefined user roles

network-admin

mdc-admin

Parameters

command-name: Specifies a command supported by the FTP client.

Usage guidelines

In FTP client view, entering ? is the same as executing the help command.

Examples

# Display all commands supported by the FTP client.

ftp> ?

Commands may be abbreviated. Commands are:

append delete ls quit rmdir

ascii debug mkdir reget status

binary dir newer rstatus system

bye disconnect open rhelp user

cd get passive rename verbose

cdup help put reset ?

close lcd pwd restart

# Display the help information for the dir command.

ftp> ? dir

dir list contents of remote directory

Related commands

help

TFTP configuration commands

tftp

Use tftp to download a file from the TFTP server to the local device or upload a local file to the TFTP server in an IPv4 network.

Syntax

tftp server-address { get | put } source-filename [ destination-filename ] [ vpn-instance vpn-instance-name ] [ source { interface interface-type interface-number | ip source-ip-address } ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

server-address: Specifies the IP address or host name of a TFTP server, a string of 1 to 20 characters.

get: Downloads a file.

put: Uploads a file.

source-filename: Specifies the source file name, a case-insensitive string of 1 to 1 to 255 characters.

destination-filename: Specifies the destination file name, a case-insensitive string of 1 to 255 characters. If this argument is not specified, the file uses the source file name.

vpn-instance vpn-instance-name: Specifies the MPLS L3VPN where the TFTP server belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the TFTP server is on the public network, do not specify this option.

source: Configures the source IP address for sent TFTP packets. If this keyword is not specified, the device uses the primary IP address of the output interface of the route to the server as the source IP address of sent TFTP packets.

· 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 TFTP packets. Make sure the interface is up and has the primary IP address configured. Otherwise, the transmission fails.

· ip source-ip-address: Specifies the source IP address of sent TFTP packets. The source address must be an IP address that has been configured on the device, and its interface must be up.

Usages guidelines

The source address specified with the tftp command takes precedence over the one specified with the tftp client source command.

The source IP address specified with the tftp client source command applies to all TFTP connections while the one specified with the tftp command applies only to the current TFTP connection.

Examples

# Download the new.bin file from the TFTP server at 192.168.1.1 and save it as new.bin.

<Sysname> tftp 192.168.1.1 get new.bin

% Total % Received % Xferd Average Speed Time Time Time Current

Dload Upload Total Spent Left Speed

100 13.9M 100 13.9M 0 0 1206k 0 0:00:11 0:00:11 --:--:-- 1206k

Table 6 Command output

Field	Description
%	Percentage of file transmission progress.
Total	Size of files to be transmitted, in bytes.
%	Percentage of received file size to total file size.
Received	Received file size, in bytes.
%	Percentage of sent file size to total file size.
Xferd	Sent file size, in bytes.
Average Dload	Average download speed, in bps.
Speed Upload	Average upload speed, in bps.

Related commands

tftp client source

Use tftp client source to specify the source IP address for TFTP packets sent by the TFTP client.

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

No source IP address is configured for sent TFTP packets. The device uses the primary IP address of the output interface of the route to the server as the source IP address.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface interface-type interface-number: Specifies the source interface for establishing TFTP connections. The primary IP address of the source interface is used as the source IP address of packets sent to a TFTP server. Make sure the interface is up and has the primary IP address configured. Otherwise, the transmission fails.

ip source-ip-address: Specifies the source IP address of sent TFTP packets. The source address must be an IP address that has been configured on the device, and its interface must be up. Otherwise, the transmission fails.

Usages guidelines

If you execute this command multiple times, the most recent configuration takes effect.

The source address specified with the tftp command takes precedence over the one specified with the tftp client source command.

The source IP address specified with the tftp client source command applies to all TFTP connections while the one specified with the tftp command applies only to the current TFTP connection.

Examples

# Specify the source IP address of sent TFTP packets as 192.168.20.222.

<Sysname> system-view

[Sysname] tftp client source ip 192.168.20.222

Related commands

tftp

tftp ipv6

Use tftp ipv6 to download a file from a TFTP server or upload a 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 ] [ vpn-instance vpn-instance-name ] [ source { interface interface-type interface-number | ipv6 source-ipv6-address } ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

tftp-ipv6-server: Specifies the 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 link local address configuration, see Layer 3—IP Services Configuration Guide.

get: Downloads a file.

put: Uploads a file.

source-file: Specifies the source file name, a case-insensitive string of 1 to 255 characters.

destination-file: Specifies the destination file name, a case-insensitive string of 1 to 255 characters. If this argument is not specified, the file uses the source file name.

vpn-instance vpn-instance-name: Specifies the MPLS L3VPN where the TFTP server belongs to. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the TFTP server is on the public network, do not specify this option.

source: Specifies the source address of sent IPv6 TFTP packets. If this keyword is not specified, the device automatically selects a source IPv6 address. For more information, see RFC 3484.

· interface interface-type interface-number: Specifies the source interface by its type and number. The IPv6 address configured on the source interface is the source address of sent TFTP packets. Make sure the interface is up. Otherwise, the transmission fails.

· ip source-ip-address: Specifies the source IPv6 address of sent TFTP packets, The source address must be an IPv6 address that has been configured on the device, and its interface must be up.

Usages guidelines

The source IPv6 address specified with the tftp ipv6 command takes precedence over the one specified with the tftp client ipv6 source command.

The source IPv6 address specified with the tftp client ipv6 source command applies to all TFTP connections while the one specified with the tftp ipv6 command applies only to the current TFTP connection.

Examples

# Download the new.bin file from the TFTP server at 2001::1 and save it as new.bin.

<Sysname> tftp ipv6 2001::1 get new.bin new.bin

% Total % Received % Xferd Average Speed Time Time Time Current

Dload Upload Total Spent Left Speed

100 13.9M 100 13.9M 0 0 1206k 0 0:00:11 0:00:11 --:--:-- 1206k

For more information about the command output, see Table 6.

tftp client ipv6 source

Use tftp client ipv6 source to specify the source address for TFTP packets sent by the IPv6 TFTP client.

Use undo tftp client ipv6 source to restore the default.

Syntax

tftp client ipv6 source { interface interface-type interface-number | ipv6 source-ipv6-address }

undo tftp client ipv6 source

Default

No source address is configured. The device automatically selects a source IPv6 address as defined in RFC 3484.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface interface-type interface-number: Specifies the source interface by its type and number. The IPv6 address configured on the source interface is the source address of sent TFTP packets. Make sure the interface is up. Otherwise, the transmission fails.

ip source-ip-address: Specifies the source IPv6 address of sent TFTP packets. The source address must be an IPv6 address that has been configured on the device, and its interface must be up. Otherwise, the transmission fails.

Usages guidelines

If you execute this command multiple times, the most recent configuration takes effect.

The source IPv6 address specified with the tftp ipv6 command takes precedence over the one specified with the tftp client ipv6 source command.

Examples

# Specify source IPv6 address 2000::1 for sent TFTP packets.

<Sysname> system–view

[Sysname] tftp client ipv6 source ipv6 2000::1

Related commands

tftp ipv6

tftp-server acl

Use tftp-server acl to use an ACL to control the device's access to TFTP servers in an IPv4 network.

Use undo tftp-server acl to restore the default.

Syntax

tftp-server acl acl-number

undo tftp-server acl

Default

No ACL is used to control the device's access to TFTP servers.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

acl-number: Specifies the number of a basic ACL, in the range of 2000 to 2999.

Usages guidelines

You can use an ACL to deny or permit the device's access to specific TFTP servers.

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

tftp-server ipv6 acl

Use tftp-server ipv6 acl to use an ACL to control the device's access to TFTP servers in an IPv6 network.

Use undo tftp-server ipv6 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 TFTP servers.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

acl-number: Specifies the number of a basic ACL, in the range of 2000 to 2999.

Usages guidelines

You can use an ACL to deny or permit the device's access to specific TFTP servers.

Examples

# Allow the device to access only the TFTP server at 2001::1.

<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

01-Fundamentals Command Reference

FTP commands

ftp server enable

ftp timeout

append

dir

rhelp

rmdir

tftp

tftp ipv6

tftp client ipv6 source

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us