char[12]  File Name
byte      Flags
char[...] File Data

Sent when: player requests a file from the host (using the send command), or probably at other times

Sent to: whomever it may concern

This record is used to transmit a file from the host to a player. It consists of a 13-byte header, followed immediately by the file data.

The File Name contains the null-padded file name. Only DOS 8.3 file names are allowed which have a maximum length of 12 characters total. The Flags contain additional flags which describe the file. Currently, only the least-significant bit is used, all others are zero (reserved for future use).

  • Bit 0 = 0: file is a binary file and must be unpacked verbatim
  • Bit 0 = 1: file is a text file, in DOS text format (lines terminated with CR+LF). Unpackers may translate it accordingly. Note that PHost 2.x sends text files verbatim as they are on the host system.

► Note: Files larger than 32k can't currently be sent through this interface. We're considering an extension to allow that at a later time. If you need it, bug us :-)

Currently, PHost uses this record for the following tasks:

  • to send the pconfig.src and shiplist.txt files, in response the send config command or the con friendly code. These files are text files.
  • to send the race.nm file when requested via the send racenames command. This is a binary file.
  • to send the xtrfcode.txt file when requested via the send fcodes command. This is a text file.

Add-on programs may use this record for a similar purpose.

This is a testing version.
It may be incomplete, and have more bugs (or features) than the public live version at planetscentral.com.