Query: ddfa
OS: hpux
Section: 7
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
ddfa(7) Miscellaneous Information Manual ddfa(7)NAMEddfa - Data Communications and Terminal Controller (DTC) Device File Access (DDFA) softwareDESCRIPTIONThe Data Communications and Terminal Controller (DTC) Device File Access (DDFA) software allows access from HP-UX system utilities and user applications to terminal servers using standard HP-UX structures. DDFA provides an interface to remote LAN-connected terminal server ports that is similar to the interface for local directly-connected ports. The basic principle is that a daemon is created for each configured terminal server port based on information in a configuration file (a Dedicated Ports file). When the daemon is spawned, it takes a from the pool and creates a device file with the same major and minor number as the slave. The device file is known as the "pseudonym" and utilities and applications use the pseudonym to access the terminal server port by exercising standard HP-UX system functions and The daemon listens on the until an application does an on the pseudonym. It then sets up and manages the connection to the terminal server port until the application does a on the pseudonym. The end result is that the terminal server port is addressed via a device file, but the mechanism that makes it happen is transparent to the user. A second configu- ration file (a port configuration file) contains information to profile the terminal server port. DDFA consists of the following items: Dedicated Ports file. This text file contains the information that DDFA needs to set up and manage a connection between a pseudonym and a terminal server port. The file is parsed by the Dedicated Port Parser which spawns an Outbound Connection Daemon for each outbound connec- tion specified in the file. The file is also used by the HP-UX Telnet daemon to identify incoming connections from a DTC and map them to a pseudonym (the Telnet port identification feature). Port Configuration File. This text file is used by DDFA to profile the terminal server port. The generic name of the template file is A port configuration file is referenced by an entry in the Dedicated Ports file Dedicated Port Parser. This command parses the Dedicated Ports file and spawns an Outbound Connection Daemon for each valid entry in the file. It can be run from the shell or it can be included in a system initialization script to automatically run the DDFA software each time the system is booted. Outbound Connection Daemon. This daemon manages the connection and data transfer to the remote terminal server port. Normally, it is spawned by the Dedicated Ports Parser (but it can be run directly from the shell. As it starts, it creates its pseudonym for the connection. As it terminates normally, it removes the pseudonym. If the pseudonym is removed while it is running, will terminate with an error condition. Outbound Connection Daemon debug mode. This is a special version of that contains debugging code. It must be run from the shell.CONFIGURATIONThere are two basic steps to configuring the DDFA software: o Enter information in the file. o Enter information in the port configuration files. Configuring the dp File The file contains one line for each outbound connection that is to be established and one line for each incoming connection request. A default file should be copied to a new file and the copy edited as needed. It is recommended that a directory be created to hold the file and the port configuration files. Each line of the file must contain the location of the terminal server port and the location of the pseudonym. In addition, for an out- bound connection, the port configuration file must be specified and a logging level may be specified. Configuring the Port Configuration Files A port configuration file is used to configure individual terminal server ports. A master port configuration file is In practice, it is renamed for each port that needs different configuration values and the values are altered appropriately for the device attached to the port. It is recommended that a directory be created to hold the port configuration files and the file. Each line of a port configuration file must consist of a name of a variable and its value. The variable-value pairs contain information on how to open a connection to a terminal server port, how to close a connection to a terminal server port, and how to manage the data trans- fer to a terminal server port. Configuring a System Initialization Script DDFA can be run at boot time by including a reference to in a system initialization script. It is recommended that the option be used when running in this environment.KILLING DAEMONSNote that should be killed using Do not use for this purpose as it does not remove the device file. verifies the validity of an existing pseudonym before trying to use it. and use data stored in the file to verify whether a process still owns a pseudonym before taking it over. If finds an unowned pseudonym, it uses it.ERROR HANDLINGWhen receives a serious error condition, such as when the LAN goes down, it transmits the error condition to the application by closing the Any or to the pseudonym returns the error condition If the pseudonym is the controlling terminal for the group to which the application belongs, is sent to all the processes in the group, including the application. ioctl() LIMITATIONS Not all functionality is available, due to the lack of a protocol that allows the transmission of such commands over the LAN to the remote port. termio Attribute Limitations The main restrictions on attributes (see termio(7)) include modem signal control and parity checking. The following are not available: ioctl() Request Limitations The following request limitations apply: DTC only supports one stop bit. DTC only supports 8 bits per character. Value cannot be modified. DTC offers static configuration to handle even or odd parity. It also handles auto parity detection for even or odd parity. Enabling/disabling done via static configuration. No programmatic interface supplied. No way to separate input from output parity features. Cannot be configured on DTC. Bad characters are forwarded to the system without marking them with OFFH or OH. Speed is part of static configuration. Flow control is enabled if the DTC static configuration specifies an ASCII access mode. If binary is selected, no flow control is provided. Pacing of output to a terminal via a programmatic interface is enabled when ASCII mode is selected in static port configuration and disabled when binary mode is selected. DTC does not offer the ability to restart output on any character received if XOFF was previously received. DDFA does not support the hanging up of modem signals on the last close of the device file. If the modem signals used on the DTC drop, the connection is closed. Not supported. not supported. not supported by Telnet port identification software. Part of static configuration is done in DTC Manager by selecting binary mode. If switching is enabled, binary can be selected at user interface level. There is no way to automatically nego- tiate binary mode when proper termio flags are reset when using Binary/ASCII switching is possible with DDFA. The DTC cannot support large reads in pure binary mode, so transferred blocks of data should not be more than 256 bytes. If half-duplex with remote acknowledgement is implemented, binary applications can be supported. ioctl() System Call Requests The following system call limitations apply: The ability to send a break without waiting for previous data to be sent is not provided at the system level in or DDFA. Receiving a Telnet break command in the DTC allows it to generate a break on asynchronous ports. The DTC output queue cannot be flushed. Hardware handshake request Not supported on DTC. Local handshake cannot be disabled on DTC. Not supported. There is no way to separately set modem lines of a DTC port. Modem timers, CD timer, connect timer, and disconnect cannot be configured. CCITT simple, and direct call-in/call-out modes DTC cannot handle simple mode because there is programmatic interface for modem signals. Call-in mode cannot be simulated if the port is opened, because modem signals (or the call) must be present within 2 minutes or the connection is cleared. No way to get device adapter information. No programmatic call to download the DTC. No programmatic interface to get such info. 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 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 and work correctly, each pseudonym must be unique in its first 17 characters (including the directory prefix 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: The printer interface scripts reside in the directory The line must be added just prior to the final 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.FILESSEE ALSOdpp(1M), ocd(1M), ocdebug(1M), ioctl(2), dp(4), pcf(4), ioctl(5), termio(7). ddfa(7)