dpp(1M)

NAME

dpp − dedicated ports parser, used by DDFA software

SYNOPSIS

dpp dp_file [-l log_file] [-c] [-k] [-p ocd_program]

DESCRIPTION

This file is part of the HP Datacommunications and Terminal Controller (DTC) Device File Access (DDFA) software. It parses the Dedicated Ports file (dp) and calls the Outbound Connection Daemon (ocd) to spawn a daemon for each valid entry in dp.

dpp can be run from the shell or it can be included in netlinkrc to automatically run the DDFA software each time the system is booted. Only user root can run dpp.

Refer to ddfa(7) for information about how to configure and install DDFA software.

Options

dpp recognizes the following options and command-line arguments:

dp_file Mandatory argument, and must be the first field. dp_file must be executable and meet the specifications given in dp(4). The dp file defines the link between the DTC port and the device file used by applications to access the port. If dp_file is modified, dpp must be run again to activate the changes.

-l log_file Log messages to log_file. If no log file is specified, all error messages are logged to the screen.

If this option is used, the log_file argument is required. If the specified file does not already exist, it is created. log_file must be non-executable, and readable by dpp.

-p ocd_program The default path for ocd is /etc/ocd; if the path is different, it must be specified using the -p option. The ocd must be executable with access rights for dpp.

dpp starts a process for each valid entry in the dp file and starts execution of ocd.

-k Remove the device file corresponding to each valid entry in the dp file, then launch ocd for each valid entry.

ocd normally creates and removes devices files. However, if the process is killed badly, 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. Deleting the device file eventually causes the ocd process (if any) to exit.

If a corresponding ocd no longer exists, the device file is removed by any following invocation of an ocd that requires the same device file.

-c Parse the dp file and log all bad entries. This option is useful for debugging the dp file before running it properly. The -pocd_program entry is ignored if -c is used.

The netlinkrc script can be modified to include dpp, as in:

/etc/dpp /etc/ddfa/dp_file -k

dpp runs, scans all the entries in the dp file, creates a process for each valid entry then exits. It is recommended that the -k option be used, and that a log file be specified.

If the dp file is modified, dpp must be run again to detect the changes.

KILLING DAEMONS

Outbound-connection daemons (ocds) should be killed using kill -15. Do not use kill -9 because it does not remove the device file. ocd verifies the validity of an existing pseudonym before trying to use it. dpp and ocd use data stored in file /etc/utmp.dfa to verify whether a process still owns a pseudonym before taking it over. If ocd finds an unowned pseudonym, it uses it.

ERRORS

Error messages are logged for bad arguments, bad file entries and ocd process-creation errors. By default, they are logged to the standard output. If the -lerror_log option is used, they are appended to the log file

Error messages are generally self-explanatory, but a brief explanation of some has been included in the following list.

error 0: dp_file is mandatory.

error 1: dp file must be the first argument.

error 2: Cannot read dp file.

The dp file either does not exist or cannot be accessed with current access privileges.

error 3: No log file defined (-l option).

error 4: Cannot create log file (-l option).

The log file cannot be created, either because of an invalid path or because of insufficient access privileges.

error 5: Cannot access log file (-l option).

The log file cannot be accessed, either because of an invalid path or because of insufficient access privileges. The log file must be readable by anyone.

error 6: No ocd file defined in program option.

error 7: Cannot execute ocd program (-p option).

The ocd program specified in the -p option either does not exist, or is not an executable file with current access privileges.

error 8: Cannot purge device file ( /dev/xxx ).

The -k option has been specified, the device file exists, but it cannot be purged because of insufficient access privileges.

error 9: Cannot execute default program (/etc/ocd).

The default ocd cannot be executed, either because of insufficient access privileges or because it has not been correctly installed.

error 10: Entry ignored (Bad IP address).

The dp file entry specified does not have a valid IP address.

error 11: Entry ignored (no board/port info).

error 12: Entry ignored (Bad port number).

The port specified is either not a decimal value or a string composed of x or X characters.

error 13: Entry ignored (Bad board number).

The board specified is either not a decimal value or is not a string composed of x or X characters.

error 14: No more processes available on system.

The ocd program specified cannot be started because there are no processes available on the system.

error 15: Entry ignored (no device name).

error 16: Entry ignored (Bad device name).

The device file specified cannot be created, either because of an invalid path or insufficient access rights.

error 17: Entry ignored (Bad config_name).

The specified config file cannot be read, either because of an invalid path or insufficient access rights.

FILES

/etc/dpp
/etc/ocdebug
/etc/ocd
/etc/dpp_login.bin
/etc/utmp.dfa
/etc/newconfig/ddfa/pcf
/etc/newconfig/ddfa/dp

Museum

Related Articles