Structured Lists
The normal directory listing output is designed for human readability. If you will be using movedat in an embedded environment, or will otherwise need to machine parse the listings, you can also obtain a structured listing.
Structured listings are produced by servedat version 1.9 or later using one of three built-in package types:
| *li | List all files in the specified directory path. |
| *lr | List the entire directory tree, starting at the specified directory path and recursing into all sub-directories. |
| *ls | List information only for the specified file or directory path. |
For example, to obtain a structured directory listing, you might type:
movedat user@server:pathname=\*li
Notice the use of a backslash to escape the asterisk character from the command shell. In an embedded call that does not include shell parsing, you may need to leave that out.
The server will return a series of ASCII text lines. Each line is terminated with a single newline character. The records on each line are delimited by tab characters.
The specifications given here are based on servedat version 1.10, which ships with ExpeDat 1.9. For specifications relating to other server versions, refer to the documentation for that server.
Header Format
The first line contains information about the server.
| Name | The name of the server. Usually "servedat". |
| Version | The revision code of the server. |
| System | One of win32, osx, linux, netbsd, freebsd, irix, solaris, hpux, or unknown. |
| Current Time | The server's "unix" time as a hexadecimal count of seconds UTC since January 1, 1970. |
| Time Zone | The three character time-zone abbreviation for the server clock. |
| Path Delimiter | The delimiting character used to separate path components. Usually '/'. |
| Restrictions | A comma separated list of access restrictions, based on the server configuration and access permissions. Possible values include: |
| ro | Read Only |
| rh | Restrict Home |
| nl | No links (symbolic links may not be created)
|
| User : Group | The effective user and group IDs which apply to this inquiry. Expressed as two hexadecimal numbers separated by a colon ':'. This field may be omitted. |
Listing Format
Each line after the header corresponds to one file or directory.
| Relative Path | The pathname of the file relative to the path being listed. Files in subdirectories will use the delimiter specified in the header. Reserved characters will be escaped using a percent character followed by two hexadecimal characters specifying the byte code. For example, "%9F". |
| Size | The size of the file in hexadecimal bytes. This value may have no meaning for directories or other irregular files. |
| Modification Date | The system modification date stamp, as a hexadecimal count of seconds UTC since January 1, 1970. |
| File Type | The first character is one of 'D'irectory, 'F'ile, 'L'ink, or 'O'ther. Additional characters may express additional subtypes. Currently only 'h'idden is supported. |
| Access Mode | A 9-bit field specifying the Read Write eXecute permissions for the owner, group, and world. On unix systems, this is the lower 9-bits of the file mode. On Windows systems it is contrived from the Read-Only setting of the file. Additional bits, if present, should be ignored. |
| User : Group | The effective user and group IDs of this file. Expressed as two hexadecimal numbers separated by a colon ':'. This field may be omitted. |
| Description | For symbolic links, this field specifies the target path. This field may be omitted. |
Example listing
prompt# movedat DataExpedition.com:=\*li
| servedat | 1.10.3 | osx | 47434A3B | CST | / | ro,rh,nl | ffffffff:ffffffff |
| Product Info and Downloads | 0 | 4242F3B6 | F | 81A4 | 2721:46 | ||
| .DS_Store | 3004 | 4729F9D7 | Fh | 81ED | 2721:50 | ||
| .htaccess | 15DA | 4734AACF | Fh | 81A4 | 2721:50 | ||
| DEI-MTP-Info.pdf | 392E1 | 46BCBFC6 | F | 81A4 | 2721:40B | ||
| DEI-Sales-050823.pdf | 37006 | 448EFBC0 | F | 81A4 | 2721:46 | ||
| DEI-Sales-050823.swf | 49F78 | 430B6B9E | F | 81A4 | 2721:46 | ||
| DEI-WP.pdf | 1EB44 | 46B0A8D6 | F | 81A4 | 2721:46 | ||
| expedat | 550 | 47429682 | D | 41ED | 2721:46 | ||
| hypergate | 30E | 47429660 | D | 41ED | 2721:46 | ||
| MTP-Dev-060606.pdf | 36149 | 4485F8B7 | F | 81A4 | 2721:46 | ||
| MTP-Dev-060606.swf | 5EFBC | 4485F8CE | F | 81A4 | 2721:46 | ||
| MTP-DigitalHour.mp3 | 72D804 | 412CCEAD | F | 81A4 | 2721:14 | ||
| MTP-Tech-060224.swf | 66079 | 43FF60A1 | F | 81A4 | 2721:46 | ||
| syncdat | 3B8 | 47429689 | D | 41ED | 2721:46 | ||
| Test Report Vnet.pdf | 7DF91 | 3E68D295 | F | 81A4 | 2721:50 | ||
| tst | AA | 4577420C | D | 41ED | 2721:46 | ||
| utility | 396 | 4742968E | D | 41ED | 2721:46 | ||