********************************************************************** FTSC FIDONET TECHNICAL STANDARDS COMMITTEE ********************************************************************** Publication: FRL-1005 Revision: 1 Title: Via kludge specification Author: Colin Turner, Joaquim Homrighausen Issue Date: 27 May 2003 Expiry Date: N/A ---------------------------------------------------------------------- Contents: 1. Current practice 2. Kludge specification 3. Examples 4. Deprecated formats ---------------------------------------------------------------------- Status of this document ----------------------- This document is a Fidonet Reference Library document (FRL). This document preserves FSP-1010.001 which was revised and released as FTS-4009. This document is released to the public domain, and may be used, copied or modified for any purpose whatever. Abstract -------- Current practice for Fidonet Technology Network (FTN) NetMail messages is to track their progress through the network and programs by using control lines. These control lines are in the form of a kludge named Via. 1. Current practice ------------------- As NetMail messages are routed through a FidoNet Technology Network or as they are processed on a system, Via control lines are used to track their progress. A single NetMail message may have any number of Via control lines. The Via control lines are stored in a block which starts after any message text. New Via lines should be added to the end of the block separated from the preceding control line by a single ASCII character (0Dh). A Via control line is typically added: when a netmail packer packs the NetMail for transmission to another system; when a netmail tracker inspects a NetMail. 2. Kludge specification ----------------------- The Via control line is formatted as a number of fields, separated by single space (20h) characters, as follows ^AVia: @YYYYMMDD.HHMMSS[.Precise][.Time Zone] [Serial Number] Where ^A denotes the ASCII (01h) character, and is the character (0Dh). The fields are defined as follows: FTN Address ----------- This field is mandatory and is the FidoNet Technology address of the system inserting the kludge. This may or may not include a domain indicator. @YYYYMMDD.HHMMSS ---------------- This field is mandatory and consists of a time stamp. This is the time at which the stamp was placed. The subcomponents are YYYY, the calendar year, in full four digit, decimal form; MM, the calendar month, in the range 01 to 12, this must be a zero padded, two digit decimal number; DD, the day of the month, in the range 01 to 31, this must be a zero padded, two digit decimal number; HH, hours, in the range 00 to 23, this must be a zero padded, two digit decimal number; MM, minutes, in the range 00 to 59, this must be a zero padded, two digit decimal number; SS. seconds, in the range 00 to 59, this must be a zero padded, two digit decimal number. Precise ------- This field is optional and takes the form of extra precision in the time stamp. If this field is present: it must begin with a single period character; this period must be followed by one or more decimal digits; the field has ended when another period or space is encountered; each decimal digit in the field following this character represents the time of the via line in fractions of a second, such that the the first digit represents tenths of a second, the second digit represents hundreds of a second and so on. Time Zone --------- This field is optional, and must be a short, widely accepted alphabetical abbreviation of the time zone that the time stamp in the Via line pertains to. The use of various Time Zone values is deprecated, implementations should attempt to convert the timestamp in the kludge to Universal Time (GMT or UTC) and use the "UTC" Time Zone indicator, where possible. The Time Zone field may only be ommitted when it is not possible for the implementation to determine the correct offset from UTC, and in this case the time stamp must represent local time on the generating system. Program Name ------------ This field is mandatory, and must follow the format used in the PID control line (detailed in FSC-46). Version ------- This field is mandatory, and must follow the format used in the PID control line (detailed in FSC-46). Serial Number ------------- This field is optional, and must follow the format used in the PID control line (detailed in FSC-46). Note that unlike many kludges, the "Via" text of the kludge itself is in mixed, and not all upper case. 3. Examples ----------- Example of valid usage are ^AVia 2:443/13 @19990305.043212.UTC O/T-Track+ 2.69 ^AVia 2:443/13@fidonet @19980331.231202.UTC FrontDoor 2.32.mL ^AVia 2:443/13.0 @19990101.002102.UTC FastEcho 1.46.1 21321 ^AVia 2:443/13 @19990323.230132 FakeMail 1.2 ^AVia 2:2480/18@fidonet @19990307.182128.47.UTC ITrack+ 1.3/G6 FP000069 4. Deprecated formats --------------------- Some other formats for the Via line are in use today, but these formats are rather variable and inconsistent in nature, while the format specified above is both more widespread and more consistent. New implentations may need to parse these formats, but must not generate them. The formats in use include, but are not limited to [VERSION] [SERIAL]
, Not that the time stamp in the above formats is also widely variable, and takes forms which include, but may not be limited to AT ::[Sec] :: ON :: / : @YYMMDDHHMMSS In the last listed format, observe in particular the two digit year and lack of period to seperate the date from time. A. References ------------- [FTS-1] "A Basic FidoNet(r) Technical Standard Revision 16", Randy Bush. September 1995. [FSC-46] "A Product Identifier for FidoNet Message Handlers", Joaquim Homrighausen, August 1994. B. Author contact data ---------------------- Colin Turner Fidonet: 2:443/13 E-mail: ct@piglets.com WWW: http://www.piglets.com Joaquim Homrighausen Fidonet: 2:201/330 E-mail: joho@defsol.se WWW: http://www.defsol.se C. History ---------- Rev.1, 990426: First release. **********************************************************************