File transfers of entire trees require a lot more meta-data and prior setup to link paths to files with unique ids so that clients can track them. This profile provides a more robust method of defining that meta-data so that directory trees can be transfered.

• Provide a full featured set of information that is applicable to tree transfers.
• Meta-data that is to be provided:
  • number of files
  • size of entire tree
  • list of files and stream ids

The tree transfer profile is in the "http://jabber.org/protocol/si/profile/tree-transfer" namespace. The profile is fairly simple: it consists of the root element with child elements that specify a directory structure of files with stream ids that will be used for each file.

This profile requires support for the File Transfer profile described in &jep0096;. Once you have accepted this SI, a new SI using the File Transfer profile will be offered for each file in the tree. This profile provides a mapping of files with paths and reserved stream ids which will be used to auto-accept a File Transfer SI that uses that same stream id from the sender.

The root element is <tree> and has two attributes. The attributes are used only during the offer stage of stream initiation:

• size - The size, in bytes, of all of the files to be sent.
• numfiles - The number of files/File Transfer SIs that are in the tree.

The size and numfiles attributes MUST be present in the profile.

The only possible child element of the root is <directory/> since there are other JEPs that handle single file transfers. The directory structure is sent in a hierarchical manner with nested <directory/> and/or <file/> tags. One or more <file/> elements will be sent, one for each file. One or more <directory/> elements will be sent, one for each directory.

The <directory/> element has one attribute:

• name - The name of the directory to create on the target system.

The attribute is REQUIRED on each <directory/> element.

The <file/> element has two attributes:

• sid - The stream id that MUST be sent for the File Transfer SI.
• name - The name of the file. The file should be saved to the same location in the target directory tree as the <directory/> hierarchy defines.

Both attributes are REQUIRED on each <file/> element. The total number of <file> elements MUST equal the numfiles attribute sent in the <tree/> element.

The stream-method that is accepted for a Tree Profile SI MUST be remembered and the subsequent File Transfer SIs MUST NOT provide a Feature Negotiation packet. The stream-method has already been chosen and should be used for all of the streams.

Implementations of this profile MUST support &jep0095; and JEP-0096.

Above is repeated for ft2, ft3, etc...

No interaction with &IANA; is required as a result of this JEP.

The profile described in this JEP will be registered with ®ISTRAR; as a valid Stream Initiation profile.