The arguments for the 7705 SAR file commands are modeled after the standard universal resource locator (URL).
A URL can refer to a file (a file-url) or a directory (a directory-url).
The 7705 SAR supports operations on both the local file system and on remote files. For the purposes of categorizing the applicability of commands to local and remote file operations, URLs are divided into three types of URLs: local, FTP, and TFTP
The syntax for each of the URL types is listed in Table: URL Types and Syntax .
|
URL Type |
Syntax |
Notes |
|---|---|---|
|
local-url |
[cflash-id/] [file-path] |
cflash-id is the compact flash device name Values: cf1: | cf1-A: | cf1-B: | cf2: | cf2-A: | cf2-B: | cf3: | cf3-A: | cf3-B: (the 7705 SAR-18 supports all values; the 7705 SAR-8 Shelf V2 supports cf3:, cf3-A:, and cf3-B:; all fixed platforms support cf3: and cf3-A:) Length: 200 characters maximum, including cflash-id; directory length is 99 characters maximum each |
|
file-path is the path to the directory or file |
||
|
remote-url |
[ftp://login:pswd@remote-locn/] [file-path] |
An absolute FTP path from the root of the remote file system: Length: 255 characters maximum (could be less depending on command); directory length is 99 characters maximum each |
|
login is the FTP user name |
||
|
pswd is the FTP user password |
||
|
remote-locn is the remote host (hostname or IP address) Values:
|
||
|
file-path is the path to the directory or file |
||
|
ftp://login:pswd]@host/./path |
A relative FTP path from the user’s home directory. Note the period and slash (‟./”) in this syntax, as compared to the absolute path. |
|
|
destination-file-url |
[user@hostname:file-path] |
The destination file to be copied to a remote host file system |
|
user is the SSH user, 32 characters maximum |
||
|
hostname is the hostname of the remote location, up to 128 characters maximum Values:
|
||
|
file-path is the destination file path, 200 characters maximum; directory length is 99 characters maximum each |
||
|
tftp-url |
tftp://login:pswd@remote-locn/file-path |
TFTP is only supported for operations on file-urls |
Table: File Command Local and Remote File System Support lists the commands that are supported both locally and remotely.
Command |
local-url |
ftp-url |
tftp-url |
|---|---|---|---|
attrib |
✓ |
||
cd |
✓ |
✓ |
|
copy |
✓ |
✓ |
✓ |
delete |
✓ |
✓ |
|
dir |
✓ |
✓ |
|
md |
✓ |
||
move |
✓ |
✓ |
|
rd |
✓ |
||
repair |
|||
scp |
source only |
||
type |
✓ |
✓ |
✓ |
version |
✓ |
✓ |
✓ |
The 7705 SAR accepts either forward slash (‟/”) or backslash (‟\”) characters to delimit directory and/or filenames in URLs. Similarly, the 7705 SAR SCP client application uses either slash or backslash characters, but not all SCP clients treat backslash characters as equivalent to slash characters. In particular, UNIX systems interpret the backslash character as an ‟escape” character. This causes problems when using an external SCP client application to send files to the 7705 SAR SCP server. If the external system treats the backslash like an escape character, the backslash delimiter gets stripped by the parser and is not transmitted to the 7705 SAR SCP server.
For example, a destination directory specified as ‟cf3:\dir1\file1” is transmitted to the 7705 SAR SCP server as ‟cf3:dir1file1” where the backslash escape characters are stripped by the SCP client system before transmission. On systems where the client treats the backslash like an ‟escape” character, a double backslash ‟\\” or the forward slash ‟/” can typically be used to properly delimit directories and the filename.