*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> ocdebug (1m)              


 ocdebug(1M)                                                     ocdebug(1M)

 NAME    [Toc]    [Back]
      ocdebug - outbound connection daemon debug utility used by DDFA

 SYNOPSIS    [Toc]    [Back]
      ocdebug -fpseudonym -nnode_name [-bboard_no] [-cconfig_file]
           [-ddebug_level] [-llog_level] [-pport_no]

 DESCRIPTION    [Toc]    [Back]
      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

    Options    [Toc]    [Back]
      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):

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 ocdebug(1M)                                                     ocdebug(1M)

                               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 debugging functions.
                          For example, -d7 enables all levels and -d3
                          enables only the first two levels.  The levels

                               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 dynamically 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:

                               0    Log only LOG_CRIT messages.
                               1    Log only LOG_CRIT and LOG_ERR messages.
                               2    Log only LOG_CRIT, LOG_ERR, and
                                    LOG_WARNING messages.
                               3    Log all messages.

                          If it is omitted, the logging level is set to 1.

           -nnode_name    Specify the IP address of the terminal server or
                          the port.

           -pport_no      Specify a DTC port number or, if the -b option is
                          omitted, the TCP port service address that will be
                          used by the software to access the port.  If the
                          value is omitted, the value 23 (Telnet) is used by

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003

 ocdebug(1M)                                                     ocdebug(1M)

      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}'`

 WARNINGS    [Toc]    [Back]
      In order to ensure that commands (such as ps) display the correct
      device file name (that is, the pseudonym), all pseudonyms should be
      placed into the directory /dev/telnet.  If pseudonyms are not
      specified for placement in this directory, the correct display of
      device file names with many commands is not guaranteed.

      In addition, in order to ensure that commands (such as w, passwd,
      finger, and wall) work correctly, each pseudonym must be unique in its
      first 17 characters (including the directory prefix /dev/telnet/).  If
      pseudonyms are not unique in their first 17 characters, the correct
      functioning of many commands is not guaranteed.

      Also, in order to reliably handle timing mark negotiations (and ensure
      that files printing on a printer attached to a terminal server have
      been completely flushed to that printer), the following line must be
      added near the end of each printer interface script for printers
      attached to a terminal server:

           stty exta <&1 2>/dev/null

      The printer interface scripts reside in the directory
      /etc/lp/interface.  The line must be added just prior to the final
      'exit' command in each printer interface script.

      If this line is not added as specified, the printing reliability of
      printers attached to a terminal server is not guaranteed.

 FILES    [Toc]    [Back]

 SEE ALSO    [Toc]    [Back]
      dpp(1M), ocd(1M), syslog(3C), dp(4), pcf(4), ddfa(7).

 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
ocd HP-UX outbound connection daemon used by DDFA software
dpp HP-UX dedicated ports parser used by DDFA software
pcf HP-UX port configuration file used by DDFA software
dp HP-UX dedicated ports file used by DDFA software and Telnet port identification feature
ddfa HP-UX Data Communications and Terminal Controller (DTC) Device File Access (DDFA) software
audit Tru64 Contains debug messages from the uucico daemon
watchdogd FreeBSD Software watchdog daemon
setld Tru64 Software subset management utility
pkg_info OpenBSD a utility for displaying information on software packages
pkg_add FreeBSD a utility for installing software package distributions
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service