file commands

See “File management” in the 7705 SAR Gen 2 Basic System Configuration Guide for more information.

file 
   —  change-directory 
      —  router-instance string
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | sftp-url)
   —  checksum 
      —  router-instance string
      —  [type] keyword
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | sftp-url)
   —  copy 
      —  client-tls-profile string
      —  [destination-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose | scp-url | sftp-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 | sftp-url)
   —  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] (sat-url | cflash-url | string-not-all-spaces | ftp-url | sftp-url)
   —  make-directory 
      —  router-instance string
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | sftp-url)
   —  move 
      —  client-tls-profile string
      —  [destination-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose | sftp-url)
      —  direct-http 
      —  force 
      —  proxy http-url
      —  router-instance string
      —  [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose | sftp-url)
   —  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] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose | sftp-url)
   —  remove-directory 
      —  force 
      —  recursive 
      —  router-instance string
      —  [url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | sftp-url)
   —  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] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose | sftp-url)
   —  unzip 
      —  create-destination 
      —  [destination-url] (sat-url | cflash-url | string-not-all-spaces)
      —  force 
      —  list 
      —  router-instance string
      —  [source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose | sftp-url)
   —  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.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

change-directory


	Synopsis	Change the working directory
	Context	file change-directory
	Tree	change-directory
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file change-directory router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | sftp-url)


	Synopsis	New working directory URL
	Context	file change-directory [url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-url \| sftp-url)
	Tree	[url]
	String length	1 to 200 (sat-url, cflash-url, string-not-all-spaces) 1 to 180 (ftp-url, sftp-url)
	Default	.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

checksum


	Synopsis	Compute and display checksums
	Context	file checksum
	Tree	checksum
	Description	This command computes and displays an image file or a checksum for a file.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file checksum router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[type] keyword


	Synopsis	Checksum option type
	Context	file checksum [type] keyword
	Tree	[type]
	Options	image, md5, sha256
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | sftp-url)


	Synopsis	File URL
	Context	file checksum [url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-tftp-url \| sftp-url)
	Tree	[url]
	String length	1 to 200 (sat-url, cflash-url, string-not-all-spaces) 1 to 199 (ftp-tftp-url) 1 to 180 (sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

copy


	Synopsis	Copy files
	Context	file copy
	Tree	copy
	Introduced	25.3.R2
	Platforms	7705 SAR-1

client-tls-profile string


	Synopsis	Connect over HTTP with a client TLS profile
	Context	file copy client-tls-profile string
	Tree	client-tls-profile
	String length	1 to 32
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[destination-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose | scp-url | sftp-url)


	Synopsis	Destination URL or '.' for the working directory
	Context	file copy [destination-url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-tftp-url \| http-url-loose \| scp-url \| sftp-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, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

direct-http


	Synopsis	Allow direct HTTP connection, do not follow redirects
	Context	file copy direct-http
	Tree	direct-http
	Introduced	25.3.R2
	Platforms	7705 SAR-1

force


	Synopsis	Force copy without prompting before overwriting
	Context	file copy force
	Tree	force
	Introduced	25.3.R2
	Platforms	7705 SAR-1

proxy http-url


	Synopsis	Connect over HTTP with a proxy
	Context	file copy proxy http-url
	Tree	proxy
	String length	1 to 255
	Introduced	25.3.R2
	Platforms	7705 SAR-1

recursive


	Synopsis	Copy sub-directories encountered at the source URL
	Context	file copy recursive
	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	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or VPRN service name
	Context	file copy router-instance string
	Tree	router-instance
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose | sftp-url)


	Synopsis	Source URL
	Context	file copy [source-url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-tftp-url \| http-url-loose \| sftp-url)
	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, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

disable


	Synopsis	Disable storage devices
	Context	file disable
	Tree	disable
	Introduced	25.3.R2
	Platforms	7705 SAR-1

active


	Synopsis	Disable all devices on the active CPM
	Context	file disable active
	Tree	active
	Notes	The following elements are part of a choice: active, cflash-id, or standby.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

cflash-id cflash-id


	Synopsis	Disable the storage device
	Context	file disable cflash-id cflash-id
	Tree	cflash-id
	String length	4 to 6
	Notes	The following elements are part of a choice: active, cflash-id, or standby.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

standby


	Synopsis	Disable all devices on the standby CPM
	Context	file disable standby
	Tree	standby
	Notes	The following elements are part of a choice: active, cflash-id, or standby.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

edit


	Synopsis	Edit files with the text editor
	Context	file edit
	Tree	edit
	Description	This command allows users to edit files with the text editor. See "Text editor" in the 7705 SAR Gen 2 Basic System Configuration Guide for more information.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces)


	Synopsis	File URL
	Context	file edit [url] (sat-url \| cflash-url \| string-not-all-spaces)
	Tree	[url]
	String length	1 to 200
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

enable


	Synopsis	Enable storage devices
	Context	file enable
	Tree	enable
	Introduced	25.3.R2
	Platforms	7705 SAR-1

active


	Synopsis	Enable all devices on the active CPM
	Context	file enable active
	Tree	active
	Notes	The following elements are part of a choice: active, cflash-id, or standby.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

cflash-id cflash-id


	Synopsis	Enable the compact flash device
	Context	file enable cflash-id cflash-id
	Tree	cflash-id
	String length	4 to 6
	Notes	The following elements are part of a choice: active, cflash-id, or standby.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

standby


	Synopsis	Enable all devices on the standby CPM
	Context	file enable standby
	Tree	standby
	Notes	The following elements are part of a choice: active, cflash-id, or standby.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

format


	Synopsis	Format a storage device
	Context	file format
	Tree	format
	Description	This command formats a storage device with a new file system without erasing the data. The device must be administratively disabled first.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[cflash-id] cflash-id


	Synopsis	Format a storage device
	Context	file format [cflash-id] cflash-id
	Tree	[cflash-id]
	String length	4 to 6
	Introduced	25.3.R2
	Platforms	7705 SAR-1

list


	Synopsis	List directory contents
	Context	file list
	Tree	list
	Introduced	25.3.R2
	Platforms	7705 SAR-1

reverse


	Synopsis	List files in reverse sort order
	Context	file list reverse
	Tree	reverse
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file list router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[sort-order] keyword


	Synopsis	Sort order for the directory
	Context	file list [sort-order] keyword
	Tree	[sort-order]
	Options	date, name, size
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | sftp-url)


	Synopsis	Location of the directory to be listed
	Context	file list [url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-url \| sftp-url)
	Tree	[url]
	String length	1 to 200 (sat-url, cflash-url, string-not-all-spaces) 1 to 180 (ftp-url, sftp-url)
	Default	.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

make-directory


	Synopsis	Make a directory
	Context	file make-directory
	Tree	make-directory
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file make-directory router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | sftp-url)


	Synopsis	Directory location
	Context	file make-directory [url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-url \| sftp-url)
	Tree	[url]
	String length	1 to 200 (sat-url, cflash-url, string-not-all-spaces) 1 to 180 (ftp-url, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

move


	Synopsis	Move or rename files or directories
	Context	file move
	Tree	move
	Introduced	25.3.R2
	Platforms	7705 SAR-1

client-tls-profile string


	Synopsis	Connect over HTTP with a client TLS profile
	Context	file move client-tls-profile string
	Tree	client-tls-profile
	String length	1 to 32
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[destination-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose | sftp-url)


	Synopsis	Destination URL or '.' for the working directory
	Context	file move [destination-url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-url \| http-url-loose \| sftp-url)
	Tree	[destination-url]
	String length	1 to 200 (sat-url, cflash-url, string-not-all-spaces) 1 to 180 (ftp-url, http-url-loose, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

direct-http


	Synopsis	Allow direct HTTP connection, do not follow redirects
	Context	file move direct-http
	Tree	direct-http
	Introduced	25.3.R2
	Platforms	7705 SAR-1

force


	Synopsis	Force move without prompting before overwriting
	Context	file move force
	Tree	force
	Introduced	25.3.R2
	Platforms	7705 SAR-1

proxy http-url


	Synopsis	Connect over HTTP with a proxy
	Context	file move proxy http-url
	Tree	proxy
	String length	1 to 255
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file move router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose | sftp-url)


	Synopsis	Source URL
	Context	file move [source-url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-url \| http-url-loose \| sftp-url)
	Tree	[source-url]
	String length	1 to 200 (sat-url, cflash-url, string-not-all-spaces) 1 to 180 (ftp-url, http-url-loose, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

permission


	Synopsis	Show or set file permissions
	Context	file permission
	Tree	permission
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[attribute] keyword


	Synopsis	File permission
	Context	file permission [attribute] keyword
	Tree	[attribute]
	Options	read-only, read-write
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[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 length	1 to 200
	Introduced	25.3.R2
	Platforms	7705 SAR-1

remove


	Synopsis	Remove files
	Context	file remove
	Tree	remove
	Introduced	25.3.R2
	Platforms	7705 SAR-1

client-tls-profile string


	Synopsis	Connect over HTTP with a client TLS profile
	Context	file remove client-tls-profile string
	Tree	client-tls-profile
	String length	1 to 32
	Introduced	25.3.R2
	Platforms	7705 SAR-1

direct-http


	Synopsis	Allow direct HTTP connection, do not follow redirects
	Context	file remove direct-http
	Tree	direct-http
	Introduced	25.3.R2
	Platforms	7705 SAR-1

force


	Synopsis	Force removal without prompting
	Context	file remove force
	Tree	force
	Introduced	25.3.R2
	Platforms	7705 SAR-1

proxy http-url


	Synopsis	Connect over HTTP with a proxy
	Context	file remove proxy http-url
	Tree	proxy
	String length	1 to 255
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file remove router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | http-url-loose | sftp-url)


	Synopsis	File URL
	Context	file remove [url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-url \| http-url-loose \| sftp-url)
	Tree	[url]
	String length	1 to 200 (sat-url, cflash-url, string-not-all-spaces) 1 to 180 (ftp-url, http-url-loose, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

remove-directory


	Synopsis	Remove directories
	Context	file remove-directory
	Tree	remove-directory
	Introduced	25.3.R2
	Platforms	7705 SAR-1

force


	Synopsis	Force removal without prompting
	Context	file remove-directory force
	Tree	force
	Introduced	25.3.R2
	Platforms	7705 SAR-1

recursive


	Synopsis	Remove directory and contents recursively
	Context	file remove-directory recursive
	Tree	recursive
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file remove-directory router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-url | sftp-url)


	Synopsis	Directory URL
	Context	file remove-directory [url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-url \| sftp-url)
	Tree	[url]
	String length	1 to 200 (sat-url, cflash-url, string-not-all-spaces) 1 to 180 (ftp-url, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

repair


	Synopsis	Repair a storage device file system
	Context	file repair
	Tree	repair
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[cflash-id] cflash-id


	Synopsis	Storage device to repair
	Context	file repair [cflash-id] cflash-id
	Tree	[cflash-id]
	String length	4 to 6
	Introduced	25.3.R2
	Platforms	7705 SAR-1

secure-erase


	Synopsis	Secure erase and format a storage device
	Context	file secure-erase
	Tree	secure-erase
	Description	This command secure erases and formats a storage device with a new file system. The device must be administratively disabled first.
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[cflash-id] cflash-id


	Synopsis	Storage device to secure erase and format
	Context	file secure-erase [cflash-id] cflash-id
	Tree	[cflash-id]
	Description	[
	String length	4 to 6
	Introduced	25.10.R1
	Platforms	7705 SAR-1

show


	Synopsis	Display the contents of a file
	Context	file show
	Tree	show
	Introduced	25.3.R2
	Platforms	7705 SAR-1

client-tls-profile string


	Synopsis	Connect over HTTP with a client TLS profile
	Context	file show client-tls-profile string
	Tree	client-tls-profile
	String length	1 to 32
	Introduced	25.3.R2
	Platforms	7705 SAR-1

direct-http


	Synopsis	Allow direct HTTP connection, do not follow redirects
	Context	file show direct-http
	Tree	direct-http
	Introduced	25.3.R2
	Platforms	7705 SAR-1

proxy http-url


	Synopsis	Connect over HTTP with a proxy
	Context	file show proxy http-url
	Tree	proxy
	String length	1 to 255
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file show router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose | sftp-url)


	Synopsis	File URL
	Context	file show [url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-tftp-url \| http-url-loose \| sftp-url)
	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, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

unzip


	Synopsis	Unzip files
	Context	file unzip
	Tree	unzip
	Introduced	25.3.R2
	Platforms	7705 SAR-1

create-destination


	Synopsis	Create destination directory if it does not exist
	Context	file unzip create-destination
	Tree	create-destination
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[destination-url] (sat-url | cflash-url | string-not-all-spaces)


	Synopsis	Destination URL or '.' for the working directory
	Context	file unzip [destination-url] (sat-url \| cflash-url \| string-not-all-spaces)
	Tree	[destination-url]
	String length	1 to 200
	Introduced	25.3.R2
	Platforms	7705 SAR-1

force


	Synopsis	Force the unzip operation without prompting
	Context	file unzip force
	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	25.3.R2
	Platforms	7705 SAR-1

list


	Synopsis	List the file contents without the unzip operation
	Context	file unzip list
	Tree	list
	Notes	The following elements are part of a choice: force or list.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

router-instance string


	Synopsis	Router name or service name
	Context	file unzip router-instance string
	Tree	router-instance
	Introduced	25.10.R1
	Platforms	7705 SAR-1

[source-url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url | http-url-loose | sftp-url)


	Synopsis	Source URL
	Context	file unzip [source-url] (sat-url \| cflash-url \| string-not-all-spaces \| ftp-tftp-url \| http-url-loose \| sftp-url)
	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, sftp-url)
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR-1

version


	Synopsis	Display the version of an SR OS image file
	Context	file version
	Tree	version
	Introduced	25.3.R2
	Platforms	7705 SAR-1

[url] (sat-url | cflash-url | string-not-all-spaces | ftp-tftp-url)


	Synopsis	File URL
	Context	file 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.
	Introduced	25.3.R2
	Platforms	7705 SAR-1