unzip

Function

The unzip command decompresses a file.

Format

unzip source-filename destination-filename

Parameters

Parameter	Description	Value
source-filename	Specifies the name of a source file to be decompressed.	The value is a string of 1 to 160 case-insensitive characters without spaces in the format [ drive ] [ path ] filename. If the string is enclosed in double quotation marks (" "), the string can contain spaces. If the value is a file name, the value is a string of 1 to 64 characters. In the preceding parameter, drive specifies the storage device name, and path specifies the directory and subdirectory. You are advised to add : and / between the storage device name and directory. The directory name cannot contain the following characters: ~ * / \ : ' "
destination-filename	Specifies the name of a destination file that is decompressed.	The value is a string of 1 to 160 case-insensitive characters without spaces in the format [ drive ] [ path ] filename. If the string is enclosed in double quotation marks (" "), the string can contain spaces. If the value is a file name, the value is a string of 1 to 64 characters. In the preceding parameter, drive specifies the storage device name, and path specifies the directory and subdirectory. You are advised to add : and / between the storage device name and directory. The directory name cannot contain the following characters: ~ * / \ : ' "

Parameter

Description

Value

source-filename

Specifies the name of a source file to be decompressed.

The value is a string of 1 to 160 case-insensitive characters without spaces in the format [ drive ] [ path ] filename. If the string is enclosed in double quotation marks (" "), the string can contain spaces. If the value is a file name, the value is a string of 1 to 64 characters.

In the preceding parameter, drive specifies the storage device name, and path specifies the directory and subdirectory.

You are advised to add : and / between the storage device name and directory. The directory name cannot contain the following characters: ~ * / \ : ' "

destination-filename

Specifies the name of a destination file that is decompressed.

In the preceding parameter, drive specifies the storage device name, and path specifies the directory and subdirectory.

You are advised to add : and / between the storage device name and directory. The directory name cannot contain the following characters: ~ * / \ : ' "

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can decompress files, especially log files that are stored on the storage device and run the more command to query the file.

The following describes the drive name.

drive is the storage device and is named as flash:.
If devices are stacked, drive can be named as:
- flash: root directory of the flash memory of the master switch in the stack.
- chassis ID#flash: root directory of the flash memory on a device in the stack.
For example, slot2#flash: indicates the flash memory in slot 2.

The path can be an absolute path or relative path. A relative path can be designated relative to either the root directory or the current working directory. A relative path beginning with a slash (/) is a path relative to the root directory.

flash:/my/test/ is an absolute path.
/selftest/ is a path relative to the root directory and indicates the selftest directory in the root directory.
selftest/ is a path relative to the current working directory and indicates the selftest directory in the current working directory.

Precautions

If the destination file path is specified while the file name is not specified, the designation file name is the same as the source file name.
The source file persists after being decompressed.
The compressed file must be a .zip file. If a file to be decompressed is not a zip file, the system displays an error message during decompression.
The source file must be a single file. If you attempt to decompress a directory or multiple files, the decompression cannot succeed.

Example

# Decompress log file logfile-2012-02-27-17-47-50.zip that are stored in the logfile directory and save it to the root directory as file log.txt.

<HUAWEI> pwd
flash:/logfile
<HUAWEI> unzip logfile-2012-02-27-17-47-50.zip flash:/log.txt
Extract flash:/logfile/logfile-2012-02-27-17-47-50.zip to flash:/log.txt?[Y/N]:y
100%  complete
%Decompressed file flash:/logfile/logfile-2012-02-27-17-47-50.zip to flash
:/log.txt.