URLs

The arguments for the 7210 SAS file commands are modeled after standard universal resource locator (URL). A URL refers to a file (a file-url) or a directory (a directory-url).

7210 SAS OS 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: local, ftp and tftp. The syntax for each of the URL types is listed in the following table.

Table: URL types and syntax

URL type

Syntax

Notes

local-url

[cflash-id:\]path

[usb-flash-id:\]path

cflash-id is the compact flash device name

Values: cf1:\ and cf2:\ (only on 7210 SAS-T and 7210 SAS-Mxp)

usb-flash-id is the USB device name

Values: uf1:\

ftp-url

ftp://[username[:password]@]host/path

An absolute ftp path from the root of the remote file system

username is the ftp username

password is the ftp user password

host is the remote host

path is the path to the directory or file

ftp://[username[:password]@]host/./path

A relative ftp path from the user’s home directory

Note the period and slash (‟./”) in this syntax compared to the absolute path

tftp-url

tftp://host[/path]/filename

tftp is only supported for operations on file-urls

All the commands can operate on the local file system. The following table describes which commands also support remote file operations.

Table: File command local and remote file system support

Command

local-url

ftp-url

tftp-url

attrib

cd

copy

delete

dir

md

move

rd

scp

source only

type

version

The system accepts either forward slash (‟/”) or backslash (‟\”) characters to delimit directories and filenames in URLs. Similarly, the SCP client application on the 7210 SAS can use either slash or backslash characters, but not all SCP clients treat backslash characters as equivalent to slash characters. In particular, UNIX systems will often times interpret the backslash character as an ‟escape” character. This can cause problems when using an external SCP client application to send files to the SCP server. If the external system treats the backslash like an escape character, the backslash delimiter will get stripped by the parser and will not be transmitted to the SCP server.

For example, a destination directory specified as ‟cf1:\dir1\file1” will be transmitted to the SCP server as ‟cf1: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 correctly delimit directories and the filename.