DataMuseum.dk

top - download

    Length: 3596 (0xe0c)
    Types: TextFile
    Notes: UNIX file
    Names: »rb«

└─⟦f27320a65⟧ Bits:30001972 Commodore 900 hard disk image with partial source code
    └─⟦2d53db1df⟧ UNIX V7 Filesystem
        └─ ⟦this⟧ »man/1.cmd/rb« 

TextFile

'\" Revision Level 
'\" Last Delta     10-14-83
.TH RB 1 CDI
.SH NAME
rb \- receive files in batch mode
.SH SYNOPSIS
.B rb
[
.B \-7bquv
]
.PP
.B rb
[
.B \-7bcquv
]
.B file
.PP
.B [-][v]rbCOMMAND
.SH DESCRIPTION
.B Rb
receives 0 or more files as sent by yam
in batch mode.
Iff
.B file
is speficied,
a single file is received in MODEM7 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.

If the raw pathname ends in .MSG, or .TXT, any existing file will
be appended to rather than replaced.

Slashes in the pathname are changed to underscore.
Any trailing period in the pathname is eliminated.
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 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 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 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.

.PP
The meanings of the available options are:
.PP
.PD 0
.TP
.B 7
Transfer file(s) using only 7 bit data.
Files will be transferred with the eighth bit reset.
Both ends must use (or not use) this option.
Cannot be used with the crc option.
.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 cyclic redundancy check rather than
the MODEM7 checksum.
Cannot be used with the 7 bit option.
.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
rb: ready C
.br
.RE
(yam command)
.RS
^E
>>>a0: sbt *.h *.c
.br
.RE
.SH SEE ALSO
sq(ucb), usq(ucb), yam manual, yam(CDI)
.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''
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/ucb/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 -7v >/dev/tty7 </dev/tty7
.SH BUGS
Path names are restricted to 127 characters.
In MODEM7 single file mode, the pathname is still processed
as described above.