Contents

File system management commands· 1

cd· 2

copy· 2

delete· 4

dir 5

file prompt 6

format 7

gunzip· 8

gzip· 8

md5sum·· 9

mkdir 9

more· 10

move· 11

pwd· 11

rename· 12

reset recycle-bin· 12

rmdir 13

sha256sum·· 13

tar create· 14

tar extract 15

tar list 16

undelete· 16

 

File system management commands

IMPORTANT: ·     Before managing storage media, file systems, files, and directories, make sure you know the possible impacts. ·     A file or directory whose name starts with a dot character (.) is a hidden file or directory. To prevent the system from hiding a file or directory, make sure the file or directory name does not start with a dot character. ·     Some system files and directories are hidden. For correct system operation and full functionality, do not modify or delete hidden files or directories.

 

File system names, directory names, or file names must be compliant with the naming conventions. For more information about the naming conventions   and the methods for specifying the names, see Fundamentals Configuration Guide.

Before you use the copy, delete, fixdisk, format, gunzip, gzip, mkdir, move, rename, rmdir, or undelete command on a USB disk, make sure the disk is not write protected.

You cannot access a file system that is being formatted or repaired. To access a file system after it is formatted or repaired, use one of the following methods:

·     Use the absolute path to specify a file or directory. For example, use the dir flash:/ command to display the files and directories in the file system on the flash memory.

·     Use the cd command to change the working directory to the root directory of the file system before accessing a file or directory in the file system. For example, to display the files and directories in the root directory of the file system on the flash memory, perform the following tasks:

a.     Use the cd flash:/ command to change the working directory to the root directory of the file system.

b.     Execute the dir command.

The following matrix shows the supported storage medium types:

 

Hardware series	Model	Storage medium types
WX1800H series	WX1804H WX1810H WX1820H	Flash memory
WX2500H series	WX2510H WX2540H WX2560H	Flash memory
WX3000H series	WX3010H-X	CF card
	WX3010H WX3010H-L WX3024H WX3024H-L	Flash memory
WX3500H series	WX3508H	Flash memory
	WX3510H WX3520H WX3540H	CF card
WX5500E series	WX5510E WX5540E	CF card
WX5500H series	WX5540H WX5560H WX5580H	CF card
Access controller modules	EWPXM1MAC0F EWPXM1WCME0 EWPXM2WCMD0F LSQM1WCMX20 LSQM1WCMX40 LSUM1WCME0 LSUM1WCMX20RT LSUM1WCMX40RT	CF card

 

The examples in this chapter use the flash memory as the storage medium.

The WX1800H series, WX2500H series, and WX3000H series access controllers do not support the slot keyword or the slot-number argument.

cd

Use cd to change the working directory.

Syntax

cd { directory | .. }

Views

User view

Predefined user roles

network-admin

Parameters

directory: Specifies the destination directory.

..: Specifies the parent directory. If the working directory is the root directory, an error message appears when you execute the cd .. command. No online help information is available for this keyword.

Examples

# Access the test directory after logging in to the device.

<Sysname> cd test

# Change to the parent directory.

<Sysname> cd ..

copy

Use copy to copy a file.

Syntax

copy source-file { dest-file | dest-directory } [ source interface interface-type interface-number ]

Views

User view

Predefined user roles

network-admin

Parameters

source-file: Specifies the name or URL of the file to be copied. If the file resides on an FTP or TFTP server rather than on the device, specify the URL of the file. Whether a URL is case sensitive depends on the server.

{ dest-file | dest-directory }: Specifies the name or URL of the destination file or directory. To copy the source file to an FTP or TFTP server, specify a URL. If you specify a directory, the device copies the specified file to the directory and saves it with its original file name. Whether a URL is case sensitive depends on the server.

source interface interface-type interface-number: Specifies the source interface used to connect to the server. After you specify the source interface, the device uses the primary IP address of the source interface as the source IP address for outgoing packets. If you do not specify this option, the device uses the outgoing interface as the source interface.

Usage guidelines

You can use the copy command to perform the following tasks:

·     Copy a local file and save it locally.

·     Copy a local file and save it to an FTP or TFTP server.

·     Copy a file on an FTP or TFTP server and save it locally.

To specify a file or directory, use the following guidelines:

 

Location	Name format	Remarks
On the device	Use the file name guidelines in Fundamentals Configuration Guide.	N/A
On an FTP server	Enter the URL in the format of ftp://FTP username[:password]@server address[:port number]/file path[/file name].	The username and password must be the same as those configured on the FTP server. If the server authenticates users only by the username, you are not required to enter the password. For example, to use the username 1 and password 1 and specify the startup.cfg file in the authorized working directory on FTP server 1.1.1.1, enter ftp://1:[email protected]/startup.cfg. To specify an IPv6 address, enclose the IPv6 address in square brackets ([ ]), for example, ftp://test:test@[2001::1]:21/test.cfg.
On a TFTP server	Enter the URL in the format of tftp://server address[:port number]/file path[/file name].	For example, to specify the startup.cfg file in the working directory on TFTP server 1.1.1.1, enter the URL tftp://1.1.1.1/startup.cfg. To enter an IPv6 address, enclose the IPv6 address in square brackets ([ ]), for example, tftp://[2001::1]:21/test.cfg.

 

Examples

# Copy the test.cfg file in the current directory and save it to the current directory as testbackup.cfg.

<Sysname> copy test.cfg testbackup.cfg

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

Copying file flash:/test.cfg to flash:/testbackup.cfg...Done.

delete

Use delete to delete a file.

Syntax

delete [ /unreserved ] file

Views

User view

Predefined user roles

network-admin

Parameters

/unreserved: Permanently deletes the specified file. If you do not specify this keyword, the command moves the file to the recycle bin.

file: Specifies the name of the file to be deleted. Asterisks (*) are acceptable as wildcards. For example, to remove files with the .txt extension in the current directory, enter delete *.txt.

Usage guidelines

Use the delete /unreserved file command with caution. You cannot restore a file that was deleted with this command.

The delete file command (without /unreserved) moves the specified file to the recycle bin if the file system has sufficient storage space. If the file system is running out of storage space, the command permanently deletes the file.

A file moved to the recycle bin can be restored by using the undelete command.

Do not use the delete command to delete files from the recycle bin. To delete files from the recycle bin, use the reset recycle-bin command.

If you delete two files that have the same name from different directories, both files are retained in the recycle bin. If you successively delete two files that have the same name from the same directory, only the most recently deleted file is retained in the recycle bin.

Examples

# Remove file 1.cfg from the current directory.

<Sysname> delete 1.cfg

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

Deleting file flash:/1.cfg...Done.

# Permanently delete file 1.cfg from the current directory.

<Sysname> delete /unreserved 1.cfg

The file cannot be restored. Delete flash:/1.cfg? [Y/N]:y

Deleting the file permanently will take a long time. Please wait...

Deleting file flash:/1.cfg...Done.

# (IRF-capable devices.) Remove file 1.cfg from the current directory.

<Sysname> delete 1.cfg

Delete cfa0:/1.cfg? [Y/N]:y

Deleting file cfa0:/1.cfg...Done.

# (IRF-capable devices.) Permanently delete file 2.cfg from the root directory of the cfa0: file system on the master.

<Sysname> delete /unreserved 2.cfg

The file cannot be restored. Delete cfa0:/2.cfg? [Y/N]:y

Deleting the file permanently will take a long time. Please wait...

Deleting file cfa0:/2.cfg...Done.

# (IRF-capable devices.) Remove file 1.cfg from the root directory of the cfa0: file system on the subordinate member with the member ID 2.

·     Method 1:

<Sysname> delete slot2#cfa0:/1.cfg

Delete slot2#cfa0:/1.cfg? [Y/N]:y

Deleting file delete slot2#cfa0:/1.cfg...Done.

·     Method 2:

<Sysname> cd slot2#cfa0:/

<Sysname> delete 1.cfg

Delete slot2#cfa0:/1.cfg? [Y/N]:y

Deleting file slot2#cfa0:/1.cfg...Done.

Related commands

·     reset recycle-bin

·     undelete

dir

Use dir to display files or directories.

Syntax

dir [ /all ] [ file | directory | /all-filesystems ]

Views

User view

Predefined user roles

network-admin

Parameters

/all: Displays all files and directories in the current directory, visible or hidden. If you do not specify this option, only visible files and directories are displayed.

file: Displays a specific file. This argument can use the asterisk (*) as a wildcard. For example, to display files with the .txt extension in the current directory, enter dir *.txt.

directory: Displays a specific directory.

/all-filesystems: Displays files and directories in the root directories of all file systems on the device.

Usage guidelines

If no option is specified, the command displays all visible files and directories in the current directory.

The directory name of the recycle bin is .trash. To display files in the recycle bin, use either of the following methods:

·     Execute the dir /all .trash command.

·     Execute the cd .trash command and then the dir command.

Examples

# Display information about all files and directories in the current directory.

<Sysname> dir /all

Directory of flash:/

...

# Display files and directories in the root directories of all file systems on the device.

<Sysname> dir /all-filesystems

Directory of flash:/

...

# (IRF-capable devices.) Display information about all files and directories in the cfa0: file system on the master.

<Sysname> dir /all

Directory of cfa0:/

...

# (IRF-capable devices.) Display files and directories in the root directories of all file systems in the IRF fabric.

<Sysname> dir /all-filesystems

Directory of cfa0:/

...

 

Directory of slot1#cfa0:/

...

# (IRF-capable devices.) Display information about all files and directories in the cfa0: file system of the subordinate member with the member ID 2.

<Sysname> cd slot2#cfa0:/

<Sysname> dir /all

Directory of slot2#cfa0:/

...

Table 1 Command output

Field	Description
Directory of	Current directory.
0     -rwh      3144  Apr 26 2014 13:45:28   xx.xx	File or directory information: ·     0—File or directory number, which is automatically allocated by the system. ·     -rwh—Attributes of the file or directory. The first character is the directory indicator (d for directory and – for file). The second character indicates whether the file or directory is readable (r for readable). The third character indicates whether the file or directory is writable (w for writable). The fourth character indicates whether the file or directory is hidden (h for hidden, - for visible). Modifying, renaming, or deleting hidden files might affect functions. ·     3144—File size in bytes. For a directory, a hyphen (-) is displayed. ·     Apr 26 2014 13:45:28—Last date and time when the file or directory was modified. ·     xx.xx—File or directory name.

 

file prompt

Use file prompt to set the operation mode for files and directories.

Use undo file prompt to restore the default.

Syntax

file prompt { alert | quiet }

undo file prompt

Default

The operation mode is alert. The system prompts for confirmation when you perform a destructive file or directory operation.

Views

System view

Predefined user roles

network-admin

Parameters

alert: Prompts for confirmation when a destructive file or directory operation is being performed.

quiet: Gives no confirmation prompt for file or directory operations.

Usage guidelines

In quiet mode, the system does not prompt for confirmation when a user performs a file or directory operation. The alert mode provides an opportunity to cancel a disruptive operation.

Examples

# Set the file and directory operation mode to alert.

<Sysname> system-view

[Sysname] file prompt alert

format

Use format to format a file system.

Syntax

format filesystem

Views

User view

Predefined user roles

network-admin

Parameters

filesystem: Specifies the name of a file system.

Usage guidelines

Formatting a file system permanently deletes all files in the file system. If a startup configuration file exists in the file system, back it up if necessary.

You can format a file system only when no other users are accessing the medium.

Examples

# Format the file system flash:.

<Sysname> format flash:

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

Formatting flash:... Done.

gunzip

Use gunzip to decompress a file.

Syntax

gunzip file

Views

User view

Predefined user roles

network-admin

Parameters

file: Specifies the name of the file to be decompressed. This argument must have .gz as the extension.

Usage guidelines

This command deletes the specified file after decompressing it.

Examples

# Decompress the file system.bin.gz:

1.     Before decompressing the file, you can display files whose names start with the system. string.

<Sysname> dir system.*

Directory of flash:

   1 -rw-          20 Jun 14 2012 10:18:53   system.bin.gz

472972 KB total (472840 KB free)

2.     Decompress the file system.bin.gz.

<Sysname> gunzip system.bin.gz

Decompressing file flash:/system.bin.gz..... Done.

3.     Verify the decompress operation.

<Sysname> dir system.*

Directory of flash:

   1 -rw-           0 May 30 2012 11:42:25   system.bin

472972 KB total (472844 KB free)

gzip

Use gzip to compress a file.

Syntax

gzip file

Views

User view

Predefined user roles

network-admin

Parameters

file: Specifies the name of the file to be compressed. The compressed file will be saved to the file.gz file.

Usage guidelines

This command deletes the specified file after compressing it.

Examples

# Compress the file system.bin:

1.     Before compressing the file, you can display files whose names start with system.

<Sysname> dir system.*

Directory of flash:

   1 -rw-           0 May 30 2012 11:42:24   system.bin

472972 KB total (472844 KB free)

2.     Compress the file system.bin.

<Sysname> gzip system.bin

Compressing file flash:/system.bin..... Done.

3.     Verify the compress operation.

<Sysname> dir system.*

Directory of flash:

   1 -rw-          20 Jun 14 2012 10:18:53   system.bin.gz

472972 KB total (472840 KB free)

md5sum

Use md5sum to use the MD5 algorithm to calculate the digest of a file.

Syntax

md5sum file

Views

User view

Predefined user roles

network-admin

network-operator

Parameters

file: Specifies the name of a file.

Usage guidelines

You can use file digests to verify file integrity.

Examples

# Use the MD5 algorithm to calculate the digest of file system.bin.

<Sysname> md5sum system.bin

MD5 digest:

4f22b6190d151a167105df61c35f0917

mkdir

Use mkdir to create a directory in the current directory.

Syntax

mkdir directory

Views

User view

Predefined user roles

network-admin

Parameters

directory: Specifies a directory.

Usage guidelines

The name of the directory to be created must be unique in the specified directory.

You can create a directory only in an existing directory. For example, to create the flash:/test/mytest directory, make sure the test directory already exists.

Examples

# Create the test directory in the current directory.

<Sysname> mkdir test

Creating directory flash:/test... Done.

# Create the test/subtest directory in the current directory.

<Sysname> mkdir test/subtest

Creating directory flash:/test/subtest... Done.

more

Use more to display the contents of a text file.

Syntax

more file

Views

User view

Predefined user roles

network-admin

Parameters

file: Specifies the name of a file.

Examples

# Display the contents of the test.txt file.

<Sysname> more test.txt

Have a nice day.

# Display the contents of the testcfg.cfg file.

<Sysname> more testcfg.cfg

 

#

version 7.1.064, ESS 5103

#

 sysname Sysname

#

  ---- More ----

move

Use move to move a file.

Syntax

move source-file { dest-file | dest-directory }

Views

User view

Predefined user roles

network-admin

Parameters

source-file: Specifies the name of the source file.

dest-file: Specifies the name of the destination file.

dest-directory: Specifies the name of the destination directory.

Usage guidelines

If you specify a destination directory, the system moves the source file to the specified directory without changing the file name.

Examples

# Move the flash:/test/sample.txt file to flash:/, and save it as 1.txt.

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

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

Moving file flash:/test/sample.txt to flash:/1.txt ...Done.

# Move the b.cfg file to the directory test2.

<Sysname> move b.cfg test2

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

Moving file flash:/b.cfg to flash:/test2/b.cfg... Done.

pwd

Use pwd to display the working directory.

Syntax

pwd

Views

User view

Predefined user roles

network-admin

Examples

# Display the working directory.

<Sysname> pwd

flash:

rename

Use rename to rename a file or directory.

Syntax

rename { source-file | source-directory } { dest-file | dest-directory }

Views

User view

Predefined user roles

network-admin

Parameters

source-file: Specifies the name of the source file.

source-directory: Specifies the name of the source directory.

dest-file: Specifies the name of the destination file.

dest-directory: Specifies the name of the destination directory.

Usage guidelines

This command is not executed if the destination file or directory name is already used by an existing file or directory in the working directory.

Examples

# Rename the copy.cfg file as test.cfg.

<Sysname> rename copy.cfg test.cfg

Rename flash:/copy.cfg as flash:/test.cfg? [Y/N]:y

Renaming flash:/copy.cfg as flash:/test.cfg... Done.

reset recycle-bin

Use reset recycle-bin to delete files from the recycle bin.

Syntax

reset recycle-bin [ /force ]

Views

User view

Predefined user roles

network-admin

Parameters

/force: Deletes all files in the recycle bin without prompting for confirmation. If you do not specify this option, the command prompts you to confirm the deletion.

Usage guidelines

The delete file command only moves a file to the recycle bin. To permanently delete the file, use the reset recycle-bin command to clear the recycle bin.

If a file is corrupted, you might not be able to delete the file by using the reset recycle-bin command. In this case, use the reset recycle-bin /force command.

Examples

# Empty the recycle bin. (In this example there are two files in the recycle bin.)

<Sysname> reset recycle-bin

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

Clearing file flash:/a.cfg... Done.

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

Clearing file flash:/b.cfg... Done.

# Delete the b.cfg file from the recycle bin. (In this example there are two files in the recycle bin.)

<Sysname> reset recycle-bin

Clear flash:/a.cfg? [Y/N]:n

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

Clearing file flash:/b.cfg... Done.

Related commands

delete

rmdir

Use rmdir to delete a directory.

Syntax

rmdir directory

Views

User view

Predefined user roles

network-admin

Parameters

directory: Specifies a directory.

Usage guidelines

To delete a directory, you must delete all files and subdirectories in the directory permanently or move them to the recycle bin. If you move them to the recycle bin, executing the rmdir command permanently deletes them.

Examples

# Delete the subtest directory.

<Sysname> rmdir subtest/

Remove directory flash:/test/subtest and the files in the recycle-bin under this directory will be deleted permanently. Continue? [Y/N]:y

Removing directory flash:/test/subtest... Done.

sha256sum

Use sha256sum to use the SHA-256 algorithm to calculate the digest of a file.

Syntax

sha256sum file

Views

User view

Predefined user roles

network-admin

Parameters

file: Specifies the name of a file.

Usage guidelines

You can use file digests to verify file integrity.

Examples

# Use the SHA-256 algorithm to calculate the digest of file system.bin.

<Sysname> sha256sum system.bin

SHA256 digest:

0851e0139f2770e87d01ee8c2995ca9e59a8f5f4062e99af14b141b1a36ca152

tar create

Use tar create to archive files and directories.

Syntax

tar create [ gz ] archive-file dest-file [ verbose ] source { source-file | source-directory }&<1-5>

Views

User view

Predefined user roles

network-admin

Parameters

gz: Uses gzip to compress the files and directories before archiving them. If you do not specify this keyword, the command archives the files and directories without compressing them.

archive-file dest-file: Specifies the archive file name. If you specified the gz keyword, the suffix of the archive file name must be .tar.gz. If you did not specify the gz keyword, the suffix of the archive file name must be .tar.

verbose: Displays the names of the successfully archived files and directories. If you do not specify this keyword, the command does not display the names of the successfully archived files and directories.

source { source-file | source-directory }&<1-5>: Specifies the files and directories to be archived. The argument can be a space-separated list of up to five items. Each item can be a file or directory name.

Examples

# Archive the files 1.cfg, 2.cfg, and the directory test to the file a.tar.

<Sysname> tar create archive-file a.tar source 1.cfg 2.cfg test

Creating archive flash:/a.tar Done.

# Compress and archive the files 1.cfg, 2.cfg, and the directory test to b.tar.gz.

<Sysname> tar create gz archive-file b.tar.gz source 1.cfg 2.cfg test

Creating archive flash:/b.tar.gz Done.

# Compress and archive files and directories, and display the successfully archived files and directories.

<Sysname> tar create gz archive-file c.tar.gz verbose source 1.cfg 2.cfg test

1.cfg

2.cfg

test/

test/a.log

test/subtest/

test/subtest/aa.log

Related commands

·     tar extract

·     tar list

tar extract

Use tar extract to extract files and directories.

Syntax

tar extract archive-file file [ verbose ] [ screen | to directory ]

Views

User view

Predefined user roles

network-admin

Parameters

archive-file file: Specifies the archive file name. The suffix can be .tar or .tar.gz.

verbose: Displays the names of the successfully extracted files and directories.

screen: Displays the content of the extracted files and directories on the screen. The extracted files are not saved.

to directory: Saves the extracted files and directories to a different directory. The directory argument specifies the directory.

Usage guidelines

If you do not specify the screen keyword or the to directory option, the command saves the extracted files and directories to the working directory.

The command saves the extracted files and directories by using their original names. If a file or directory that has the same name as an extracted file or directory already exists in the destination directory, the file or directory is overwritten.

Examples

# Extract files and directories from archive file a.tar.

<Sysname> tar extract archive-file a.tar

Extracting archive flash:/a.tar Done.

# Extract files and directories from archive file a.tar, and display the names of the successfully extracted files and directories.

<Sysname> tar extract archive-file a.tar.gz verbose

1.cfg

2.cfg

test/

test/a.log

test/subtest/

test/subtest/aa.log

# Extract files and directories from archive file a.tar, and display the content of the files on the screen.

<Sysname> tar extract archive-file a.tar.gz screen

#

 version 7.1.055, Demo 2501008

#

 sysname Sysname

#

...

Related commands

·     tar create

·     tar list

tar list

Use tar list to display the names of archived files and directories.

Syntax

tar list archive-file file

Views

User view

Predefined user roles

network-admin

Parameters

archive-file file: Specifies the archive file name. The suffix can be .tar or .tar.gz.

Examples

# Display the names of archived files and directories.

<Sysname> tar list archive-file a.tar

1.cfg

2.cfg

test/

test/a.log

test/subtest/

test/subtest/aa.log

Related commands

·     tar create

·     tar extract

undelete

Use undelete to restore a file from the recycle bin.

Syntax

undelete file

Views

User view

Predefined user roles

network-admin

Parameters

file: Specifies the name of the file to be restored.

Usage guidelines

If a file with the same name already exists in the directory, the system prompts whether or not you want to overwrite the existing file. If you enter Y, the existing file is overwritten. If you enter N, the command is not executed.

Examples

# Restore the copy.cfg file, which was moved from the flash: directory to the recycle bin.

<Sysname> undelete copy.cfg

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

Undeleting file flash:/copy.cfg... Done.

# Restore the startup.cfg file, which was moved from the flash:/seclog directory to the recycle bin.

·     Method 1:

<Sysname> undelete seclog/startup.cfg

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

Undeleting file flash:/seclog/startup.cfg... Done.

<Sysname>

·     Method 2:

<Sysname> cd seclog

<Sysname> undelete startup.cfg

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

Undeleting file flash:/seclog/startup.cfg... Done.