dhcp_relay(1M)                                                  dhcp_relay(1M)


NAME
     dhcp_relay - proclaim relay-agent for Dynamic Host Configuration Protocol

SYNOPSIS
     /usr/etc/dhcp_relay [ -f ] [ -o relay_options_file ]

DESCRIPTION
     dhcp_relay is the relay-agent that communicates with other DHCP and
     proclaim clients and servers to provide address-leases across networks
     using DHCP messages.  The format of DHCP messages is based on BOOTP
     messages (see RFC 951).  A detailed protocol specification for DHCP is
     contained in RFC 1541, available from the Network Information Center.

     The DHCP relay-agent receives service requests at the UDP port indicated
     in the bootp service description contained in the file /etc/services (see
     services(4)).

     dhcp_relay replaces the standard bootp(1M) server application and serves
     both bootp and DHCP clients.  The -f option on the command line enables
     the forwarding function of bootp(1M).


CONFIGURATION
     dhcp_relay execution can be controlled through the following steps.

     1)  Specify relay-agent options in the /etc/config/dhcp_relay.options
         file, if any, as in this example:
         -c proclaim_config_dir
         This specifies an optional proclaim server configuration directory.
         The default directory is /var/dhcp/config.

     2)  The configuration directory contains a file dhcp_relay.servers, which
         has a list of proclaim servers, one per line.  DHCP messages are
         forwarded to each server contained in this file.  Proclaim servers
         may be specified using either an Internet host name or an Internet
         address in standard dot notation (see inet(3N)).  Here is a sample
         dhcp_relay.servers configuration file:
         192.26.61.9
         dhcpserver.sgi.com

     3)  Enable the proclaim relay-agent by entering these commands:
         chkconfig proclaim_relayagent on
         chkconfig proclaim_server off

     4)  Replace the "bootp" entry in /usr/etc/inetd.conf with this line:
         bootp dgram udp wait root /usr/etc/dhcp_relay dhcp_relay -o \
              /etc/config/dhcp_relay.options

     5)  Kill any running bootp with this command:
         /etc/killall bootp


     6)  Restart inetd with this command:
         /etc/killall -HUP inetd


FILES
     /etc/config/dhcp_relay.options
     /etc/hosts
     /etc/ethers
     /usr/etc/inetd.conf
     /var/dhcp/etherToIP
     /var/dhcp/config/dhcp_relay.servers


SEE ALSO
     bootp(1M), chkconfig(1M), dhcp_bootp(1M), inetd(1M), proclaim(1M),
     ProclaimRelayMgr(1M), syslogd(1M), ethers(4), hosts(4).

     IETF RFCs 1541, 1533, 1534, 1535.


                                                                        Page 2