file commands

See “File management” in the 7705 SAR Gen 2 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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

change-directory


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

[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	.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

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 Gen 2

[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 Gen 2

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


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

copy


	Synopsis	Copy files
	Context	file copy
	Tree	copy
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

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 Gen 2

[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
	Context	file 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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

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 Gen 2

force


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

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 Gen 2

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 Gen 2

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 Gen 2

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


	Synopsis	Source URL
	Context	file 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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

disable


	Synopsis	Disable compact flash devices
	Context	file disable
	Tree	disable
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

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 Gen 2

cflash-id cflash-id


	Synopsis	Disable the compact flash 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 Gen 2

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 Gen 2

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 Gen 2

[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 Gen 2

enable


	Synopsis	Enable compact flash devices
	Context	file enable
	Tree	enable
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

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 Gen 2

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 Gen 2

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 Gen 2

format


	Synopsis	Format a compact flash device
	Context	file format
	Tree	format
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cflash-id] cflash-id


	Synopsis	Compact flash ID
	Context	file format [cflash-id] cflash-id
	Tree	[cflash-id]
	String length	4 to 6
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

list


	Synopsis	List directory contents
	Context	file list
	Tree	list
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

reverse


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

[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 Gen 2

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


	Synopsis	Location of the directory to be listed
	Context	file 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	.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

make-directory


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

[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	25.3.R2
	Platforms	7705 SAR Gen 2

move


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

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 Gen 2

[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 [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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

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 Gen 2

force


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

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 Gen 2

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


	Synopsis	Source URL
	Context	file 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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

permission


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

[attribute] keyword


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

[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 Gen 2

remove


	Synopsis	Remove files
	Context	file remove
	Tree	remove
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

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 Gen 2

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 Gen 2

force


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

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 Gen 2

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


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

remove-directory


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

force


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

recursive


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

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


	Synopsis	Directory URL
	Context	file 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	25.3.R2
	Platforms	7705 SAR Gen 2

repair


	Synopsis	Repair a compact flash file system
	Context	file repair
	Tree	repair
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cflash-id] cflash-id


	Synopsis	Compact flash ID
	Context	file repair [cflash-id] cflash-id
	Tree	[cflash-id]
	String length	4 to 6
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

show


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

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 Gen 2

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 Gen 2

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 Gen 2

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


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

unzip


	Synopsis	Unzip files
	Context	file unzip
	Tree	unzip
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

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 Gen 2

[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 Gen 2

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 Gen 2

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 Gen 2

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


	Synopsis	Source URL
	Context	file 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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

version


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

[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 Gen 2