messages in more robust formats. This command should be passed two arguments.
The first is the message number of the message being requested. In server
version 4.04 and above, the second argument may be set to either 0 to read the
-entire message, or 1 to read the headers only.
+entire message, or 1 to read the headers only. In server version 6.00 and
+above, the third argument may be set to the desired section of the message (if
+there are attachments).
The server should, of course, make sure that the client actually has access
to the message being requested before honoring this request. Citadel/UX does
typically be 0; see the MSG0 command above).
4 - Post name. When postflag is 2, this is the name you are posting as.
This is an Aide only command.
- 5 - Separator string to be used when there are MIME attachments following
+ 5 - Boundary string to be used when there are MIME attachments following
the normal message text.
Possible result codes:
this client (Note: NOOP's don't count)
6 - The last command received from a client. (NOOP's don't count)
7 - Session flags. These are: + (spoofed address), - (STEALTH mode), *
- (posting) and . (idle).
+ (posting) and . (idle). (Citserver 5.02 and above)
The listing is terminated, as always, with the string "000" on a line by
itself.
This is used in allowing a client to calculate idle times.
+----------------------------------------------
+The following are for citserver 5.11 and above
+----------------------------------------------
+
AGUP (Administrative Get User Parameters)
ASUP (Administrative Set User Parameters)
simply returns OK. If the client has insufficient access to perform the
requested operation, ERROR+HIGHER_ACCESS_REQUIRED is returned. If the
requested user does not exist, ERROR+NO_SUCH_USER is returned.
-
+
+
+ GPEX (Get Policy for message EXpiration)
+
+ Returns the policy of the current room, floor, or site regarding the automatic
+purging (expiration) of messages. The following policies are available:
+ 0 - Fall back to the policy of the next higher level. If this is a room,
+ use the floor's default policy. If this is a floor, use the system
+ default policy. This is an invalid value for the system policy.
+ 1 - Do not purge messages automatically.
+ 2 - Purge by message count. (Requires a value: number of messages)
+ 3 - Purge by message age. (Requires a value: number of days)
+
+ The format of this command is: GPEX <which>
+ The value of <which> must be one of: "room" "floor" "site"
+
+ If successful, GPEX returns OK followed by <policy>|<value>.
+
+
+
+ SPEX (Set Polict for message EXpiration)
+
+ Sets the policy of the current room, floor, or site regarding the automatic
+purging (expiration) of messages. See the writeup for the GPEX command for
+the list of available policies.
+
+ The format of this command is: SPEX <which>|<policy>|<value>
+ The value of <which> must be one of: "room" "floor" "site"
+
+ If successful, GPEX returns OK; otherwise, an ERROR code is returned.
+
+
+
+ CONF (get or set global CONFiguration options)
+
+ Retrieves or sets various system-wide configuration and policy options. This
+command is only available to Aides. The sole parameter accepted is a command,
+which should be either GET or SET. If the GET command succeeds, CONF will
+return LISTING_FOLLOWS followed by the fields described below, one line at a
+time. If the SET command succeeds, CONF will return SEND_LISTING and expect
+the fields described below, one line at a time (don't worry about other fields
+being added in the future; if a 'short' configuration list is sent, the missing
+values at the end will be left unchanged on the system). If either command
+fails for any reason, ERROR is returned.
+
+ The configuration lines are as follows:
+
+ 1. Node name
+ 2. Fully qualified domain name
+ 3. Human-readable node name
+ 4. Landline telephone number of this system
+ 5. Flag (0 or 1) - creator of private room automatically becomes room aide
+ 6. Server connection idle timeout (in seconds)
+ 7. Initial access level for new users
+ 8. Flag (0 or 1) - require registration for new users
+ 9. Flag (0 or 1) - automatically move Problem User messages to twit room
+ 10. Name of twit room
+ 11. Text of <more> prompt
+ 12. Flag (0 or 1) - restrict access to Internet mail
+ 13. Geographic location of this system
+ 14. Name of the system administrator
+ 15. Number of maximum concurrent sessions allowed on the server
+ 16. Password for server-to-server networking
+ 17. Default purge time (in days) for users
projects / citadel.git / blobdiff