N8. Conexiones

Se ha alcanzado el límite de licencia (conexión denegada)

Se llama cuando falla una conexión debido a restricciones en el acuerdo de licencia.

Base de datos

Parámetros

Valor devuelto

disponible

id — ID de la estación,

address — dirección de red del cliente,

station — nombre NetBIOS de la estación. No se sustituye por el nombre DNS,

type — tipo station

se ignora

Texto del hook:

--[[

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

Error de conexión

Se llama cuando no se puede establecer una conexión con un nuevo cliente.
Causas posibles: las licencias han caducado (en tal caso se llama primero el license_error.ds), no hay conexión con la base de datos, error de la base de datos, se ha superado el número de estaciones que esperaban autorización, el Servidor o la base de datos están sobrecargados.

Base de datos

Parámetros

Valor devuelto

disponible si la causa es no license y potencialmente disponible si la causa es overload (no se recomienda utilizar la base de datos en ese tiempo)

address — dirección de red del cliente,

reason — causa del error de conexión:

no database — no se ha establecido conexión con la base de datos

overload — la base de datos está sobrecargada,

no license — no hay licencias disponibles para aceptar la conexión

se ignora

Texto del hook:

--[[

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 free license to accept connection

 

Returned value:

 ignored

 

]]

 

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

Se ha recibido el PONG del cliente

Cuando se recibe el PONG del cliente.

Base de datos

Parámetros

Valor devuelto

disponible

id —ID del cliente,

address — dirección de red del cliente,

station — nombre del cliente (para Agente, Servidor, Instalador),

time — tiempo de retorno (round-trip) del paquete

se ignora

Texto del hook:

--[[

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

La conexión con el cliente se ha interrumpido

Se llama después de finalizar la conexión del cliente.

Base de datos

Parámetros

Valor devuelto

disponible

id —ID del cliente,

address — dirección de red del cliente,

type — tipo de cliente: unknown, station, console, server, installer, newbie

station — nombre de la estación (solo para el Agente),

bytesin — se han recibido bytes sin compresión,

bytesout — se han enviado bytes sin compresión,

totalbytesin — se han recibido bytes con compresión,

totalbytesout — se han enviado bytes con compresión,

reason — causa de la desconexión

se ignora

Texto del hook:

--[[

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