ls

Lists persistent objects in the CNA storage repository.

ls [<extension>]
 

• extension--filename extension of files to list

System operations mode, login-level access.

Certain objects are stored as files in a persistent repository on CNA, including configuration files, snapshot report files, and persistent output from various show commands. Use the ls command to see a list of filenames; the delete command to permanently remove an object; the rename command to rename an object; and the copy command to make a copy.

The ls command by itself will list all objects, or you can filter the list by specifying one of the following as extension:

• cfg--configuration files
• gif--gif images
• html--Internet files
• img--CNA images
• name--prefixes alias mapping files
• prefix--bgp prefixes (used for customer-based reports)
• qry--trend-report query files (defines data to be retrieved for trend-report graphs)
• tmpl--template files for trend reports
• txt--text files

Trend report filenames displayed on the command line (file extension .qry) may differ from the filenames displayed in the web interface, which allows the use of spaces and the slash character in trend report names (but not when naming other file types).

These characters will be translated into a commonly accepted URL encoding scheme when the file is written to disk. The web interface translates the filename back to an unencoded format when displaying the filename, but the filenames are shown in their encoded form on the command line.

For example, a trend report listed as trend report/1 in the list of trend reports in the web interface will appear as trend_report=2F1.qry on the command line. The template file listed as Bandwidth (5 Day) Template in the web interface appears as Bandwidth_=285_Day=29Template.tmpl on the command line.