[net.sources] xmodem man page

brian@sdccsu3.UUCP (03/01/84)

x

.TH XMODEM LOCAL 2/7/84
.UC 4.2
.SH NAME
xmodem \- Christensen protocol file transfer utility
.SH SYNOPSIS
.B xmodem
[
.B st|sb|rt|rb
][
.B cdflx
]
file
.br
.SH DESCRIPTION
The
.I xmodem
program implements the Christensen (CP/M users group) file transfer
protocol for moving files between 4.2BSD Unix systems and microcomputers.
.PP
.SH PARAMETERS
exactly one of the following must be selected:
.TP
.B rb  
Receive Binary - file is placed on Unix disk without conversion as sent.
.TP
.B rt  
Receive Text - file is converted from CP/M format of CR-LF pairs to Unix
convention of 
.I newline 
characters only between lines.  The resulting file
is acceptable to the Unix editors and compilers, and is usually slightly
smaller than the original CP/M file.
.TP
.B sb  
Send Binary - the file is sent without conversion as it exists on the Unix disk.
.TP
.B st  
Send Text - newline characters in the file are converted to CR-LF pairs
in accord with the CP/M conventions for text files.  The file grows
slightly as this occurs so the estimate of file transmission size and
time are always optimistically low.
.PP
.SH Options:
.TP
.B c   
Select CRC mode on receive.  CRC mode is better at catching
transmission errors that occur.  Automatically selected on
transmission if the receiving modem program requests it.
.TP
.B d   
Toggle (off/on) log file deletion.  If deletion is selected, the log
file will be deleted before file transfer is begun.
.TP
.B l   
Toggle (off/on) the log file.  If logging is selected, a file
.I xmodem.log 
will be created (or appended to), with entries for errors
and retries described.  This can be useful to see why things went wrong
when they do.
.TP
.B f
Filter 8-bit chars on receive.  Zeros the 8th bit (bit 0-6 are
unchanged) to prevent "soft" characters generated by WordStar and other
text editors from making a text file uneditable.  This option should be
selected when receiving WordStar text files onto Unix for further
processing.
.TP
.B x   
Toggle (off/on) debug mode.  If debugging is selected, massive amounts
of information (some of it useful) will be written to the log file.
.SH FILES
xmodem.log (if logging or debugging is enabled)
.SH BUGS
The CRC option doesn't work yet.
.br
The
.B -f
option should probably default on for text receive mode.
.SH NOTES
Squeezed CP/M files must be transferred in binary mode, even if they
contain text.
.SH SEE ALSO
kermit(L)
.SH AUTHOR
Brian Kantor, University of California at San Diego.
Based on
.I umodem
by Lauren Weinstein, Richard Conn and others.
-- 
	-Brian Kantor, UC San Diego 
	Kantor@Nosc
	ihnp4 \
	decvax \
	dcdwest  -----  sdcsvax  ----- brian
	ittvax /
	ucbvax/