Technical article 110811

How do I configure UUCP over TCP/IP between SCO OpenServer 5.0.x and UnixWare 7.x?

OpenServer 5.0.0OpenServer 5.0.2OpenServer 5.0.4OpenServer 5.0.5UnixWare 7.0.0UnixWare 7.0.1UnixWare 7.1.0UnixWare 7.1.1

Written · Last revised

Problem

How do I configure UUCP over TCP/IP between SCO OpenServer 5 and UnixWare 7?

Solution

The document assumes knowledge of both UUCP and SCO TCP/IP.

Both OpenServer and UnixWare are capable of UUCP communication over
TCP/IP.  This solution uses the Transport Layer Interface (TLI)
method from UnixWare to OpenServer and the TCP socket method from
OpenServer to UnixWare.

For a more complete explanation of UUCP communication over TLI and TCP, see ta103575, "How do I set up UUCP over TCP/IP with the Transport Layer Interface?".

This article assumes the configuration is between these systems with a working TCP/IP network between them:

OpenServer 5    oserv5.uucp.com     192.168.32.45
UnixWare 7      uware7.uucp.com     10.76.34.23
	  ------------------------
OpenServer Configuration
------------------------
TLI CONFIGURATION
1. This configuration requires that you convert your IP address
   to hexadecimal.  Use the command bc(C), for example, with the
   address 192.168.32.45:
# bc
obase=16      (sets output to hex conversion)
192
C0
168
A8
32
20
45
2D
quit
#
So 192.168.32.45 converts to C0,A8,20,2D.

2. Next use the following commands to configure the TLI listening service:

# nlsadmin -i inet/tcp
# nlsadmin -a 10103 -c "/usr/lib/uucp/uucico -r0 -iTLI \
                  -unuucp" -w uucp -y "TLI UUCP" inet/tcp
# nlsadmin -l "\x020002bac0a8202d0000000000000000" inet/tcp

This is the hexadecimal representation of the address TLI will listen to, as defined by the sockaddr_in /usr/include/sys/socket.h.

a. The first byte represents the address family. This is always AF_INET, or 02, as defined in the header file /usr/include/sys/socket.h.

b. The second byte is always 00.

c. The third and fourth bytes are the hexadecimal representation of the TLI port on which oserv5 listens for UUCP requests. In this case, decimal 698 equals 2ba in hexadecimal, hence the third byte is 02, and the fourth byte is ba. This port number must be one that is not already used and must not be port 540.

d. The fifth, sixth, seventh, and eighth bytes represent the hexadecimal equivalent of each octet of the IP number, which in this example is 192.68.32.45, then the fifth, sixth, seventh, and eighth bytes are (respectively):

c0, a8, 20, and 2d

e. The last eight bytes are all 00.

f. Thus, putting it all together, the address constructed is:

02|00|02|ba|c0|a8|20|2d|00|00|00|00|00|00|00|00
for a total of 16 bytes. (The "|"s are added for clarity.)
TLI is now configured.  To start the listener, issue the command:
# nlsadmin -s inet/tcp

This should start a process called "listen".

3. To ensure that the listener starts after reboot, add this to /etc/rc2.d/P87USRDAEMON:

nlsadmin -s inet/tcp 2>/dev/null
[ $? = 0 ] && echo "Started listener"

4. If you have problems with the listener, check the log at:

/usr/net/nls/inet/tcp/
UUCP CONFIGURATION ON OPENSERVER 5 (oserv5)

1. Add the following line to /usr/lib/uucp/Systems:

uware7 Any TCP,e  Any  uware7.uucp.com ""

Be sure that there aren't other uware7 entries in the Systems file.

2. Add the following set of lines to /usr/lib/uucp/Permissions:

MACHINE=uware7 LOGNAME=nuucp \
         COMMANDS=rmail:rnews:uucp \
         READ=/usr/spool/uucppublic:/usr/tmp \
         WRITE=/usr/spool/uucppublic:/usr/tmp \
         SENDFILES=yes REQUEST=yes

3. Add the following line to /usr/lib/uucp/Devices:

TCP    TCP,e   -       Any     TCP   540
------------------------
UnixWare 7 Configuration
------------------------
TCP SOCKET CONFIGURATION

1. Add the following line to /etc/inetd.conf:

uucp    stream  tcp     nowait  root    /usr/lib/uucp/uucico \
   in.uucpd -u nuucp

2. Restart inetd by sending (SIGHUP) to the process.

# ps -ef|grep inetd
root   851  829 TS  80  0 Jan 28 ?  0:00 /usr/sbin/inet
# kill -1 851

This configures UnixWare 7 to listen for UUCP connections on TCP port 540, based on the uucp entry in /etc/services.

UUCP CONFIGURATION ON UNIXWARE 7 (uware7)

1. Add the following line to /usr/lib/uucp/Systems:

oserv5 Any TCP - \x000202bac0a8202d
Notice the hex address:

00 - always 00. 02 - for AF_INET from /usr/include/sys/socket.h 02 - first half of port address 698 - 02ba ba - second half of port address c0 - first part(192) of oserv5's ip 192.68.32.45 a8 - second part(68) 20 - third part(32) 2d - forth part(45)

2. Add the following set of lines to /usr/lib/uucp/Permissions:

MACHINE=oserv5 LOGNAME=nuucp \
         COMMANDS=rmail:rnews:uucp \
         READ=/usr/spool/uucppublic:/usr/tmp \
         WRITE=/usr/spool/uucppublic:/usr/tmp \
         SENDFILES=yes REQUEST=yes

3. Add the following line to /usr/lib/uucp/Devices:

TCP tcp - - TLIS \D nls.uucico

See also

ta103575, "How do I set up UUCP over TCP/IP with the Transport Layer Interface?"

Manual pages on OpenServer: Systems(F), permissions(F), Devices(F), nlsadmin(ADM)

Manual pages on UnixWare: Systems(4bnu), Permissions(4bnu),
Devices(4bnu), inetd.conf(4tcp)

From the Xinuos technical article database, record 110811. Reproduced with permission. The original is at www.sco.com/ta/110811, which is reachable but blocked from search engines. Xinuos marks this article against a retired product line. That refers to the product’s lifecycle, not to whether the advice still works — plenty of it still applies to running systems.

Next step

Need this fixed rather than explained?

Tell us the release, what the system runs and what it is doing. We will reply by email with what we would do next.

  • You deal with the people who do the work
  • No obligation, and no upgrade required before we will help
  • We tell you plainly if something is not worth doing

Send an enquiry

We reply by email. If a server is down, say so in the first line. You can also write to help@scoexpert.com.