home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO004.ZIP / XMODSYSV.ZIP / UMODEM.1 next >
Text File  |  1987-01-09  |  3KB  |  93 lines
  1. '\" t
  2. .TH umodem 1 "Local"
  3. .SH NAME
  4. umodem \- file transfer to and from personal computers
  5. .SH SYNOPSIS
  6. .B umodem\ 
  7. \fB-rb\fR | \fB-rt\fR | \fB-sb\fR | \fB-st\fR [ \fBqlmdy7\fR ] \fIfilename\fR
  8. .br
  9. .SH DESCRIPTION
  10. This command is used to transfer files to and from a Personal Computer
  11. using the standard "CP/M User's Group (Ward Christensen)" protocol.
  12. \fIUmodem\fR can be used to transfer one file at a time either to the PC or
  13. from the PC, and is compatible with most file transfer programs running on
  14. the PC.
  15. .SH "umodem"
  16. .I Umodem
  17. cooperates with the a multitude of programs that run
  18. on a Personal Computer to perform a file transfer.
  19. The integrity of the transfer is enhanced by use of a block checksum
  20. for error detection, and block retransmission for error correction.
  21. .PP
  22. .I Umodem
  23. requires exactly one of the following :
  24. .TP 8
  25. .B -rb
  26. Receive Binary \- transfer a file
  27. .I from
  28. the Personal Computer, in raw binary mode.  Every byte of the file will be
  29. transferred intact.  This mode is usually used to transfer, for example, .COM
  30. files.
  31. .TP
  32. .B -rt
  33. Receive Text \- transfer a file
  34. .I from
  35. the Personal Computer, in text mode.  In this mode the program attempts to
  36. convert from the CP/M text file format to the Unix format on-the-fly,
  37. by stripping carriage-return characters, and by ceasing to store data
  38. after a Control-Z is detected.
  39. .TP
  40. .B -sb
  41. Send Binary \- transfer a file
  42. .I to
  43. the Personal Computer, in raw binary mode.  Every byte of the file will be
  44. transferred intact.  This mode is usually used to transfer, for example, .COM
  45. files.
  46. .TP
  47. .B -st
  48. Send Text \- transfer a file
  49. .I to
  50. the Personal Computer, in text mode.  In this mode the program attempts to
  51. convert from the Unix text file format to the CP/M format on-the-fly,
  52. by adding carriage-return characters, and by appending a control-z
  53. character to the end of the file.
  54. .PP
  55. In addition,
  56. .I umodem
  57. recognizes the following options:
  58. .TP 8
  59. .B q
  60. Quiet option - the initial "boiler plate" of program name,
  61. file size, etc., is suppressed.
  62. .TP
  63. .B l
  64. Logfile option - enables logging the progress of the file transfer.
  65. This option is primarily useful for debugging.
  66. .TP
  67. .B m
  68. "Mung-mode" option - unless this option is specified, an attempt to
  69. receive a
  70. .I filename
  71. that already exists will be denied.  With this option, the existing file
  72. is overwritten.
  73. .TP
  74. .B d
  75. Delete the logfile, if it exists, before starting.
  76. .TP
  77. .B y
  78. Display file status (size) information only.
  79. .TP
  80. .B 7
  81. Seven-bit transfer option - strip off the high-order bit of each byte
  82. before it is sent (\f2-st\f1 case) or stored (\f2-rt\f1 case).
  83. This option is valid only for text-mode transfers.
  84. .PP
  85. \fIUmodem\fR supports only the checksum block
  86. error check, and not the more robust CRC.
  87. It supports neither the MODEM7 nor the YAM batch file transfer
  88. protocols.  Only single file transfers are supported.
  89. .SH FILES
  90. $HOME/umodem.log - created or appended to if the
  91. .B "-l"
  92. option is specified.
  93.