next up previous contents
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 up previous contents
Next: 9. Scripts Up: Dwun 0.8g Previous: 7. Client commands   Contents

2000-06-15