Table of Contents

1 FTP Configuration Commands· 1-1

FTP Client Configuration Commands· 1-1

ascii 1-1

binary· 1-2

bye· 1-2

cd· 1-3

cdup· 1-4

close· 1-4

debugging· 1-5

delete· 1-6

dir 1-6

disconnect 1-8

display ftp client configuration· 1-8

ftp· 1-9

ftp client source· 1-10

ftp ipv6· 1-11

get 1-12

lcd· 1-12

ls· 1-13

mkdir 1-14

open· 1-14

open ipv6· 1-15

passive· 1-16

put 1-16

pwd· 1-17

quit 1-17

remotehelp· 1-18

rmdir 1-20

user 1-20

verbose· 1-21

2 TFTP Configuration Commands· 2-1

TFTP Client Configuration Commands· 2-1

display tftp client configuration· 2-1

tftp-server acl 2-1

tftp· 2-2

tftp client source· 2-3

tftp ipv6· 2-4

 

 

FTP Client Configuration Commands

 

 

ascii

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.

binary

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.

bye

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, and quit.

Examples

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

[ftp] bye

221 Server closing.

cd

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. drive represents the storage medium name. Usually, the storage medium is flash or cf. 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.

cdup

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

close

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 Service closing control connection

[ftp]

debugging

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 successful

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

 

delete

Syntax

delete remotefile

View

FTP client view

Default Level

3: Manage level

Parameters

remotefile: File name, a string of 1 to 256 characters.

Description

Use the delete command to permanently delete a specified file on the remote FTP server.

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.

dir

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.

 

 

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 file aa.txt

[ftp] quit

<Sysname> more aa.txt

-rwxrwxrwx   1 noone    nogroup      3077 Jun 20 15:34 ar-router.cfg

disconnect

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.

display ftp client configuration

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.

 

 

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

ftp

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 asked 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 from the current device Sysname1 in 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]

ftp client source

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

<Sysname> system-view

[Sysname] ftp client source interface Vlan-interface 1

ftp ipv6

Syntax

ftp ipv6 [ server-address [ service-port ] [ source ipv6 source-ipv6-address ] [ -i interface-type interface-number ] ]

View

User view

Default Level

3: Manage level

Parameters

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

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

source ipv6 source-ipv6-address: Specifies a source IPv6 address for transmitted FTP packets. This address must be an IPv6 address that has been configured on the device.

-i interface-type interface-number: Specifies the type and number of the egress interface. This parameter can be used only in case that the FTP server address is a link local address and the specified egress interface must have a link local address (For the configuration of link local addresses, see IPv6 Basics in the Layer 3 – IP Services Configuration Guide).

Description

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

Note that:

l          This command applies to IPv6 networks.

l          If you use this command without specifying any parameters, you will simply enter the FTP client view without logging in to an FTP server.

l          If you specify the parameters, you will be asked to enter the username and password for accessing the FTP server.

Examples

# Log in to the FTP server with IPv6 address 3000::200.

<Sysname> ftp ipv6 3000::200

Trying 3000::200 ...

Press CTRL+K to abort

Connected to 3000::200.

220 Welcome!

User(3000::200:(none)): MY_NAME

331 Please specify the password.

Password:

230 Login successful.

[ftp]

get

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.

If no local file name is specified, the local file uses the name of the source file on the FTP server by default.

Examples

# Download file testcfg.cfg and save it as aa.cfg.

[ftp]get testcfg.cfg aa.cfg

 

227 Entering Passive Mode (192,168,1,50,17,163).

125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.

.....226 Transfer complete.

FTP: 5190 byte(s) received in 7.754 second(s), 669.00 byte(s)/sec.

lcd

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.

ls

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 view the information of a specified file or subdirectory, and save the result to a local file specified by the localfile argument.

 

 

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

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

mkdir

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 MKD.command sucessful 

open

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]

open ipv6

Syntax

open ipv6 server-address [ service-port ] [ -i interface-type interface-number ]

View

FTP client view

Default Level

3: Manage level

Parameters

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

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

-i interface-type interface-number: Specifies the egress interface by it type and number. This parameter can be used only in case that the FTP server address is a link local address and the specified egress interface must have a link local address (For the configuration of link local addresses, see IPv6 Basics in the Layer 3 – IP Services Configuration Guide).

Description

Use the open ipv6 command to log in to the IPv6 FTP server in 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.

Related commands: close.

Examples

# Log in to the FTP server (with IPv6 address 3000::200) in FTP client view.

<Sysname> ftp

[ftp] open ipv6 3000::200

Trying 3000::200 ...

Press CTRL+K to abort

Connected to 3000::200.

220 Welcome!

User(3000::200:(none)): MY_NAME

331 Please specify the password.

Password:

230 Login successful.

passive

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

put

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.

pwd

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.

quit

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>

remotehelp

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 parameter 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-2 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

 

rmdir

Syntax

rmdir directory

View

FTP client view

Default Level

3: Manage level

Parameters

directory: Directory name on the remote FTP server, a string of 1 to 256 characters..

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, see 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 directory temp1 from the authorized directory on the FTP server.

[ftp] rmdir /temp1

200 RMD command successful.

user

Syntax

user username [ password ]

View

FTP client view

Default Level

3: Manage level

Parameters

username: Login username.

password: Login password.

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 tothe current FTP server. (Suppose username ftp2 and password 123123123123 have been configured on the FTP server).

[ftp] user ftp2

331 Password required for ftp2.

Password:

230 User logged in.

 

[ftp]

verbose

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 protcol 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 protcol inforamtion function and perfrom 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.

 

TFTP Client Configuration Commands

display tftp client configuration

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

 

 

tftp-server acl

Syntax

tftp-server [ ipv6 ] acl acl-number

undo tftp-server [ ipv6 ] acl

View

System view

Default Level

3: Manage level

Parameters

ipv6: References an IPv6 ACL. If it is not specified, an IPv4 ACL is referenced.

acl-number: Number of a basic ACL, in the range 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, see ACL in the ACL and QoS Configuration Guide and Command Reference.

Examples

# In IPv4 networking environment, 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

# In IPv6 networking environment, allow the device to access the TFTP server with the IP address of 2001::1 only.

<Sysname> system-view

[Sysname] acl ipv6 number 2001

[Sysname-acl6-basic-2001] rule permit source 2001::1/128

[Sysname-acl6-basic-2001] quit

[Sysname] tftp-server ipv6 acl 2001

tftp

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 have 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 Ethernet 1/0.

<Sysname> tftp 192.168.0.98 put config.cfg config.bak source interface ethernet 1/0

 

  File will be transferred in binary mode

  Sending file to remote TFTP server. Please wait...

  TFTP:        345600 bytes sent in 1 second(s).

  File uploaded successfully.

tftp client source

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

<Sysname> system-view

[Sysname] tftp client source interface Vlan-interface 1

tftp ipv6

Syntax

tftp ipv6 tftp-ipv6-server [ -i interface-type interface-number ] { get | put } source-file [ destination-file ]

View

User view

Default Level

3: Manage level

Parameters

tftp-ipv6-server: IPv6 address or host name (a string of 1 to 46 characters) of a TFTP server.

-i interface-type interface-number: Specifies the egress interface by its type and number. This parameter can be used only in case that the TFTP server address is a link local address and the specified egress interface must have a link local address (For the configuration of link local address, see IPv6 Basics in the Layer 3 – IP Services Configuration Guide).

get: Downloads a file.

put: Uploads a file.

source-filename: Source filename, a string of 1 to 135 characters..

destination-filename: Destination filename, a string of 1 to 135 characters. If not specified, this filename is the same as the source filename.

Description

Use the tftp ipv6 command to download a specified file from a TFTP server or upload a specified local file to a TFTP server.

This command applies to IPv6 networks.

Examples

# Download filetoget.txt from the TFTP server.

<Sysname> tftp ipv6 fe80::250:daff:fe91:e058 -i Vlan-interface 1 get filetoget.txt

  ...

  File will be transferred in binary mode

  Downloading file from remote TFTP server, please wait....

  TFTP:      411100 bytes received in 2 second(s)

  File downloaded successfully.