4.4.3. Configuring a local hosts file

To configure a hosts file:

  1. Start RealView Debugger without connecting to a target.

  2. Display the Connection Control window where the new connection entry is visible, shown in Figure 4.7.

    Figure 4.7. Hosts file in the Connection Control window

    Hosts file in the Connection Control window

    RealView Debugger locates the rvbroker.brd file in your home directory, or in \etc, and includes the configuration details in the board file, ready for editing.

  3. Right-click on the Remote_Hosts entry to display the context menu.

  4. Select Properties... from the context menu to display the Connection Properties window, shown in Figure 4.8.

    Figure 4.8. Configuring a hosts file

    Configuring a hosts file
  5. Edit the RVBROKER=Remote_Hosts group as follows:

    1. Edit the Description settings value in the right pane, to identify the remote connection, for example Remote to test board on TESTPC1.

    2. Make sure that the Disabled settings value in the right pane is set to False, the default.

    3. Expand the Remote group, in the right pane, to display the contents.

      Edit the Remote settings values page to enter the network address of the remote workstation, for example Hostname=TESTPC1.ournet.tst.com, shown in the example in Figure 4.4.

  6. Select File ? Save and Close to save your changes and close the Connection Properties window.

The hosts file, rvbroker.brd, is automatically updated with the new configuration information. You can view the amended file using a text editor, for example:

[RVBROKER=Remote_Hosts]
description="Remote to test board on TESTPC1"
remote.hostname="TESTPC1.ournet.tst.com"

You can also use the network IP address to specify the remote target, for example:

[RVBROKER=Remote_Hosts]
description="Remote to test board on TESTPC1"
remote.hostname="123.145.6.170"

Custom entries in the hosts file

Default board file entries are not shown in the hosts file. For example, the setting Disabled=False (shown in Figure 4.8) is the default setting for the new RVBROKER entry and so there is no corresponding entry in the hosts file. However, if you edit this setting so that it becomes *Disabled=False, an entry is created in the hosts file, for example:

[RVBROKER=Remote_Hosts]
description="Remote to test board on TESTPC1"
remote.hostname="123.145.6.170"
disabled=False

You can specify entries in the hosts file even where these are the default settings for the new connection.

Copyright © 2002-2006 ARM Limited. All rights reserved.ARM DUI 0182H
Non-Confidential