01-Fundamentals Command Reference

HomeSupportResource CenterSwitchesH3C S6300 Switch SeriesH3C S6300 Switch SeriesTechnical DocumentsCommandCommand ReferencesH3C S6300 Switch Series Command References-Release 243x-6W10001-Fundamentals Command Reference
05-File system management commands
Title Size Download
05-File system management commands 110.84 KB

File system management commands

IMPORTANT

IMPORTANT:

·     Before managing storage media, files, and directories, make sure you know the possible impacts.

·     A file or directory whose name starts with a period (.) is considered a hidden file or directory. Do not give a common file or directory a name that starts with a period.

·     Some system files and directories are hidden.

 

A file name must be specified in one of the file name formats allowed. For more information, 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 storage medium while another user is repairing, formatting, or partitioning the medium.

To access a storage medium after the medium is repaired, formatted, or partitioned, use one of the following methods:

·     Specify the storage medium name for the command. For example, use dir flash:/ to display all files and folders on the flash memory.

·     Use the cd command to change to the storage medium before using the command. For example, use cd flash:/ to change to the root directory of the flash memory, and then use dir to display all files and folders.

The device supports the FIPS mode that complies with NIST FIPS 140-2 requirements. Support for features, commands, and parameters might differ in FIPS mode and non-FIPS mode. For more information about FIPS mode, see Security Configuration Guide.

cd

Use cd to change the current working directory.

Syntax

cd { directory | .. }

Views

User view

Predefined user roles

network-admin

Parameters

directory: Specifies the name of the destination directory, in the format [drive:/]path. For more information about how to enter the drive and path arguments, see Fundamentals Configuration Guide. If no drive information is provided, the argument represents a folder or subfolder in the current directory.

..: Specifies the parent directory. If the current 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 folder after logging in to the device.

<Sysname> cd test

# Return to the upper directory.

<Sysname> cd ..

# Access the flash root directory of the subordinate member with the member ID 2 after you log in to the master.

<Sysname> cd slot2#flash:/

# Change back to the flash root directory of the master.

<Sysname> cd flash:/

copy

Use copy to copy a file.

Syntax

In non-FIPS mode:

copy fileurl-source fileurl-dest [ vpn-instance vpn-instance-name ] [ source interface interface-type interface-number ]

In FIPS mode:

copy fileurl-source fileurl-dest

Views

User view

Predefined user roles

network-admin

Parameters

fileurl-source: Specifies the name or URL of the file to be copied in non-FIPS mode, and specifies the name of the file to be copied in FIPS mode. 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.

fileurl-dest: Specifies the name or URL of the destination file or directory in non-FIPS mode, and specifies the name of the destination file or directory in FIPS mode. 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.

vpn-instance vpn-instance-name: Specifies the VPN instance to which the destination FTP or TFTP server belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the server belongs to the public network, do not specify this option.

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

In FIPS mode, you can only use the copy command to copy a local file and save it locally.

In non-FIPS mode, 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 a remote file server.

·     Copy a file on a remote file server and save it locally.

The remote file server can be an FTP server, HTTP server, or TFTP server.

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:1@1.1.1.1/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://test:test@[2001::1]:21/test.cfg.

On an HTTP server

Enter the URL in the format of http://username[:password]@server address[:port number]/file path[/file name].

The username and password must be the same as those configured on the HTTP 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 HTTP server 1.1.1.1, enter http://1:1@1.1.1.1/startup.cfg.

If authentication is not required, you do not need to enter the username or password. For example, to specify the startup.cfg file in the authorized working directory on HTTP server 1.1.1.1, enter http://1.1.1.1/startup.cfg.

 

Examples

# Copy the test.cfg file in the current folder and save it to the current folder 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.

# Copy the 1.cfg file from the test folder of the flash memory to the USB disk. Save the copy to the testbackup folder on the first partition with the file name 1backup.cfg.

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

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

Copying file flash:/test/1.cfg to usba0:/testbackup/1backup.cfg...Done.

# Copy test.cfg from the working directory on FTP server 1.1.1.1. Save the copy to the local current folder as testbackup.cfg. In this example, the FTP username and password are user and private, respectively

<Sysname> copy ftp://user:private@1.1.1.1/test.cfg testbackup.cfg

Copy ftp://user:private@1.1.1.1/test.cfg to flash:/testbackup.cfg?[Y/N]:y

Copying file ftp://user:private@1.1.1.1/test.cfg to flash:/testbackup.cfg... Done.

# Copy test.cfg from the current folder. Save the copy to the working directory on FTP server 1.1.1.1 as testbackup.cfg. In this example, the FTP username and password are user and private.

<Sysname> copy test.cfg ftp://user:private@1.1.1.1/testbackup.cfg

Copy flash:/test.cfg to ftp://user:private@1.1.1.1/testbackup.cfg?[Y/N]:y

Copying file flash:/test.cfg to ftp://user:private@1.1.1.1/testbackup.cfg... Done.

# Copy test.cfg from the working directory on TFTP server 1.1.1.1. Save the copy to the local current folder as testbackup.cfg.

<Sysname> copy tftp://1.1.1.1/test.cfg testbackup.cfg

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

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

# Copy test.cfg from the current folder. Save the copy to the working directory on TFTP server 1.1.1.1 as testbackup.cfg.

<Sysname> copy test.cfg tftp://1.1.1.1/testbackup.cfg

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

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

# Copy test.cfg from the working directory on FTP server 1.1.1.1. Save the copy to the local current folder as testbackup.cfg. In this example, the FTP username and password are user and private, and the FTP server belongs to VPN instance vpn1.

<Sysname> copy ftp://user:private@1.1.1.1/test.cfg testbackup.cfg vpn-instance vpn1

Copy ftp://user:private@1.1.1.1/test.cfg to flash:/testbackup.cfg?[Y/N]:y

Copying file ftp://user:private@1.1.1.1/test.cfg to flash:/testbackup.cfg... Done.

# Copy test.cfg from the working directory on TFTP server 1.1.1.1. Save the copy to the local current folder as testbackup.cfg. In this example, the TFTP server belongs to VPN instance vpn1.

<Sysname> copy tftp://1.1.1.1/test.cfg testbackup.cfg vpn-instance vpn1

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

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

# Copy test.cfg from the working directory on FTP server 2001::1. Save the copy to the local current folder as testbackup.cfg. In this example, the FTP username and password are user and private, respectively.

<Sysname> copy ftp://user:private@[2001::1]/test.cfg testbackup.cfg

Copy ftp://user:private@[2001::1]/test.cfg to flash:/testbackup.cfg?[Y/N]:y

Copying file ftp://user:private@[2001::1]/test.cfg to flash:/testbackup.cfg... Done.

# Copy test.cfg from the working directory on TFTP server 2001::1. Save the copy to the local current folder as testbackup.cfg.

<Sysname> copy tftp://[2001::1]/test.cfg testbackup.cfg

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

Copying file tftp://[2001::1]/test.cfg to flash:/testbackup.cfg... Done.

# Copy the master's configuration file test.cfg to the subordinate member with the member ID 2. Save the copy to the root directory of the flash memory.

<Sysname> copy test.cfg slot2#flash:/

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

Copying file flash:/test.cfg to slot2#flash:/test.cfg...Done.

delete

Use delete to delete a file.

Syntax

delete [ /unreserved ] file-url

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-url: 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-url command with caution. You cannot restore a file that was deleted with this command.

The delete file-url command (without /unreserved) moves the specified file to the recycle bin, except in the following situation, where the file is permanently deleted:The device is running out of storage space.

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 but reside in 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 file deleted last is retained in the recycle bin.

Examples

# Remove file 1.cfg from the root directory of the master's storage medium.

<Sysname> delete 1.cfg

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

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

# Permanently delete file 2.cfg from the root directory of the master's storage medium.

<Sysname> delete /unreserved 2.cfg

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

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

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

# Remove file 1.cfg from the root directory of the storage medium on the subordinate member with the member ID 2.

·     Method 1:

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

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

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

·     Method 2:

<Sysname> cd slot2#flash:/

<Sysname> delete 1.cfg

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

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

Related commands

·     undelete

·     reset recycle-bin

dir

Use dir to display files or folders.

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

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

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

/all-filesystems: Displays files and folders in the root directory of all storage media on the device.

Usage guidelines

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

The folder 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 folders in the storage medium of the master.

<Sysname> dir /all

Directory of flash:/

...

# Display files and folders in the root directory of all storage media on the IRF fabric.

<Sysname> dir /all-filesystems

Directory of flash:/

...

 

Directory of slot1#flash:/

...

# Display information about all files and folders in the storage medium of the subordinate member with the member ID 2.

<Sysname> cd slot2#flash:/

<Sysname> dir /all

Directory of slot2#flash:/

...

Table 1 Command output

Field

Description

Directory of

Current directory.

0     -rwh      3144  Apr 26 2008 13:45:28   xx.xx

File or folder information:

·     0File or folder number, which is automatically allocated by the system.

·     -rwhAttributes of the file or folder. The first character is the folder indicator (d for folder and for file). The second character indicates whether the file or folder 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 folder, a hyphen (-) is displayed.

·     Apr 26 2008 13:45:28—Last date and time when the file or folder was modified.

·     xx.xx—File or folder name.

 

fdisk

Use fdisk to partition a storage medium.

Syntax

fdisk medium-name [ partition-number ]

Views

User view

Predefined user roles

network-admin

Parameters

medium-name: Specifies the name of the storage medium to be partitioned. The value varies by device model.

partition-number: Specifies the number of partitions, in the range of 1 to 4.

Usage guidelines

The flash memory cannot be partitioned.

If the partition-number argument is specified, the storage medium is divided into the specified number of partitions. Otherwise, partitioning is performed in an interactive way.

It is normal that the specified partition size and the actual partition size have an error less than 5% of the total memory.

A partition cannot be partitioned.

Before partitioning a USB disk, perform the following tasks:

·     Back up the files in the storage medium. The partition operation clears all data in the medium.

·     If you are partitioning a USB disk, make sure the disk is not write protected. Otherwise, the partition operation will fail, and you must remount or reinstall the disk to restore access to the USB disk.

·     Make sure no other users are accessing the medium. Otherwise, the partition operation fails.

Examples

# Divide the USB disk on the device evenly into three partitions in simple mode.

<Sysname> fdisk usba: 3

Capacity of usba: : 256M bytes

usb: will be divided into the following partitions:

DeviceName      Capacity

usba0:            85MB

usba1:            85MB

usba2:            86MB

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

Partitioning usba:...Done.

# Divide the USB disk on the device into one partition in an interactive way.

<Sysname> fdisk usba:

The capacity of usba: : 256M bytes

Partition 1 (32MB~224MB, 256MB. Press CTRL+C to quit or Enter to use all available space):

// Press Enter or enter 256.

usba: will be divided into the following partition(s):

DeviceName    Capacity

usba0:          256MB

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

Partitioning usba:...Done.

# Divide the USB disk on the device into three partitions and specify the size for each partition:

<Sysname> fdisk usba:

The capacity of usba: : 256M bytes

Partition 1 (32MB~224MB, 256MB, Press CTRL+C to quit or Enter to use all available space):128

// Enter 128 to set the size of the first partition to 128 MB.

Partition 2 (32MB~96MB, 128MB, Press CTRL+C to quit or Enter to use all available space):31

// Enter 31 to set the size of the second partition to 31 MB.

The partition size must be greater than or equal to 32MB.

Partition 2 (32MB~96MB, 128MB, Press CTRL+C to quit or Enter to use all available space):1000

// Enter 1000 to set the size of the second partition to 1000 MB.

The partition size must be less than or equal to 128MB.

Partition 2 (32MB~96MB, 128MB, Press CTRL+C to quit or Enter to use all available space):127

// Enter 127 to set the size of the second partition to 127 MB.

The remaining space is less than 32MB. Please enter the size of partition 2 again.

Partition 2 (32MB~96MB, 128MB, Press CTRL+C to quit or Enter to use all available space):

// Enter 56 to set the size of the second partition to 56 MB.

Partition 3 (32MB~40MB, 72MB, Press CTRL+C to quit or Enter to use all available space):

// Press Enter to assign the remaining space to the third partition.

usba: will be divided into the following partition(s):

DeviceName     Capacity

usba0:            128MB

usba1:            56MB

usba2:            72MB

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

Partitioning usba:...Done.

file prompt

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

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

Views

System view

Predefined user roles

network-admin

Parameters

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

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

Usage guidelines

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

Examples

# Set the file and folder operation mode to alert.

<Sysname> system-view

[Sysname] file prompt alert

fixdisk

Use fixdisk to check a storage medium for damage and repair any damage.

Syntax

fixdisk medium-name

Views

User view

Predefined user roles

network-admin

Parameters

medium-name: Specifies the name of a storage medium name. The value varies by device model.

Usage guidelines

Use this command to fix a storage medium when space on the medium cannot be used or released due to abnormal operations.

Before you repair a storage medium, make sure no other users are accessing the medium. Otherwise, the repair operation fails.

Examples

# Restore the space of the flash memory.

<Sysname> fixdisk flash:

Restoring flash: may take some time...

Restoring flash:...Done.

format

Use format to format a storage medium.

Syntax

format medium-name

Views

User view

Predefined user roles

network-admin

Parameters

medium-name: Specifies the name of a storage medium. The value varies by device model.

Usage guidelines

Formatting a storage medium permanently deletes all files on the storage medium. If a startup configuration file exists on the storage medium, back it up if necessary.

To format a storage medium that has been partitioned, you must format all the partitions individually, instead of formatting the medium as a whole.

You can format a storage medium only when no one is accessing the medium.

Examples

# Format the flash memory.

<Sysname> format flash:

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

Formatting flash:... Done.

# Format the third partition on the USB disk.

<Sysname> format usba2:

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

Formatting usba2:... Done.

gunzip

Use gunzip to decompress a file.

Syntax

gunzip filename

Views

User view

Predefined user roles

network-admin

Parameters

filename: 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 filename

Views

User view

Predefined user roles

network-admin

Parameters

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

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 MD algorithm to calculate the digest of a file.

Syntax

md5sum file-url

Views

User view

Predefined user roles

network-admin

network-operator

Parameters

file-url: Specifies the name of a file.

Usage guidelines

The digest can be used to verify the integrity of the file.

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 folder in the current directory.

Syntax

mkdir directory

Views

User view

Predefined user roles

network-admin

Parameters

directory: Specifies the name of a folder.

Usage guidelines

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

To use this command to create a folder, the specified directory must already exist. For example, to create the flash:/test/mytest folder, the test folder must already exist. Otherwise, the mytest folder is not created.

Examples

# Create the test folder in the current directory.

<Sysname> mkdir test

Creating directory flash:/test... Done.

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

<Sysname> mkdir test/subtest

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

# Create the test folder on the subordinate member with the member ID 2.

<Sysname> mkdir slot2#flash:/test

Creating directory slot2#flash:/test... Done.

more

Use more to display the contents of a text file.

Syntax

more file-url

Views

User view

Predefined user roles

network-admin

Parameters

file-url: Specifies a file name.

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.045, ESS 2415

#

 sysname Sysname

#

vlan 2

#

return

<Sysname>

# Display the contents of the testcfg.cfg file on the subordinate member with the member ID 2.

<Sysname> more slot2#flash:/testcfg.cfg

#

 version 7.1.045, ESS 2415

#

 sysname Sysname

#

  ---- More ----

mount

Use mount to mount a hot swappable storage medium.

Syntax

mount medium-name

Default

A storage medium is automatically mounted and in mounted state after being connected to the device, and you can use it without mounting it.

Views

User view

Predefined user roles

network-admin

Parameters

medium-name: Specifies the name of a storage medium. The value varies by device model.

Usage guidelines

To avoid file system corruption, do not perform the following tasks while the system is mounting a storage medium:

·     Install or remove storage media.

·     Perform a master/subordinate switchover.

To mount a partitioned storage medium, you must mount all the partitions individually, instead of mounting the USB disk as a whole.

Examples

# Mount the USB disk on the master.

<Sysname> mount usba0:

# Mount the USB disk on the subordinate member with the member ID 2.

<Sysname> mount slot2#usba0:

Related commands

umount

move

Use move to move a file.

Syntax

move fileurl-source fileurl-dest

Views

User view

Predefined user roles

network-admin

Parameters

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

fileurl-dest: Specifies the name of the destination file or folder.

Usage guidelines

If you specify a destination folder, the system moves the source file to the specified folder 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 folder 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 current working directory.

Syntax

pwd

Views

User view

Predefined user roles

network-admin

Examples

# Display the current working directory.

<Sysname> pwd

flash:

rename

Use rename to rename a file or folder.

Syntax

rename fileurl-source fileurl-dest

Views

User view

Predefined user roles

network-admin

Parameters

fileurl-source: Specifies the name of the source file or folder.

fileurl-dest: Specifies the name of the destination file or folder.

Usage guidelines

This command is not executed if the destination file or folder name is already used by an existing file or folder in the current 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

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-url 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 remove a folder.

Syntax

rmdir directory

Views

User view

Predefined user roles

network-admin

Parameters

directory: Specifies a folder name.

Usage guidelines

To remove a directory, you must delete all files and subfolders 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

# Remove the subtest folder.

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

Views

User view

Predefined user roles

network-admin

Parameters

file-url: Specifies the name of a file.

Usage guidelines

The digest of a file can be used 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

Related commands

md5sum

tar create

Use tar create to archive files and folders.

Syntax

tar create [ gz ] archive-file fileurl-dest [ verbose ] source fileurl-source-list&<1-5>

Views

User view

Predefined user roles

network-admin

Parameters

gz: Uses gzip to compress the files and folders before archiving them.

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

verbose: Displays the names of the successfully archived files and folders.

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

Examples

# Archive file a.cfg to file a.tar.

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

Creating archive a.tar …… Done.

# Compress file a.cfg and archive the file to a.tar.gz.

<Sysname> tar create gz archive-file a.tar.gz source a.cfg

Creating archive a.tar.gz Done.

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

<Sysname> tar create gz archive-file a.tar.gz verbose source a.cfg a.dbm ./core

a.cfg

a.dbm

./core

Related commands

·     tar extract

·     tar list

tar extract

Use tar extract to extract files and folders.

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

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

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

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

to directory-name: Saves the extracted files and folders to a path.

Usage guidelines

If you do not specify the screen keyword or the to directory-name option, the command extracts the archived files and folders and saves them to the same folder as the archive file.

Examples

# Extract files and folders, and save them to the same folder as the archive file.

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

Extracting archive a.tar.gz …… Done.

# Extract files and folders, and display their content on the screen.

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

a.cfg

#

version 7.1.045, ESS 2415

#

sysname Sysname

#

# Extract files and folders, save them to the same folder as the archive file, and display the names of the archived files and folders.

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

a.txt

# Extract files and folders, and save them to the path flash:/a.

<Sysname> tar extract archive-file a.tar.gz to flash:/a

Extracting archive a.tar.gz ......Done.

Related commands

·     tar create

·     tar list

tar list

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

Syntax

tar list archive-file fileurl-dest

Views

User view

Predefined user roles

network-admin

Parameters

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

Examples

# Display the names of archived files and folders.

<Sysname> tar list archive-file a.tar.gz

a.cfg

Related commands

·     tar create

·     tar extract

umount

Use umount to unmount a hot swappable storage medium.

Syntax

umount medium-name

Default

A storage medium is automatically mounted and placed in mounted state.

Views

User view

Predefined user roles

network-admin

Parameters

medium-name: Specifies the name of a storage medium. The value varies by device model.

Usage guidelines

Before you remove a mounted storage medium from the system, first unmount it to avoid damaging the medium.

Before you unmount a storage medium, make sure no other users are accessing the medium. Otherwise, the unmount operation fails.

When a storage medium is connected to a lower version system, the system might not be able to automatically recognize the device. In this case, you must first execute the mount command for the storage medium to function correctly.

To avoid file system corruption, do not perform the following tasks while the system is mounting or unmounting a storage medium:

·     Install or remove storage media.

·     perform a master/subordinate switchover.

Examples

# Unmount a USB disk from the master.

<Sysname> umount usba0:

# Unmount a USB disk from the subordinate member with the member ID 2.

<Sysname> umount slot2#usba0:

Related commands

mount

undelete

Use undelete to restore a file from the recycle bin.

Syntax

undelete file-url

Views

User view

Predefined user roles

network-admin

Parameters

file-url: 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.