5. file commands

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

string
keyword
string
copy
source-url sring
destination-url string
client-tls-profile string
force
proxy string
disable
active
cflash-id string
standby
enable
active
cflash-id string
standby
format
string
keyword
string
reverse
string
move
string
string
client-tls-profile string
force
proxy string
keyword
string
remove
string
client-tls-profile string
force
proxy string
string
force
repair
string
show
string
client-tls-profile string
proxy string
unzip
string
string
force
list
version
string

5.1. file command descriptions

file

Synopsis

Perform file operations

Context
Tree
Description

Commands in this context execute file management operations.

Introduced

20.10.R1

Platforms

All

change-directory

Synopsis

Change the working directory

Introduced

20.10.R1

Platforms

All

[url] strings

Synopsis

New working directory URL

Context
String Length

1 to 200

Default

.

Introduced

20.10.R1

Platforms

All

checksum

Synopsis

Compute and display checksums

Context
Tree
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 keyword

Options

image, md5, sha256

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

[url] string

Synopsis

File URL

Context

file checksum string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

copy

Synopsis

Copy files

Context
Tree
Introduced

20.10.R1

Platforms

All

[source-url] string

Synopsis

Source URL

Context

file copy string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

[destination-url] string

Synopsis

Destination URL or '.' for the working directory

Context

file copy string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

client-tls-profile string

Synopsis

Connect over HTTP with a 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

Introduced

20.10.R1

Platforms

All

force

Synopsis

Force copy without prompting before overwriting

Context
Tree
Introduced

20.10.R1

Platforms

All

proxy string

Synopsis

Connect over HTTP with a proxy

Context

file copy proxy string

Tree
String Length

1 to 255

Introduced

20.10.R1

Platforms

All

recursive

Synopsis

Copy sub-directories encountered at the source URL

Tree
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

disable

Synopsis

Disable compact flash devices

Context
Tree
Introduced

20.10.R1

Platforms

All

active

Synopsis

Disable all devices on the active CPM

Tree
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
Tree
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

Tree
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
Tree
Introduced

20.10.R1

Platforms

All

active

Synopsis

Enable all devices on the active CPM

Context
Tree
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
Tree
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

Tree
Notes

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

Introduced

20.10.R1

Platforms

All

format

Synopsis

Format a compact flash device

Context
Tree
Introduced

20.10.R1

Platforms

All

[cflash-id] string

Synopsis

Compact flash ID

Context

file format string

String Length

4 to 6

Introduced

20.10.R1

Platforms

All

list

Synopsis

List directory contents

Context
Tree
Introduced

20.10.R1

Platforms

All

[sort-order] keyword

Synopsis

Sort order for the directory

Context

file list keyword

Options

date, name, size

Introduced

20.10.R1

Platforms

All

[url] string

Synopsis

Location of the directory to be listed

Context

file list string

String Length

1 to 200

Default

.

Introduced

20.10.R1

Platforms

All

reverse

Synopsis

List files in reverse sort order

Context
Tree
Introduced

20.10.R1

Platforms

All

make-directory

Synopsis

Make a directory

Introduced

20.10.R1

Platforms

All

[url] string

Synopsis

Directory location

Context
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
Tree
Introduced

20.10.R1

Platforms

All

[source-url] string

Synopsis

Source URL

Context

file move string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

[destination-url] string

Synopsis

Destination URL or '.' for the working directory

Context

file move string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

client-tls-profile string

Synopsis

Connect over HTTP with a 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

Introduced

20.10.R1

Platforms

All

force

Synopsis

Force move without prompting before overwriting

Context
Tree
Introduced

20.10.R1

Platforms

All

proxy string

Synopsis

Connect over HTTP with a proxy

Context

file move proxy string

Tree
String Length

1 to 255

Introduced

20.10.R1

Platforms

All

permission

Synopsis

Show or set file permissions

Context
Introduced

20.10.R1

Platforms

All

[attribute] keyword

Synopsis

File permission

Context
Options

read-only, read-write

Introduced

20.10.R1

Platforms

All

[url] string

Synopsis

File URL to set permissions

Context
String Length

1 to 200

Introduced

20.10.R1

Platforms

All

remove

Synopsis

Remove files

Context
Tree
Introduced

20.10.R1

Platforms

All

[url] string

Synopsis

File URL

Context

file remove string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

client-tls-profile string

Synopsis

Connect over HTTP with a 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

Introduced

20.10.R1

Platforms

All

force

Synopsis

Force removal without prompting

Context
Tree
Introduced

20.10.R1

Platforms

All

proxy string

Synopsis

Connect over HTTP with a proxy

Context
Tree
String Length

1 to 255

Introduced

20.10.R1

Platforms

All

remove-directory

Synopsis

Remove directories

Introduced

20.10.R1

Platforms

All

[url] string

Synopsis

Directory URL

Context
String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

force

Synopsis

Force removal without prompting

Tree
Introduced

20.10.R1

Platforms

All

recursive

Synopsis

Remove directory and contents recursively

Tree
Introduced

20.10.R1

Platforms

All

repair

Synopsis

Repair a compact flash file system

Context
Tree
Introduced

20.10.R1

Platforms

All

cflash-id string

Synopsis

Compact flash ID

Context
Tree
String Length

4 to 6

Introduced

20.10.R1

Platforms

All

show

Synopsis

Display the contents of a file

Context
Tree
Introduced

20.10.R1

Platforms

All

[url] string

Synopsis

File URL

Context

file show string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

client-tls-profile string

Synopsis

Connect over HTTP with a 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

Introduced

20.10.R1

Platforms

All

proxy string

Synopsis

Connect over HTTP with a proxy

Context

file show proxy string

Tree
String Length

1 to 255

Introduced

20.10.R1

Platforms

All

unzip

Synopsis

Unzip files

Context
Tree
Introduced

20.10.R1

Platforms

All

[source-url] string

Synopsis

Source URL

Context

file unzip string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All

[destination-url] string

Synopsis

Destination URL or '.' for the working directory

Context

file unzip string

String Length

1 to 200

Introduced

20.10.R1

Platforms

All

create-destination

Synopsis

Create destination directory if it does not exist

Introduced

20.10.R1

Platforms

All

force

Synopsis

Force the unzip operation without prompting

Context
Tree
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
Tree
Notes

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

Introduced

20.10.R1

Platforms

All

version

Synopsis

Display the version of an SR OS image file

Context
Tree
Introduced

20.10.R1

Platforms

All

[url] string

Synopsis

File URL

Context

file version string

String Length

1 to 200

Notes

This element is mandatory.

Introduced

20.10.R1

Platforms

All