目  录

1 FTP与SFTP

1.1 FTP服务器配置命令

1.1.1 display ftp-server

1.1.2 display ftp-user

1.1.3 ftp disconnect

1.1.4 ftp server enable

1.1.5 ftp timeout

1.2 FTP客户端配置命令

1.2.1 ascii

1.2.2 binary

1.2.3 bye

1.2.4 cd

1.2.5 cdup

1.2.6 close

1.2.7 delete

1.2.8 dir

1.2.9 disconnect

1.2.10 ftp

1.2.11 get

1.2.12 lcd

1.2.13 ls

1.2.14 mkdir

1.2.15 open

1.2.16 passive

1.2.17 put

1.2.18 pwd

1.2.19 quit

1.2.20 remotehelp

1.2.21 rename

1.2.22 rmdir

1.2.23 user

1.2.24 verbose

1.3 SFTP 服务器配置命令

1.3.1 sftp server enable

1.3.2 sftp timeout

1.4 SFTP 客户端配置命令

1.4.1 bye

1.4.2 cd

1.4.3 cdup

1.4.4 delete

1.4.5 dir

1.4.6 exit

1.4.7 get

1.4.8 help

1.4.9 ls

1.4.10 mkdir

1.4.11 put

1.4.12 pwd

1.4.13 quit

1.4.14 remove

1.4.15 rename

1.4.16 rmdir

1.4.17 sftp

2 TFTP

2.1 TFTP配置命令

2.1.1 tftp { ascii | binary }

2.1.2 tftp get

2.1.3 tftp put

2.1.4 tftp-server acl

 

1 FTP与SFTP

1.1  FTP服务器配置命令

1.1.1  display ftp-server

【命令】

display ftp-server

【视图】

任意视图

【参数】

无

【描述】

display ftp-server命令用来显示当前FTP服务器的各项参数，包括启动状态和用户数量等信息。

进行FTP参数设置后，可通过此命令查看配置效果。

相关命令可参考ftp server enable，ftp timeout。

【举例】

# 显示FTP服务器参数设置结果。

<Sysname> display ftp-server

   FTP server is running

   Max user number       1

   User count            0

   Timeout value(in minute)       30

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

字段	描述
FTP server is running	FTP服务器已经启动。如果FTP服务器处于关闭状态，则显示“% FTP server has been stopped”，且不会显示以下的三行内容
Max user number	支持同时登录的最大用户数
User count	当前登录的用户数
Timeout value (in minute)	FTP用户的连接空闲时间

 

 

1.1.2  display ftp-user

【命令】

display ftp-user

【视图】

任意视图

【参数】

无

【描述】

display ftp-user命令用来显示当前已登录到本交换机上的FTP用户信息，包括用户名、主机IP、端口、空闲时间和授权目录。

 

【举例】

# 显示当前登录的FTP用户信息。

<Sysname> display ftp-user

  UserName             HostIP    Port    Idle              HomeDir

admin           192.168.0.152    1029       0               flash:

# 当登录用户名长度超过10位时，将换行并靠左对齐显示。例如登录用户名为administrator，显示情况为：

<Sysname> display ftp-user

  UserName             HostIP    Port    Idle              HomeDir

administra

tor             192.168.0.152    1031       0               flash:

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

字段	描述
UserName	用户名
HostIP	FTP客户端的IP地址
Port	FTP客户端登录时使用的端口
Idle	FTP客户端的空闲时间
HomeDir	为该FTP用户配置的初始工作路径，即用户登录后所在的路径

 

1.1.3  ftp disconnect

【命令】

ftp disconnect user-name

【视图】

系统视图

【参数】

user-name：需要中断与FTP服务器连接的用户名称（长度为1～184的字符串）。

【描述】

ftp disconnect命令用来中断指定用户与FTP服务器的连接。

 

相关命令可参考display ftp-user。

【举例】

# 查看当前在线的FTP用户。

<Sysname> display ftp-user

  UserName             HostIP    Port    Idle              HomeDir

admin           192.168.0.152    1029       0               flash:

# 中断与用户admin的FTP连接。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] ftp disconnect admin

%Apr  2 01:06:14:915 2000 Sysname FTPS/5/USEROUT:- 1 -User admin(192.168.0.152) logged out

1.1.4  ftp server enable

【命令】

ftp server enable

undo ftp server

【视图】

系统视图

【参数】

无

【描述】

ftp server enable命令用来启动交换机的FTP服务器功能。undo ftp server命令用来关闭FTP服务器功能。

缺省情况下，本系列以太网交换机没有开启FTP服务器功能，以避免可能存在的安全隐患。

 

相关命令可参考display ftp-server。

【举例】

# 启动FTP服务器。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] ftp server enable

% Start FTP server

1.1.5  ftp timeout

【命令】

ftp timeout minutes

undo ftp timeout

【视图】

系统视图

【参数】

minutes：连接空闲时间，单位为分钟，取值范围为1～35791。

【描述】

ftp timeout命令用来设置FTP客户端的空闲超时时间，当FTP客户端的空闲时间超过该超时时间后，FTP服务器将中断与该客户端的连接。undo ftp timeout命令用来恢复缺省的空闲超时时间。

缺省情况下，FTP客户端空闲超时时间为30分钟。

在用户登录到FTP服务器后，一旦连接异常中断，而FTP服务器又无法及时获悉，将会继续保持该连接，从而占用系统资源，并影响其他FTP用户的登录。使用空闲超时时间，可以防止这类情况的发生。如果FTP客户端在达到空闲超时时间后仍没有与FTP服务器进行命令交互，FTP服务器会认为该连接已失效，并中断与该客户端的连接。

【举例】

# 设置FTP客户端的空闲超时时间为36分钟。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] ftp timeout 36

1.2  FTP客户端配置命令

 

1.2.1  ascii

【命令】

ascii

【视图】

FTP Client视图

【参数】

无

【描述】

ascii命令用来设置文件传输的模式为ASCII模式，ASSII模式适用于传输文本文件。

缺省情况下，文件传输模式为ASCII模式。

相关命令可参考binary。

【举例】

# 设置文件传输模式为ASCII模式。

[ftp] ascii

200 Type set to A.

1.2.2  binary

【命令】

binary

【视图】

FTP Client视图

【参数】

无

【描述】

binary命令用来设置文件传输模式为二进制模式，二进制模式适用于传输程序文件。

缺省情况下，文件传输模式为ASCII模式。

相关命令可参考ascii。

【举例】

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

[ftp] binary

200 Type set to I.

1.2.3  bye

【命令】

bye

【视图】

FTP Client视图

【参数】

无

【描述】

bye命令用来终止与FTP服务器的控制连接和数据连接，并退回到用户视图。

该命令的作用与quit命令相同。

【举例】

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

[ftp] bye

221 Server closing.

<Sysname>

1.2.4  cd

【命令】

cd pathname

【视图】

FTP Client视图

【参数】

pathname：目标目录的路径。

【描述】

cd命令用来改变远程FTP服务器上的工作目录。

用户使用cd命令可以访问FTP服务器上的另一目录，该目录只能是FTP服务器对用户授权的目录。

相关命令请参考pwd。

【举例】

# 改变工作目录到flash:/temp。

[ftp] cd flash:/temp

# 显示当前工作目录。

[ftp] pwd

257 "flash:/temp" is current directory.

1.2.5  cdup

【命令】

cdup

【视图】

FTP Client视图

【参数】

无

【描述】

cdup命令用来退出当前在远程FTP服务器上的工作目录，并返回至上一级目录。上一级目录必须是用户已经被授权可以访问的路径，否则该命令将不能正常执行。

相关命令请参考cd，pwd。

【举例】

# 改变工作目录到flash:/temp。

[ftp] cd flash:/temp

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

[ftp] cdup

# 显示当前路径。

[ftp] pwd

257 "flash:" is current directory.

1.2.6  close

【命令】

close

【视图】

FTP Client视图

【参数】

无

【描述】

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

该命令的作用与disconnect命令相同。

【举例】

# 终止与远程FTP 服务器的连接，并保持在FTP Client视图。

[ftp] close

221 Server closing.

[ftp]

1.2.7  delete

【命令】

delete remotefile

【视图】

FTP Client视图

【参数】

remotefile：待删除的文件名称。

【描述】

delete命令用来删除指定的远程文件。

【举例】

# 删除文件temp.c。

[ftp] delete temp.c

250 DELE command successful.

1.2.8  dir

【命令】

dir [ filename [ localfile ] ]

【视图】

FTP Client视图

【参数】

filename：待查询的文件名称。

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

【描述】

dir命令用来查询远程FTP服务器上指定的文件，显示当前工作目录下的文件名称、文件大小和创建日期，并将查询情况保存至本地文件中。

如果不指定文件，系统将显示当前远程工作目录下的所有文件。

 

相关命令请参考pwd。

【举例】

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

[ftp] dir

227 Entering Passive Mode (192,168,0,152,4,0).

125 ASCII mode data connection already open, transfer starting for *.

-rwxrwxrwx   1 noone    nogroup    377424 Apr 26 13:05 s3r01.btm

-rwxrwxrwx   1 noone    nogroup    377424 Oct 10  2006 s3r01_15.btm

-rwxrwxrwx   1 noone    nogroup      2833 May 11 17:58 config.cfg

-rwxrwxrwx   1 noone    nogroup    225295 Apr 26 12:21 default.diag

-rwxrwxrwx   1 noone    nogroup    377424 Apr 30 16:58 switch.btm

drwxrwxrwx   1 noone    nogroup         0 Apr 28 11:41 test

-rwxrwxrwx   1 noone    nogroup      2145 Apr 28 13:13 test.txt

-rwxrwxrwx   1 noone    nogroup        13 Apr 28 13:21 mytest.bak

-rwxrwxrwx   1 noone    nogroup         9 Apr 28 13:24 a.txt

-rwxrwxrwx   1 noone    nogroup       142 Sep 10  2006 myopenssh

-rwxrwxrwx   1 noone    nogroup   5292802 Apr 30 17:02 switch2.bin

-rwxrwxrwx   1 noone    nogroup        15 Apr 26 17:45 public

-rwxrwxrwx   1 noone    nogroup        15 Apr 26 17:56 temp.c

-rwxrwxrwx   1 noone    nogroup   5286666 Oct 18  2006 switch5.bin

-rwxrwxrwx   1 noone    nogroup       306 May 13 11:17 swithc001

226 Transfer complete.

FTP: 1025 byte(s) received in 0.019 second(s) 53.00K byte(s)/sec.

# 查询文件config.cfg的相关信息，并将查询情况保存在temp1文件中。

[ftp] dir config.cfg temp1

227 Entering Passive Mode (192,168,0,152,4,3).

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

.....226 Transfer complete.

FTP: 67 byte(s) received in 5.818 second(s) 11.00 byte(s)/sec.

1.2.9  disconnect

【命令】

disconnect

【视图】

FTP Client视图

【参数】

无

【描述】

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

该命令的作用与close命令相同。

【举例】

# 终止与远程FTP服务器的连接，保持在FTP Client视图。

[ftp] disconnect

221 Server closing.

[ftp]

1.2.10  ftp

【命令】

ftp [ cluster | remote-server [ port-number ] ]

【视图】

用户视图

【参数】

cluster：表示登录到用户配置的集群FTP服务器，有关集群FTP服务器的配置，请参考本手册“Cluster”部分的介绍。

remote-server：远程FTP服务器的主机名（长度为1～20的字符串）或IP地址。

port-number：远程FTP服务器的端口号，取值范围为0～65535，缺省值为21。

【描述】

ftp命令用来与远程FTP服务器建立控制连接，当用户输入了正确的用户名和密码后，将进入FTP Client视图。

【举例】

# 连接到地址为2.2.2.2的远程FTP服务器。

<Sysname> ftp 2.2.2.2

Trying ...

Press CTRL+K to abort

Connected.

220 FTP service ready.

User(none):admin

331 Password required for admin.

Password:

230 User logged in.

[ftp]

1.2.11  get

【命令】

get remotefile [ localfile ]

【视图】

FTP Client视图

【参数】

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

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

【描述】

get命令用来下载远程文件，并将下载的文件保存在本地。

 

【举例】

# 下载temp.c文件。

[ftp] get temp.c

227 Entering Passive Mode (2,2,2,2,4,12).

125 ASCII mode data connection already open, transfer starting for temp.c.

..226 Transfer complete.

FTP: 15 byte(s) received in 2.568 second(s) 0.00 byte(s)/sec.

1.2.12  lcd

【命令】

lcd

【视图】

FTP Client视图

【参数】

无

【描述】

lcd命令用来显示FTP客户端本地的工作目录。在已经登录到FTP服务器的情况下，用户不能修改FTP客户端本地的工作目录；如需要修改，需要中断与FTP服务器的连接并退出FTP Client视图，在用户视图下使用cd命令切换工作目录后，再重新登录FTP服务器。

【举例】

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

[ftp] lcd

% Local directory now flash:/temp

1.2.13  ls

【命令】

ls [ remotefile [ localfile ] ]

【视图】

FTP Client视图

【参数】

remotefile：待查询的文件名称。

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

【描述】

ls命令用来查询FTP服务器上指定的文件名称。

如果不输入任何参数，系统将显示当前远程工作目录下的所有文件名。

 

相关命令请参考pwd。

【举例】

# 查询当前远程FTP服务器工作目录的所有文件名称。

[ftp] ls

227 Entering Passive Mode (2,2,2,2,4,4).

125 ASCII mode data connection already open, transfer starting for *.

s3r01.btm

s3r01_15.btm

config.cfg

default.diag

s5r-btm-116.btm

test

test.txt

mytest.bak

a.txt

myopenssh

s5r1205p02.bin

public

temp.c

s5r1205.bin

swithc001

226 Transfer complete.

FTP: 200 byte(s) received in 0.145 second(s) 1.00Kbyte(s)/sec.

1.2.14  mkdir

【命令】

mkdir pathname

【视图】

FTP Client视图

【参数】

pathname：待创建的目录名称。

【描述】

mkdir命令用来在远程FTP服务器上建立目录。

远程FTP服务器授权客户端用户使用建立目录操作后，用户才能执行mkdir命令。

相关命令请参考dir，rmdir。

【举例】

# 在远程FTP服务器上建立目录flash:/lanswitch。

[ftp] mkdir flash:/lanswitch

257 "flash:/ lanswitch" new directory created.

1.2.15  open

【命令】

open { ip-address | server-name } [ port ]

【视图】

FTP Client视图

【参数】

ip-address：远程FTP服务器的IP地址。

server-name：远程FTP服务器的主机名（长度为1～20的字符串）。

port：远程FTP服务器的端口号，取值范围为0～65535，缺省值为21。

【描述】

open命令用来在FTP Client视图下，与远程FTP服务器建立控制连接。如果当前已经登录到FTP服务器，则不能直接使用open命令连接到其他服务器，需要中断与当前服务器的连接后再重新执行。

相关命令可以参考close。

【举例】

# 在FTP Client视图下，与远程FTP服务器（IP地址为1.1.1.1）建立控制连接。

[ftp] open 1.1.1.1

Trying ...

Press CTRL+K to abort

Connected.

220 FTP service ready.

User(none):abc

331 Password required for abc

Password:

230 User logged in.

1.2.16  passive

【命令】

passive

undo passive

【视图】

FTP Client视图

【参数】

无

【描述】

passive命令用来设置数据传输的方式为被动方式。undo passive命令用来设置数据传输的方式为主动方式。

缺省情况下，数据传输的方式为被动方式。

被动方式与主动方式的区别在于：

l              当FTP客户端工作在主动方式时，FTP客户端将通过控制会话端口（TCP21）向FTP服务器通告一个随机端口Port1，FTP服务器收到通告后，主动向FTP客户端的Port1端口发起连接，进行数据传输。

l              当FTP客户端工作在被动方式时，在开始数据传输前，FTP客户端会向FTP服务器发送被动方式请求，由服务器向FTP客户端通告本地随机端口Port2，FTP客户端使用自身随机端口与Port2发起连接。

如果FTP客户端是通过防火墙访问FTP服务器，则在主动方式时，由于FTP服务器对Port1的连接请求是由外网主动发起，防火墙可能会屏蔽该请求，从而影响数据传输的进行。因此，建议用户在通过防火墙访问FTP服务器时，将FTP客户端的数据传输方式配置为被动方式。

【举例】

# 设置数据传输的方式为被动方式。

[ftp] passive

% Passive is on

1.2.17  put

【命令】

put localfile [ remotefile ]

【视图】

FTP Client视图

【参数】

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

remotefile：文件上传完成后，在服务器上保存时使用的文件名称。

【描述】

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

如果用户没有指定远程服务器上的文件名，则系统缺省认为此文件名与本地文件名相同。

【举例】

# 将本地temp.c文件上传到远程FTP服务器。

[ftp] put temp.c

227 Entering Passive Mode (2,2,2,2,4,13).

125 ASCII mode data connection already open, transfer starting for temp.c.

226 Transfer complete.

FTP: 15 byte(s) sent in 7.549 second(s) 1.00byte(s)/sec.

1.2.18  pwd

【命令】

pwd

【视图】

FTP Client视图

【参数】

无

【描述】

pwd命令用来显示远程FTP服务器上的工作目录。

相关命令请参考cd，cdup，dir，ls。

【举例】

# 显示远程FTP服务器上的工作目录。

[ftp] pwd

257 "flash:/temp" is current directory.

1.2.19  quit

【命令】

quit

【视图】

FTP Client视图

【参数】

无

【描述】

quit命令用来终止与远程FTP服务器的连接，并退回到用户视图。

该命令的作用与bye命令相同。

【举例】

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

[ftp] quit

221 Server closing.

<Sysname>

1.2.20  remotehelp

【命令】

remotehelp [ protocol-command ]

【视图】

FTP Client视图

【参数】

protocol-command：FTP协议命令。

【描述】

remotehelp命令用来显示FTP协议命令的帮助信息。

只有当FTP服务器提供协议命令帮助时，remotehelp命令才有效。

 

【举例】

# 查看协议命令user的语法。

[ftp] remotehelp user

214 Syntax: USER <sp> <username>

1.2.21  rename

【命令】

rename remote-source remote-dest

【视图】

FTP Client视图

【参数】

remote-source：远程主机上的源文件名。

remote-dest：远程主机上的目标文件名。

【描述】

rename命令用来重命名远程FTP服务器上的文件。

若目标文件名与已经存在的目录名或文件名相同，系统将提示文件不能读取，重命名操作不能执行。

【举例】

# 重命名文件 temp.c为forever.c

[ftp] rename temp.c forever.c

350 Enter the name to rename it to...

250 File renamed successfully

1.2.22  rmdir

【命令】

rmdir pathname

【视图】

FTP Client视图

【参数】

pathname：远程FTP服务器上的目录名。

【描述】

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

只有当该目录为空目录时，rmdir命令才能删除成功。

【举例】

# 删除FTP服务器上的flash:/temp1目录。

[ftp] rmdir flash:/temp1

200 RMD command successful.

1.2.23  user

【命令】

user username [ password ]

【视图】

FTP Client视图

【参数】

username：登录用户名。

password：登录密码。

【描述】

user命令用来使用指定的用户名和密码登录远程FTP服务器。

【举例】

# 以FTP服务器上用户名为tom，口令为111的用户身份登录。

[ftp] user tom 111

331 Password required for tom.

230 User logged in.

1.2.24  verbose

【命令】

verbose

undo verbose

【视图】

FTP Client视图

【参数】

无

【描述】

verbose命令用来打开FTP功能的协议信息开关，用于显示FTP协议对用户操作的执行结果及响应信息。undo verbose命令用来关闭该开关。

缺省情况下，FTP协议信息开关为开启状态。

【举例】

# 下载名为“test1.cfg”的文件。

[ftp] get test1.cfg

 

227 Entering Passive Mode (192,168,0,3,5,239)

150 "D:\FTP\test1.cfg" file ready to send (100 bytes) in ASCII mode

....226 Transfer finished successfully.

FTP: 100 byte(s) received in 5.109 second(s) 20.00 byte(s)/sec.

# 关闭verbose开关。

[ftp] undo verbose

# 下载名为“test.cfg”的文件。

[ftp] get test.cfg

......FTP: 1740 byte(s) received in 9.367 second(s) 185.00 byte(s)/sec.

可以看到，在关闭FTP协议信息开关后，用户的操作将只能得到交换机系统返回的执行结果，而FTP协议输出的以三位数字开头的信息将不能反馈给用户。

有关FTP协议信息开头的数字所表示的含义，请参考RFC959中的介绍。

1.3  SFTP 服务器配置命令

1.3.1  sftp server enable

【命令】

sftp server enable

undo sftp server

【视图】

系统视图

【参数】

无

【描述】

sftp server enable命令用来启动SFTP服务器。undo sftp server命令用来关闭SFTP服务器。

缺省情况下，SFTP服务器处于关闭状态。

【举例】

# 启动SFTP服务器。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] sftp server enable

%Start SFTP server

1.3.2  sftp timeout

【命令】

sftp timeout time-out-value

undo sftp timeout

【视图】

系统视图

【参数】

time-out-value：超时时间，取值范围为1～35791，单位为分钟。缺省值为10分钟。

【描述】

sftp timeout命令用来在SFTP Server端设置SFTP用户连接的空闲超时时间。undo sftp timeout命令用来恢复SFTP用户连接空闲超时时间的缺省值。

当SFTP用户连接的空闲超时时间超过设定的阈值后，系统会自动断开此用户的连接。

【举例】

# 设置SFTP用户连接的空闲超时时间为500分钟。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] sftp timeout 500

1.4  SFTP 客户端配置命令

1.4.1  bye

【命令】

bye

【视图】

SFTP Client视图

【参数】

无

【描述】

bye命令用来终止与远程SFTP Server的连接，并退回到系统视图。

该命令功能与exit，quit相同。

【举例】

# 终止与远程SFTP server的连接。

sftp-client> bye

Bye

[Sysname]

1.4.2  cd

【命令】

cd [ remote-path ]

【视图】

SFTP Client视图

【参数】

remote-path：服务器上目标目录的路径。

【描述】

cd命令用来改变远程SFTP服务器上的工作路径。如果没有指定remote-path，则显示当前工作路径。

 

【举例】

# 改变工作路径到new1。

sftp-client>cd new1

Received status: Success

Current Directory is:

/new1

sftp-client> 

1.4.3  cdup

【命令】

cdup

【视图】

SFTP Client视图

【参数】

无

【描述】

cdup命令用来改变远程SFTP服务器上的工作路径，返回到上一级目录。

【举例】

# 改变工作路径到上一级目录。

sftp-client>cdup

Received status: Success

Current Directory is:

/

1.4.4  delete

【命令】

delete remote-file&<1-10>

【视图】

SFTP Client视图

【参数】

remote-file&<1-10>：服务器上的文件名。&<1-10>表示最多可以输入10个文件名，每个文件名之间用空格分隔。

【描述】

delete命令用来删除远程SFTP服务器上指定的文件。

该命令功能和remove相同。

【举例】

# 删除服务器上的文件test.txt。

sftp-client> delete test.txt

The following files will be deleted: 

/test.txt

Are you sure to delete it?(Y/N):y

This operation may take a long time.Please wait...

 

Received status: Success

File successfully Removed

1.4.5  dir

【命令】

dir [ -a | -l ] [ remote-path ]

【视图】

SFTP Client视图

【参数】

-a：显示指定目录下文件及文件夹的名称。

-l：以列表的形式显示指定目录下文件及文件夹的详细信息。

remote-path：查询的目录名。

【描述】

dir命令用来查询远程SFTP服务器上指定目录。

如果没有指定-a和-l参数，则以列表的形式显示指定目录下文件及文件夹的详细信息。

如果没有指定remote-path，则查询当前工作目录下的文件。

该命令功能与ls相同。

【举例】

# 查询当前目录下的文件。

sftp-client> dir

-rwxrwxrwx   1 noone    nogroup      1759 Aug 23 06:52 config.cfg

-rwxrwxrwx   1 noone    nogroup       225 Aug 24 08:01 pubkey2

-rwxrwxrwx   1 noone    nogroup       283 Aug 24 07:39 pubkey1

-rwxrwxrwx   1 noone    nogroup       225 Sep 28 08:28 pub1

drwxrwxrwx   1 noone    nogroup         0 Sep 28 08:24 new1

drwxrwxrwx   1 noone    nogroup         0 Sep 28 08:18 new2

-rwxrwxrwx   1 noone    nogroup       225 Sep 28 08:30 pub2

Received status: End of file

Received status: Success 

1.4.6  exit

【命令】

exit

【视图】

SFTP Client视图

【参数】

无

【描述】

exit命令用来终止与远程SFTP server的连接，并退回到系统视图。

该命令功能与bye，quit相同。

【举例】

# 终止与远程SFTP server的连接。

sftp-client> exit

Bye

[Sysname]

1.4.7  get

【命令】

get remote-file [ local-file ]

【视图】

SFTP Client视图

【参数】

remote-file：远程SFTP Server上的文件名。

local-file：本地文件名。

【描述】

get命令用来从远程服务器上下载文件并存储在本地。

缺省情况下，如果没有指定本地文件名，则将该文件按照远程SFTP Server上的文件名保存到本地。

【举例】

# 下载tt.bak文件，并以tt.txt文件名保存。

sftp-client>get tt.bak tt.txt....

This operation may take a long time, please wait...

Remote  file:tt.bak --->  Local file: tt.txt..

Received status: End of file

Received status: Success

Downloading file successfully ended

1.4.8  help

【命令】

help [ all |command ]

【视图】

SFTP Client视图

【参数】

all：显示所有命令的名字。

command：命令名。

【描述】

help命令用来显示SFTP客户端命令的帮助信息。

如果没有指定command，系统将显示所有命令的名字。

【举例】

# 查看命令get的帮助信息。

sftp-client> help get

get remote-path [local-path]  Download file.Default local-path is the same

                              with remote-path

1.4.9  ls

【命令】

ls [ -a | -l ] [ remote-path ]

【视图】

SFTP Client视图

【参数】

-a：显示指定目录下文件及文件夹的名称。

-l：以列表的形式显示指定目录下文件及文件夹的详细信息。

remote-path：查询的目录名。

【描述】

ls命令用来查询远程SFTP服务器上指定目录下的文件。

如果没有指定-a和-l参数，则以列表的形式显示指定目录下文件及文件夹的详细信息。

如果没有指定remote-path，则查询当前工作目录下的文件。

该命令功能与dir相同。

【举例】

# 查询当前目录。

sftp-client> ls

-rwxrwxrwx   1 noone    nogroup      1759 Aug 23 06:52 config.cfg

-rwxrwxrwx   1 noone    nogroup       225 Aug 24 08:01 pubkey2

-rwxrwxrwx   1 noone    nogroup       283 Aug 24 07:39 pubkey1

-rwxrwxrwx   1 noone    nogroup       225 Sep 28 08:28 pub1

drwxrwxrwx   1 noone    nogroup         0 Sep 28 08:24 new1

drwxrwxrwx   1 noone    nogroup         0 Sep 28 08:18 new2

-rwxrwxrwx   1 noone    nogroup       225 Sep 28 08:30 pub2

Received status: End of file

Received status: Success

1.4.10  mkdir

【命令】

mkdir remote-path

【视图】

SFTP Client视图

【参数】

remote-path：远程SFTP server上的目录名。

【描述】

mkdir命令用来在远程SFTP server上建立目录。

【举例】

# 在远程SFTP服务器上建立目录hj。

sftp-client>mkdir hj

Received status: Success

New directory created

1.4.11  put

【命令】

put local-file [ remote-file ]

【视图】

SFTP Client视图

【参数】

local-file：本地的文件名。

remote-file：远程SFTP Server上的文件名。

【描述】

put命令用来将本地的文件上传到远程SFTP Server。

缺省情况下，如果没有指定远程服务器上的文件名，则认为服务器上的文件与本地文件同名。

【举例】

# 将本地config.cfg文件上传到远程SFTP Server，并以1.txt文件名保存。

sftp-client>put config.cfg 1.txt

This operation may take a long time, please wait...

Local file:config.cfg --->  Remote file: /1.txt

Received status: Success  

Uploading file successfully ended

1.4.12  pwd

【命令】

pwd

【视图】

SFTP Client视图

【参数】

无

【描述】

pwd命令用来显示远程SFTP Server上的工作目录。

【举例】

# 显示远程SFTP Server上的工作目录。

sftp-client> pwd

/

1.4.13  quit

【命令】

quit

【视图】

SFTP Client视图

【参数】

无

【描述】

quit命令用来终止与远程SFTP server的连接，并退回到系统视图。

该命令功能与bye，exit相同。

【举例】

# 终止与远程SFTP server的连接。

sftp-client> quit

Bye

[Sysname]

1.4.14  remove

【命令】

remove remote-file&<1-10>

【视图】

SFTP Client视图

【参数】

remote-file&<1-10>：服务器上的文件名。&<1-10>表示最多可以输入10个文件名，每个文件名之间用空格分隔。

【描述】

remove命令用来删除远程SFTP服务器上指定的文件。

该命令和delete功能相同。

【举例】

# 删除服务器上的文件temp.c。

sftp-client> remove temp.c

The followed File will be deleted:

/temp.c

Are you sure to delete it?(Y/N):y

This operation may take a long time.Please wait...

 

Received status: Success

File successfully Removed

1.4.15  rename

【命令】

rename oldname newname

【视图】

SFTP Client视图

【参数】

oldname：原文件名。

newname：新文件名。

【描述】

rename命令用来改变SFTP服务器上指定的文件名。

【举例】

# 将SFTP服务器上的文件temp.bat改名为temp.txt。

sftp-client> rename temp.bat temp.txt

File successfully renamed

1.4.16  rmdir

【命令】

rmdir remote-path&<1-10>

【视图】

SFTP Client视图

【参数】

remote-path&<1-10>：远程SFTP server上的目录名。&<1-10>表示最多可以输入10个文件名，每个文件名之间用空格分隔。

【描述】

rmdir命令用来删除SFTP服务器上指定的目录。

【举例】

# 删除SFTP服务器上的hello目录。

sftp-client>rmdir hello

The followed directory will be deleted

/hello

Are you sure to remove it?(Y/N):y

This operation may take a long time.Please wait...

 

Received status: Success

Directory successfully removed

1.4.17  sftp

【命令】

sftp { host-ip | host-name } [ port-num ] [ identity-key { dsa | rsa } | prefer_kex { dh_group1 | dh_exchange_group } | prefer_ctos_cipher { des | aes128 } | prefer_stoc_cipher { des | aes128 } | prefer_ctos_hmac { sha1 | sha1_96 | md5 | md5_96 } | prefer_stoc_hmac { sha1 | sha1_96 | md5 | md5_96 } ] *

【视图】

系统视图

【参数】

host-ip：服务器IP地址。

host-name：表示服务器名称的字符串，长度为1～20个字符。

port-num：服务器端口号，取值范围为0～65535，缺省值为22。

identity-key：publickey认证采用的公共密钥算法，缺省算法为rsa。

l              dsa：公共密钥算法为DSA。

l              rsa：公共密钥算法为RSA。

prefer_kex：Key交换首选算法，选择两种算法之间的一种。

l              dh_group1：Key交换算法diffie-hellman-group1-sha1，为缺省Key交换算法。

l              dh_exchange_group：Key交换算法diffie-hellman-group-exchange-sha1。

prefer_ctos_cipher：客户端到服务器端的首选加密算法，缺省算法为aes128。

prefer_stoc_cipher：服务器端到客户端的首选加密算法，缺省算法为aes128。

l              des：des_cbc加密算法。

l              aes128：aes_128加密算法。

prefer_ctos_hmac：客户端到服务器端的首选HMAC算法，缺省为sha1_96。

prefer_stoc_hmac：服务器端到客户端的首选HMAC算法，缺省为sha1_96。

l              sha1：HMAC算法hmac-sha1。

l              sha1_96：HMAC算法hmac-sha1-96。

l              md5：HMAC算法hmac-md5。

l              md5_96：HMAC算法hmac-md5-96。

【描述】

sftp命令用来与远程SFTP服务器建立连接，并进入SFTP Client视图。

如果在服务器端指定客户端的认证方式为公钥认证，当客户端登录SFTP服务器端时客户端需要读取本地的私钥进行验证。由于公钥认证可以采用RSA和DSA两种加密算法，所以需要用identity-key关键字指定采用的加密算法，才能得到正确的本地私钥数据，否则无法登录成功。

【举例】

# 连接IP地址为10.1.1.2的SFTP服务器，加密算法均取缺省值。

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname]sftp 10.1.1.2

Input Username: kk

Trying 10.1.1.2...

Press CTRL+K to abort

Connected to 10.1.1.2 ...

 

The Server is not authenticated. Do you continue access it?(Y/N):y

Do you want to save the server's public key?(Y/N):y

Enter password:

 

sftp-client>

 

2 TFTP

2.1  TFTP配置命令

 

2.1.1  tftp { ascii | binary }

【命令】

tftp { ascii | binary }

【视图】

系统视图

【参数】

ascii：以ASCII方式传输数据，ASSII模式适用于传输文本文件。

binary：以二进制方式传输数据，二进制模式适用于传输程序文件。

【描述】

tftp { ascii | binary }命令用来设置通过TFTP传输文件时，数据传输的方式。

缺省情况下，数据传输方式为binary。

【举例】

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

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] tftp ascii

TFTP transfer mode changed to ASCII.

2.1.2  tftp get

【命令】

tftp tftp-server get source-file [ dest-file ]

【视图】

用户视图

【参数】

tftp-server：TFTP服务器的IP地址或者主机名，取值为1～20个字符的字符串。当交换机处于集群中时，取值为“cluster”表示登录到集群的TFTP服务器。有关集群TFTP服务器的配置，请参见本手册“Cluster”部分的介绍。

source-file：需要从TFTP服务器上下载的文件名称。

dest-file：下载完成后在交换机上进行保存时使用的文件名称。

【描述】

tftp get命令用来从TFTP服务器上下载文件，并保存到本地存储设备中。

与FTP功能不同的是，TFTP无法在客户端上切换或指定服务器的工作目录，如需要进入其他目录，用户只能在TFTP服务器软件上进行修改，并重新登录。

本系列以太网交换机支持TFTP文件大小协商功能，即在下载文件前，先向TFTP服务器请求待下载文件的大小，以确认本地Flash是否有足够空间进行下载。如果TFTP服务器也支持这个功能，当文件超大时，交换机将提前获知并终止下载操作，节省网络资源；如果TFTP服务器不支持该功能，交换机只能先将文件下载到内存中，在写入Flash时发现文件超大，再进行删除。

相关配置可参考命令tftp put。

【举例】

# 从TFTP服务器（IP地址为1.1.1.1），将文件abc.txt下载到本机并保存为efg.txt（假设flash剩余空间足够）。

<Sysname>tftp 1.1.1.1 get abc.txt efg.txt

  File will be transferred in binary mode.

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

  TFTP:       35 bytes received in 0 second(s).

  File downloaded successfully.

# 从TFTP服务器（IP地址为1.1.1.1），将文件temp.txt下载到本机并保存为test1.txt（假设Flash剩余空间不足，且TFTP服务器不支持文件大小协商的扩展协议）。

<Sysname> tftp 1.1.1.1 get temp.txt test1.txt

  File will be transferred in binary mode.

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

  Not enough space; Writing to device failed; Downloaded data will be deleted.............

  Deleting file successful.

# 从TFTP服务器（IP地址为1.1.1.1），将文件temp.txt下载到本机并保存为test2.txt（假设Flash剩余空间不足，且TFTP服务器支持文件大小协商的扩展协议）。

<Sysname> tftp 1.1.1.1 get temp.txt test2.txt

  File will be transferred in binary mode.

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

  Not enough space; Quit writing to device; Created file will be deleted.............

  Deleting file successful.

2.1.3  tftp put

【命令】

tftp tftp-server put source-file [ dest-file ]

【视图】

用户视图

【参数】

tftp-server：TFTP服务器的IP地址或者主机名，取值为1～20个字符的字符串。当交换机处于集群中时，取值为“cluster”表示登录到集群的TFTP服务器。有关集群TFTP服务器的配置，请参见本手册“Cluster”部分的介绍。

source-file：需要上传到TFTP服务器的文件名称。

dest-file：文件上传到TFTP服务器后保存时使用的名称。

【描述】

tftp put命令用来将以太网交换机上的文件上传到TFTP服务器的指定目录下。

在向TFTP上传文件时，用户只能选择设备当前工作路径下的文件，如需要上传其他目录中的文件，请在执行tftp put命令前，在用户视图下使用cd命令切换至指定目录。关于用户视图下cd命令的使用，请参见本手册“文件系统管理”部分的介绍。

相关配置可参考命令tftp get。

【举例】

# 将本机的config.cfg文件上传到TFTP服务器（1.1.1.1）并保存为temp.cfg。

<Sysname> tftp 1.1.1.1 put config.cfg temp.cfg

  File will be transferred in binary mode.

  Copying file to remote tftp server. Please wait... /

  TFTP:      962 bytes sent in 0 second(s).

  File uploaded successfully.

EA.bin

2.1.4  tftp-server acl

【命令】

tftp-server acl acl-number

undo tftp-server acl

【视图】

系统视图

【参数】

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

【描述】

tftp-server acl命令用来指定TFTP客户端在连接TFTP服务器时所选用的ACL规则的编号。undo tftp-server acl命令用来取消所有指定的ACL规则的编号。

【举例】

# 指定TFTP客户端选用编号为2000的ACL。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] tftp-server acl 2000