UC.C for UNIX

[rconn%brl at sri-unix.UUCP]

From:      Rick Conn <rconn at brl>

I have just finished creating UC.C for UNIX SYSTEM III, and it has
compiled and executed successfully under SYSTEM III and compiled at
BRL with the -3 flag on the compiler.  UC (for UNIX-CP/M) is a
(optionally) menu-driven/command-completion comm tool for transferring
text and binary files between UNIX and CP/M.  It is available from
/d/rconn/.src/uc.c and /d/rconn/.man/uc.1 (source and man), and it
will be available from SIMTEL20 in a day or two.  Part of the man
entry follows:




     UUUUCCCC((((1111))))			 BBBBRRRRLLLL UUUUNNNNIIIIXXXX			 UUUUCCCC((((1111))))



     NNNNAAAAMMMMEEEE
	  uc - Version 1.0 - UNIX-to-CP/M File Transfer	Tool

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
	  UC is	a file transfer	tool which runs	under UNIX.  It, in
	  conjunction with a CP/M-based	MODEM communications program,
	  allows the user to transfer both binary and text files
	  between UNIX and CP/M.

	  UC is	based on ideas from UMODEM 3.5.	 UC is a totally new
	  design, including many features of similar function but
	  different implementation and adding many new features	and
	  both a menu-driven and command-completion user interface.

	  Usage:  uc c[o] [filename]

	  where	'c' MUST be One	of the Following Commands --
		  C -- CRC Check on Binary File	(filename required)
		  c -- CRC Check on Text File (filename	required)
		  f or F -- File Status	(filename required)
		  R -- Receive Binary File (filename required)
		  r -- Receive Text File (filename required)
		  S -- Send Binary File	(filename required)
		  s -- Send Text File (filename	required)
		  z or Z -- Enter Command Mode (filename NOT required)

	  and Additional Options 'o' Include --
		  1 -- Select File Transfer Protocol 1
		  7 -- Select 7-Bit Transfer
		  a or A -- Enable ARPA	Net Communication
		  b or B -- Override 'c', 's', or 'r' to Binary
		  l or L -- Turn Off Log Entries
		  t or T -- Override 'C', 'S', or 'R' to Text

	  Examples:
		  uc S myfile -or- uc sb myfile	  <-- Send Binary File
		  uc s7l myfile	  <-- Send Text	File with 7 Bits and
	  No Log

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
	       UC is a file transfer tool which	runs on	UNIX.  It
	  allows the user to transfer files between UNIX and CP/M
	  systems, verify the integrity	of transferred files via
	  Cyclic Redundancy Check (CRC)	value computation, and perform
	  other	functions useful in file transfer.

	       UC implements the following communications protocols:

		    1) "CP/M User's Group XMODEM" protocol developed
	  by Ward Christensen (checksum	only)

		    2) TERM II/TERM III	File Transfer Protocol 1



     Page 1					   (last mod. 9/13/83)






     UUUUCCCC((((1111))))			 BBBBRRRRLLLL UUUUNNNNIIIIXXXX			 UUUUCCCC((((1111))))



	  developed by Richard Conn

	       UC supports 7- or 8-bit transfers (7 or 8 significant
	  bits/byte) for text files and	8-bit transfers	for binary
	  files.

	  There	is currently no	batch file transfer capability.

	  The program writes logging data to a file in the user's home
	  directory called uc.log.  This file contains a transaction
	  of activity since the	invocation of the program, and this
	  transaction includes data on file transmissions (error log).

	  The program's	defaults can be	initialized for	each user by a
	  setup	file called .ucsetup (note the leading dot, so
	  .ucsetup is hidden from normal directory displays).
	  .ucsetup is a	text file which	contains initialization
	  options for uc.  It can be created by	using any editor under
	  UNIX.

	  The program will do a	protocol file transfer with error
	  checking to or from a	CP/M system running Ward Christensen's
	  program MODEM	or one of its derivatives (MODEM7 or APMOD777
	  etc.)	or any program that uses the same protocols (e.g. ZPRO
	  or TERM II).	Note that executable and squeezed files	must
	  use the -sb or -rb options.