dp.4 (2010 09)

d
dp(4) dp(4)
NAME
dp - dedicated ports file used by DDFA software and Telnet port identification feature
DESCRIPTION
The
dp file has two uses:
Datacommunications and Terminal Controller Device File Access
The
dp file is used by the Datacommunications and Terminal Controller Device File Access
(DDFA) software to allow terminal server ports to be programmatically accessed from HP-UX
applications in the same way as devices connected directly to the HP-UX system. It contains a
one-line entry for each configured terminal server port.
The
dp file contains the information the DDFA software needs to set up and manage an out-
bound connection to a specified terminal server port. The file is parsed by the Dedicated Port
Parser (dpp
) which spawns an Outbound Connection Daemon (ocd) for each outbound connec-
tion specified in the file.
Telnet Port Identification
The
dp file is used by the HP-UX telnet daemon (
telnetd) to identify the calling port and
board of a telnet connection from an HP Datacommunications and Terminal Controller (DTC).
At connection time, the host negotiates the telnet environment option and the DTC replies with
the port and board number of the connecting device.
Telnetd maps the port and board
numbers to the well-known name for the device, which has previously been configured in the
dp file.
Datacommunications and Terminal Controller Device File Access
For outbound connections, an entry should have the following format:
dtc_name board/port pseudonym config_file log_level
The exact details of each field are given below.
Telnet Port Identification
To configure the dp file for using the Telnet port identification feature, the default file
/usr/examples/ddfa/dp
should be copied to a new file and the copy configured with the appropriate
values for the incoming connections. The recommended procedure is to create a directory to hold the
dp
file and the modified port configuration files.
An entry for this purpose should have the following format:
dtc_name board
/port pseudonym
The exact details of each field are given below.
Configuration Information
There are three ways to specify a terminal server port:
• Explicitly specify its IP address.
• Specify the node name or the IP address of the DTC then specify the board and port.
• Specify the node name or the IP address of the terminal server and the TCP port service address
of the port.
Comments in the
dp file can be appended by starting them with a # character. Everything after the #
is ignored by the parser. Fields in the dp file are separated by space characters.
See ddfa (7) for more information on how to configure the DDFA software.
The fields of an entry of the
dp file are as follows:
dtc_name This field is the node name or the IP address of the terminal server being accessed or
the IP address of the port on the terminal server. A node name must be defined in a
name database.
board
/port This field contains the terminal server port address with the parts separated by the /
character. It is not necessary to pad the values with leading zeros. The port address
is not checked by dpp, but is checked by ocd. Valid values are 0 through 7 for board ,
and 0 through 31 for port (these restrictions do not apply if the TCP port service
address is specified instead).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1