|resources:||Home Installation Source Bugs Screenshots Roadmap RGTP URLs|
The format of RGTP URLs
Archangel uses URLs whose scheme is
rgtp. These are intended to conform to the guidelines laid down in RFC 1738. This document is an informal specification of the format. It's intended to be read in conjunction with RFC 1738, and with the RGTP protocol.
In some cases, part of this specification is planned but not yet implemented. These are marked (NYI:).
(NYI:) The user name and password are supported; the password field is used to supply a shared secret. It must be a hex number with an even number of digits. If no shared secret is supplied, the program should either reuse a stored secret or prompt the user. If an invalid or incorrect shared secret is supplied, the program should report the error to the user and fail. If no username is supplied, the program should either reuse a stored name or prompt the user. If the name supplied matches the string "anonymous" exactly, any shared-secret is ignored and the program should attempt to log in without sending any sort of authentication.
The hostname must be given. It should be one of the following:
- a valid name within the DNS, though not necessarily a fully-qualified one (for example,
- one of the following well-known names:
well-known name resolves to DNS name
- (NYI:) a single asterisk, in which case no username, password, port or url-path fields may be supplied. The program should supply a list of known servers to the user. (This is by analogy with
news:*, RFC 1738 §3.6.)
A port number may be specified. If it isn't given, it defaults to 1431, as allocated by IANA. The way port numbers work is independent of whether a well-known hostname is used.
The url-path is one of the following:
- (NYI:) An empty string: equivalent to
index: the user should be shown the index.
- Any alphabetic character followed by any seven decimal characters: the user should be shown the item whose itemid is in the url-path, if it exists. If not, it's an error.
motd: the user should be shown the message of the day.
editlog: the user should be shown the editors' log.