caf@omen.UUCP (Chuck Forsberg WA7KGX) (12/19/85)
These are the updated manual pages for both Unix and VMS rb and sb programs. The Unix source code has not changed since the posting a few weeks ago. The VMS version has been modified to work around a bug in VMS 4.x. # This is a shell archive. # Remove everything above and including the cut line. # Then run the rest of the file through sh. -----cut here-----cut here-----cut here-----cut here----- #!/bin/sh # shar: Shell Archiver # Run the following text with /bin/sh to create: # rb.1 # sb.1 # This archive created: Wed Dec 18 13:15:40 1985 echo shar: extracting rb.1 '(4641 characters)' cat << \SHAR_EOF > rb.1 '\" Revision Level '\" Last Delta 12-16-85 .TH RB 1 OMEN .SH NAME rb \- YMODEM batch file receive .SH SYNOPSIS .B rb [ .B \-bquv ] .PP .B rb [ .B \-bcquv ] .B file .PP .B [-][v]rbCOMMAND .SH DESCRIPTION .B Rb receives 0 or more files in batch mode. Iff .B file is speficied, a single file is received in XMODEM single file mode. Normally, the file contents are converted to .SM Unix conventions by stripping carriage returns and all characters beginning with Control Z (CP/M end of file). If the raw pathname ends in ".A", ".ARC", ".CCC", ".CL", ".CMD", ".COM", ".CRL", ".DAT", ".DIR", ".EXE", ".O", ".OBJ", ".OVL", ".PAG", ".REL", ".SAV", ".SUB", ".SWP", ".SYS", ".TAR", ".UTL", ".a", ".o", ".tar", or if the first sector contains data that suggest a binary file (parity bits or characters in the range 000 to 006 before the first ^Z), or if the file mode is transmitted and the 0100000 bit is set, that file will be received in binary mode anyway. Otherwise, if the raw pathname ends in .MSG, or .TXT, any existing file will be appended to rather than replaced. Normally, each file name is converted to lower case unless it contains one or more lower case letters. Rb works with either standard 128 byte sectors or 1024 byte sectors (YAM .B k option). The user should determine experimentally the conditions under which use of 1k blocks actually improves throughput without causing problems. If extended file information (file length, etc.) is received, the file length controls the number of bytes written to the output dataset, and the modify time and file mode (iff non zero) are set accordingly. If no extended file information is received, slashes in the pathname are changed to underscore, and any trailing period in the pathname is eliminated. If rb is invoked with stdout and stderr to different datasets, Verbose is set to 2, causing frame by frame progress reports to stderr. This may be disabled with the .B q option. If the SHELL environment variable includes .I "rsh" or .I "rksh" (restricted shell), rb will not accept pathnames containing referenced to absolute paths or to a parent directory, will not receive to an existing file, and removes any files received in error. .PP The meanings of the available options are: .PP .PD 0 .TP .B b transfer all files in binary (tell it like it is) mode. This option disables any append mode special processing. .TP .B c Request 16 bit cyclic redundancy check (8 bit checksum default). .TP .B q Quiet suppresses verbosity. .TP .B v .IR Verbose causes a list of file names to be appended to /tmp/rblog . More v's generate more output. .TP .B u Retain upper case letters in file names unconditionally. .PD .SH EXAMPLES ( .SM Unix command) .RS $rb .br rb: ready C .br .RE (Pro-YAM command) .RS <F1> .br >>>c: sbt *.h *.c .br .RE .SH SEE ALSO YMODEM.DOC, IMP(CP/M), ncu(1), Professional-YAM manual, sb(omen), usq(omen), undos(omen) Compile time options for various operating systems are described in the program source file. .SH NOTES If rb is invoked as .B rbCOMMAND (with an optional leading \- as generated by login(1)), rb will pipe each received file to ``COMMAND filename'' (filename is the name of the transmitted file) with the file contents as standard input. A typical usage for this form is rbrmail which calls rmail to post mail. On some .SM Unix systems, the login directory must contain COMMAND as login sets SHELL=rsh which disallows absolute pathnames. If invoked with a leading ``v'' rb will report progress to LOGFILE. The following entry works for .SM Unix 3.0. rbrmail::5:1::/bin:/usr/local/rbrmail .PP The following (in a shell script) may be used to fetch file(s) from a remote computer connected to /dev/tty7 once sb has been started on the remote. rb -v >/dev/tty7 </dev/tty7 .SH BUGS Pathnames are restricted to 127 characters. In XMODEM single file mode, the pathname given on the command line is still processed as described above. The CR/LF to NL translation merely deletes CR\'s; undos(omen) performs a more intelligent translation. .SH "VMS VERSION" Some of the #includes with file names enclosed with angle brackets <> may need to have the angle brackets removed, or vice versa. The VMS version does not set binary mode according to the incoming file type. Non binary file processing consists of stripping all characters beginning with CPMEOF (^Z). The VMS version does not set the file time. VMS occaisonally loses incoming characters, resulting in retries and degradation of throughput. There may be unknown interactions between the VMS C standard i/o package and RMS. The VMS version does not support invocation as .B rbCOMMAND . SHAR_EOF echo shar: extracting sb.1 '(3443 characters)' cat << \SHAR_EOF > sb.1 '\" Revision Level '\" Last Delta 12-07-85 .TH SB 1 OMEN .SH NAME sb \- send files in batch mode .SH SYNOPSIS .B sb [ .B \-1dfkquv ] .B file ... .br .B "sb -X" [ .B \-1kquv ] .B file .SH DESCRIPTION .B Sb sends one or more files with YMODEM batch protocol. Normally, only the file name part of the pathname is transmitted. On .SM Unix systems, additional information about the file is transmitted. If the receiving program uses this information, the transmitted file length controls the exact number of bytes written to the output dataset, and the modify time and file mode are set accordingly. With the .B -X flag, .B sb sends a single file using XMODEM protocol. The received file name must be supplied by the user. If sb is invoked with stdout and stderr to different datasets, Verbose is set to 2, causing frame by frame progress reports to stderr. This may be disabled with the .B q option. Iff sb is invoked with $SHELL set and iff that variable contains the string .I "rsh" or .I "rksh" (restricted shell), sb operates in restricted mode. Restricted mode restricts pathnames to the current directory and PUBDIR (conventionally, /usr/spool/uucppublic) and/or subdirectories thereof. Sb supports YMODEM .B g mode by switching to "cbreak" tty mode with XON/XOFF folow control and the interrupt character set to CAN. The YMODEM .B g mode (Pro-YAM .B g option) increases throughput over error free channels (direct connection, X.PC, etc.) by not acknowledging each transmitted sector. .PP The meanings of the available options are: .PP .PD 0 .TP .B 1 Use file descriptor 1 for ioctls and reads. By default, file descriptor 0 is used. .TP .B X (XMODEM protocol) Send a single file without the filename packet. .TP .B d Change all instances of "." to "/" in the transmitted pathname. Thus, C.omenB0000 (which is unacceptable to MSDOS or CP/M) is transmitted as C/omenB0000. If the resultant filename has more than 8 characters in the stem, a "." in inserted to allow a total of eleven. .TP .B f Send Full pathnname. Normally directory prefices are stripped from the transmitted filename. .TP .B k Send files using 1024 byte blocks rather than the default 128 byte blocks. The user should determine experimentally the conditions under which use of 1k blocks actually improves throughput without causing problems. .TP .B q Quiet suppresses verbosity. .TP .B u Unlink the file after successful transmission. .TP .B v .IR Verbose causes a list of file names to be appended to /tmp/sblog . More v's generate more output. .PD .SH EXAMPLES (Unix command) .RS sb -k *.c .br .RE (Pro-YAM command) .RS <F3> .br .RE (8-bit YAM Commands) .br .RS ^E .br >>>c: rt -y .br .RE .SH SEE ALSO rb(omen), YMODEM.DOC, Professional-YAM manual, IMP(CP/M), ncu(1), sq(omen), todos(omen), tocpm(omen), tomac(omen) Compile time options for various operating systems are described in the program source file. .SH BUGS On VMS, some of the #includes with file names enclosed with angle brackets <> may need to have the angle brackets removed, or vice versa. The VMS version does not transmit the file date. The VMS version does not recognize Pro-YAM\'s .B g option (YMODEM-g protocol). The VMS version calculates the file length by counting the bytes therin. When VMS is lightly loaded, the response time may be too quick for MODEM7 unless the MODEM7 .B "q" modifier is used. There may be unknown interactions between the VMS C standard i/o package and RMS. SHAR_EOF # End of shell archive exit 0 -- Chuck Forsberg WA7KGX ...!tektronix!reed!omen!caf CIS:70715,131 Omen Technology Inc 17505-V NW Sauvie Island Road Portland OR 97231 Home of Professional-YAM, the most powerful COMM program for the IBM PC Voice: 503-621-3406 TeleGodzilla: 621-3746 (Hit CRs) L.sys entry for omen: omen Any ACU 1200 1-503-621-3746 se:--se: link ord: Giznoid in:--in: uucp