Function

adminBan - Disconnection of client from the server by the administrator

This function disconnects the user from the XML Socket MUltiuser Server – eClever prohibiting him to connect again from the same IP address. The function can only be used by those connected as administrators.

If XML Socket Multiuser Server – eClever is restarted the function adminBan loses its functionality. If you want to prevent somebody from connecting definitively you have to put their IP number in the section black-list of eClever.config.

XML request, sent by the client to the server

<protocol>
    <adminBan sendTo="test2" [sid="3"]>
         <data>message</data>
    </adminBan>
</protocol>

Attribute

Meaning

sendTo

Name of the client that we want to disconnect from the XML Socket Multiuser Server - eClever.

data

In the section data we can send a message to the disconnected client explaining why we had done so.

XML response of the server to the client

<protocol>
     <response action="adminBan" errorCode="0" [sid="3"]/>
</protocol>

errorCode

Error description

1021

There is no client with this name on the server.

1022

The message couldn't be sent.

XML message of the server to other clients

<protocol>
    <received action="adminBan" sentFrom="admin">
        <data>message</data>
    </received>
</protocol>

<protocol>
    <received action="disconnect" sentFrom="test3"/>
</protocol>

Attribute

Meaning

sentFrom

Name of the client that sent the message.

data

In this section the informations, that are sent by the admin, are included.