M8. Connessioni

Limite di licenza raggiunto (connessione rifiutata)

Viene invocata se la connessione è stata rifiutata in base alle limitazioni del contratto di licenza.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo di rete della postazione,

station — nome NetBIOS della postazione. Non viene sostituito con il nome DNS,

type — tipo station

viene ignorato

Testo della procedura personalizzata:

--[[

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

Errore di connessione

Viene invocata se non è possibile stabilire la connessione al nuovo client.
Possibili cause: sono esaurite le licenze (prima viene invocato license_error.ds), nessuna connessione al database, errore di database, superato il numero di postazioni in attesa di autenticazione, server o database sovraccaricato.

Database

Parametri

Valore restituito

è disponibile se la causa è no license, ed è potenzialmente disponibile se la causa è overload (non è consigliato utilizzare il database in questo tempo)

address — indirizzo del client,

reason — causa di errore di connessione:

no database — non stabilita la connessione al database,

overload — il database è sovraccaricato,

no license — non ci sono più licenze disponibili per accettare la connessione

viene ignorato

Testo della procedura personalizzata:

--[[

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

Ricevuto PONG da client

Viene invocata se viene ricevuto un PONG dal client.

Database

Parametri

Valore restituito

è disponibile

id — ID del client,

address — indirizzo di rete del client,

station — nome del client (per Agent, Server, Installer),

time — tempo di ritorno (round-trip) del pacchetto

viene ignorato

Testo della procedura personalizzata:

--[[

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

Il client si è disconnesso

Viene invocata dopo la disconnessione del client.

Database

Parametri

Valore restituito

è disponibile

id — ID del client,

address — indirizzo di rete del client,

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

station — nome della postazione (solo per Agent),

bytesin — ricevuti byte non compressi,

bytesout — inviati byte non compressi,

totalbytesin — ricevuti byte compressi,

totalbytesout — inviati byte compressi,

reason — causa di disconnessione

viene ignorato

Testo della procedura personalizzata:

--[[

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