Next: 9. Scripts
Up: Dwun 0.8g
Previous: 7. Client commands
  Contents
8. Remote administration
There is currently no special client for the admin user. Use telnet. (Do not
attempt to use a normal client).
The user admin is special and is used to remote administration. You can
add this user by running
dwunmakeauth -a
The normal commands7, with the exception of CONNECT and
DISCONNECT, can be used and additionally the admin has the following special
commands:
- SHUTDOWN
- shutdown server.
- RESTART
- restart server. Any changes in the rcfile and authfile will be read
in.
- LIST
- show list of clients.
- SHOWLOCKS
- show list of locked accounts.
- STATUS
- show connection state.
- RECONNECT
- force a redial (like SIGUSR211) or
allow dialing after a SIGINT11 when using fatal admin5.
- UPTIME
- show length of time since we've been #Connected.
The next commands should be given a single argument of
either a pid (as returned by LIST) or username in the form %username (e.g.
KILL 50210 or KILL %tim). Only one argument of either a pid or
a %username is allowed per line.
There are three meta-users available; %all, %con,
%unknown. %all controls all users. If you ``LOCK %%all''
users will receive an error message when they try to attach to the dwun server.
%unknown is for unauthenticated users. ``LOCK %%unknown'' will have
the same effect as locking %all, so this is usually used to ''KILL %%unknown''.
%con controls CONNECTed users. ``LOCK %%con'' is particulary useful
to stop new users from CONNECTing.
- KILL
- kill client (with %user will kill all connections belonging to that user).
We won't kill our admin client. To force dwun to disconnect, KILL %%all.
- LOCK
- disable account.
- UNLOCK
- enable account.
- ZAP
- LOCK and then KILL. (Will kill all connections belonging to the user whether
or not a pid or username was specified).
Be warned that if %unknown or %all are locked, you will not be able to connect
to dwun even as the admin user. (Existing connections will not be affected).
In that case, you will have to manually edit /etc/dwunauth to continue, changing
the '!' to a ':' for the specified user account. You will normally only want
to use KILL when referring to %unknown or %all. Since the admin user cannot
use the CONNECT command, anything you do to %con will not affect it.
Note that where possible, when one of these commands is specified with a pid
as an argument, the LIST at the last time you saw it will be used. This is so
if you lock a pid, the account will be locked even if that person has since
left.
Next: 9. Scripts
Up: Dwun 0.8g
Previous: 7. Client commands
  Contents
2000-06-15