M8. Connections

License limit reached (connection denied)

Called when connection denied according license limitation.

Database

Parameters

Returned value

available

id — station ID

address — station network address

station — NetBIOS name of a station. Does not replaced by DNS name

type — the type is station

ignored

Procedure text:

--[[

Called:

 when connection denied according license limitation

 

Database:

 available

 

Parameters:

 id             station ID

 address        station network address

 station        station name

                this is NetBIOS station name (not replaced by DNS one)

 type           one of 'station'

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.type

 

-- no return => `nil' value

Connection error

Called when new client connection cannot be established. Possible reasons: no available licenses (in this case, the license_error.ds is called first), no connection to the database, database error, number of stations that are waiting for authorization is exceeded, Dr.Web Server or DB is overloaded.

Database

Parameters

Returned value

available if reason is no license and potentially available if reason is overload (it is not recommended to use DB at this time)

address — client address

reason — reason of connection error:

no database — no established database connection

overload — database is overloaded

no license — no available licenses to accept the connection

ignored

Procedure text:

--[[

Called:

 when new client connection cannot be established

 

Database:

 available if reason is "no license" and potentialy available if

 reason is "overload" (but it is not recommended to use DB that time)

 

Parameters:

 address                   client address

 reason   "no database"    no established database connection

          "overload"       database is overloaded

          "no license"     no available license to accept connection

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.address, args.reason

The PONG received from client

Called when PONG received from a client.

Database

Parameters

Returned value

available

id — client ID

address — client network address

station — client name (for Agent, Server, Installer)

time — packet round-trip time

ignored

Procedure text:

--[[

Called:

 when 'PONG' received from client

 

Database:

 available

 

Parameters:

 id         client ID

 address    network address

 station    station name (for Agent, Server, Installer)

 time       packet round-trip time in milliseconds

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station,

                -- args.time

Client disconnected

Called when client disconnected.

Database

Parameters

Returned value

available

id — client ID

address — client network address

type — client type: unknown, station, console, server, installer, newbie

station — station name (only for Agent)

bytesin — bytes received

bytesout — bytes sent

totalbytesin — compressed bytes received

totalbytesout — compressed bytes sent

reason — disconnect reason

ignored

Procedure text:

--[[

Called:

 when client disconnected

 

Database:

 available

 

Parameters:

 id              client ID

 address         network address

 type            client type: "unknown", "station", "proxy",

                               "server", "installer", "newbie"

 station         station name (only for Agent)

 bytesin         bytes received

 bytesout        bytes sent

 totalbytesin    compressed bytes received

 totalbytesout   compressed bytes sent

 reason          disconnect reason

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.type, args.station

                -- args.bytesin, args.bytesout

                -- args.totalbytesin, args.totalbytesout

                -- args.reason