======Bandwidth Control======
(VPOP3 Enterprise Only)

Every time a connection is made to a VPOP3 service, or a user logs into a service, VPOP3 Enterprise runs a Lua function which can assign the connection a bandwidth pool, or assign a bandwidth limit on the connection.

VPOP3 runs a function called 'GetBandwidth' in a file called **bandwidth.lua** in the VPOP3 directory.

The function signature is:
**GetBandwidth(Params)**

The Params parameter is a Lua table with the following entries

  * clientip - The IP address of the client computer connecting to VPOP3
  * serveraddress - The local IP address of the VPOP3 service which is being connected to
  * serverport - The local TCP port which is being connected to
  * servertype - The local service type (eg POP3, IMAP4, SMTP)
  * serverid - The numeric ID of the service being connected to
  * serverbandwidth - The configured bandwidth for the service being connected to
  * bandwidth - The current bandwidth limit on the connection
  * username - The currently logged in user (if any)
  * usernumber - The internal numeric user ID of the currently logged in user (if any)
  * userbandwidth - The configured bandwidth limit of the currently logged in user (if any) - this is not currently used

The function returns a number indicating the bandwidth limit to apply
  * 0 = no limit
  * 1 to 999999999 = bandwidth limit (in bytes per second) of this connection
  * -1 to -1000 = bandwidth pool to use (as a negative number, -1 = bandwidth pool 1, etc)