unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 ocd(1M)							     ocd(1M)




 NAME
      ocd - outbound connection daemon used by DDFA software

 SYNOPSIS
      ocd -fpseudonym -nnode_name [-bboard_no] [-cconfig_file] [-llog_level]
	   [-pport_no]

 DESCRIPTION
      The Outbound Connection Daemon (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.  It can be spawned from the Dedicated Port
      Parser (dpp) or run directly from the shell.

      For performance reasons, ocd does not have a debug mode.	However, a
      version called ocdebug with debug facilities is available.

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

      ocd logs important messages and error conditions to /var/adm/syslog.

    Options
      ocd recognizes the following options:

	   -bboard_no	     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 option is
			     omitted, the default 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



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 ocd(1M)							     ocd(1M)




				  open_timer:	   0
				  close_timer:	   0
				  status_request:  disable
				  status_timer:	   30
				  eight_bit:	   disable
				  tcp_nodelay:	   enable

	   -fpseudonym	     The absolute or relative path to the device
			     file that is linked by the software to the
			     reserved pty.  Applications use 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 this option is omitted, the logging level is
			     set to 1.

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

	   -pport_no	     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 default.

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



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 ocd(1M)							     ocd(1M)




      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 <&lt&lt&lt;&&amp&amp&amp;1 2>&gt&gt&gt;/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
      /usr/examples/ddfa/dp
      /usr/examples/ddfa/pcf
      /usr/sbin/dpp
      /usr/sbin/ocd
      /usr/sbin/ocdebug
      /var/adm/dpp_login.bin
      /var/adm/utmp.dfa

 SEE ALSO
      dpp(1M), ocdebug(1M), syslog(3C), dp(4), pcf(4), ddfa(7).

























 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000