ocdebug(1M)

NAME

ocdebug − Outbound Connection Daemon debug utility (used by DDFA software)

SYNOPSIS

ocdebug -n node_name -f pseudonym [-b board_no] [-p port_no] [-c config_file] [-d level]

DESCRIPTION

The Outbound Connection Daemon (ocd) is part of the HP Datacommunication and Terminal Controller (DTC) Device File Access (DDFA) software. It manages the connection and data transfer to the remote DTC port. For performance reasons, it does not have a debug mode; ocdebug is a version of ocd with debug facilities. See ocd(1M) for more information about ocd.

See ddfa(7) for more information about how to configure and install the DDFA software, and for an explanation of how it works.

Debugging may be toggled interactively by sending the SIGUSR1 signal to the process by typing kill -16 pid.

Options and Command-Line Arguments

ocdebug recognizes the following arguments (note that apart from -d they are the same as the ocd command-line arguments):

-n node_name Mandatory. This is the IP address of the server or the port.

-f pseudonym Mandatory. This is the absolute or relative path to the device file that is linked by the software to the reserved pty. Applications use the pseudonym; not the dynamically allocated pty slave.

-b board_no Optional. This refers to the board number of the DTC. If it is omitted, the port number option must contain the full TCP service port address.

If the -n option explicitly names a DTC port, the -b option is not needed.

-p port_no Optional. This is the DTC port number. If the -b option is omitted, the port number must be the TCP service port address used by the server to access the port. If port_no is not specified, a value of 23 (Telnet) is used by default.

-c config_file Optional. This is the path to the Port Configuration File (pcf) used for profiling the DTC port. If this value is omitted, the default values specified in the default pcf file (/etc/newconfig/ddfa/pcf) is used. If the pcf doesn’t exist, an error message is logged, and the following values are used (note that the values for open_tries and open_timer are different from the default values):

telnet_mode: enable
timing_mark: enable
telnet_timer: 120
binary_mode: disable
open_tries: 0
open_timer: 0
close_timer: 0
status_request: disable
status_timer: 30
eight_bit: disable
tcp_nodelay: enable

-d level Optional. This indicates the level of debugging. Levels can be added together to accumulate dubugging functions. For example, -d7 enables all levels, and -d3 enables only the first two levels. The levels are:

0 No debug messages.

1 Trace procedure entry/exit logged.

2 Additional tracking messages logged.

4 Data structures dumped.

Debug messages are logged to the file /usr/adm/ocdpid , and the file name is displayed at the start of debugging.

FILES

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

Museum