目  录

1 文件系统管理命令

1.1 文件系统管理命令

1.1.1 cd

1.1.2 copy

1.1.3 delete

1.1.4 dir

1.1.5 execute

1.1.6 file prompt

1.1.7 fixdisk

1.1.8 format

1.1.9 mkdir

1.1.10 more

1.1.11 move

1.1.12 pwd

1.1.13 rename

1.1.14 reset recycle-bin

1.1.15 rmdir

1.1.16 undelete

2 配置文件管理命令

2.1 配置文件管理命令

2.1.1 archive configuration

2.1.2 archive configuration interval

2.1.3 archive configuration location

2.1.4 archive configuration max

2.1.5 backup startup-configuration

2.1.6 configuration replace file

2.1.7 display archive configuration

2.1.8 display saved-configuration

2.1.9 display startup

2.1.10 reset saved-configuration

2.1.11 restore startup-configuration

2.1.12 save

2.1.13 startup saved-configuration

3 FTP配置命令

3.1 FTP客户端配置命令

3.1.1 ascii

3.1.2 binary

3.1.3 bye

3.1.4 cd

3.1.5 cdup

3.1.6 close

3.1.7 debugging

3.1.8 delete

3.1.9 dir

3.1.10 disconnect

3.1.11 display ftp client configuration

3.1.12 ftp

3.1.13 ftp client source

3.1.14 ftp ipv6

3.1.15 get

3.1.16 lcd

3.1.17 ls

3.1.18 mkdir

3.1.19 open

3.1.20 open ipv6

3.1.21 passive

3.1.22 put

3.1.23 pwd

3.1.24 quit

3.1.25 remotehelp

3.1.26 rmdir

3.1.27 user

3.1.28 verbose

4 TFTP配置命令

4.1 TFTP客户端配置命令

4.1.1 display tftp client configuration

4.1.2 tftp-server acl

4.1.3 tftp

4.1.4 tftp client source

4.1.5 tftp ipv6

 

 

1 文件系统管理命令

 

1.1  文件系统管理命令

1.1.1  cd

【命令】

cd { directory | .. | / }

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

directory：指定目标工作路径。格式为[drive:/]path。drive和path参数的详细解释，请参见“系统分册”中的“文件系统管理配置”。如果没有给出drive信息，则表示当前路径下的文件夹或者子文件夹。

..：返回上一级目录。如果当前的工作路径是根目录，或不存在上一级目录，则执行cd ..后保持当前的工作路径不变。该参数不支持命令行在线帮助。

/：返回存储介质的根目录。该参数不支持命令行在线帮助。

【描述】

cd命令用来修改当前的工作路径。

【举例】

# 登录设备后从根目录进入test子文件夹。

<Sysname> cd test

# 返回上一级目录（请注意关键字cd后有一个空格）。

<Sysname> cd ..

# 返回根目录。

<Sysname> cd /

使用cd命令修改当前的工作路径后，可以使用pwd命令查看当前所在的路径。

1.1.2  copy

【命令】

copy fileurl-source fileurl-dest

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

fileurl-source：源文件名。

fileurl-dest：目标文件名或者目标文件夹。

【描述】

copy命令用来复制文件。

如果使用文件夹作为fileurl-dest，则系统会将文件复制到指定文件夹，使用源文件名称作为文件名。

【举例】

# 将文件test.cfg在当前文件夹下复制一份，并命名为testbackup.cfg。

<Sysname> copy test.cfg testbackup.cfg

Copy flash:/test.cfg to flash:/testbackup.cfg?[Y/N]:y

....

%Copy file flash:/test.cfg to flash:/testbackup.cfg...Done.

# 将文件夹test下的文件1.cfg复制到文件夹testbackup，并命名为1backup.cfg。

<Sysname> copy flash:/test/1.cfg flash:/testbackup/1backup.cfg

Copy flash:/test/1.cfg to flash:/testbackup/1backup.cfg?[Y/N]:y

 

%Copy file flash:/test/1.cfg to flash:/testbackup/1backup.cfg...Done.

1.1.3  delete

【命令】

delete [ /unreserved ] file-url

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

/unreserved：彻底删除该文件，被彻底删除的文件将不能被恢复。

file-url：要删除的文件名。file-url参数支持通配符“*”进行匹配，比如delete *.txt可以删除当前目录下所有以txt为扩展名的文件。

【描述】

delete命令用来删除设备中的指定文件。

l              未使用/unreserved关键字删除的文件存放在回收站目录中，使用dir /all命令可以显示当前目录下删除的、在回收站目录中的文件，这种文件在显示时会以方括号“[ ]”标出。

l              未使用/unreserved关键字删除的文件，可以使用undelete命令恢复。若要从回收站中彻底删除该文件，请使用reset recycle-bin命令。

 

【举例】

# 删除当前目录下的文件tt.cfg。

<Sysname> delete tt.cfg

Delete flash:/tt.cfg? [Y/N]:y

 

%Delete file flash:/tt.cfg...Done.

1.1.4  dir

【命令】

dir [ /all ] [ file-url ]

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

/all：显示所有的文件。

file-url：显示的文件名或目录名。file-url参数支持通配符“*”进行匹配，比如dir *.txt可以显示当前目录下所有以txt为扩展名的文件。

【描述】

l              dir命令（不带参数）用来显示当前目录下所有可见文件及文件夹的信息。

l              dir /all命令用来显示当前目录下所有的文件及子文件夹信息，显示内容包括隐藏文件、隐藏子文件夹以及回收站中的原属于该目录下的文件的信息，回收站里的文件会以方括号“[ ]”标出。

l              dir file-url命令用来显示指定的文件或文件夹的信息。

【举例】

# 显示系统中所有的文件及文件夹信息。

<Sysname> dir /all

Directory of flash:/

 

   0     -rw-   4145120  Oct 10 2002 10:10:10   test.bin

   1     -rwh       690  Apr 26 2000 12:00:14   private-data.txt

   2     -rw-      1107  Apr 26 2000 12:03:16   startup.cfg

   3     -rwh         4  Apr 26 2000 14:22:15   snmpboots

 

6477 KB total (2423 KB free)

表1-1 dir命令显示信息描述表

字段	说明
Directory of	当前的工作路径
d	表示目录，无此标记表示文件
r	表示本文件或目录是可读的
w	表示本文件或目录是可写的
h	表示本文件或目录是隐藏的
[ ]	表示本文件是回收站里的

 

1.1.5  execute

【命令】

execute filename

【视图】

系统视图

【缺省级别】

2：系统级

【参数】

filename：批处理文件名，必须以“.bat”为后缀。可以使用rename命令将配置文件的后缀修改为.bat后作为批处理文件使用。

【描述】

execute命令用来执行指定的批处理文件。批处理命令逐条执行批处理文件中的命令行，执行过程相当于手工逐条执行的自动化过程。

l              批处理文件中不能包含不可见字符。如果发现有不可见字符，批处理命令则退出当前执行过程，但是不会撤销已经执行了的批处理文件里的操作。

l              批处理命令不保证每一条命令的执行，比如某命令设置错误或者该命令执行的条件不成熟，系统就会跳过该命令转到下一条。

l              批处理文件中的每一条配置命令，均要求必须为系统标准配置命令，即配置成功后通过display current-configuration命令查看到的实际生效配置信息，否则命令可能无法被正确执行。

【举例】

# 执行根目录下的test.bat批处理文件。

<Sysname> system-view

[Sysname] execute test.bat

1.1.6  file prompt

【命令】

file prompt { alert | quiet }

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

alert：交互确认方式。当用户对文件进行有危险性的操作时，系统会要求用户进行交互确认。

quiet：非交互确认方式。用户对文件进行任何操作，系统均不要求用户进行确认。

【描述】

file prompt命令用来设置系统对文件操作的提示方式。

缺省情况下，文件操作的提示方式为alert。

需要注意的是，如果将文件操作的提示方式设置为quiet，则系统对文件操作不要求用户进行确认，这样可能会导致一些因误操作而发生的、不可恢复的、对系统造成破坏的操作产生。

【举例】

# 设置系统对文件操作的提示方式为alert。

<Sysname> system-view

[Sysname] file prompt alert

1.1.7  fixdisk

【命令】

fixdisk device

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

device：存储设备名称。

【描述】

fixdisk命令用来恢复存储设备的空间。

由于异常操作等原因，存储设备的某些空间可能不可用，用户可以通过fixdisk命令来恢复存储设备的空间。

【举例】

# 恢复存储设备Flash的空间。

<Sysname> fixdisk flash:

Fixdisk flash: may take some time to complete...

%Fixdisk flash: completed.

1.1.8  format

【命令】

format device

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

device：存储设备名（如flash）。

【描述】

format命令用来格式化存储设备。

 

【举例】

# 格式化Flash。

<Sysname> format flash:

All data on flash: will be lost, proceed with format? [Y/N]:y

./

%Format flash: completed.

1.1.9  mkdir

【命令】

mkdir directory

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

directory：文件夹。

【描述】

mkdir命令用来在存储设备的指定目录下创建文件夹。

需要注意的是：

l              如果创建的文件夹与指定目录下的其它文件夹重名，则创建操作失败。

l              在使用该命令创建文件夹之前，指定的目录必须已经存在。比如：创建文件夹flash:/test/mytest，这时，test目录必须已经存在，否则，创建失败。

【举例】

# 在当前路径创建目录test。

<Sysname> mkdir test

....

%Created dir flash:/test.

# 在当前路径创建文件夹test/subtest。

<Sysname> mkdir test/subtest

....

%Created dir flash:/test/subtest.

1.1.10  more

【命令】

more file-url

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

file-url：文件名。

【描述】

more命令用来显示指定文件的内容。

目前文件系统只支持显示文本文件的内容。

【举例】

# 显示文件test.txt的内容。

<Sysname> more test.txt

Welcome to H3C.

# 显示文件testcfg.cfg的内容。

<Sysname> more testcfg.cfg

 

#

 version 5.20, Beta 1201, Standard

#

 sysname Sysname

#

 configure-user count 5

#

vlan 2

#

return

<Sysname>

1.1.11  move

【命令】

move fileurl-source fileurl-dest

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

fileurl-source：源文件名。

fileurl-dest：目标文件名或者目标文件夹。

【描述】

move命令用来移动文件。

如果使用文件夹作为fileurl-dest，则系统会将文件移到指定文件夹，文件名保持不变。

【举例】

# 将文件flash:/test/sample.txt移动到flash:，并更名为1.txt。

<Sysname> move flash:/test/sample.txt flash:/1.txt

Move flash:/test/sample.txt to flash:/1.txt? [Y/N]:y

....

% Moved file flash:/test/sample.txt to flash:/1.txt

# 将文件b.cfg移动到子文件夹test2下。

<Sysname> move b.cfg test2

Move flash:/b.cfg to flash:/test2/b.cfg?[Y/N]:y

.

%Moved file flash:/b.cfg to flash:/test2/b.cfg.

1.1.12  pwd

【命令】

pwd

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

无

【描述】

pwd命令用来显示当前路径。

【举例】

# 显示当前路径。

<Sysname> pwd

flash:

1.1.13  rename

【命令】

rename fileurl-source fileurl-dest

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

fileurl-source：源文件名或源文件夹。

fileurl-dest：目标文件名或目标文件夹。

【描述】

rename命令用来重命名文件或文件夹。若目标文件名与当前路径下已经存在的文件重名，则该操作不执行。

【举例】

# 将文件sample.txt重命名为sample.bat。

<Sysname> rename sample.txt sample.bat

Rename flash:/sample.txt to flash:/sample.bat? [Y/N]:y

 

% Renamed file flash:/sample.txt to flash:/sample.bat

1.1.14  reset recycle-bin

【命令】

reset recycle-bin [ /force ]

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

/force：强制清空回收站。

【描述】

reset recycle-bin命令用来彻底删除当前目录下、处于回收站中的文件。

如果文件损坏，直接使用reset recycle-bin命令可能不能删除该文件。使用reset recycle-bin /force可以强制删除回收站中的所有文件。

需要注意的是：

l              用delete file-url命令删除文件是将文件放在回收站中，但仍然占用存储空间，如果想要把回收站中的该文件删除，必须在该文件的原目录下执行reset recycle-bin命令。

l              reset recycle-bin命令删除的是当前目录下、处于回收站中的文件。如果要清除的文件的原路径不是当前路径，则必须先使用cd命令进入文件的原目录，再执行reset recycle-bin命令。

【举例】

# 删除回收站中的文件。

<Sysname> reset recycle-bin

Clear flash:/~/tt.cfg? [Y/N]:y

Clearing files from flash may take a long time. Please wait...

 

%Cleared file flash:/~/tt.cfg.

1.1.15  rmdir

【命令】

rmdir directory

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

directory：文件夹。

【描述】

rmdir命令用来删除文件夹。

需要注意的是：

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

l              成功执行rmdir后，回收站中原来属于该文件夹的文件会自动被彻底删除。

【举例】

# 删除文件夹mydir。

<Sysname> rmdir mydir

Rmdir flash:/mydir? [Y/N]:y

 

%Removed directory flash:/mydir.

1.1.16  undelete

【命令】

undelete file-url

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

file-url：要恢复的文件名。

【描述】

undelete命令用来恢复未被彻底删除（即存放在回收站里）的文件。

如果恢复的文件名与当前存在的文件重名，系统将提示操作者是否覆盖原有文件。

【举例】

# 恢复目录flash:下删除的文件a.cfg。

<Sysname> undelete a.cfg

Undelete flash:/a.cfg?[Y/N]:y

.....

%Undeleted file flash:/a.cfg.

 

2 配置文件管理命令

2.1  配置文件管理命令

2.1.1  archive configuration

【命令】

archive configuration

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

无

【描述】

archive configuration命令用来手工备份当前配置。

执行该命令后，系统会将当前的配置以指定的文件名（指定前缀+序号）保存到指定的路径。

需要注意的是：执行archive configuration命令前必须先执行archive configuration location命令来设置备份文件的前缀和保存路径。

【举例】

# 手工备份当前配置。

<Sysname> archive configuration

Warning: Save the running configuration to an archive file. Continue? [Y/N]: Y

Please wait...

Info: The archive configuration file myarchive_1.cfg is saved.

2.1.2  archive configuration interval

【命令】

archive configuration interval minutes

undo archive configuration interval

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

minutes：表示自动备份当前配置的时间间隔，取值范围为10～525600（相当于365天），单位为分钟。

【描述】

archive configuration interval命令用来使能自动备份当前配置功能，并设置自动备份的间隔时间。undo archive configuration interval用来恢复缺省情况。

缺省情况下，系统不会自动备份当前配置。

成功执行本命令后，每隔指定时间（由minutes值决定）系统会把当前配置以指定文件名自动保存到指定路径。

使用该命令时应根据设备存储介质的性能和修改配置的频繁程度来设置minutes参数的具体值：

l              对于不会频繁修改配置的设备，建议按需手动备份当前配置（相关配置可参见命令archive configuration）；

l              对于使用低速存储介质（如Flash）的设备，建议不要进行自动备份配置，或设置minutes大于1440（24小时）；

需要注意的是：执行archive configuration interval命令前必须先执行archive configuration location命令来设置备份文件的前缀和保存路径。

【举例】

# 设置每隔一小时自动备份当前配置。

<Sysname> system-view

[Sysname] archive configuration interval 60

Info: Archive files will be saved every 60 minutes.

2.1.3  archive configuration location

【命令】

archive configuration location directory filename-prefix filename-prefix

undo archive configuration location

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

directory：表示保存备份配置文件的文件夹的路径，为1～63字节的字符串，格式为存储介质名:/[文件夹名]/子文件夹名，不区分大小写。该文件夹必须预先创建好，路径中不能包含槽位号。

filename-prefix：表示备份配置文件的文件名前缀，为1～30字节的字符串，只能包含字母、数字、’_’和’-‘，不区分大小写。

【描述】

archive configuration location命令用来设置备份配置文件的保存路径和文件名前缀。undo archive configuration location命令用来恢复缺省情况。

缺省情况下，系统没有设置备份配置文件的保存路径和文件名前缀，也不会定时备份配置。

需要注意的是：

l              自动或手动备份当前配置前必须使用该命令设置备份配置文件的保存路径和文件名前缀。

l              执行undo archive configuration location命令后，用户将不能手工备份当前配置，系统也不再自动备份当前配置，archive configuration interval和archive configuration max的配置也会恢复到缺省情况，已保存的备份配置文件记录也会被清除。

【举例】

# 在flash:/archive/目录下备份配置文件，文件名前缀为my_archive。

<Sysname> mkdir archive

.

%Created dir flash:/archive.

<Sysname> system-view

[Sysname] archive configuration location flash:/archive filename-prefix my_archive

2.1.4  archive configuration max

【命令】

archive configuration max file-number

undo archive configuration max

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

file-number：表示可保存的备份配置文件数目上限，取值范围为1～10。该参数的具体数值应根据设备存储介质的空间大小来决定。对于存储空间较小的设备，建议设置file-number为较小值。

【描述】

archive configuration max命令用来设置系统允许保存的备份配置文件的最大数。undo archive configuration max用来恢复缺省情况。

缺省情况下，系统最多允许保存5个备份配置文件。

备份配置文件数目过多会占用系统内存空间，通过该命令可以控制备份配置文件的数目。当备份配置文件数目到达上限后，下次备份配置文件（包括自动和手动两种触发方式）时，将删除保存时间最早的备份文件，以保存新的备份配置文件。修改备份配置文件数上限时并不删除多余文件，如果当前已有的备份配置文件数大于或等于新设置的上限值，则在备份新的配置时，系统将自动删除生成时间最早的（当前已有备份配置文件数-新设置的上限值+1）个备份配置文件。（比如，当前已有备份配置文件数为7，新设置的上限值为4，当有配置需要备份时，系统会先删除“7-4+1=4”个生成时间最早的备份配置文件）

在使用该命令前，必须先执行archive configuration location命令设置保存路径和文件名前缀，否则，本命令执行失败。

需要注意的是，执行undo archive configuration location，系统最多允许保存的备份配置文件数目也会恢复到缺省情况。

【举例】

# 设置系统最大允许保存10个备份配置文件。

<Sysname> system-view

[Sysname] archive configuration max 10

2.1.5  backup startup-configuration

【命令】

backup startup-configuration to dest-addr [ dest-filename ]

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

dest-addr：TFTP服务器的IP地址或主机名，不支持IPv6。

dest-filename：目的文件名。在服务器上将以该文件名保存设备的启动配置文件。

【描述】

backup startup-configuration命令用于将设备的下次启动配置文件备份到指定的TFTP服务器。如果不指定目的文件名，则使用原文件名备份。

执行该命令仅对主用下次启动配置文件进行备份。

目前设备通过TFTP传输协议来实现备份操作。

【举例】

# 将设备的下次启动配置文件备份到IP地址为2.2.2.2的TFTP服务器上，文件名为192-168-1-26.cfg。

<Sysname> display startup

  Current startup saved-configuration file:          flash:/config.cfg

  Next startup saved-configuration file:             flash:/test.cfg

<Sysname> backup startup-configuration to 2.2.2.2 192-168-1-26.cfg

Backup next startup-configuration file to 2.2.2.2, please wait...finished!

<Sysname>

执行以上操作后，设备将文件test.cfg备份到TFTP服务器2.2.2.2上，在服务器上该文件的名称为192-168-1-26.cfg。

2.1.6  configuration replace file

【命令】

configuration replace file filename

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

filename：指定用来回滚配置的配置文件名。

【描述】

configuration replace file命令用来进行配置回滚。

执行本命令后，系统当前配置将恢复到指定配置文件（filename）中的配置状态。

【举例】

# 将当前配置回滚到配置文件my_archive_1.cfg中的配置状态。

<Sysname> system-view

[Sysname] configuration replace file my_archive_1.cfg

Info: Now replacing the current configuration. Please wait...

Info: Succeeded in replacing current configuration with the file my_archive_1.cfg.

2.1.7  display archive configuration

【命令】

display archive configuration

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display archive configuration命令用来显示配置回滚功能的相关信息。

【举例】

# 显示配置回滚功能的相关信息。

<Sysname> display archive configuration

Location: flash:/archive

Filename prefix: my_archive

Archive interval in minutes: 120

Maximum number of archive files: 10

Saved archive files:

  No. TimeStamp              FileName

  1   Aug 05 2007 20:24:54   my_archive_1.cfg

  2   Aug 05 2007 20:34:54   my_archive_2.cfg

# 3   Aug 05 2007 20:44:54   my_archive_3.cfg

‘#’ indicates the most recent archive file.

Next archive file to be saved: my_archive_4.cfg

表2-1 display archive configuration命令显示信息描述表

字段	描述
Location	保存备份配置文件的文件夹的绝对路径
Filename prefix	备份配置文件的文件名前缀
Archive interval in minutes	自动备份配置文件的时间间隔，以分钟为单位 若不自动备份配置文件，不显示此项
Maximum number of archive files	设备可保存的最大备份配置文件数目
Saved archive files	当前已保存的备份配置文件信息
No.	显示已保存的备份配置文件信息的行号
TimeStamp	备份配置文件的保存时间
FileName	备份配置文件名，不包含路径
‘#’ indicates the most recent archive file.	“#”表示该行描述的备份配置文件是最近一次备份的
Next archive file to be saved	下次保存备份配置文件将使用的文件名

 

2.1.8  display saved-configuration

【命令】

display saved-configuration [ by-linenum ]

【视图】

任意视图

【缺省级别】

2：系统级

【参数】

by-linenum：显示每一行信息的行号。

【描述】

display saved-configuration命令用来查看设备存储介质中保存的下次启动配置文件的内容。

可以在管理/维护设备时使用该命令确认重要的配置是否已经保存到下次启动配置文件。

如果设备未设置下次启动配置文件，或下次启动配置文件不存在，执行display saved-configuration命令时将没有信息显示。

相关配置可参考命令save、reset saved-configuration和“系统分册/系统基本配置命令”中的命令display current-configuration。

【举例】

# 显示设备存储介质中保存的下次启动配置文件的内容。

#

#

 version 5.20, Test 5310

#

 sysname Sysname

#

 domain default enable system

#

 telnet server enable

#

 multicast routing-enable

#

vlan 1

#

vlan 999

#

domain system

 access-limit disable

 state active

 idle-cut disable

 self-service-url disable

#

interface NULL0

#

  ---- More ----

以上显示的配置依次是全局配置、端口配置、用户接口配置。“---- More ----”表示这一屏信息已经显示完毕，会暂停显示。按<Enter>键将接着显示下一行信息；按<Space>键将接着显示下一屏的信息；按<Ctrl+C>或其它任意键将退出显示。

# 使用行号显示设备存储介质中保存的下次启动配置文件的内容。

<Sysname> display saved-configuration by-linenum

    1:  #

    2:   version 5.20, Test 5310

    3:  #

    4:   sysname Sysname

    5:  #

    6:   domain default enable system

    7:  #

    8:   telnet server enable

    9:  #

   10:   multicast routing-enable

   11:  #

   12:  vlan 1

   13:  #

   14:  vlan 999

   15:  #

   16:  domain system

   17:   access-limit disable

   18:   state active

   19:   idle-cut disable

   20:   self-service-url disable

   21:  #

   22:  interface NULL0

   23:  #

  ---- More ----

“---- More ----”表示这一屏信息已经显示完毕，会暂停显示。按<Enter>键将接着显示下一行信息；按<Space>键将接着显示下一屏信息；按<Ctrl+C>或其它任意键将退出显示。

2.1.9  display startup

【命令】

display startup

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display startup命令用来显示用于本次及下次启动相关的配置文件名。

相关配置可参考命令startup saved-configuration。

【举例】

# 显示本次及下次启动的配置文件名。

<Sysname> display startup

  Current startup saved-configuration file:          flash:/testcfg.cfg

  Next main startup saved-configuration file:        flash:/testcfg.cfg

  Next backup startup saved-configuration file:      NULL

表2-2 display startup命令显示信息描述表

域名	描述
Current Startup saved-configuration file	当前启动使用的配置文件
Next main startup saved-configuration file	下一次启动时使用的配置文件
Next backup startup saved-configuration file	下一次启动时使用的备用配置文件

 

2.1.10  reset saved-configuration

【命令】

reset saved-configuration [ backup | main ]

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

backup：删除备用下次启动配置文件。

main：删除主用下次启动配置文件。

【描述】

reset saved-configuration命令用来删除设备存储介质中保存的下次启动配置文件。

需要注意的是：

l              删除操作会将配置文件从设备上彻底删除，所以请慎用该命令。

l              如果当前设备的主备用下次启动配置文件相同，仅执行一次删除操作，系统只会将相应的下次启动配置文件设置为NULL，但不会删除该文件。

l              reset saved-configuration和reset saved-configuration main命令执行效果相同：都会删除主用下次启动配置文件。

相关配置可参考命令save和display saved-configuration。

【举例】

# 删除设备存储介质中保存的下次启动配置文件。

<Sysname> reset saved-configuration

The saved configuration file will be erased. Are you sure? [Y/N]:y

Configuration file in flash is being cleared.

Please wait ...........

 Configuration file is cleared.

2.1.11  restore startup-configuration

【命令】

restore startup-configuration from src-addr src-filename

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

src-addr：TFTP服务器的IP地址或名称，不支持IPv6。

src-filename：源文件名，指定服务器上将下载的文件的文件名。

【描述】

restore startup-configuration命令用于从指定TFTP服务器上下载配置文件并设置为设备的下次启动配置文件。

执行该命令设置的是主用下次启动配置文件。

【举例】

# 从IP地址为2.2.2.2的TFTP服务器上下载config.cfg文件作为设备的下次启动配置文件。

<Sysname> restore startup from 2.2.2.2 config.cfg

Restore next startup-configuration file from 2.2.2.2. Please wait............

finished!

2.1.12  save

【命令】

save file-url

save [ safely ] [ backup | main ]

【视图】

任意视图

【缺省级别】

2：系统级

【参数】

file-url：文件路径，文件名部分必须以“.cfg”为后缀。

safely：以安全模式保存配置文件。如果不指定该参数，表示以快速保存方式保存配置文件。

backup：将当前配置保存到交互方式下指定的文件中，并将该文件设置为备用下次启动配置文件。

main：将当前配置保存到交互方式下指定的文件中，并将该文件设置为主用下次启动配置文件。

【描述】

save file-url命令用来将当前配置保存到指定文件，但不会将该文件设置为下次启动配置文件。如果file-url不存在，则系统会先创建该文件，再执行保存操作。

save [ safely ] [ backup | main ]命令用来将当前配置保存到存储介质的根目录，并将该文件设置为下次启动配置文件。

相关配置可参考命令reset saved-configuration、display current-configuration和display saved-configuration。

【举例】

# 将当前配置文件保存到指定配置文件，但不将该文件设置为下次启动配置文件。

<Sysname> save test.cfg

The current configuration will be saved to flash:/test.cfg. Continue? [Y/N]:y

Now saving current configuration to the device.

Saving configuration flash:/test.cfg. Please wait...

............

Configuration is saved to flash successfully.

# 将当前配置保存到存储介质的根目录，并将该文件设置为下次启动配置文件。

<Sysname> display startup

 Current startup saved-configuration file: flash:/hmr.cfg

 Next main startup saved-configuration file: flash:/aa.cfg

 Next backup startup saved-configuration file: NULL

// 以上显示信息表明设备的主用下次启动文件为aa.cfg。

<Sysname> save

The current configuration will be written to the device. Are you sure? [Y/N]:y

Please input the file name(*.cfg)[flash:/aa.cfg]

(To leave the existing filename unchanged, press the enter key):startup.cfg

 Validating file. Please wait............

 Configuration is saved to device successfully.

<Sysname> display startup

 Current startup saved-configuration file: flash:/hmr.cfg

 Next main startup saved-configuration file: flash:/startup.cfg

 Next backup startup saved-configuration file: NULL

// 以上显示信息表明设备的主用下次启动文件已经变为startup.cfg。

2.1.13  startup saved-configuration

【命令】

startup saved-configuration cfgfile [ backup | main ]

undo startup saved-configuration

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

cfgfile：配置文件的文件名称，该文件必须是存储介质根目录下、后缀为.cfg的文件。

backup：将配置文件设置为备用下次启动配置文件。

main：将配置文件设置为主用下次启动配置文件。

【描述】

startup saved-configuration命令用来配置下次启动置文件（系统下次启动时使用的配置文件）。undo startup saved-configuration命令用来设置设备以空配置启动（空配置启动指使用设备的出厂配置启动）。

使用该命令设置配置文件时：

l              startup saved-configuration和startup saved-configuration main命令执行效果相同：都是用来配置主用下次启动配置文件。

l              主用下次启动配置文件和备用下次启动配置文件可以设置为同一文件，但为了更可靠，建议设置为不同的文件，或者将一份配置保存在两个不同名的文件中，一个设置为主用，一个设置为备用。

l              在执行undo startup saved-configuration命令之后，系统会将主用/备用下次启动配置文件均设置为NULL，但不会删除该文件。

相关配置可参考命令display startup。

【举例】

# 配置下次启动使用的配置文件。

<Sysname> startup saved-configuration testcfg.cfg

Please wait ....... Done!

 

3 FTP配置命令

3.1  FTP客户端配置命令

 

3.1.1  ascii

【命令】

ascii

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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

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

不同的操作系统对换行符的表示方法不同，比如H3C设备系统和Windows系统使用“/r/n”标志换行，在Linux系统中使用“/n”表示换行，所以在换行符表示方法不同的两个系统（比如Linux系统和H3C设备系统）间传输完文件后，要正确解析这些文件的话，必须遵循FTP传输模式规则。

FTP传输文件有两种模式：

l              二进制模式（又称为binary模式），用于传输程序文件或者图片。

l              ASCII码模式，用于传输文本文件。

相关配置可参考binary。

【举例】

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

[ftp] ascii

200 Type set to A.

3.1.2  binary

【命令】

binary

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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

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

相关配置可参考ascii。

【举例】

# 设置文件传输类型支持binary模式。

[ftp] binary

200 Type set to I.

3.1.3  bye

【命令】

bye

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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

相关命令可参见close、disconnect和quit。

【举例】

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

[ftp] bye

221 Server closing.

3.1.4  cd

【命令】

cd { directory | .. | / }

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

directory：指定目标工作路径。格式为[drive:][/]path。drive表示存储介质的名称，通常为flash或者cf。如果没有给出drive信息，则表示当前路径下的文件夹或者子文件夹。

..：返回上一级目录，其功能相当于cdup。如果当前的工作路径是根目录，或不存在上一级目录，则执行cd ..后保持当前的工作路径不变。该参数不支持命令行在线帮助。

/：返回存储介质的根目录。该参数不支持命令行在线帮助。

【描述】

cd命令用来切换远程FTP服务器上的工作路径。

用户访问FTP服务器上的另一目录时，可使用本命令。需要注意的是，用户可以访问的目录只能是FTP服务器对用户已经授权的目录。

相关命令可参考pwd。

【举例】

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

[ftp] cd logfile

250 CWD command successful.

# 切换工作路径到授权目录下的folder子目录。

[ftp] cd /folder

250 CWD command successful.

3.1.5  cdup

【命令】

cdup

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

cdup命令用来退出远程FTP服务器的当前目录，返回FTP服务器的上一级目录。

如果当前目录已经是授权目录（即work-directory），执行该命令，工作路径将不再更改。

相关命令可参考cd和pwd。

【举例】

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

[ftp] pwd

257 "/ftp/subdir" is current directory.

[ftp] cdup

200 CDUP command successful.

[ftp] pwd

257 "/ftp" is current directory.

3.1.6  close

【命令】

close

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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

该命令的功能与disconnect命令相同。

【举例】

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

[ftp] close

221 Service closing control connection

[ftp]

3.1.7  debugging

【命令】

debugging

undo debugging

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

debugging命令用来打开FTP客户端调试信息开关。undo debugging命令用来关闭FTP客户端调试信息开关。

缺省情况下，FTP客户端调试信息开关处于关闭状态。

【举例】

# 设备作为FTP客户端，成功登录后，打开设备的FTP客户端调试信息开关，使用主动模式下载FTP服务器当前目录下的sample.file文件。

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

表3-1 debugging命令显示信息描述表

字段	描述
---> PORT	发出FTP指令，数据端口号为
The parsed reply is	收到的FTP应答码。FTP应答码由RFC 959规定
---> RETR	下载文件
FTPC: File transfer started with the signal light turned on.	开始文件传输，打开文件传输指示灯
FTPC: File transfer completed with the signal light turned off.	文件传输结束，关闭文件传输指示灯

 

3.1.8  delete

【命令】

delete remotefile

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

remotefile：文件名，为1～256个字符的字符串。

【描述】

delete命令用来彻底删除远程FTP服务器上的指定文件，删除的文件不能被恢复。

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

【举例】

# 删除文件temp.c。

[ftp] delete temp.c

250 DELE command successful.

3.1.9  dir

【命令】

dir [ remotefile [ localfile ] ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

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

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

【描述】

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

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

dir remotefile localfile命令用来查看远程FTP服务器上指定目录或文件的详细信息，并把查看结果（找到的目录或文件的详细信息）保存在本地以localfile命名的文件中。

 

【举例】

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

[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]

# 查看文件ar-router.cfg，并将查询结果保存在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. 

# 查看aa.txt文件的内容。

[ftp] quit

<Sysname> more aa.txt

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

3.1.10  disconnect

【命令】

disconnect

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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

该命令的功能与close命令相同。

【举例】

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

[ftp] disconnect

221 Server closing.

3.1.11  display ftp client configuration

【命令】

display ftp client configuration

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display ftp client configuration命令用来显示FTP客户端的配置信息。

相关配置可参考命令ftp client source。

【举例】

# 显示FTP客户端的当前配置信息。

<Sysname> display ftp client configuration

The source IP address is 192.168.0.123

 

3.1.12  ftp

【命令】

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

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

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

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

interface interface-type interface-number：当前FTP客户端连接使用的源接口，包括接口类型和接口编号。此接口下配置的主IP地址即为发送报文的源地址。如果源接口下没有配置主地址，连接失败。

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

【描述】

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

需要注意的是：

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

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

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

l              本命令指定的源地址的优先级高于ftp client source命令配置的源地址的优先级。如果执行ftp client source命令指定了源地址后，又在ftp命令中指定了源地址，则采用ftp命令中指定的源地址进行通信。

相关配置可参考命令ftp client source。

【举例】

# 使用FTP方式，从当前设备Sysname1登录到设备Sysname2（IP地址为192.168.0.211），并且FTP发送报文的源IP地址为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]

3.1.13  ftp client source

【命令】

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

undo ftp client source

【视图】

系统视图

【缺省级别】

2：系统级

【参数】

interface interface-type interface-number：FTP连接使用的源接口，包括接口类型和接口编号。源接口下配置的主IP地址即为FTP发送报文的源地址。如果源接口下没有主地址，会导致连接失败。

ip source-ip-address：FTP连接使用的源IP地址。该地址必须是设备上已配置的IP地址。

【描述】

ftp client source命令用来配置FTP客户端发送的FTP报文的源地址。undo ftp client source命令用来恢复缺省情况。

缺省情况下，设备使用路由决定的源地址与FTP服务器通信。

需要注意的是：

l              源地址包括源接口和源IP，如果先后使用ftp client source命令指定了源接口和源IP，新指定的源IP将覆盖现有的源接口配置。反之亦然。

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

l              ftp client source命令指定的源地址对所有的ftp连接有效，ftp命令指定的源地址只对当前的ftp连接有效。

相关配置可参考命令display ftp client configuration。

【举例】

# 指定FTP客户端的源IP地址为2.2.2.2。

<Sysname> system-view

[Sysname] ftp client source ip 2.2.2.2

# 指定FTP客户端的源接口为Vlan-interface 1。

<Sysname> system-view

[Sysname] ftp client source interface Vlan-interface 1

3.1.14  ftp ipv6

【命令】

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

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

server-address：远端设备的IP地址或主机名。

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

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

-i interface-type interface-number：出接口的接口类型和接口编号。此参数只用于FTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址（链路本地地址的介绍和配置请参见“IP业务分册”中的“IPv6基础配置”）

【描述】

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

需要注意的是：

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

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

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

【举例】

# 登录到IPv6地址为3000::200的远程FTP服务器。

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

3.1.15  get

【命令】

get remotefile [ localfile ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

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

localfile：将文件下载到本地保存时使用的文件名称。如不使用该参数，将使用源文件名称作为本地文件名称保存到用户执行ftp命令时的当前工作路径。

【描述】

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

【举例】

# 下载testcfg.cfg文件，并以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.

3.1.16  lcd

【命令】

lcd

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

lcd命令用来获取FTP客户端本地的工作路径。

【举例】

# 显示本地的工作路径。

[ftp] lcd

FTP: Local directory now flash:/clienttemp

以上信息表明FTP客户端在执行ftp命令前的工作路径是flash:/clienttemp。

3.1.17  ls

【命令】

ls [ remotefile [ localfile ] ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

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

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

【描述】

ls命令用来查询远程FTP服务器上当前目录下的子目录及文件，系统将列出当前目录下的所有子目录及文件的名称。

ls remotefile命令用来查询远程FTP服务器上的指定目录或文件，系统将列出找到的目录或文件的名称。

ls remotefile localfile命令用来查询远程FTP服务器上指定的目录或文件，并把查询结果（找到的目录或文件的名称）保存到本地以localfile命名的文件中。

 

【举例】

# 查询FTP服务器上当前目录下的所有子目录及文件。

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

# 查询FTP服务器上的子目录logfile，并将查询结果保存在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.

# 查看aa.txt文件的内容。

[ftp] quit

<Sysname> more aa.txt

.

..

logfile.log

3.1.18  mkdir

【命令】

mkdir directory

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

directory：待创建的目录名称。

【描述】

mkdir命令用来在远程FTP服务器上指定目录下创建子目录。

只有获得远程FTP服务器授权的客户端用户才能执行此项操作。

【举例】

# 在远程FTP服务器的当前目录下创建子目录mytest。

[ftp] mkdir mytest

257 MKD.command sucessful 

3.1.19  open

【命令】

open server-address [ service-port ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

server-address：远端设备的IP地址或主机名。

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

【描述】

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

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

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

相关配置请参考命令close。

【举例】

# 在FTP Client视图下，登录远程FTP服务器（IP地址为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]

3.1.20  open ipv6

【命令】

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

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

server-address：远端设备的IP地址或主机名。

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

-i interface-type interface-number：出接口的接口类型和接口编号。此参数只用于FTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址（链路本地地址的介绍和配置请参见“IP业务分册”中的“IPv6基础配置”）

【描述】

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

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

相关配置请参考命令close。

【举例】

# 在FTP Client视图下，登录FTP服务器（IPv6地址为3000::200）。

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

3.1.21  passive

【命令】

passive

undo passive

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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

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

数据传输的方式分为：主动方式和被动方式。主动方式是指在建立数据连接时由服务器主动发起连接请求；被动方式是指在建立数据连接时由客户端主动发起连接请求。该命令主要与防火墙功能配合使用，以便限制私网和公网用户之间建立FTP会话。

【举例】

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

[ftp] passive

FTP: passive is on

3.1.22  put

【命令】

put localfile [ remotefile ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

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

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

【描述】

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

如果用户没有指定远程服务器上的文件名，则系统缺省认为此文件名与本地文件名相同。文件上传后将保存在用户的授权路径，该路径可以使用authorization-attribute命令来设置。

【举例】

# 将本地cc.txt文件上传到远程FTP服务器，并以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.

3.1.23  pwd

【命令】

pwd

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

pwd命令用来显示当前用户正在访问的远程FTP服务器上的路径。

【举例】

# 显示当前用户正在访问的远程FTP服务器上的路径。

[ftp] cd servertemp

[ftp] pwd

257 "/servertemp" is current directory.

以上显示信息表明当前用户正在访问FTP服务器根目录下的servertemp文件夹。

3.1.24  quit

【命令】

quit

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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

【举例】

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

[ftp] quit

221 Server closing. 

 

<Sysname>

3.1.25  remotehelp

【命令】

remotehelp [ protocol-command ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

protocol-command：FTP协议命令。

【描述】

remotehelp命令用来显示远程FTP服务器支持的FTP相关协议命令的帮助信息。

如果不指定协议命令参数，则显示远程FTP服务器支持的FTP相关协议命令。

【举例】

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

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

# 查看协议命令user的帮助信息。

[ftp] remotehelp user

214 Syntax: USER <sp> <username>.

 

[ftp]

表3-2 remotehelp命令显示信息描述表

字段	描述
214-Here is a list of available ftp commands	以下是可用的FTP命令列表
Those with '*' are not yet implemented.	带星号“*”的命令功能目前还没实现
USER	用户名
PASS	用户口令
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	扩展命令，含义同CUP
XCWD	扩展命令，含义同CWD
XMKD	扩展命令，含义同MKD
XPWD	扩展命令，含义同PWD
XRMD	扩展命令，含义同RMD
Syntax: USER <sp> <username>.	USER命令的语法：user（关键字）+空格+用户名

 

3.1.26  rmdir

【命令】

rmdir directory

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

directory：远程FTP服务器上的目录名，为1~256个字符的字符串。

【描述】

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

只有获得远程FTP服务器授权的客户端用户才能执行此项操作。

需要注意的是：

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

l              成功执行rmdir后，远程回收站中原来属于该文件夹的文件会自动被彻底删除。

【举例】

# 删除FTP服务器上的授权目录下的temp1目录。

[ftp] rmdir /temp1

200 RMD command successful.

3.1.27  user

【命令】

user username [ password ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

username：其他的登录用户名。

password：登录密码。

【描述】

user命令用来在成功登录FTP服务器后，使用其他用户身份重新登录当前访问的FTP服务器。

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

【举例】

# 用户ftp1已经登录FTP服务器，现以ftp2的身份重新访问当前FTP服务器。（假设用户名ftp2及其登录密码123123123123已经在FTP服务器设置完毕）

[ftp] user ftp2

331 Password required for ftp2.

Password:

230 User logged in.

 

[ftp]

3.1.28  verbose

【命令】

verbose

undo verbose

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

verbose命令用来打开FTP协议信息开关，使能显示FTP服务器返回的详细信息。undo verbose命令用来关闭verbose开关，禁止显示FTP服务器返回的详细信息。

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

【举例】

# 打开FTP协议信息开关。

[ftp] verbose

FTP: verbose is on

# 关闭FTP协议信息开关时，执行get操作。

[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]

# 打开FTP协议信息开关时，执行get操作。

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

 

4 TFTP配置命令

4.1  TFTP客户端配置命令

4.1.1  display tftp client configuration

【命令】

display tftp client configuration

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display tftp client configuration命令用来显示TFTP客户端的配置信息。

相关配置可参考命令tftp client source。

【举例】

# 显示TFTP客户端的当前配置信息。

<Sysname> display tftp client configuration

The source IP address is 192.168.0.123

 

4.1.2  tftp-server acl

【命令】

tftp-server [ ipv6 ] acl acl-number

undo tftp-server [ ipv6 ] acl

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

ipv6：TFTP服务支持IPv6协议。不带该参数，表示使用IPv4协议。

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

【描述】

tftp-server acl命令用来使用ACL限制设备可访问哪些TFTP服务器。undo tftp-server ipv6 acl命令用来恢复缺省情况。

缺省情况下，没有使用ACL限制TFTP服务器。

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

ACL的相关内容请参见“ACL分册”中的“ACL配置”和“ACL命令”。

【举例】

# 在IPv4组网环境下，仅允许设备访问IP地址为1.1.1.1的TFTP server，不能访问其它TFTP server。

<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

# 在IPv6组网环境下，仅允许设备访问IP地址为2001::1的TFTP server，不能访问其它TFTP server。

<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

4.1.3  tftp

【命令】

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

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

server-address：TFTP服务器的IP地址或主机名。

get：表示普通下载文件操作。

put：表示上传文件操作。

sget：表示安全下载文件操作。

source-filename：源文件名。

destination-filename：目标文件名。

source：配置源地址绑定参数。

l              interface interface-type interface-number：当前TFTP客户端传输使用的源接口，包括接口类型和接口编号。此接口下配置的主IP地址即为发送报文的源地址。如果源接口下没有配置主地址，传输失败。

l              ip source-ip-address：当前TFTP客户端发送报文所使用的源IP地址。此地址必须是设备上已配置的IP地址。

【描述】

tftp命令用来实现从本地设备上传文件到TFTP服务器或从TFTP服务器下载文件至本地设备。

l              如果没有指定本地文件名，则使用与远程FTP服务器上相同的文件名保存到用户的当前工作路径（即执行tftp命令时的工作路径）。

l              本命令指定的源地址的优先级高于tftp client source命令配置的源地址的优先级。如果执行tftp client source命令指定了源地址后，又在tftp命令中指定了源地址，则采用tftp命令中指定的源地址进行通信。

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

相关配置可参考命令tftp client source。

【举例】

# 将TFTP服务器根目录下的config.cfg文件下载到本地存储设备。TFTP服务器的IP地址为192.168.0.98，下载到本地之后以文件名config.bak保存，指定源IP地址为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.

# 将设备存储器的文本文件config.cfg上传到TFTP服务器缺省路径下。TFTP服务器的IP地址为192.168.0.98，config.cfg文件在TFTP服务器上以文件名config.bak保存，指定源接口为Ethernet1/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.

4.1.4  tftp client source

【命令】

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

undo tftp client source

【视图】

系统视图

【缺省级别】

2：系统级

【参数】

interface interface-type interface-number：设置TFTP传输使用的源接口，包括接口类型和接口编号。源接口下配置的主IP地址即为发送报文的源地址。如果源接口下没有配置地址，会导致传输失败。

ip source-ip-address：设置当前TFTP客户端发送报文所使用的源IP地址。该地址必须是设备上已配置的IP地址。

【描述】

tftp client source命令用来配置TFTP客户端发送的TFTP报文的源地址。undo telnet client source命令用来恢复缺省情况。

缺省情况下，设备使用路由决定的源地址与TFTP服务器通信。

需要注意的是：

l              源地址包括源接口和源IP，如果先后使用tftp client source命令指定了源接口和源IP，新指定的源IP将覆盖现有的源接口配置。反之亦然。

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

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

相关配置可参考命令display tftp client configuration。

【举例】

# 指定TFTP客户端的源IP地址为2.2.2.2。

<Sysname> system-view

[Sysname] tftp client source ip 2.2.2.2

# 指定TFTP客户端的源接口为Vlan-ingterface1。

<Sysname> system-view

[Sysname] tftp client source interface Vlan-interface 1

4.1.5  tftp ipv6

【命令】

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

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

tftp-ipv6-server：TFTP服务器的IPv6地址或主机名（主机名为1～46个字符的字符串）。

-i interface-type interface-number：出接口的接口类型和接口编号。此参数只用于TFTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址（链路本地地址的介绍和配置请参见“IP业务分册”中的“IPv6基础配置”）。

get：执行下载文件操作。

put：执行上传文件操作。

source-filename：源文件的名称，为1~135个字符的字符串。

destination-filename：目的文件的名称。如果不指定该参数，则目的文件的名称与源文件的名称相同，为1~135个字符的字符串。

【描述】

tftp ipv6命令用来执行下列操作：

l              下载文件操作：将TFTP服务器上的指定源文件下载到本地。

l              上传文件操作：将本地的指定源文件上传到TFTP服务器。

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

【举例】

# 从TFTP服务器下载文件filetoget.txt。

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