ocdebug.1m (2010 09)

o
ocdebug(1M) ocdebug(1M)
NAME
ocdebug - outbound connection daemon debug utility used by DDFA software
SYNOPSIS
ocdebug -fpseudonym -nnode_name [
-bboard_no ][-cconfig_file ][-ddebug_level ][
-llog_level ]
[
-pport_no ]
DESCRIPTION
The
ocdebug daemon is the debugging version of the Outbound Connection Daemon (
ocd). ocd is part
of the Data Communications and Terminal Controller (DTC) Device File Access (DDFA) software. It
manages the connection and data transfer to the remote terminal server port.
See ddfa (7) for more information on how to configure the DDFA software and for an explanation of how it
works.
Debugging may be toggled interactively by sending the
SIGUSR1 signal to the process using:
kill -16 pid.
ocdebug logs important messages and error conditions to
/var/adm/syslog. Debug messages are
logged to the file
/var/adm/ocdpid and the file name is displayed at the start of debugging.
Options
ocdebug recognizes the following options. Apart from the -d option they are the same as the
ocd
options.
-bboard_no Specify the board number of a DTC. If it is omitted, the port number option must
contain the full TCP service port address. The -b and -p options must not be used
if the IP address given in the -n option is the IP address of a port.
If the
-n option explicitly names a terminal server port, the -b option is not
needed.
-cconfig_file Specify the name (including the absolute path) of the configuration file used to
profile the terminal server port. If this value is omitted, the values specified in the
default pcf file (/usr/examples/ddfa/pcf
) are used. If the file specified does
not 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
-ddebug_level Specify the level of debugging. Levels can be added together to accumulate debug-
ging 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.
-fpseudonym Specify the absolute or relative path to the device file, which is linked by the
software to the reserved pty. Applications use the pseudonym and not the dynami-
cally allocated pty slave.
-llog_level Specify the logging level. It determines the severity of messages sent to
/var/adm/syslog. The logging levels (and how they relate to system logging
levels) are as follows:
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1