The xrootd Protocol

Version 2.9.2

Andrew Hanushevsky

Stanford Linear Accelerator Center

7-April-2008

©2004-2008 by the Board of Trustees of the Leland Stanford, Jr., University

All Rights Reserved

Produced under contract DE-AC02-76-SFO0515 with the Department of Energy

This code is available under a BSD-style license allowing minimally restricted use.

1 Contents

1 Contents. 3

2 Request/Response Protocol 5

2.1 Format of Client-Server Initial Handshake. 5

2.2 Data Serialization. 6

2.3 Client Request Format 9

2.3.1 Valid Client Requests. 10

2.3.2 Valid Client Paths. 11

2.3.3 Client Recovery From Server Failures. 11

2.3.4 Client Recovery From File Location Failures. 12

2.4 Server Response Format 13

2.4.1 Valid Server Response Status Codes. 14

2.4.2 Server kXR_attn Response Format 15

2.4.2.1 Server kXR_attn Response for kXR_asyncab Client Action. 17

2.4.2.2 Server kXR_attn Response for kXR_asyncdi Client Action. 18

2.4.2.3 Server kXR_attn Response for kXR_asyncgo Client Action. 19

2.4.2.4 Server kXR_attn Response for kXR_asyncms Client Action. 20

2.4.2.5 Server kXR_attn Response for kXR_asyncrd Client Action. 21

2.4.2.6 Server kXR_attn Response for kXR_asynresp Client Action. 23

2.4.2.7 Server kXR_attn Response for kXR_asyncwt Client Action. 24

2.4.3 Server kXR_authmore Response Format 25

2.4.4 Server kXR_error Response Format 26

2.4.4.1 Server kXR_error Sub-Codes. 27

2.4.5 Server kXR_ok Response Format 28

2.4.6 Server kXR_oksofar Response Format 29

2.4.7 Server kXR_redirect Response Format 30

2.4.8 Server kXR_wait Response Format 32

2.4.9 Server kXR_waitresp Response Format 33

3 Detailed Protocol Specifications. 35