HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

d
dpp(1M) dpp(1M)
NAME
dpp - dedicated ports parser used by DDFA software
SYNOPSIS
dpp dp_file [-c][
-k][-l log_file][-p ocd_program]
DESCRIPTION
The Dedicated Ports Parser command (
dpp) is part of the Data Communications and Terminal Controller
(DTC) Device File Access (DDFA) software. It parses the Dedicated Ports file (
dp
) and spawns an Out-
bound Connection Daemon (
ocd) for each valid entry in the
dp file.
dpp can be run from the shell or it can be included in a system initialization script to automatically run the
DDFA software each time the system is booted.
See ddfa(7) for more information on how to configure the DDFA software and for an explanation of how it
works.
Options and Arguments
dpp recognizes the following options and arguments:
dp_file It must be the first argument. The dp file (dp_file) defines the link between a ter-
minal server port and the device file used by applications to access the port. Its
contents must meet the specifications given in dp(4). If it is modified,
dpp must
be run again to activate the changes.
-c Specify that the dp file should be parsed and that all incorrect entries should be
logged without invoking any ocd processes. This option is useful for debugging
the dp file before running it properly. The -p option is ignored if the -c
option is
used.
-k Specify that the device file corresponding to each valid entry in the
dp file should
be removed before launching
ocd for each valid entry. Removing the device file
eventually causes an ocd process (if any is running) to shutdown. If this option is
omitted, no device files will be removed and, therefore, only newly added valid
entries in the dp file will have ocd launched.
ocd normally creates and removes devices files. However, if the process is killed
incorrectly, such as with
kill -9, the device file may remain. If the system is
rebooted, the -k option can be specified to restart all dp file entries correctly.
If a corresponding
ocd no longer exists, the device file is removed by any following
invocation of
ocd that requires the same device file.
In order to shutdown every ocd running without restarting them, the following
command can be executed:
kill -15 ‘ps -e | grep ocd | awk ’{print $1}’‘
-l
log_file Specify where to log error messages. If this option is omitted, all error messages
are logged to standard output.
If the specified file does not already exist, it is created. The file must be nonexe-
cutable and readable by dpp.
-pocd_program Specify the path for an outbound connection daemon. The default path for is
/usr/sbin/ocd . The daemon must be executable.
DIAGNOSTICS
Error messages are logged for bad arguments, bad file entries, and ocd creation errors. By default, they
are logged to standard output. If the -l option is used, they are appended to the specified log file.
(0) ERROR: dp file is mandatory
(1) ERROR: dp file must be the first argument
(2) ERROR: Cannot read dp file (
filename)
The dp file either does not exist or cannot be accessed with the current access privileges.
(3) ERROR: No log file defined (-l option)
(4) ERROR: Cannot create log file (-l
filename)
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−185