test

ChorusOS 5.0 System Administrator's Guide

dhclient

The Dynamic Host Configuration Protocol utility, dhclient(1M), allows the ChorusOS system to obtain network information, such as a dynamically assigned IP address, or the IP addresses of the default router and name server, from a DHCP server at boot time. In order to boot using dhclient you must first embed the dhclient process into the ChorusOS system image.

dhclient reads dhclient.cf(4CC) and dhcp.options(4CC).

Embedding the dhclient process into the ChorusOS system image

You can use Ews, the graphic configuration utility to embed the dhclient process:

  1. Open the Ews graphic configuration utility:

    host% ews <build_DIR>/conf/ChorusOS.xml &

  2. Select the Application file list node, as follows:

    ChorusOS configuration | ChorusOS System Image Configuration | Applications | Application file

  3. Click on Application File with the right-hand mouse button and select New Element.

  4. Double-click on the Empty file which appears in the Application File. A new window opens in Ews.

  5. Click twice on the Value cell next to Reference in this window, then click on the button marked "..." which appears on its right hand side. This opens a window entitled Select a Reference.

  6. Select dhclient from the list of options in the Select a Reference window. If necessary, follow the same procedure to select dhclient.cf in order to embed the optional dhclient configuration file.

  7. Close the Select a Reference window, then select file | save in the Ews graphic configuration tool to save the new settings.

  8. By default, ChorusOS boots using RARP. In order to boot using DHCP, you must change the sysadm.ini file. In the sysadm.ini file, you deactivate RARP by making the appropriate line into a comment and you activate DHCP by including the line corresponding to dhclient:

    # rarp ifeth0

    /image/sys_bank/dhclient ifeth0

  9. You must now build or re-build the ChorusOS system image:

    host% make chorus

    Further information on building the system image is supplied with the ChorusOS 5.0 Installation Guide.

See also "The Embedded Workshop Graphical Configuration Tool" for additional guidance on Ews.