Heading:
LookupFile Protocol
Page Numbers: Yes X: 527 Y: 10.5"
Inter-Office Memorandum
ToCommunication ProtocolsDateSeptember 10, 1982
FromEd TaftLocationPARC/CSL
SubjectLookupFile ProtocolFile[Maxc]<Pup>LookupFile.bravo
XEROX
Attributes:informal, technical, communication, filing
Abstract:The existence of a file, along with its create date and length hint, may be determined by a single exchange of packets with a LookupFile server.
The existence of a file, along with its create date and length hint, may be determined by a single exchange of packets with the LookupFile server. This is intended to provide a means of file validation much cheaper than either FTP or Leaf. Its principal intended application is the CIFS file cache manager in Cedar.
The server resides on socket 61B of any file server that offers this service. The client initiates the exchange with:
LookupFileRequest:
Pup type: 200B
Pup ID: chosen by client
Pup contents: a text string identifying the file
If the server is not offering this service, it responds with an Error Pup with sub-type 2, ‘‘no such port’’. Otherwise, it responds with one of:
LookupFileReply:
Pup type: 201B
Pup ID: same as LookupFileRequest Pup
Pup contents: 3 words, as follows:
file version number (1 word)
file create date, in standard Alto packed format (2 words, high-order word first—note that this is the reverse of the word order for a Mesa LONG CARDINAL)
file length in 8-bit bytes (2 words, high-order word first)—note that this is only a hint, and doesn’t include the leader page.
LookupFileError:
Pup type: 202B
Pup ID: same as LookupFileRequest Pup
Pup contents: 1-word error code whose interpretation is server-dependent
It is the client’s responsibility to choose Pup IDs in such a way that it can correctly match responses with requests.
This protocol is currently implemented by IFS file servers running version 1.36.4 or newer of the IFS software.
The IFS implementation requires that the LookupFileRequest contain a complete IFS filename in the form ‘‘<directory>subdirectories>..>name!version’’, except that the version may be one of the special version designators (‘‘!H’’ or ‘‘!L’’), or may be omitted altogether in which case "!H" is assumed. Patterns containing ‘‘*’’ are not permitted.
The error codes returned by IFS LookupFile servers are IFS internal error codes, whose interpretation may be found in file <System>IFS.errors on that server.