The DNS connector allows you to intercept and potentially modify all requests and responses for the Domain Name Service.
The best way to see this connector in action is to go through the DNS tutorial.
This connector takes the following parameters:
Can be any name you want.
If checked, then this connection will be active any time Gallium Data is running, meaning that the local port will be open and listening for requests. If you uncheck this (and then click Publish), then the connection is "commented out" -- it's as if it didn't exist, but you can still keep it around for later.
The type of this connection, which is set at creation time and cannot be changed.
The name or address of the DNS server. This is the only required parameter.
Optional - the local address on which to listen for requests. This is useful only if your machine has more than one IP address. By default, the connection will listen on all local addresses.
Optional - the DNS port on the server (specified by the Server host parameter). This is almost always 53, the standard port for DNS.
Optional - the port on which to listen for requests. This is almost always 53, the standard port for DNS.
The DNS connector allows you to have more than one connection, which is handy if you want to redirect requests easily (see the Redirecting requests page for details). There can only be one connection marked as the default connection in a project. All other DNS connections within the project must not be marked as Default connection. If there is only one connection in the project, the connection is considered to be the default connection and this flag is ignored.
Whether to also run on TCP (in addition to UDP). This is normally desirable, since a DNS implementation is not complete without TCP. However, on many operating systems, opening a TCP port below 1025 requires superuser/admin privileges. If you do not have such access, you can turn this option off to avoid an error message on startup.
See the DNS packets page for details on the packets used with this connector.
There are a few examples showing typical code.
The following request filters are available:
The following response filters are available:
The following duplex filters are available:
The DNS connector has a capability not available with the database connectors: it supports multiple connections. See the Redirecting requests page for details.