Changi NNTP Server 1.0
[
Bottom of Page |
Previous Page |
Next Page |
Table of Contents ]
CHANGI.EXE
Control Interface
This chapter is targeted to application programmers who want
to make use of the Changi control interface. It doesn't contain
any useful information for the normal user.
Beside listening for clients on tcp port 119 Changi maintains
a second interface on udp port 119. Datagrams sent to the
control port must have the following general format:
<user-id><1><command><1>[<parameter>...]
- <user-id>
- ID of the user sending this command.
- <command>
- This is the single character, case sensitive command specifier.
- <parameter>
- Most commands require one or more parameters.
- <1>
- Items within the datagram must be separated by ASCII code 1
(Ctrl+A).
After successfully processing the command, Changi responds to the sender
with
0 OK
In case of errors the response will be
1 <human readable error text>
The two commands q [shutdown] and x [xabort]
will not be answered with any response. The application program
may, for example, check changi.pid to
detect successful completion.
Changi recognizes the following commands and associated parameters.
For a more detailed description you should also refer to the related
Chanco command line options given in
square brackets.
- a id arr exp post path
- Add history line.
[addhist]
- D reason
- Allow remote connections.
[allow]
- b site
- Start newly-added site.
This command is currently not implemented.
- c id
- Cancel message locally.
[cancel]
- u group rest
- Change mode of group.
[changegroup]
- d
- Check syntax of newsfeeds file.
This command is currently not implemented.
- e site
- Stop feeding site.
[drop]
- f site
- Flush feed for site*.
[flush]
- g
- Flush history and active.
[flushlogs]
- F reason
- Flush history and active and queue incoming articles.
[flushserver]
- h reason
- Restart after flushserver/pause/throttle.
[go]
- i channel
- Hangup specified connection.
This command is currently not implemented.
- s
- Print operating mode.
[mode]
- j nnn
- Print name of specified channel.
This command is currently not implemented.
- k group rest creator
- Create new group.
[newgroup]
- l letter value
- Change command-line parameter.
[param]
- m reason
- Short-term pause.
[pause]
- v flag text
- Enable/disable newsreading.
This command is currently not implemented.
- t path group
- Refile an article.
This command is currently not implemented.
- C reason
- Reject remote connections.
[reject]
- o what reason
- Re-read config files*.
This command is currently not implemented.
- n group
- Renumber the active file.
This command is currently not implemented.
- z reason
- Reserve next pause/throttle.
This command is currently not implemented.
- p group
- Remove named group.
[rmgroup]
- A feed text
- Send control text to feed.
This command is currently not implemented.
- q reason
- Drop all connections and shut down server.
[shutdown]
- r reason
- Drop all connections.
[throttle]
- w flag
- Turn tracing on or off.
This command is currently not implemented.
- x text
- Immediately abort the server without flushing internal buffers.
[xabort]
- Y speed
- Update overview slow, fast or normal, or stop updating.
[oversync]
- Hhostentry index
- Print host by index
[hostentry]
- Uuserentry index
- Print user by index
[userentry]
- Rresource type
- Query system resource
[resource]
- Edisconnect client
- Kick out a client
[disconnect]
- Ggroupentry index
- Print group by index
[groupentry]
- Srejecting
- Print reject reason
[rejecting]
[
Top of Page |
Previous Page |
Next Page |
Table of Contents ]