目  录

1 FTP

1.1 FTP服务器配置命令

1.1.1 display ftp-server

1.1.2 display ftp-user

1.1.3 free ftp user

1.1.4 free ftp user-ip

1.1.5 free ftp user-ip ipv6

1.1.6 ftp server acl

1.1.7 ftp server dscp

1.1.8 ftp server enable

1.1.9 ftp server ipv6 dscp

1.1.10 ftp server ssl-server-policy

1.1.11 ftp timeout

1.2 FTP客户端配置命令

1.2.1 ?

1.2.2 append

1.2.3 ascii

1.2.4 binary

1.2.5 bye

1.2.6 cd

1.2.7 cdup

1.2.8 close

1.2.9 debug

1.2.10 delete

1.2.11 dir

1.2.12 disconnect

1.2.13 display ftp client source

1.2.14 ftp

1.2.15 ftp client ipv6 source

1.2.16 ftp client source

1.2.17 ftp ipv6

1.2.18 get

1.2.19 help

1.2.20 lcd

1.2.21 ls

1.2.22 mkdir

1.2.23 newer

1.2.24 open

1.2.25 passive

1.2.26 put

1.2.27 pwd

1.2.28 quit

1.2.29 reget

1.2.30 rename

1.2.31 reset

1.2.32 restart

1.2.33 rhelp

1.2.34 rmdir

1.2.35 rstatus

1.2.36 status

1.2.37 system

1.2.38 user

1.2.39 verbose

2 TFTP

2.1 TFTP配置命令

2.1.1 tftp

2.1.2 tftp client ipv6 source

2.1.3 tftp client source

2.1.4 tftp ipv6

2.1.5 tftp-server acl

2.1.6 tftp-server ipv6 acl

 

1 FTP

1.1  FTP服务器配置命令

1.1.1  display ftp-server

display ftp-server命令用来显示设备作为FTP服务器时的配置和运行情况。

【命令】

display ftp-server

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示FTP服务器的配置和运行情况。

<Sysname> display ftp-server

FTP server is running.

User count:                        1

Idle-timeout timer (in minutes):  30

表1-1 display ftp-server命令显示信息描述表

字段	描述
FTP server is running	FTP服务器功能正在运行中
User count	当前登录的用户数
Idle-timeout timer (in minutes)	FTP连接自动断开前的空闲时间，如果在该时间段内，FTP客户端和FTP服务器之间没有报文交互，该FTP连接会被断开

 

【相关命令】

·     ftp server enable

·     ftp timeout

1.1.2  display ftp-user

display ftp-user命令用来显示FTP用户的详细情况。

【命令】

display ftp-user

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示FTP用户详细情况。

<Sysname> display ftp-user

UserName     HostIP             Port     HomeDir

root         192.168.20.184     46539    flash:

当登录用户名长度超过10位时，将换行并靠左对齐显示；当登录用户的IP地址长度超过15位时，将换行并靠左对齐显示；当用户根路径长度超过37位时，将换行并靠左对齐显示。形如：

<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/123456789/

tor                                      123456789/123456789/123456789/1234567

                                         89/123456789                        

表1-2 display ftp-user命令显示信息描述表

字段	描述
UserName	当前登录的FTP用户名
HostIP	当前登录的FTP用户的IP地址
Port	当前登录的FTP用户使用的端口号
HomeDir	当前登录的FTP用户的授权路径

 

1.1.3  free ftp user

free ftp user命令用来强制释放通过用户名建立的FTP连接。

【命令】

free ftp user username

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

username：用户名。可以使用display ftp-user命令来查看当前FTP用户的信息。

【举例】

# 强制释放通过用户名ftpuser建立的FTP连接。

<Sysname> free ftp user ftpuser

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

<Sysname>

1.1.4  free ftp user-ip

free ftp user-ip命令用来强制释放通过IPv4地址建立的FTP连接。

【命令】

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ip-address：待释放的FTP连接的源IP。可以使用display ftp-user命令来查看当前FTP连接的源IP。

port port：待释放的FTP连接的源端口，port为源端口的端口号。可以使用display ftp-user命令来查看当前FTP连接的源端口。

【举例】

# 强制释放通过IP地址192.168.20.184建立的FTP连接。

<Sysname> free ftp user-ip 192.168.20.184

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

<Sysname>

1.1.5  free ftp user-ip ipv6

free ftp user-ip命令用来强制释放通过IPv6地址建立的FTP连接。

【命令】

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ipv6-address：待释放的FTP连接的源IP。可以使用display ftp-user命令来查看当前FTP连接的源IP。

port port：待释放的FTP连接的源端口，port为源端口的端口号。可以使用display ftp-user命令来查看当前FTP连接的源端口。

【举例】

# 强制释放通过IP地址2000::154建立的FTP连接。

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

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

<Sysname>

1.1.6  ftp server acl

ftp server acl命令用来使用ACL限制哪些FTP客户端可以访问设备。

undo ftp server acl命令用来恢复缺省情况。

【命令】

ftp server acl { advanced-acl-number | basic-acl-number | ipv6 { advanced-acl-number | basic-acl-number } }

undo ftp server acl [ ipv6 ]

【缺省情况】

未使用ACL限制FTP客户端。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

advanced-acl-number: 表示高级IPv4 ACL的编号,取值范围为3000～3999。

basic-acl-number: 表示基本IPv4 ACL的编号, 取值范围为2000～2999.

ipv6 advanced-acl-number: 表示高级IPv6 ACL的编号,取值范围为3000～3999。

ipv6 basic-acl-number: 表示基本IPv6 ACL的编号, 取值范围为2000～2999.

【使用指导】

通过将FTP服务与ACL关联，可以过滤掉来自某些FTP客户端的FTP请求报文，只允许符合ACL过滤规则的FTP客户端访问设备。

配置ACL限制FTP客户端时：

·     当未引用ACL时，允许所有FTP客户端访问设备；

·     当引用的ACL不存在或者为空时，禁止所有FTP客户端访问设备；

·     当引用的ACL非空时，则只有ACL中permit的用户才能访问设备，禁止其他用户访问设备，以避免非法用户访问设备；

·     如果多次使用该命令配置FTP服务与ACL关联，最新配置生效。

关于ACL的详细描述和介绍请参见“ACL和QoS配置指导”中的“ACL”。

该配置只过滤新建立的FTP连接，不会对已建立的FTP连接和操作造成影响。

【举例】

# 配置FTP服务与ACL关联，只允许FTP客户端（1.1.1.1）通过FTP访问本设备。

<Sysname> system-view

[Sysname] acl basic 2001

[Sysname-acl-ipv4-basic-2001] rule 0 permit source 1.1.1.1 0

[Sysname-acl-ipv4-basic-2001] rule 1 deny source any

[Sysname-acl-ipv4-basic-2001] quit

[Sysname] ftp server acl 2001

1.1.7  ftp server dscp

ftp server dscp命令用来配置FTP服务器发送的FTP报文的DSCP优先级。

undo ftp server dscp命令用来恢复缺省情况。

【命令】

ftp server dscp dscp-value

undo ftp server dscp

【缺省情况】

FTP服务器发送的FTP报文的DSCP优先级为0。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

dscp-value：指定设备发送的FTP报文的DSCP优先级，取值范围为0～63。

【使用指导】

DSCP携带在IP报文中的ToS字段，用来体现报文自身的优先等级，决定报文传输的优先程度。

【举例】

# 配置FTP服务器发送的FTP报文的DSCP优先级为30。

<Sysname> system-view

[Sysname] ftp server dscp 30

1.1.8  ftp server enable

ftp server enable命令用来开启设备的FTP服务器功能，允许FTP用户登录。

undo ftp server enable命令用来关闭设备的FTP服务器功能。

【命令】

ftp server enable

undo ftp server enable

【缺省情况】

FTP服务器功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 开启设备的FTP服务器功能。

<Sysname> system-view

[Sysname] ftp server enable

1.1.9  ftp server ipv6 dscp

ftp server ipv6 dscp命令用来配置FTP服务器发送的IPv6 FTP报文的DSCP优先级。

undo ftp server ipv6 dscp命令用来恢复缺省情况。

【命令】

ftp server ipv6 dscp dscp-value

undo ftp server ipv6 dscp

【缺省情况】

FTP服务器发送的IPv6 FTP报文的DSCP优先级为0。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

dscp-value：指定设备发送的IPv6 FTP报文的DSCP优先级，取值范围为0～63。

【使用指导】

DSCP携带在IPv6报文中的Trafic class字段，用来体现报文自身的优先等级，决定报文传输的优先程度。

【举例】

# 配置FTP服务器发送的IPv6 FTP报文的DSCP优先级为30。

<Sysname> system-view

[Sysname] ftp server ipv6 dscp 30

1.1.10  ftp server ssl-server-policy

ftp server ssl-server-policy命令用来配置FTP服务与SSL服务器端策略关联。

undo ftp server ssl-server-policy命令用来恢复缺省情况。

【命令】

ftp server ssl-server-policy policy-name

undo ftp server ssl-server-policy

【缺省情况】

未配置SSL服务器端策略与FTP服务关联。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

policy-name：SSL服务器端策略名，为1～31个字符的字符串。

【使用指导】

当支持FTP安全扩展协议的两台设备建立FTP连接时，通过将FTP服务与SSL服务器端策略关联，可以建立一条安全的SSL连接来传输数据，保证FTP传输的安全性。

【举例】

# 设置FTP服务使用的SSL服务器端策略为myssl。

<Sysname> system-view

[Sysname] ftp server ssl-server-policy myssl

【相关命令】

·     ftp server enable

·     ssl server-policy（安全命令参考/SSL）

1.1.11  ftp timeout

ftp timeout命令用来设置FTP连接自动断开前的空闲时间。

undo ftp timeout命令用来恢复缺省情况。

【命令】

ftp timeout minute

undo ftp timeout

【缺省情况】

FTP连接自动断开前的空闲时间为30分钟。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

minute：FTP连接自动断开前的空闲时间，取值范围为1～35791，单位为分钟。

【使用指导】

如果在设置的连接空闲时间到期时，FTP服务器和客户端一直没有信息交互，FTP服务器将认为该连接已失效并断开该连接，从而避免系统资源被持续占用、其它FTP用户的登录受影响。

【举例】

# 设置FTP连接自动断开前的空闲时间为36分钟。

<Sysname> system-view

[Sysname] ftp timeout 36

1.2  FTP客户端配置命令

 

1.2.1  ?

?命令用来显示所有FTP客户端支持命令的名字。

? command-name命令用来显示指定命令的帮助信息。

【命令】

? [ command-name ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

command-name：命令名。

【使用指导】

在FTP客户端视图下，?命令等同于help命令。

【举例】

# 显示FTP客户端支持的所有命令的名字。

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

# 查看dir命令的帮助信息

ftp> ? dir

dir              list contents of remote directory

【相关命令】

·     help

1.2.2  append

append命令用来在原文件内容的后面添加新文件的内容。

【命令】

append localfile [ remotefile ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

localfile：待添加的本地文件名称。

remotefile：被添加的FTP服务器文件名称。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

【举例】

# 将本地a.txt文件内容添加到FTP服务器上的b.txt文件内容的后面。

ftp> append a.txt b.txt

227 Entering Passive Mode (192,168,1,84,8,145)

150 Accepted data connection

226 File successfully transferred

1657 bytes sent in 0.000736 seconds (2.15 Mbyte/s)

1.2.3  ascii

ascii命令用来设置文件传输的模式为ASCII模式。

【命令】

ascii

【缺省情况】

文件传输模式为二进制模式。

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

当设备作为FTP服务器时，使用的传输模式由FTP客户端决定。当设备作为FTP客户端时，使用的传输模式用户可通过命令行修改，缺省为二进制模式。

请使用二进制模式传输非文本文件，用ASCII模式传输文本文件。

【举例】

# 设置数据传输的模式为ASCII模式。

ftp> ascii

200 TYPE is now ASCII

【相关命令】

·     binary

1.2.4  binary

binary命令用来设置文件传输的模式为二进制模式（也称为流模式）。

【命令】

binary

【缺省情况】

文件传输模式为二进制模式。

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

当设备作为FTP服务器时，使用的传输模式由FTP客户端决定。当设备作为FTP客户端时，使用的传输模式用户可通过命令行修改，缺省为二进制模式。

请使用二进制模式传输非文本文件，用ASCII模式传输文本文件。

【举例】

# 设置文件传输类型为二进制模式。

ftp> binary

200 TYPE is now 8-bit binary

【相关命令】

·     ascii

1.2.5  bye

bye命令用来断开与FTP服务器的连接，并退回到用户视图。如果设备与FTP服务器没有建立连接，则直接退回到用户视图。

【命令】

bye

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【举例】

# 终止与FTP服务器的连接，并退回到用户视图。

ftp> bye

221-Goodbye. You uploaded 2 and downloaded 2 kbytes.

221 Logout.

<Sysname>

【相关命令】

·     quit

1.2.6  cd

cd命令用来切换FTP服务器上的工作目录，即访问FTP服务器上的另一目录。

【命令】

cd { directory | .. | / }

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

directory：指定目标工作目录。如果指定的工作目录不存在，则执行cd directory后保持当前工作目录不变。

..：返回上一级目录，功能与cdup类似。如果当前工作目录已经是FTP根目录，则执行cd ..后保持当前工作目录不变。

/：返回FTP根目录。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

用户可以访问的目录只能是FTP服务器对用户授权的目录。

【举例】

# 切换工作目录到当前工作目录的logfile子目录下。

ftp> cd logfile

250 OK. Current directory is /logfile

# 切换工作目录到FTP根目录的folder子目录下。

ftp> cd /folder

250 OK. Current directory is /folder

# 切换工作目录到当前工作目录的上层目录下。

ftp> cd ..

250 OK. Current directory is /

# 切换工作目录到FTP根目录下。

ftp> cd /

250 OK. Current directory is /

【相关命令】

·     cdup

·     pwd

1.2.7  cdup

cdup命令用来退出FTP服务器的当前工作目录，并返回到FTP服务器的上一级目录。如果当前工作目录已经是FTP根目录，则执行该命令后，保持当前工作目录不变。

【命令】

cdup

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

【举例】

# 将工作目录改为上一级目录。

ftp> pwd

257 "/ftp/subdir" is your current location

ftp> cdup

250 OK. Current directory is /ftp

ftp> pwd

257 "/ftp" is your current location

【相关命令】

·     cd

·     pwd

1.2.8  close

close命令用来在不退出FTP客户端视图的前提下，断开与FTP服务器的连接。

【命令】

close

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

【举例】

# 断开与FTP服务器的连接，并保持在FTP客户端视图。

ftp> close

221-Goodbye. You uploaded 0 and downloaded 0 kbytes.

221 Logout.

ftp>

【相关命令】

·     disconnect

1.2.9  debug

debug命令用来切换FTP客户端调试信息开关状态。

【命令】

debug

【缺省情况】

FTP客户端调试信息开关处于关闭状态。

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

重复执行该命令，可以打开或者关闭FTP客户端调试信息开关。

【举例】

# 切换FTP客户端调试信息开关状态。

ftp> debug

Debugging on (debug=1).

ftp> debug

Debugging off (debug=0).

1.2.10  delete

delete命令用来彻底删除FTP服务器上的文件。

【命令】

delete remotefile

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

remotefile：FTP服务器上的文件的文件名。

【使用指导】

 

只有成功登录FTP服务器后才能执行此项操作。

用户必须具有删除的权限才能执行该操作。

【举例】

# 删除文件b.txt。

ftp> delete b.txt

250 Deleted b.txt

1.2.11  dir

dir命令用来查看FTP服务器工作目录下的所有子目录及文件的详细信息。

【命令】

dir [ remotefile [ localfile ] ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

remotefile：待查看的FTP服务器上的目录或文件名。

localfile：用于保存查询信息的本地文件的名称。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

dir remotefile命令用来查看FTP服务器上目录或文件的详细信息。

dir remotefile localfile命令用来将FTP服务器上目录或文件的详细信息保存在本地以localfile命名的文件中。

在FTP客户端视图下，dir命令等同于ls命令。

【举例】

# 显示当前FTP服务器工作目录下的所有文件夹以及文件的信息。

ftp> dir

150 Connecting to port 50201

-rwxr-xr-x    1 0          0                1481 Jul  7 15:36 a.txt

drwxr-xr-x    2 0          0                8192 Jul  2 14:33 diagfile

drwxr-xr-x    3 0          0                8192 Jul  7 15:21 ftp

drwxr-xr-x    2 0          0                8192 Jul  5 09:15 logfile

drwxr-xr-x    2 0          0                8192 Jul  2 14:33 seclog

-rwxr-xr-x    1 0          0            40808448 Jul  2 14:33 system-a1801.bin

-rwxr-xr-x    1 0          0                3050 Jul  7 12:26 startup.cfg

-rwxr-xr-x    1 0          0               54674 Jul  4 09:24 startup.mdb

-rwxr-xr-x    1 0          0                1481 Jul  7 12:34 x.cfg

226 9 matches total

# 将文件a.txt的查询结果保存在s.txt文件中。

ftp> dir a.txt s.txt

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

150 Connecting to port 50203

226-Glob: a.txt

查看s.txt文件的内容。

ftp> bye

221-Goodbye. You uploaded 0 and downloaded 2 kbytes.

221 Logout.

<Sysname> more s.txt

-rwxr-xr-x    1 0          0                1481 Jul  7 12:34 a.txt

【相关命令】

·     ls

1.2.12  disconnect

disconnect命令用来在不退出FTP客户端视图的前提下，断开与FTP服务器的连接。

【命令】

disconnect

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

【举例】

# 断开与FTP服务器的连接，保持在FTP客户端视图。

ftp> disconnect

221-Goodbye. You uploaded 0 and downloaded 0 kbytes.

221 Logout.

ftp>

【相关命令】

·     close

1.2.13  display ftp client source

display ftp client source命令用来显示设备作为FTP客户端时的源地址的配置。

【命令】

display ftp client source

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示设备作为FTP客户端时的源地址的配置。

<Sysname> display ftp client source

The source IP address of the FTP client is 1.1.1.1.

1.2.14  ftp

ftp命令用来登录FTP服务器，并进入FTP客户端视图。

【命令】

ftp [ ftp-server [ service-port ] [ dscp dscp-value | source { interface interface-type interface-number | ip source-ip-address } | -d ] * ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ftp-server：FTP服务器的主机名或IP地址。其中，主机名为1～253个字符的字符串，不区分大小写，字符串仅可包含字母、数字、“-”、“_”或“.”。

service-port：远端设备提供FTP服务的TCP端口号，取值范围为0～65535，缺省值为21。

dscp dscp-value：指定设备发送的FTP报文中携带的DSCP优先级的取值，取值范围为0～63，缺省值为0。

source { interface interface-type interface-number | ip source-ip-address }：指定建立FTP连接时使用的源地址。其中：

·     interface interface-type interface-number：表示源接口的接口类型和接口编号。发送FTP协议报文时，设备将使用该接口下配置的主IP地址作为源地址。如果源接口下没有配置主地址，则不能建立连接。

·     ip source-ip-address：表示源IP地址。发送FTP协议报文时，设备将使用该IP地址作为源地址。该地址必须是设备上已配置的IP地址，否则不能建立连接。

-d：打开FTP客户端的调试信息开关。

【使用指导】

该命令仅适用于IPv4组网环境。

如果不指定任何参数，则只进入FTP客户端视图，不登录FTP服务器。

如果指定参数，系统会提示用户输入登录FTP服务器的用户名和密码。如果用户名和密码正确，则登录成功，并进入FTP客户端视图；否则，登录失败。

【举例】

# 使用FTP方式，从当前设备Sysname登录到设备FTP Server（IP地址为192.168.0.211），并且FTP发送报文的源IP地址为192.168.0.212。

<Sysname>ftp 192.168.0.211 source ip 192.168.0.212

Press CTRL+C to abort.

Connected to 192.168.0.211 (192.168.0.211).

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

User (192.168.0.211:(none)): abc

331 Give me your password, please

Password:

230 Logged in successfully

Remote system type is MSDOS.

ftp>

# 使用FTP方式，从当前设备登录到FTP Server（IP地址为192.168.0.211），并打开FTP客户端的调试信息开关。

<Sysname> ftp 192.168.0.211 –d

Press CTRL+C to abort.

Connected to 192.168.0.211 (192.168.0.211).

220 FTP service ready.

User (192.168.0.211:(none)): abc

*Feb 10 09:02:24:139 2020 Sysname FTPC/7/EVENT: PAM initialization result: 0.

*Feb 10 09:02:24:150 2020 Sysname FTPC/7/EVENT: PAM: Sent a start-accounting request. Result: 0.

*Feb 10 09:02:24:860 2020 Sysname FTPC/7/COMMAND: USER abc

331 Password required for abc.

Password:

*Feb 10 09:02:25:575 2020 Sysname FTPC/7/COMMAND: PASS XXXX

230 User logged in.

215 UNIX Type: L8

Remote system type is UNIX.

Using binary mode to transfer files.

ftp> *Feb 10 09:02:25:640 2020 SIMWARE FTPC/7/COMMAND: SYST

ftp>

表1-3 ftp ftp-server -d命令显示信息描述表

字段	描述
Failed to create a socket. Reason: error-info.	创建Socket失败，原因是error-info
Failed to bind address ip-address. Reason: error-info.	绑定地址ip-address失败，原因是error-info
Failed to connect to server. Reason: error-info.	连接服务器失败，原因是error-info
Failed to set socket attribute. Reason: error-info.	设置Socket属性失败，原因是error-info
Wrong address family type: number.	错误的地址族类型number
Failed to obtain socket name. Reason: error-info.	获取Socket名称失败，原因是error-info
Failed to open stream on socket. Reason: error-info.	在Socket上打开流失败，原因是error-info
PAM initialization result: result-info.	PAM初始化结果为result-info
PAM: Failed to set attribute. Result: result-info.	PAM属性设置失败，返回结果为result-info
PAM: Sent a start-accounting request. Result: result-info.	向PAM发起开始计费请求，返回结果为result-info
PAM: Sent a stop-accounting request. Result: result-info.	向PAM发起结束计费请求，返回结果为result-info
PAM: Resources released.	释放PAM相关资源
command	FTP客户端向服务器发送请求的命令

 

1.2.15  ftp client ipv6 source

ftp client ipv6 source命令用来在IPv6组网环境下配置FTP客户端发送的FTP报文的源地址。

undo ftp client ipv6 source命令用来恢复缺省情况。

【命令】

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

undo ftp client ipv6 source

【缺省情况】

未配置源地址，设备自动选择IPv6 FTP报文的源IPv6地址，具体选择原则请参见RFC 3484。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface interface-type interface-number：表示源接口的类型和编号，此接口下配置的IPv6地址即为发送报文的源地址。请使用状态为up的接口作为源接口，否则，文件传输失败。

ipv6 source-ipv6-address：设置当前FTP客户端发送报文所使用的源IPv6地址。该地址必须是设备上已经配置的IPv6地址，并且地址所在接口状态为up，否则，文件传输失败。

【使用指导】

多次执行本命令，最新一次执行的命令生效。

使用该命令指定了源地址后，又在ftp ipv6命令中指定了源地址，则采用ftp ipv6命令中指定的源地址进行通信。

本命令指定的源地址对所有的FTP传输有效，ftp ipv6命令指定的源地址只对当前的FTP传输有效。

【举例】

# 配置设备发送的FTP报文的源IPv6地址为2000::1。

<Sysname> system－view

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

【相关命令】

·     ftp ipv6

1.2.16  ftp client source

ftp client source命令用来在IPv4组网环境下配置FTP客户端发送的FTP报文的源地址。

undo ftp client source命令用来恢复缺省情况。

【命令】

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

undo ftp client source

【缺省情况】

未配置源地址，使用路由出接口的主IP地址作为设备发送FTP报文的源IP地址。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface interface-type interface-number：设置FTP传输使用的源接口，包括接口类型和接口编号，此接口下配置的主IP地址即为发送报文的源地址。请使用配置了主IP地址，并且状态为up的接口作为源接口，否则，文件传输失败。

ip source-ip-address：设置当前FTP客户端发送报文所使用的源IP地址。该地址必须是设备上已经配置的IP地址，并且地址所在接口状态为up，否则，文件传输失败。

【使用指导】

多次执行本命令，最新一次执行的命令生效。

使用本命令指定了源地址后，又在ftp命令中指定了源地址，则采用ftp命令中指定的源地址进行通信。

本命令指定的源地址对所有的FTP传输有效，ftp命令指定的源地址只对当前的FTP传输有效。

【举例】

# 配置设备发送FTP报文的源IP地址为192.168.20.222。

<Sysname> system-view

[Sysname] ftp client source ip 192.168.20.222

【相关命令】

·     ftp

1.2.17  ftp ipv6

ftp ipv6命令用来登录FTP服务器，并进入FTP客户端视图。

【命令】

ftp ipv6 [ ftp-server [ service-port ] [ dscp dscp-value | source { ipv6 source-ipv6-address | interface interface-type interface-number } | -d ] * [ -i interface-type interface-number ] ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ftp-server：远端设备的IPv6地址或主机名。其中，主机名为1～253个字符的字符串，不区分大小写，字符串仅可包含字母、数字、“-”、“_”或“.”。

service-port：远端设备提供FTP服务的TCP端口号，取值范围为0～65535，缺省值为21。

dscp dscp-value：指定设备发送的IPv6 FTP报文中携带的DSCP优先级的取值，取值范围为0～63，缺省值为0。

source { ipv6 source-ipv6-address | interface interface-type interface-number }：指定建立IPv6 FTP连接时使用的源地址。其中：

·     interface interface-type interface-number：当前FTP客户端连接所使用的源接口的接口类型和接口编号。此参数主要用于FTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址。链路本地地址的介绍和配置请参见“网络互通配置指导”中的“IPv6基础”。

·     ipv6 source-ipv6-address：当前FTP客户端连接所使用的源IPv6地址。该地址必须是设备上已配置的IPv6地址。

-i interface-type interface-number：当前FTP客户端连接所使用的出接口的接口类型和接口编号。此参数主要用于FTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址。

-d：打开FTP客户端的调试信息开关。

【使用指导】

该命令仅适用于IPv6组网环境。

如果不指定任何参数，则只进入FTP客户端视图，不登录FTP服务器。

如果指定参数，系统会提示用户输入登录FTP服务器的用户名和密码。如果用户名和密码正确，则登录成功，并进入FTP客户端视图；否则，登录失败。

【举例】

# 登录到IPv6地址为2000::154的FTP服务器。

<Sysname> ftp ipv6 2000::154

Press CTRL+C to abort.

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

# 使用FTP方式，从当前设备登录FTP Server（IPv6地址为2000::154），并打开FTP客户端的调试信息开关。

<Sysname> ftp ipv6 2000::154 –d

Press CTRL+C to abort.

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

220 FTP service ready.

User (2000::154:(none)): root

*Feb 10 09:03:24:139 2020 Sysname FTPC/7/EVENT: PAM initialization result: 0.

*Feb 10 09:03:24:150 2020 Sysname FTPC/7/EVENT: PAM: Sent a start-accounting request. Result: 0.

*Feb 10 09:03:24:860 2020 Sysname FTPC/7/COMMAND: USER root

331 Password required for root.

Password:

*Feb 10 09:03:25:575 2020 Sysname FTPC/7/COMMAND: PASS XXXX

230 User logged in.

215 UNIX Type: L8

Remote system type is UNIX.

Using binary mode to transfer files.

ftp> *Feb 10 09:03:25:640 2020 SIMWARE FTPC/7/COMMAND: SYST

ftp>

表1-4 ftp ftp-server -d命令显示信息描述表

字段	描述
Failed to create a socket. Reason: error-info.	创建Socket失败，原因是error-info
Failed to bind address ip-address. Reason: error-info.	绑定地址ip-address失败，原因是error-info
Failed to connect to server. Reason: error-info.	连接服务器失败，原因是error-info
Failed to set socket attribute. Reason: error-info.	设置Socket属性失败，原因是error-info
Wrong address family type: number.	错误的地址族类型number
Failed to obtain socket name. Reason: error-info.	获取Socket名称失败，原因是error-info
Failed to open stream on socket. Reason: error-info.	在Socket上打开流失败，原因是error-info
PAM initialization result: result-info.	PAM初始化结果为result-info
PAM: Failed to set attribute. Result: result-info.	PAM属性设置失败，返回结果为result-info
PAM: Sent a start-accounting request. Result: result-info.	向PAM发起开始计费请求，返回结果为result-info
PAM: Sent a stop-accounting request. Result: result-info.	向PAM发起结束计费请求，返回结果为result-info
PAM: Resources released.	释放PAM相关资源
command	FTP客户端向服务器发送请求的命令

 

1.2.18  get

get命令用来下载FTP服务器上的文件，并将下载的文件存储在本地。

【命令】

get remotefile [ localfile ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

remotefile：需要下载的文件名称。

localfile：将文件下载到本地保存时使用的文件名称。当不使用该参数，将使用源文件名称作为本地文件名称保存。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

保存文件时：

·     如果要将文件保存到用户执行ftp命令时的当前工作目录，localfile只能是文件的名称或者不输入，形如a.cfg。

·     如果要将文件保存到用户执行ftp命令时的当前工作目录外的其它目录，则localfile必须是绝对路径形式，形如flash:/subdirectory/a.cfg，否则，命令执行失败。

【举例】

# 下载a.txt文件，并以b.txt文件名保存到用户执行ftp命令时的当前工作目录。

ftp> get a.txt b.txt

local: b.txt remote: a.txt

150 Connecting to port 47457

226 File successfully transferred

1569 bytes received in 0.00527 seconds (290.6 kbyte/s)

# 下载a.txt文件，并以b.txt文件名保存到用户执行ftp命令时的当前工作目录的子文件夹test。

ftp> get a.txt flash:/test/b.txt

local: flash:/test/b.txt remote: a.txt

150 Connecting to port 47457

226 File successfully transferred

1569 bytes received in 0.00527 seconds (290.6 kbyte/s)

【相关命令】

·     put

1.2.19  help

help命令用来显示所有FTP客户端支持的命令的名字。

help command-name命令用来显示指定命令的帮助信息。

【命令】

help [ command-name ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

command-name：命令名。

【使用指导】

在FTP客户端视图下，help命令等同于?命令。

【举例】

# 显示所有FTP客户端支持的命令的名字。

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

# 查看dir命令的帮助信息

ftp> help dir

dir              list contents of remote directory

【相关命令】

·     ?

1.2.20  lcd

lcd命令用来显示或切换FTP客户端本地的工作目录。

【命令】

lcd [ directory | / ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

directory：表示本设备上的目录。该参数用来将FTP客户端本地的工作目录切换到指定目录。请注意，存储介质名前面必须带“/”，形如“/flash:/logfile”。

/：表示本设备的根目录。该参数用来将FTP客户端本地的工作目录切换到本设备的根目录。

【使用指导】

执行lcd命令，不指定任何参数时，用来显示FTP客户端本地的工作目录。

【举例】

# 显示FTP客户端本地的当前工作目录。

ftp> lcd

Local directory now /flash:

# 将FTP客户端本地的工作目录切换到flash:/logfile。

ftp> lcd /flash:/logfile

Local directory now /flash:/logfile

1.2.21  ls

ls命令用来查看FTP服务器工作目录下的所有子目录及文件的详细信息。

【命令】

ls [ remotefile [ localfile ] ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

remotefile：待查看的FTP服务器上的目录或文件名。

localfile：用于保存查询信息的本地文件的名称。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

ls remotefile命令用来查看FTP服务器上目录或文件的详细信息。

ls remotefile localfile命令用来将FTP服务器上目录或文件的详细信息保存在本地以localfile命名的文件中。

在FTP客户端视图下，ls命令等同于dir命令。

【举例】

# 显示当前FTP服务器工作目录下的所有文件夹以及文件的信息。

ftp> ls

150 Connecting to port 50201

-rwxr-xr-x    1 0          0                1481 Jul  7 15:36 a.txt

drwxr-xr-x    2 0          0                8192 Jul  2 14:33 diagfile

drwxr-xr-x    3 0          0                8192 Jul  7 15:21 ftp

drwxr-xr-x    2 0          0                8192 Jul  5 09:15 logfile

drwxr-xr-x    2 0          0                8192 Jul  2 14:33 seclog

-rwxr-xr-x    1 0          0            40808448 Jul  2 14:33 system-a1801.bin

-rwxr-xr-x    1 0          0                3050 Jul  7 12:26 startup.cfg

-rwxr-xr-x    1 0          0               54674 Jul  4 09:24 startup.mdb

-rwxr-xr-x    1 0          0                1481 Jul  7 12:34 x.cfg

226 9 matches total

# 将文件a.txt的查询结果保存在s.txt文件中。

ftp> ls a.txt s.txt

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

150 Connecting to port 50203

226-Glob: a.txt

查看s.txt文件的内容。

ftp> bye

221-Goodbye. You uploaded 0 and downloaded 2 kbytes.

221 Logout.

<Sysname> more s.txt

-rwxr-xr-x    1 0          0                1481 Jul  7 12:34 a.txt

【相关命令】

·     dir

1.2.22  mkdir

mkdir命令用来在FTP服务器上当前工作目录下创建子目录。

【命令】

mkdir directory

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

directory：待创建的目录名称。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

用户必须具有创建的权限才能执行此项操作。

【举例】

# 在FTP服务器的当前工作目录下创建子目录newdir。

ftp> mkdir newdir

257 "newdir" : The directory was successfully created

1.2.23  newer

newer命令用来更新本地文件。

【命令】

newer remotefile [ localfile ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

remotefile：目标文件名称。

localfile：需要更新的本地文件名称。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

如果本地文件不存在，一律视为目标文件比本地新，即本地文件需要更新。

如果目标文件不比本地文件新，则不更新本地文件。

【举例】

# FTP服务器的文件a.txt比本地的要新，更新本地文件。

ftp> newer a.txt

local: a.txt remote: a.txt

150 Connecting to port 63513

226 File successfully transferred

1573 bytes received in 0.0293 seconds (52.3 kbyte/s)

1.2.24  open

open命令用来在FTP客户端视图下，登录FTP服务器。

【命令】

open server-address [ service-port ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

server-address：FTP服务器的IP地址（IPv4或IPv6地址）或主机名。

service-port：远端设备提供FTP服务的TCP端口号，取值范围为0～65535，缺省值为21。

【使用指导】

登录时，系统会提示用户输入登录用户名和密码。如果用户名和密码正确，则登录成功；否则，登录失败。

如果已经登录到FTP服务器，则不能直接使用open命令连接到其他FTP服务器，需要中断与FTP服务器的连接后再重新连接。

【举例】

# 在FTP客户端视图下，登录FTP服务器（IP地址为192.168.40.7）。

<Sysname> ftp

ftp> open 192.168.40.7

Press CTRL+C to abort.

Connected to 192.168.40.7 (192.168.40.7).

220 FTP service ready.

User (192.168.40.7:(none)): root

331 Password required for root.

Password:

230 User logged in.

Remote system type is H3C.

ftp>

1.2.25  passive

passive命令用来切换FTP数据传输的主被动方式。

【命令】

passive

【缺省情况】

数据传输的方式为被动方式。

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

数据传输的方式分为主动方式和被动方式：

·     主动方式是指在建立数据连接时由FTP服务器主动发起连接请求。

·     被动方式是指在建立数据连接时由FTP客户端主动发起连接请求。

重复执行该命令，可以将FTP数据传输方式设置为主动方式或者被动方式。

该命令主要与防火墙功能配合使用，用来限制私网用户和公网用户之间建立FTP会话。

【举例】

# 切换数据传输的主被动方式。

ftp> passive

Passive mode on.

ftp> passive

Passive mode off.

1.2.26  put

put命令用来将FTP客户端本地的文件上传到FTP服务器。

【命令】

put localfile [ remotefile ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

localfile：待上传的本地文件名称。

remotefile：文件上传完成后，在FTP服务器上保存时使用的文件名称。如果用户没有指定FTP服务器上的文件名，则系统缺省认为此文件名与本地文件名相同。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

保存文件时：

·     如果要将用户执行ftp命令时的当前工作目录下的某文件上传，localfile只能是文件的名称，形如a.cfg。

·     如果要将用户执行ftp命令时的当前工作目录外的其它文件上传，则localfile必须是绝对路径形式，形如flash:/subdirectory/a.cfg，否则，命令执行失败。

【举例】

# 上传用户执行ftp命令时的当前工作目录下的a.txt文件，并以b.txt文件名保存。

ftp> put a.txt b.txt

local: a.txt remote: b.txt

150 Connecting to port 47461

226 File successfully transferred

1569 bytes sent in 0.000671 seconds (2.23 Mbyte/s)

# 上传用户执行ftp命令时的当前工作目录下子文件夹test下的a.txt文件，并以b.txt文件名保存。

ftp> put flash:/test/a.txt b.txt

local: flash:/test/a.txt remote: b.txt

150 Connecting to port 47461

226 File successfully transferred

1569 bytes sent in 0.000671 seconds (2.23 Mbyte/s)

【相关命令】

·     get

1.2.27  pwd

pwd命令用来显示当前用户正在访问的FTP服务器上的目录。

【命令】

pwd

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

【举例】

# 显示当前用户正在访问的FTP服务器上的目录。

ftp> cd subdir

250 OK. Current directory is /subdir

ftp> pwd

257 "/subdir" is your current location

1.2.28  quit

quit命令用来断开与FTP服务器的连接，并退回到用户视图。

【命令】

quit

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【举例】

# 终止与FTP服务器的连接，并退回到用户视图。

ftp> quit

221-Goodbye. You uploaded 0 and downloaded 0 kbytes.

221 Logout.

<Sysname>

【相关命令】

·     bye

1.2.29  reget

reget命令用来实现断点续传。

【命令】

reget remotefile [ localfile ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

network-operator

【参数】

remotefile：目标文件名称。

localfile：内容保存不完整的本地文件名称。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

网络故障或者存储空间不足，可能导致正在进行的下载操作终止，下载的文件内容不完整。当网络故障排除或者存储空间恢复后，可执行reget命令继续下载文件剩余的内容。

【举例】

# 获取因传输中断而不完整的本地文件s.bin的剩余内容。

ftp> reget s.bin

local: s.bin remote: 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)

1.2.30  rename

rename命令用来重命名文件。

【命令】

rename [ oldfilename [ newlfilename ] ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

oldfilename：原文件名。

newfilename：新文件名。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

【举例】

# 将文件a.txt改名为b.txt。

方法一：

ftp> rename

(from-name) a.txt

(to-name) b.txt

350 RNFR accepted - file exists, ready for destination

250 File successfully renamed or moved

方法二：

ftp> rename a.txt

(to-name) b.txt

350 RNFR accepted - file exists, ready for destination

250 File successfully renamed or moved

方法三：

ftp> rename a.txt b.txt

350 RNFR accepted - file exists, ready for destination

250 File successfully renamed or moved

1.2.31  reset

reset命令用来清除缓存中FTP服务器端发送回来的命令应答。

【命令】

reset

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【举例】

# 清除缓存中FTP服务器端发送回来的命令应答。

ftp> reset

1.2.32  restart

restart命令用来指定重传点。

【命令】

restart marker

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

marker：重传点，从文件首部开始的偏移量，单位为字节。

【使用指导】

在FTP文件传输过程中，如果发生了中断，执行该命令，则设备将从重传点开始重新传输文件。

只有成功登录FTP服务器后才能执行此项操作。

不同FTP服务器对本命令的支持情况可能不同，请以FTP服务器的实际情况为准。

【举例】

# 设置重传点的偏移量为2字节，将本地文件h.c（大小82字节）上传。

ftp> restart 2

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

ftp> put h.c h.c

local: h.c remote: h.c

350 Restart position accepted (2).

150 Ok to send data.

226 File receive OK.

80 bytes sent in 0.000445 seconds (175.6 kbyte/s)

ftp> dir

150 Here comes the directory listing.

-rw-r--r--    1 0        0              82 Jul 18 02:58 h.c

1.2.33  rhelp

rhelp命令用来显示FTP服务器支持的FTP相关协议命令字。

rhelp protocol-command命令用来显示FTP服务器支持的FTP相关协议命令字的帮助信息。

【命令】

rhelp [ protocol-command ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

protocol-command：FTP协议命令字。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

【举例】

# 查看FTP服务器支持的FTP相关协议命令字。

ftp> rhelp

214-The following FTP commands are recognized

 USER PASS NOOP QUIT SYST TYPE

 HELP CWD  XCWD PWD  CDUP XCUP

 XPWD LIST NLST MLSD PORT EPRT

 PASV EPSV REST RETR STOR APPE

 DELE MKD  XMKD RMD  XRMD ABOR

 SIZE RNFR RNTO

214 UNIX Type: L8

表1-5 rhelp命令显示信息描述表

字段	描述
214-The following FTP commands are recognized	以下是可用的FTP命令字列表
USER	用户名
PASS	用户口令
NOOP	空操作，表示当服务器收到无效命令时，不做任何操作
QUIT	退出
SYST	显示系统参数
TYPE	请求类型
HELP	帮助
CWD	改变当前工作目录
XCWD	扩展命令，含义同CWD
PWD	打印工作路径
CDUP	改变目录到父级目录
XCUP	扩展命令，含义同CDUP
XPWD	扩展命令，含义同PWD
LIST	列出文件
NLST	列出文件简单描述
MLSD	列出文件内容
PORT	主动模式（IPv4）
EPRT	主动模式（IPv6）
PASV	被动模式（IPv4）
EPSV	被动模式（IPv6）
REST	重启动
RETR	下载文件
STOR	上传文件
APPE	追加上传
DELE	删除文件
MKD	创建文件夹
XMKD	扩展命令，含义同MKD
RMD	删除文件夹
XRMD	扩展命令，含义同RMD
ABOR	中断传输
SIZE	获取文件的传输大小
RNFR	需要重命名的文件的原名称
RNTO	需要重命名的文件的新名称

 

1.2.34  rmdir

rmdir命令用来彻底删除FTP服务器上的目录。

【命令】

rmdir directory

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

directory：FTP服务器上的目录名。

【使用指导】

 

只有成功登录FTP服务器后才能执行此项操作。

用户必须具有删除的权限才能执行此项操作。

被删除的目录必须为空目录（即删除目录前，必须先删除该目录下的所有文件及子目录，文件的删除请参见delete命令）。

成功执行rmdir命令后，FTP服务器的回收站中原来属于该文件夹的文件不会被删除。

【举例】

# 删除空目录subdir1。

ftp>rmdir subdir1

250 The directory was successfully removed

【相关命令】

·     delete

1.2.35  rstatus

rstatus命令用来显示FTP服务器的状态。

rstatus remotefile命令用来显示FTP服务器上目录或文件的详细信息。

【命令】

rstatus [ remotefile ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

remotefile：待查询的FTP服务器上的目录或文件名。

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

不同FTP服务器对本命令的支持情况可能不同，请以FTP服务器的实际情况为准。

【举例】

# 显示FTP服务器状态。

ftp> rstatus

211-FTP server status:

     Connected to 192.168.20.177

     Logged in as root

     TYPE: ASCII

     No session bandwidth limit

     Session timeout in seconds is 300

     Control connection is plain text

     Data connections will be plain text

     At session startup, client count was 1

     vsFTPd 2.0.6 - secure, fast, stable

211 End of status

表1-6 rstatus命令显示信息描述表

字段	描述
211-FTP server status:	211：FTP命令字；整个字段表示FTP服务器状态信息开始
Connected to 192.168.20.177	连接的FTP客户端IP地址：192.168.20.177
Logged in as root	登入的用户名：root
TYPE: ASCII	文件传输模式：ASCII
No session bandwidth limit	无带宽限制
Session timeout in seconds is 300	超时时间：300，单位为秒
Control connection is plain text	控制连接类型：纯文本
Data connections will be plain text	数据连接类型：纯文本
At session startup, client count was 1	FTP客户端连接数：1
vsFTPd 2.0.6 - secure, fast, stable	FTP版本号：2.0.6；可靠，快速，稳定
211 End of status	FTP服务器状态信息结束

 

# 查看文件a.txt。

ftp> rstatus a.txt

213-Status follows:

-rw-r--r--    1 0        0              80 Jul 18 02:58 a.txt

213 End of status

表1-7 rstatus命令显示文件信息描述表

字段	描述
213-Status follows:	213：FTP命令字；整个字段表示文件信息开始
-rw-r--r--	第一位表示文件类型： ·     -：普通文件 ·     b：块设备文件 ·     c：字符设备文件 ·     d：目录 ·     l：符号连接文件 ·     p：命名管道文件 ·     s：socket文件 第二位到第十位分为3组，每组3个字符，分别表示所有者、组和其他用户的访问权限： ·     -：没有对应权限 ·     r：有读权限 ·     w：有写权限 ·     x：有执行权限
1	表示文件的连接数
0	文件所有者的名字
0	文件所有者的组名
80	文件大小，单位为字节
Jul 18 02:58	文件最近一次修改的日期和时间
a.txt	文件名
213 End of status	文件信息结束

 

1.2.36  status

status命令用来显示当前FTP状态。

【命令】

status

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【举例】

# 显示当前FTP状态。

ftp> status

Connected to 192.168.1.56.

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

表1-8 status命令显示信息描述表

字段	描述
Connected to 192.168.1.56.	连接到的FTP服务器IP地址
No proxy connection.	不使用代理连接
Not using any security mechanism.	不使用安全机制
Mode: stream; Type: ascii; Form: non-print; Structure: file	文件传输模式：数据流；类型：ASCII；格式：非打印；组织结构：文件
Verbose: on; Bell: off; Prompting: on; Globbing: off	显示调试信息；操作完成后无蜂鸣提示；多文件操作时不需要每个文件进行确认；不能自动匹配文件名
Store unique: off; Receive unique: off	FTP服务器文件名唯一；本地接收文件名唯一
Case: off; CR stripping: on	不支持一次获取多个文件；文本环境下下载文件时，将“\r”删除
Ntrans: off	不使用输入输出传输表
Nmap: off	文件名不使用输入输出映射模板
Hash mark printing: off; Use of PORT cmds: on	不以“#”号结尾；使用“PORT”命令字作为数据传输连接

 

1.2.37  system

system命令用来显示FTP服务器的系统信息。

【命令】

system

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

只有成功登录FTP服务器后才能执行此项操作。

【举例】

# 显示FTP服务器的系统信息。

ftp> system

215 UNIX Type: L8

1.2.38  user

user命令用来在现有FTP连接上重新发起FTP认证。认证成功后，能访问当前的FTP服务器。

【命令】

user username [ password ]

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【参数】

username：登录用户名。

password：登录密码。

【使用指导】

该命令通常用于：

·     用户登录FTP服务器失败，在FTP连接超时前，使用该命令重新登录当前访问的FTP服务器；

·     用户已成功登录FTP服务器，使用该命令以其他用户身份重新登录当前访问的FTP服务器。

在使用该命令前，必须事先在FTP服务器上设置相应的用户名和密码，否则将导致登录失败，FTP连接关闭。

【举例】

# 用户已经登录FTP服务器，现以新身份（用户名ftp，密码123456）重新登录当前FTP服务器。

方法一：

ftp> user ftp 123456

331 Password required for ftp.

230 User logged in.

方法二：

ftp> user ftp

331 Password required for ftp.

Password:

230 User logged in.

1.2.39  verbose

verbose命令用来允许或者禁止显示FTP操作过程中的详细信息。

【命令】

verbose

【缺省情况】

允许显示FTP操作过程中的详细信息。

【视图】

FTP客户端视图

【缺省用户角色】

network-admin

【使用指导】

本配置只对当前会话生效。当用户重新登录后，本命令将恢复到缺省情况。

【举例】

# 禁止显示FTP操作过程中的详细信息时，执行get操作。

ftp> verbose

Verbose mode off.

ftp> get a.cfg 1.cfg

# 允许显示FTP操作过程中的详细信息时，执行get操作。

ftp> verbose

Verbose mode on.

ftp> get a.cfg 2.cfg

227 Entering Passive Mode (192,168,1,58,68,14)

150-Accepted data connection

150 The computer is your friend. Trust the computer

226 File successfully transferred

3796 bytes received in 0.00762 seconds (486.5 kbyte/s)

 

2 TFTP

2.1  TFTP配置命令

2.1.1  tftp

tftp命令用来在IPv4组网环境下执行下列操作：

·     下载文件：将TFTP服务器上的源文件下载到本地。

·     上传文件：将本地的源文件上传到TFTP服务器。

【命令】

tftp tftp-server { get | put | sget } source-filename [ destination-filename ] [ dscp dscp-value | source { interface interface-type interface-number | ip source-ip-address } ] * [ -d ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

tftp-server：TFTP服务器的IP地址或主机名。其中，主机名为1～253个字符的字符串，不区分大小写，字符串仅可包含字母、数字、“-”、“_”或“.”。

get：执行下载文件操作。执行该操作时，设备直接将文件保存到存储介质中。如果下载前存储介质中已有同名文件，则先删除存储介质中的已有文件，再下载。如果下载失败，将导致已有文件被删除，不可恢复，因此，不安全。

put：执行上传文件操作。

sget：执行安全下载文件操作。执行该操作时，设备会先将文件保存到内存，保存成功后，再拷贝到存储介质中，并删除内存中的文件。比get方式更加安全。

source-filename：源文件名，为1～255个字符的字符串，不区分大小写。

destination-filename：目标文件名，为1～255个字符的字符串，不区分大小写。如果不指定该参数，则使用源文件名作为目标文件名。

dscp dscp-value：指定设备发送的TFTP报文中携带的DSCP优先级的取值，取值范围为0～63，缺省值为0。

source：发送的TFTP报文的源IP地址。不指定该参数时，则使用路由出接口的主IP地址作为发送的TFTP报文的源IP地址。

interface interface-type interface-number：表示源接口的类型和编号，此接口下配置的主IP地址将作为设备发送的TFTP报文的源IP地址。请使用配置了主IP地址，并且状态为up的接口作为源接口，否则，文件传输失败。

ip source-ip-address：源IP地址，该地址将作为设备发送的TFTP报文的源IP地址。该地址必须是设备上已经配置的IP地址，并且地址所在接口状态为up，否则，文件传输失败。

-d：打开TFTP客户端调试信息开关，缺省为关闭状态。

【使用指导】

使用tftp client source命令指定了源地址后，又在tftp命令中指定了源地址，则采用tftp命令中指定的源地址进行通信。

tftp client source命令指定的源地址对所有的TFTP传输有效，tftp命令指定的源地址只对当前的TFTP传输有效。

【举例】

# 将TFTP服务器上的new.bin文件下载到本地存储设备。TFTP服务器的IP地址为192.168.1.1，下载到本地后以文件名new.bin保存。

<Sysname> tftp 192.168.1.1 get new.bin

Press CTRL+C to abort.

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

                                 Dload  Upload   Total   Spent    Left  Speed

100   183  100   183    0     0    640      0 --:--:-- --:--:-- --:--:--  1830

100   183  100   183    0     0    629      0 --:--:-- --:--:-- --:--:--   629

表2-1 tftp命令显示信息描述表

字段	描述
%	文件传输的进度百分比
Total	要传输的文件大小，单位为字节
%	下载时已接收文件大小与文件总大小的百分比
Received	下载时已接收的文件大小，单位为字节
%	上传时已发送文件大小与文件总大小的百分比
Xferd	上传时已发送的文件大小，单位为字节
Average Dload	平均下载速度，单位为字节/秒
Speed Upload	平均上传速度，单位为字节/秒
Time Total	文件传输时已花费时间和剩余时间的总和，单位为秒
Time Spent	文件传输时已花费时间，单位为秒
Time Left	完成文件传输，还需要的时间，单位为秒
Current Speed	文件传输时的当前速度，单位为字节/秒

 

表2-2 tftp客户端调试信息描述表

字段	描述
TFTP_STATE_START	TFTP服务启动
File not found	没有找到目标文件
DO phase is complete	操作已经完成
Connection time-out	连接超时
TFTP response timeout	响应超时
Data size exceeds single call write limit	数据长度超过回写限制
INTERNAL CONFUSION	内部传输数据混乱
Internal error clearing splay node	清除节点上的数据时发生内部错误
Could not open socket pair.	不能打开套接字对
Could not fork	不能创建进程
Received too short packet	收到数据太短
Internal error Unexpected packet	内部错误，不是期望的数据包
STATE: INIT =>	状态：初始化
Trying ip-address	尝试连接ip-address
STATE: CONNECT =>	状态：连接
Connected to ip-address () port port-id	连接到ip-address，端口号是port-id
bind() failed;	绑定失败
STATE: WAITCONNECT =>	状态：等待连接
STATE: SENDPROTOCONNECT =>	状态：开始协议连接
Added connection	增加连接
set timeouts for state 0:	为状态0设置超时时间
STATE: DO =>	状态：开始操作
got option=(parameter) value=(value)	接收到到数据包包含选项parameter，取值为value
requested (size)	请求包的长度为size字节
blksize parsed from OACK (size)	OACK响应包的长度为size字节
Server requested blksize larger than allocated	服务请求数据长度超限
Connected for receive	接收文件连接
Connected for transmit	传输文件连接
TFTP_STATE_RX	TFTP服务状态为接收数据
TFTP_STATE_TX	TFTP服务状态为传输数据
Internal state machine error	内部状态错误
Receive last DATA packet block %d again	再一次收到最后一个数据包
Received unexpected DATA packet block %d,expecting block %d	接收到错误的数据包（长度为%d），正确的数据长度为%d，单位为字节
Timeout waiting for block %d ACK. Retries =	ACK请求超时，重新请求
Received ACK for block %d, expecting	接收到正确的ACK响应
tftp_tx:giving up waiting for block %d ack	TFTP传输：放弃等待ACK响应
tftp_rx: internal error	TFTP接收数据：内部错误
tftp_tx: internal error，event:event-info	TFTP传输数据：内部错误，事件：event-info
STATE: DOING =>	状态：操作中
STATE: DO_DONE =>	状态：操作完成
multi_done	多处理完成
TFTP finished	TFTP完成
Closing connection 0	关闭连接0
The cache now contains 0 members	当前缓冲区为空
TFTP: Illegal operation	非法操作
Expire cleared	TFTP服务结束

 

【相关命令】

·     tftp client source

2.1.2  tftp client ipv6 source

tftp client ipv6 source命令用来在IPv6组网环境下配置TFTP客户端发送的TFTP报文的源地址。

undo tftp client ipv6 source命令用来恢复缺省情况。

【命令】

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

undo tftp client ipv6 source

【缺省情况】

未配置源地址，设备自动选择IPv6 TFTP报文的源IPv6地址，具体选择原则请参见RFC 3484。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface interface-type interface-number：表示源接口的类型和编号，此接口下配置的IPv6地址即为发送报文的源地址。请使用状态为up的接口作为源接口，否则，文件传输失败。

ipv6 source-ipv6-address：设置当前TFTP客户端发送报文所使用的源IPv6地址。该地址必须是设备上已经配置的IPv6地址，并且地址所在接口状态为up，否则，文件传输失败。

【使用指导】

多次执行本命令，最新一次执行的命令生效。

使用该命令指定了源地址后，又在tftp ipv6命令中指定了源地址，则采用tftp ipv6命令中指定的源地址进行通信。

本命令指定的源地址对所有的TFTP传输有效，tftp ipv6命令指定的源地址只对当前的TFTP传输有效。

【举例】

# 配置设备发送的TFTP报文的源IPv6地址为2000::1。

<Sysname> system－view

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

【相关命令】

·     tftp ipv6

2.1.3  tftp client source

tftp client source命令用来在IPv4组网环境下配置TFTP客户端发送的TFTP报文的源地址。

undo tftp client source命令用来恢复缺省情况。

【命令】

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

undo tftp client source

【缺省情况】

未配置源地址，使用路由出接口的主IP地址作为设备发送TFTP报文的源IP地址。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface interface-type interface-number：设置TFTP传输使用的源接口，包括接口类型和接口编号，此接口下配置的主IP地址即为发送报文的源地址。请使用配置了主IP地址，并且状态为up的接口作为源接口，否则，文件传输失败。

ip source-ip-address：设置当前TFTP客户端发送报文所使用的源IP地址。该地址必须是设备上已经配置的IP地址，并且地址所在接口状态为up，否则，文件传输失败。

【使用指导】

多次执行本命令，最新一次执行的命令生效。

使用本命令指定了源地址后，又在tftp命令中指定了源地址，则采用tftp命令中指定的源地址进行通信。

本命令指定的源地址对所有的TFTP传输有效，tftp命令指定的源地址只对当前的TFTP传输有效。

【举例】

# 配置设备发送TFTP报文的源IP地址为192.168.20.222。

<Sysname> system-view

[Sysname] tftp client source ip 192.168.20.222

【相关命令】

·     tftp

2.1.4  tftp ipv6

tftp ipv6命令用来在IPv6组网环境下执行下列操作：

·     下载文件：将TFTP服务器上的源文件下载到本地。

·     上传文件：将本地的源文件上传到TFTP服务器。

【命令】

tftp ipv6 tftp-server [ -i interface-type interface-number ] { get | put | sget } source-filename [ destination-filename ] [ dscp dscp-value | source { interface interface-type interface-number | ipv6 source-ipv6-address } ] * [ -d ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

tftp-server：TFTP服务器的IPv6地址或主机名。其中，主机名为1～253个字符的字符串，不区分大小写，字符串仅可包含字母、数字、“-”、“_”或“.”。

-i interface-type interface-number：表示出接口的接口类型和接口编号。如果TFTP服务器的地址是链路本地地址的情况，则必须指定出接口且出接口必须具有链路本地地址（链路本地地址的介绍和配置请参见“三层技术-IP业务配置指导”中的“IPv6基础”）。

get：执行下载文件操作。执行该操作时，设备直接将文件保存到存储介质中。如果下载前存储介质中已有同名文件，则先删除存储介质中的已有文件，再下载。如果下载失败，将导致已有文件被删除，不可恢复，因此，不安全。

put：执行上传文件操作。

sget：执行安全下载文件操作。执行该操作时，设备会先将文件保存到内存，保存成功后，再拷贝到存储介质中，并删除内存中的文件。比get方式更加安全。

source-filename：源文件的名称，为1～255个字符的字符串，不区分大小写。

destination-filename：目的文件的名称，为1～255个字符的字符串，不区分大小写。如果不指定该参数，则目的文件的名称与源文件的名称相同。

dscp dscp-value：指定设备发送的IPv6 TFTP报文中携带的DSCP优先级的取值，取值范围为0～63，缺省值为0。

source { interface interface-type interface-number | ipv6 source-ipv6-address }：发送的IPv6 TFTP报文的源地址。不指定该参数时，设备自动选择报文的源IPv6地址，具体选择原则请参见RFC 3484。其中：

·     interface interface-type interface-number：表示源接口的类型和编号，此接口下配置的IPv6地址将作为设备发送的TFTP报文的源IPv6地址。请使用状态为up、且已配置了IPv6地址的接口作为源接口，否则，文件传输失败。

·     ipv6 source-ipv6-address：源IPv6地址，该地址将作为设备发送的TFTP报文的源IPv6地址。该地址必须是设备上已经配置的IPv6地址，并且地址所在接口状态为up，否则，文件传输失败。

-d：打开TFTP客户端调试信息开关，缺省为关闭状态。

【使用指导】

使用tftp client ipv6 source命令指定了源地址后，又在tftp ipv6命令中指定了源地址，则采用tftp ipv6命令中的源地址进行通信。

tftp client ipv6 source命令指定的源地址对所有的TFTP传输有效，tftp ipv6命令指定的源地址只对当前的TFTP传输有效。

【举例】

# 将TFTP服务器上的new.bin文件下载到本地存储设备。TFTP服务器的IPv6地址为2001::1，下载到本地之后以文件名new.bin保存。

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

Press CTRL+C to abort.

   % 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

Writing file...Done.

本命令显示信息的详细描述请参见表2-1和表1-2。

2.1.5  tftp-server acl

tftp-server acl命令用来在IPv4组网环境下使用ACL限制设备可访问哪些TFTP服务器。

undo tftp-server acl命令用来恢复缺省情况。

【命令】

tftp-server acl acl-number

undo tftp-server acl

【缺省情况】

未使用ACL对设备可访问的TFTP服务器进行限制。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

acl-number：基本访问控制列表的编号，取值范围为2000～2999。

【使用指导】

用户利用ACL中配置的规则可以允许或禁止设备对网络中特定TFTP服务器的访问。

【举例】

# 仅允许设备访问IP地址为1.1.1.1的TFTP服务器。

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 1.1.1.1 0

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] tftp-server acl 2000

2.1.6  tftp-server ipv6 acl

tftp-server ipv6 acl命令用来在IPv6组网环境下使用ACL限制设备可访问哪些TFTP服务器。

undo tftp-server ipv6 acl命令用来恢复缺省情况。

【命令】

tftp-server ipv6 acl ipv6-acl-number

undo tftp-server ipv6 acl

【缺省情况】

未使用ACL对设备可访问的IPv6 TFTP服务器进行限制。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ipv6-acl-number：基本访问控制列表的编号，取值范围为2000～2999。

【使用指导】

用户利用ACL中配置的规则可以允许或禁止设备对网络中特定TFTP服务器的访问。

【举例】

# 仅允许设备访问IP地址为2001::1的TFTP服务器。

<Sysname> System-view

[Sysname] acl ipv6 basic 2001

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

[Sysname-acl-ipv6-basic-2001] quit

[Sysname] tftp-server ipv6 acl 2001