file commands

See “File management” in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Basic System Configuration Guide for more information.

file 
   —  change-directory 
      —  router-instance string
      —  [url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  checksum 
      —  router-instance string
      —  [type] keyword
      —  [url] (ftp-tftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  copy 
      —  client-tls-profile string
      —  [destination-url] (ftp-tftp-url | http-url-loose | scp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
      —  direct-http 
      —  force 
      —  proxy http-url
      —  recursive 
      —  router-instance string
      —  [source-url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  disable 
      —  active 
      —  cflash-id cflash-id
      —  standby 
   —  edit 
      —  [url] (sat-url | cflash-url | string-not-all-spaces)
   —  enable 
      —  active 
      —  cflash-id cflash-id
      —  standby 
   —  format 
      —  [cflash-id] cflash-id
   —  list 
      —  reverse 
      —  router-instance string
      —  [sort-order] keyword
      —  [url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  make-directory 
      —  router-instance string
      —  [url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  move 
      —  client-tls-profile string
      —  [destination-url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
      —  direct-http 
      —  force 
      —  proxy http-url
      —  router-instance string
      —  [source-url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  permission 
      —  [attribute] keyword
      —  [url] (sat-url | cflash-url | string-not-all-spaces)
   —  remove 
      —  client-tls-profile string
      —  direct-http 
      —  force 
      —  proxy http-url
      —  router-instance string
      —  [url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  remove-directory 
      —  force 
      —  recursive 
      —  router-instance string
      —  [url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  repair 
      —  [cflash-id] cflash-id
   —  secure-erase 
      —  [cflash-id] cflash-id
   —  show 
      —  client-tls-profile string
      —  direct-http 
      —  proxy http-url
      —  router-instance string
      —  [url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  unzip 
      —  create-destination 
      —  [destination-url] (sat-url | cflash-url | string-not-all-spaces)
      —  force 
      —  list 
      —  router-instance string
      —  [source-url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
   —  version 
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url)

file command descriptions

file

Synopsis Perform file operations
Context file
Tree file

Description

Commands in this context execute file management operations.

Introduced20.10.R1

Platforms

All

change-directory

Synopsis Change the working directory
Context file change-directory
Treechange-directory
Introduced20.10.R1

Platforms

All

[url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis New working directory URL
Context file change-directory [url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[url]

String length

1 to 180 (ftp-url)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

Default

.

String format

'ftp-url' must not contain illegal characters

'ftp-url' must be ftp:// with optional user:pass@, hostname and path (e.g. ftp://user:pass@hostname.domain/path/file)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Introduced20.10.R1

Platforms

All

checksum

Synopsis Compute and display checksums
Context file checksum
Treechecksum

Description

This command computes and displays an image file or a checksum for a file.

Introduced20.10.R1

Platforms

All

[type] keyword
Synopsis Checksum option type
Context file checksum [type] keyword
Tree[type]
Optionsimage, md5, sha256

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

[url] (ftp-tftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis File URL
Contextfile checksum [url] (ftp-tftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[url]

String length

1 to 199 (ftp-tftp-url)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-tftp-url' must be ftp:// or tftp:// with host and path (e.g. ftp://user:pass@hostname.domain/path/file)

'ftp-tftp-url' must have valid hostname and optional path after scheme

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

copy

Synopsis Copy files
Contextfile copy
Treecopy
Introduced20.10.R1

Platforms

All

[destination-url] (ftp-tftp-url | http-url-loose | scp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis Destination URL or '.' for the working directory
Contextfile copy [destination-url] (ftp-tftp-url | http-url-loose | scp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[destination-url]

String length

1 to 199 (ftp-tftp-url)

1 to 180 (http-url-loose, scp-url)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-tftp-url' must be ftp:// or tftp:// with host and path (e.g. ftp://user:pass@hostname.domain/path/file)

'ftp-tftp-url' must have valid hostname and optional path after scheme

'http-url-loose' must be http:// with host and optional port and path (e.g. http://hostname.domain/path)

'scp-url' must be scp:// with optional user:pass@, hostname and path (e.g. scp://user:pass@hostname.domain/path/file)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

direct-http
Synopsis Allow direct HTTP connection, do not follow redirects
Contextfile copy direct-http
Treedirect-http
Introduced20.10.R1

Platforms

All

force
Synopsis Force copy without prompting before overwriting
Contextfile copy force
Treeforce
Introduced20.10.R1

Platforms

All

proxy http-url
Synopsis Connect over HTTP with a proxy
Context file copy proxy http-url
Treeproxy
String length1 to 255
Introduced20.10.R1

Platforms

All

recursive
Synopsis Copy sub-directories encountered at the source URL
Contextfile copy recursive
Treerecursive

Description

This command recursively copies files and directories. If files or directories already exist, the operator is prompted to overwrite them. When the force command is enabled, a positive response to the overwrite prompts is assumed, and the operator is not prompted for confirmation. The existing files or directories are overwritten.

Introduced21.10.R1

Platforms

All

[source-url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis Source URL
Contextfile copy [source-url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[source-url]

String length

1 to 199 (ftp-tftp-url)

1 to 180 (http-url-loose)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-tftp-url' must be ftp:// or tftp:// with host and path (e.g. ftp://user:pass@hostname.domain/path/file)

'ftp-tftp-url' must have valid hostname and optional path after scheme

'http-url-loose' must be http:// with host and optional port and path (e.g. http://hostname.domain/path)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

disable

Synopsis Disable storage devices
Context file disable
Treedisable
Introduced20.10.R1

Platforms

All

active
Synopsis Disable all devices on the active CPM
Contextfile disable active
Treeactive

Notes

The following elements are part of a choice: active, cflash-id, or standby.

Introduced20.10.R1

Platforms

All

cflash-id cflash-id
Synopsis Disable the storage device
Context file disable cflash-id cflash-id
Treecflash-id
String length4 to 6
String format'cflash-id' must be cf1-4: or cf1-4-A-D: (e.g. cf1: or cf2-B:)

Notes

The following elements are part of a choice: active, cflash-id, or standby.

Introduced20.10.R1

Platforms

All

standby
Synopsis Disable all devices on the standby CPM
Contextfile disable standby
Treestandby

Notes

The following elements are part of a choice: active, cflash-id, or standby.

Introduced20.10.R1

Platforms

All

edit

Synopsis Edit files with the text editor
Context file edit
Treeedit

Description

This command allows users to edit files with the text editor.

See "Text editor" in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Basic System Configuration Guide for more information.

Introduced22.10.R1

Platforms

All

[url] (sat-url | cflash-url | string-not-all-spaces)
Synopsis File URL
Contextfile edit [url] (sat-url | cflash-url | string-not-all-spaces)
Tree[url]
String length1 to 200

String format

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced22.10.R1

Platforms

All

enable

Synopsis Enable storage devices
Context file enable
Treeenable
Introduced20.10.R1

Platforms

All

active
Synopsis Enable all devices on the active CPM
Context file enable active
Treeactive

Notes

The following elements are part of a choice: active, cflash-id, or standby.

Introduced20.10.R1

Platforms

All

cflash-id cflash-id
Synopsis Enable the compact flash device
Context file enable cflash-id cflash-id
Treecflash-id
String length4 to 6
String format'cflash-id' must be cf1-4: or cf1-4-A-D: (e.g. cf1: or cf2-B:)

Notes

The following elements are part of a choice: active, cflash-id, or standby.

Introduced20.10.R1

Platforms

All

standby
Synopsis Enable all devices on the standby CPM
Contextfile enable standby
Treestandby

Notes

The following elements are part of a choice: active, cflash-id, or standby.

Introduced20.10.R1

Platforms

All

format

Synopsis Format a storage device
Context file format
Treeformat

Description

This command formats a storage device with a new file system without erasing the data. The device must be administratively disabled first.

Introduced20.10.R1

Platforms

All

[cflash-id] cflash-id
Synopsis Format a storage device
Context file format [cflash-id] cflash-id
Tree[cflash-id]
String length4 to 6
String format'cflash-id' must be cf1-4: or cf1-4-A-D: (e.g. cf1: or cf2-B:)
Introduced20.10.R1

Platforms

All

list

Synopsis List directory contents
Context file list
Treelist
Introduced20.10.R1

Platforms

All

reverse
Synopsis List files in reverse sort order
Context file list reverse
Treereverse
Introduced20.10.R1

Platforms

All

[sort-order] keyword
Synopsis Sort order for the directory
Context file list [sort-order] keyword
Tree[sort-order]
Optionsdate, name, size
Introduced20.10.R1

Platforms

All

[url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis Location of the directory to be listed
Contextfile list [url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[url]

String length

1 to 180 (ftp-url)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

Default

.

String format

'ftp-url' must not contain illegal characters

'ftp-url' must be ftp:// with optional user:pass@, hostname and path (e.g. ftp://user:pass@hostname.domain/path/file)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Introduced20.10.R1

Platforms

All

make-directory

Synopsis Make a directory
Context file make-directory
Treemake-directory
Introduced20.10.R1

Platforms

All

[url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis Directory location
Context file make-directory [url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[url]

String length

1 to 180 (ftp-url)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-url' must not contain illegal characters

'ftp-url' must be ftp:// with optional user:pass@, hostname and path (e.g. ftp://user:pass@hostname.domain/path/file)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

move

Synopsis Move or rename files or directories
Context file move
Treemove
Introduced20.10.R1

Platforms

All

[destination-url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis Destination URL or '.' for the working directory
Contextfile move [destination-url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[destination-url]

String length

1 to 180 (ftp-url, http-url-loose)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-url' must not contain illegal characters

'ftp-url' must be ftp:// with optional user:pass@, hostname and path (e.g. ftp://user:pass@hostname.domain/path/file)

'http-url-loose' must be http:// with host and optional port and path (e.g. http://hostname.domain/path)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

direct-http
Synopsis Allow direct HTTP connection, do not follow redirects
Contextfile move direct-http
Treedirect-http
Introduced20.10.R1

Platforms

All

force
Synopsis Force move without prompting before overwriting
Contextfile move force
Treeforce
Introduced20.10.R1

Platforms

All

proxy http-url
Synopsis Connect over HTTP with a proxy
Context file move proxy http-url
Treeproxy
String length1 to 255
Introduced20.10.R1

Platforms

All

[source-url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis Source URL
Contextfile move [source-url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[source-url]

String length

1 to 180 (ftp-url, http-url-loose)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-url' must not contain illegal characters

'ftp-url' must be ftp:// with optional user:pass@, hostname and path (e.g. ftp://user:pass@hostname.domain/path/file)

'http-url-loose' must be http:// with host and optional port and path (e.g. http://hostname.domain/path)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

permission

Synopsis Show or set file permissions
Context file permission
Treepermission
Introduced20.10.R1

Platforms

All

[url] (sat-url | cflash-url | string-not-all-spaces)
Synopsis File URL to set permissions
Context file permission [url] (sat-url | cflash-url | string-not-all-spaces)
Tree[url]
String length1 to 200

String format

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Introduced20.10.R1

Platforms

All

remove

Synopsis Remove files
Contextfile remove
Treeremove
Introduced20.10.R1

Platforms

All

force
Synopsis Force removal without prompting
Context file remove force
Treeforce
Introduced20.10.R1

Platforms

All

proxy http-url
Synopsis Connect over HTTP with a proxy
Context file remove proxy http-url
Treeproxy
String length1 to 255
Introduced20.10.R1

Platforms

All

[url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis File URL
Contextfile remove [url] (ftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[url]

String length

1 to 180 (ftp-url, http-url-loose)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-url' must not contain illegal characters

'ftp-url' must be ftp:// with optional user:pass@, hostname and path (e.g. ftp://user:pass@hostname.domain/path/file)

'http-url-loose' must be http:// with host and optional port and path (e.g. http://hostname.domain/path)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

remove-directory

Synopsis Remove directories
Context file remove-directory
Treeremove-directory
Introduced20.10.R1

Platforms

All

[url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis Directory URL
Contextfile remove-directory [url] (ftp-url | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[url]

String length

1 to 180 (ftp-url)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-url' must not contain illegal characters

'ftp-url' must be ftp:// with optional user:pass@, hostname and path (e.g. ftp://user:pass@hostname.domain/path/file)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

repair

Synopsis Repair a storage device file system
Context file repair
Treerepair
Introduced20.10.R1

Platforms

All

[cflash-id] cflash-id
Synopsis Storage device to repair
Context file repair [cflash-id] cflash-id
Tree[cflash-id]
String length4 to 6
String format'cflash-id' must be cf1-4: or cf1-4-A-D: (e.g. cf1: or cf2-B:)
Introduced20.10.R1

Platforms

All

secure-erase

Synopsis Secure erase and format a storage device
Contextfile secure-erase
Treesecure-erase

Description

This command secure erases and formats a storage device with a new file system. The device must be administratively disabled first.

Introduced25.10.R1

Platforms

All

[cflash-id] cflash-id
Synopsis Storage device to secure erase and format
Contextfile secure-erase [cflash-id] cflash-id
Tree[cflash-id]

Description

[

String length4 to 6
String format'cflash-id' must be cf1-4: or cf1-4-A-D: (e.g. cf1: or cf2-B:)
Introduced25.10.R1

Platforms

All

show

Synopsis Display the contents of a file
Context file show
Treeshow
Introduced20.10.R1

Platforms

All

direct-http
Synopsis Allow direct HTTP connection, do not follow redirects
Contextfile show direct-http
Treedirect-http
Introduced20.10.R1

Platforms

All

proxy http-url
Synopsis Connect over HTTP with a proxy
Context file show proxy http-url
Treeproxy
String length1 to 255
Introduced20.10.R1

Platforms

All

[url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis File URL
Contextfile show [url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[url]

String length

1 to 199 (ftp-tftp-url)

1 to 180 (http-url-loose)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-tftp-url' must be ftp:// or tftp:// with host and path (e.g. ftp://user:pass@hostname.domain/path/file)

'ftp-tftp-url' must have valid hostname and optional path after scheme

'http-url-loose' must be http:// with host and optional port and path (e.g. http://hostname.domain/path)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

unzip

Synopsis Unzip files
Contextfile unzip
Treeunzip
Introduced20.10.R1

Platforms

All

[destination-url] (sat-url | cflash-url | string-not-all-spaces)
Synopsis Destination URL or '.' for the working directory
Contextfile unzip [destination-url] (sat-url | cflash-url | string-not-all-spaces)
Tree[destination-url]
String length1 to 200

String format

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Introduced20.10.R1

Platforms

All

force
Synopsis Force the unzip operation without prompting
Contextfile unzip force
Treeforce

Description

When configured, files and directories that already exist in the destination URL are overwritten without prompting. 

The system does not automatically create directories explicitly specified by the destination URL. To allow the system to create new directories, use the create-destination command.

When unconfigured, the system prompts the user before overwriting a file or directory.

Notes

The following elements are part of a choice: force or list.

Introduced20.10.R1

Platforms

All

list
Synopsis List the file contents without the unzip operation
Contextfile unzip list
Treelist

Notes

The following elements are part of a choice: force or list.

Introduced20.10.R1

Platforms

All

[source-url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Synopsis Source URL
Contextfile unzip [source-url] (ftp-tftp-url | http-url-loose | sftp-url | sat-url | cflash-url | string-not-all-spaces)
Tree[source-url]

String length

1 to 199 (ftp-tftp-url)

1 to 180 (http-url-loose)

1 to 512 (sftp-url)

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

String format

'ftp-tftp-url' must be ftp:// or tftp:// with host and path (e.g. ftp://user:pass@hostname.domain/path/file)

'ftp-tftp-url' must have valid hostname and optional path after scheme

'http-url-loose' must be http:// with host and optional port and path (e.g. http://hostname.domain/path)

'sftp-url' must not contain illegal characters

'sftp-url' must be sftp:// with optional user:pass@, hostname and path (e.g. sftp://user:pass@hostname.domain/path/file)

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

version

Synopsis Display the version of an SR OS image file
Contextfile version
Treeversion
Introduced20.10.R1

Platforms

All

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url)
Synopsis File URL
Contextfile version [url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url)
Tree[url]

String length

1 to 200 (sat-url, cflash-url, string-not-all-spaces)

1 to 199 (ftp-tftp-url)

String format

'sat-url' must start with sat: (e.g. sat:path/to/file)

'cflash-url' must start with cf1-4, optional slot A-D, then path (e.g. cf1:/path or cf1-A:/path)

'cflash-url' must have each path segment at most 99 characters

'string-not-all-spaces' must contain at least one non-space character

'ftp-tftp-url' must be ftp:// or tftp:// with host and path (e.g. ftp://user:pass@hostname.domain/path/file)

'ftp-tftp-url' must have valid hostname and optional path after scheme

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All