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 
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
   —  checksum 
      —  [type] keyword
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url)
   —  copy 
      —  client-tls-profile string
      —  [destination-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose | scp-url)
      —  direct-http 
      —  force 
      —  proxy http-url
      —  recursive 
      —  router-instance string
      —  [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
   —  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 
      —  [sort-order] keyword
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
   —  make-directory 
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
   —  move 
      —  client-tls-profile string
      —  [destination-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
      —  direct-http 
      —  force 
      —  proxy http-url
      —  [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
   —  permission 
      —  [attribute] keyword
      —  [url] (sat-url | cflash-url | string-not-all-spaces)
   —  remove 
      —  client-tls-profile string
      —  direct-http 
      —  force 
      —  proxy http-url
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
   —  remove-directory 
      —  force 
      —  recursive 
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
   —  repair 
      —  [cflash-id] cflash-id
   —  show 
      —  client-tls-profile string
      —  direct-http 
      —  proxy http-url
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
   —  unzip 
      —  create-destination 
      —  [destination-url] (sat-url | cflash-url | string-not-all-spaces)
      —  force 
      —  list 
      —  [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
   —  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] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
Synopsis New working directory URL
Context file change-directory [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
Tree[url]

String length

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

1 to 180 (ftp-url)

Default .
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] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url)
Synopsis File URL
Contextfile checksum [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)

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

copy

Synopsis Copy files
Contextfile copy
Treecopy
Introduced20.10.R1

Platforms

All

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

String length

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

1 to 199 (ftp-tftp-url)

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

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] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
Synopsis Source URL
Contextfile copy [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
Tree[source-url]

String length

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

1 to 199 (ftp-tftp-url)

1 to 180 (http-url-loose)

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All

disable

Synopsis Disable compact flash 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 compact flash device
Context file disable cflash-id cflash-id
Treecflash-id
String length4 to 6

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

Notes

This element is mandatory.

Introduced22.10.R1

Platforms

All

enable

Synopsis Enable compact flash 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

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 compact flash device
Context file format
Treeformat
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] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
Synopsis Location of the directory to be listed
Contextfile list [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
Tree[url]

String length

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

1 to 180 (ftp-url)

Default .
Introduced20.10.R1

Platforms

All

make-directory

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

Platforms

All

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

String length

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

1 to 180 (ftp-url)

Notes

This element is mandatory.

Introduced 20.10.R1

Platforms

All

move

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

Platforms

All

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

String length

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

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

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] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
Synopsis Source URL
Contextfile move [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
Tree[source-url]

String length

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

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

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
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] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
Synopsis File URL
Contextfile remove [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
Tree[url]

String length

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

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

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] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
Synopsis Directory URL
Contextfile remove-directory [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
Tree[url]

String length

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

1 to 180 (ftp-url)

Notes

This element is mandatory.

Introduced 20.10.R1

Platforms

All

repair

Synopsis Repair a compact flash file system
Context file repair
Treerepair
Introduced20.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] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
Synopsis File URL
Contextfile show [url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
Tree[url]

String length

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

1 to 199 (ftp-tftp-url)

1 to 180 (http-url-loose)

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
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] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
Synopsis Source URL
Contextfile unzip [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
Tree[source-url]

String length

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

1 to 199 (ftp-tftp-url)

1 to 180 (http-url-loose)

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)

Notes

This element is mandatory.

Introduced20.10.R1

Platforms

All