ConsoleThe rld console can be used to issue commands to a running rld server. It starts up after the server has been initialized.If the file server.rootdir/rld.conf exists, the rld console executes it. Then, depending on the value of admin.console, the admin console either 1) starts reading on stdin, 2) starts listening on a socket, or 3) disables itself altogether. If the parameter admin.password is set, the console prompts users for a password before letting them in. By default, the console listens on stdin and does not require a password. One simple means of getting to your server without sending passwords across the network in cleartext (on machines that you trust) is to bind the admin console to the loopback address 127.0.0.1 and password protect it (see admin.password). If the server machine is running sshd, you can use ssh to create a secure connection between the machine running rld and your own machine. From there you can then telnet to the loopback address and access the admin console. The most secure alternative is to disable the admin console completely. There is no way to reenable a disabled console. While enabled, the console can always be transferred from standard input to a socket and back again. When bound to a socket, the console will only service a single connection at a time (i.e. one way to prevent other people from using the console is by using it yourself), and it times out the connection after a period of inactivity. The console accepts the following commands (commands can be abbreviated to their first few characters):
1. adduser LOGIN [PASS [PRIV [NICK]]]Creates a new user account. The only required parameter is LOGIN, to specify a name for the new account. Use the PASS parameter to set a password for the account. If unspecified, defaults to no password required. The PRIVS parameter is a sum describing the privileges for the user, derived from the following table:
CAN_RENAME_FOLDERS = 1 CAN_DELETE_FOLDERS = 2 CAN_CREATE_FOLDERS = 4 CAN_MOVE_FILES = 8 CAN_RENAME_FILES = 16 CAN_DOWNLOAD_FILES = 32 CAN_UPLOAD_FILES = 64 CAN_DELETE_FILES = 128 CAN_DELETE_ACCOUNTS = 256 CAN_CREATE_ACCOUNTS = 512 CAN_SEND_CHAT = 8192 CAN_READ_CHAT = 16384 CAN_MOVE_FOLDERS = 32768 CANNOT_BE_DISCONNECTED = 65536 CAN_DISCONNECT_USERS = 131072 CAN_POST_NEWS = 262144 CAN_READ_NEWS = 524288 CAN_MODIFY_ACCOUNTS = 4194304 CAN_READ_ACCOUNTS = 8388608 CAN_MAKE_ALIASES = 16777216 CAN_VIEW_DROPBOXES = 33554432 CAN_COMMENT_FOLDERS = 67108864 CAN_COMMENT_FILES = 134217728 DONT_SHOW_AGREEMENT = 268435456 CAN_USE_ANY_NAME = 536870912 CAN_UPLOAD_ANYWHERE = 1073741824 CAN_GET_USER_INFO = 2147483648If the PRIVS parameter is left unspecified, it defaults to 0 (an easy way to grant "all privileges" is to specify -1). The NICK parameter specifies a nickname for the user. If not specified, defaults to LOGIN.
Disconnects the users with the specified socket ID's and bans them for 30 minutes. Prints the list of currently connected users. Optionally the list may be limited to only the specified socket ID's. Deletes a user account. Shows a general help message, or, if CMD is specified, gives more detailed help on that command. The special CMD 'params' gives info on the useful NAME's that can be passed to 'set'. Gets info on the users with the specified socket ID's. Disconnects the users with the specified socket ID's. Lists all user accounts. Broadcasts an administrator message to all connected users. Quits the console. If the console is on standard input, this has the added side effect of shutting down the server; an optional MSG may be supplied to inform connected clients of the reason for shutting down. Unsets NAME when VALUE is omitted, otherwise sets NAME to VALUE. See Parameters for a list of useful NAMEs. Terminates the server. If MSG is given, rld will broadcast it as an administrator message before disconnecting all clients. Displays running totals and statistics for the server. Shows the version of rld. Kills a transfer request. XFREF is a unique reference for the transfer. Lists all transfers in progress and in the queue.
25 october 2001 |