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 ]


URL: changi/manual/serverctl.html
Created: 3 August 1996
Revised: 1 December 1996
Author: harald@os2point.ping.de