I wrote the following text for the LIST command for level 3 clients:
---------------
A client can list a directory by sending the message "LIST
<directory>", eg. "LIST chat". If the client wishes to receive the
top directory, then no argument must be given. The client must cache
this list during a session, and only delete it if it becomes dirty
(see section 3.13).
The output of the LIST message first starts with a header, the DIR
message. In this message, the <dirname> is the same as the LIST
argument, or "TOP" if no argument was supplied. It looks as follows:
LIST <dirname> <flags>
Then zero or more of the following lines are sent:
DIR <dirname> <flags>
CHN <channame> <flags>
Here, the <dirname> and <channame> are the name of the subdirectory
or channel in the requested directory. The list ends with an END
message:
END
<flags> consists of zero or more of characters. For directories, the
following characters will be used:
'd' - it is allowed to create a directory inside that directory
'c' - it is allowed to create a channel inside that directory
'k' - the directory is unsuitable for users younger than 12 years
'a' - the directory is unsuitable for users younger than 18 years
In the case of 'k' and 'a', the client should prohibit access to
these directories if the user is not at an appropriate age. It is up
to the client implementation to track this information.
For channels, the following characters can be used:
'k' - the channel is unsuitable for users younger than 12 years
'a' - the channel is unsuitable for users younger than 18 years
'i' - access to the channel will only be granted after an
invitation
------------
Does this seem usable? I'm gonna start implement it tomorrow and after
the weekend, and try to see if I've got all information I need. Please
send me your comments.
Grit