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)
      —  direct-http 
      —  force 
      —  proxy string
      —  recursive 
      —  [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
   —  disable 
      —  active 
      —  cflash-id string
      —  standby 
   —  enable 
      —  active 
      —  cflash-id string
      —  standby 
   —  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 string
      —  [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
   —  remove 
      —  client-tls-profile string
      —  direct-http 
      —  force 
      —  proxy string
      —  [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)
   —  show 
      —  client-tls-profile string
      —  direct-http 
      —  proxy string
      —  [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)
Parent topic: Operational commands

file command descriptions

file

  Synopsis Perform file operations
  Context file
  Tree file
 

Description

Commands in this context execute file management operations.
  Introduced 20.10.R1
 

Platforms

All

change-directory

  Synopsis Change the working directory
  Context file
  Tree change-directory
  Introduced 20.10.R1
 

Platforms

All
[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
  Synopsis New working directory URL
  Context file change-directory
  Tree [url]
  String Length 1 to 200
  Default .
  Introduced 20.10.R1
 

Platforms

All

checksum

  Synopsis Compute and display checksums
  Context file
  Tree checksum
 

Description

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

Platforms

All
[type] keyword
  Synopsis Checksum option type
  Context file checksum
  Tree [type]
  Options image, md5, sha256
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All
[url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url)
  Synopsis File URL
  Context file checksum
  Tree [url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All

copy

  Synopsis Copy files
  Context file
  Tree copy
  Introduced 20.10.R1
 

Platforms

All
client-tls-profile string
  Synopsis Connect over HTTP with a client TLS profile
  Context file copy
  Tree client-tls-profile
  String Length 1 to 32
  Introduced 20.10.R1
 

Platforms

All
[destination-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
  Synopsis Destination URL or '.' for the working directory
  Context file copy
  Tree [destination-url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All
direct-http
  Synopsis Allow direct HTTP connection, do not follow redirects
  Context file copy
  Tree direct-http
  Introduced 20.10.R1
 

Platforms

All
force
  Synopsis Force copy without prompting before overwriting
  Context file copy
  Tree force
  Introduced 20.10.R1
 

Platforms

All
proxy string
  Synopsis Connect over HTTP with a proxy
  Context file copy
  Tree proxy
  String Length 1 to 255
  Introduced 20.10.R1
 

Platforms

All
recursive
  Synopsis Copy sub-directories encountered at the source URL
  Context file copy
  Tree recursive
 

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.
  Introduced 21.10.R1
 

Platforms

All
[source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
  Synopsis Source URL
  Context file copy
  Tree [source-url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All

disable

  Synopsis Disable compact flash devices
  Context file
  Tree disable
  Introduced 20.10.R1
 

Platforms

All
active
  Synopsis Disable all devices on the active CPM
  Context file disable
  Tree active
 

Notes

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

Platforms

All
cflash-id string
  Synopsis Disable the compact flash device
  Context file disable
  Tree cflash-id
  String Length 4 to 6
 

Notes

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

Platforms

All
standby
  Synopsis Disable all devices on the standby CPM
  Context file disable
  Tree standby
 

Notes

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

Platforms

All

enable

  Synopsis Enable compact flash devices
  Context file
  Tree enable
  Introduced 20.10.R1
 

Platforms

All
active
  Synopsis Enable all devices on the active CPM
  Context file enable
  Tree active
 

Notes

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

Platforms

All
cflash-id string
  Synopsis Enable the compact flash device
  Context file enable
  Tree cflash-id
  String Length 4 to 6
 

Notes

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

Platforms

All
standby
  Synopsis Enable all devices on the standby CPM
  Context file enable
  Tree standby
 

Notes

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

Platforms

All

list

  Synopsis List directory contents
  Context file
  Tree list
  Introduced 20.10.R1
 

Platforms

All
reverse
  Synopsis List files in reverse sort order
  Context file list
  Tree reverse
  Introduced 20.10.R1
 

Platforms

All
[sort-order] keyword
  Synopsis Sort order for the directory
  Context file list
  Tree [sort-order]
  Options date, name, size
  Introduced 20.10.R1
 

Platforms

All
[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
  Synopsis Location of the directory to be listed
  Context file list
  Tree [url]
  String Length 1 to 200
  Default .
  Introduced 20.10.R1
 

Platforms

All

make-directory

  Synopsis Make a directory
  Context file
  Tree make-directory
  Introduced 20.10.R1
 

Platforms

All
[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
  Synopsis Directory location
  Context file make-directory
  Tree [url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All

move

  Synopsis Move or rename files or directories
  Context file
  Tree move
  Introduced 20.10.R1
 

Platforms

All
client-tls-profile string
  Synopsis Connect over HTTP with a client TLS profile
  Context file move
  Tree client-tls-profile
  String Length 1 to 32
  Introduced 20.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
  Context file move
  Tree [destination-url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All
direct-http
  Synopsis Allow direct HTTP connection, do not follow redirects
  Context file move
  Tree direct-http
  Introduced 20.10.R1
 

Platforms

All
force
  Synopsis Force move without prompting before overwriting
  Context file move
  Tree force
  Introduced 20.10.R1
 

Platforms

All
proxy string
  Synopsis Connect over HTTP with a proxy
  Context file move
  Tree proxy
  String Length 1 to 255
  Introduced 20.10.R1
 

Platforms

All
[source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
  Synopsis Source URL
  Context file move
  Tree [source-url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All

remove

  Synopsis Remove files
  Context file
  Tree remove
  Introduced 20.10.R1
 

Platforms

All
client-tls-profile string
  Synopsis Connect over HTTP with a client TLS profile
  Context file remove
  Tree client-tls-profile
  String Length 1 to 32
  Introduced 20.10.R1
 

Platforms

All
direct-http
  Synopsis Allow direct HTTP connection, do not follow redirects
  Context file remove
  Tree direct-http
  Introduced 20.10.R1
 

Platforms

All
force
  Synopsis Force removal without prompting
  Context file remove
  Tree force
  Introduced 20.10.R1
 

Platforms

All
proxy string
  Synopsis Connect over HTTP with a proxy
  Context file remove
  Tree proxy
  String Length 1 to 255
  Introduced 20.10.R1
 

Platforms

All
[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose)
  Synopsis File URL
  Context file remove
  Tree [url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All

remove-directory

  Synopsis Remove directories
  Context file
  Tree remove-directory
  Introduced 20.10.R1
 

Platforms

All
force
  Synopsis Force removal without prompting
  Context file remove-directory
  Tree force
  Introduced 20.10.R1
 

Platforms

All
recursive
  Synopsis Remove directory and contents recursively
  Context file remove-directory
  Tree recursive
  Introduced 20.10.R1
 

Platforms

All
[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url)
  Synopsis Directory URL
  Context file remove-directory
  Tree [url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All

show

  Synopsis Display the contents of a file
  Context file
  Tree show
  Introduced 20.10.R1
 

Platforms

All
client-tls-profile string
  Synopsis Connect over HTTP with a client TLS profile
  Context file show
  Tree client-tls-profile
  String Length 1 to 32
  Introduced 20.10.R1
 

Platforms

All
direct-http
  Synopsis Allow direct HTTP connection, do not follow redirects
  Context file show
  Tree direct-http
  Introduced 20.10.R1
 

Platforms

All
proxy string
  Synopsis Connect over HTTP with a proxy
  Context file show
  Tree proxy
  String Length 1 to 255
  Introduced 20.10.R1
 

Platforms

All
[url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
  Synopsis File URL
  Context file show
  Tree [url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All

unzip

  Synopsis Unzip files
  Context file
  Tree unzip
  Introduced 20.10.R1
 

Platforms

All
create-destination
  Synopsis Create destination directory if it does not exist
  Context file unzip
  Tree create-destination
  Introduced 20.10.R1
 

Platforms

All
[destination-url] (sat-url | cflash-url | string-not-all-spaces)
  Synopsis Destination URL or '.' for the working directory
  Context file unzip
  Tree [destination-url]
  String Length 1 to 200
  Introduced 20.10.R1
 

Platforms

All
force
  Synopsis Force the unzip operation without prompting
  Context file unzip
  Tree force
 

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.
  Introduced 20.10.R1
 

Platforms

All
list
  Synopsis List the file contents without the unzip operation
  Context file unzip
  Tree list
 

Notes

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

Platforms

All
[source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose)
  Synopsis Source URL
  Context file unzip
  Tree [source-url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All

version

  Synopsis Display the version of an SR OS image file
  Context file
  Tree version
  Introduced 20.10.R1
 

Platforms

All
[url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url)
  Synopsis File URL
  Context file version
  Tree [url]
  String Length 1 to 200
 

Notes

This element is mandatory.
  Introduced 20.10.R1
 

Platforms

All