4.11. Debug server (dbgs)

--version

-v

Displays the debug server version.

--help

-h

-?

Displays brief help information about debug server startup command line settings.

--service

Registers the debug server as a Windows OS service.

The service key is incompatible with the daemon key.

--daemon

This key allows you to start the debug server in the "demon" mode of Linux OS, i.e in the background application mode that does not interact with the terminal from where this application is running. Starting a debug server with this key does not mean that the server agent will be automatically started for execution after the system is rebooted.

The daemon key is incompatible with the service key.

--addr=<host>

-a <host>

Allows to specify the IP address that will be used as the debug server address. It makes sense if there are several network cards with different IP addresses installed on the computer. If the IP address is not specified, then the address of an arbitrary network card will be used.

--port=<port>

-p <port>

The port that will be used to connect to the debug server. If the specified port will be unavailable, the debug server will not start and debugging will be impossible. The port must be specified explicitly, there is no default value. When you start the debug server using the server cluster, the port 1550 will be used, which cluster selects by default and can be redefined using the server cluster start-up keys.

If the port and range parameters are specified at the same time, the port parameter is ignored.

--range=<range>

-r <range>

Specifies a range of ports to select the port from, which will connect to the debug server. If all the ports specified in this parameter are unavailable, the debug server cannot start and debugging is impossible.

A range of ports is indicated by the symbol ":", several ranges (or specific ports) are separated by the symbol ",". For example: 2560:2590, 4567, 9000:12000. In this example, the ports from 2560 to 2590, port 4567 and ports from 9000 to 12000 are used to select the port. As a result, one port is selected, which will be used in the work. Information about the selected port (along with the address of the debug server) will be written to the file specified with the notify parameter.

If the port and range parameters are specified at the same time, the port parameter is ignored.

--ownerPID=<PID>

-opid <PID>

This parameter specifies the ID of the operating system process, the lifetime of which determines the lifetime of the debug server process. The debug server monitors the process with the specified id. After completion of this process it also completes work. In this case, all debugging processes that are performed through this debug server will also be terminated.

When debugging the file infobase, Designer automatically sets its own process ID for this parameter, and when running from a server cluster, the cluster manager process ID is set in this parameter (rmngr).

--password=<pwd>

-pwd <pwd>

Password to access the debug server. The password is to be specified for all debuggers that want to be debugged using this debug server.

If the debugServerUsers and password parameters are specified at the same time, the password parameter is ignored.

--notify=<file>

The full name of the file where debug server stores its address. Designer or cluster manager reads the information on the debug server address and deletes the file.

--debugServerUsers=<file>

-dbgsUsers <file>

Allows the debug server to specify a file with a list of debug users. If the debugServerUsers and password parameters are specified at the same time, the password parameter is ignored.

If the debugServerUsers parameter is not specified, the debug server does not limit debugging capabilities.