COHERENT manpages
This page displays the COHERENT manpage for mwcbbs [Download files from the Mark Williams bulletin board].
List of available manpages
Index
mwcbbs -- Command
Download files from the Mark Williams bulletin board
mwcbbs [-cp] [-dpath] directory
The command mwcbbs lets you select one or more files from mwcbbs, the
bulletin board maintained by Mark Williams Company. It displays the
contents of Contents files that you download from the bulletin board, lets
you select one or more files interactively, then constructs a uucp command
and requests the files from Mark Williams. If all goes well, the files
will be delivered to directory /usr/spool/uucppublic on your system.
mwcbbs. In this way, you can obtain the latest versions of COHERENT
software, sources for public-domain software that has been ported to
COHERENT, and exchange mail with MWC developers and support personnel.
Options
mwcbbs recognizes the following options:
-c Force uucp to telephone the Mark Williams bulletin board when you exit
from mwcbbs.
-dpath
Use path in place of the default receive path.
-p Print the Contents file. You can print all entries in a Contents
file, or entries newer than a specified date.
mwcbbs looks for the file .mwcbbs in the current directory. This file
contains the interface variables DOWNPATH and DATAPATH. The former names
names the directory into which uucp is to write the requested files; and
the latter names the directory where you keep data files. For example:
DOWNPATH=/usr/spool/uucppublic/
DATAPATH=/usr/lib/mwcbbs
Please note that path names are limited to 45 characters.
When you invoke mwcbbs, it displays a menu with the following items:
0. Contents.down
List public-domain software and shareware available for COHERENT
release 3.N (COHERENT 286).
1. Contents.32bit
List public-domain software and shareware available for COHERENT
release 4.N (COHERENT 386).
2. Contents.news
List news items and other informative postings from MWC.
3. Contents.UPD
List updates to COHERENT.
4. Maillist
List the mail sites available through mwcbbs.
5. Net_Maps
Show available network maps of world-wide UNIX sites.
6. Quit
Exit from mwcbbs.
Downloading Files
If you select items 0 through 3 from the main menu, mwcbbs displays the
names of files, 100 at a time. These names are read from a Contents file
that is stored in a directory you name either with the option -d or the
variable DATAPATH.
You can select one or more of these files for downloading to your system.
Note that when you invoke mwcbbs for the first time, the only files
displayed are those of the Contents files themselves; you must download
them first, before you can begin to download other files. This is because
the Contents are continually being updated, and also to test your UUCP with
the Mark Williams bulletin board before you attempt to download a large
number of source files.
To select a file for downloading, use the arrow keys to move the cursor to
that file (or use the vi cursor-movement keys h, j, k, and l). mwcbbs lets
you enter any of the following commands:
-s Select highlighted file name for more information or downloading.
Pressing <return> also selects the file.
-n Go to next screen (if there are more than 100 files).
-p Go to the previous screen.
-q Quit mwcbbs.
When you select a highlighted file, mwcbbs displays the following
information about it:
-> A summary of the file.
-> The date it was added or last updated
-> Other files that are required for compilation or use of selected file
name.
-> Other miscellaneous notes that may be of interest.
-> The system commands to be generated to download the selected file from
the Mark Williams bulletin board.
If a file is more than 50,000 bytes long, mwcbbs downloads it in parts.
When a file is to be received in parts you must concatenate the parts into
one file, which should be given the name of the file you selected.
Lists and Networks
Item 4 on the main menu (Maillist) gives you information about electronic
mail sites throughout the United States. When you select this option,
mwcbbs displays the names of the 50 states. When you select a state, as
with the file lists, mwcbbs displays information about the mail sites in
that state.
Item 5 (Net_Maps) gives you information about networks. When you select
this option, mwcbbs displays a menu with the following items:
0. Net_Maps.WORLD
Network maps of UNIX sites across the world.
1. Net_Maps.USA
Network maps of UNIX sites in the United States, by area code.
2. Net_Maps.CAN
Network maps of UNIX sites in Canada, by area code.
3. Quit
Return to main menu.
Options 0 through 2 display maps of available networks. You can select a
map interactively, as with the file options.
Printing a Contents File
When you invoke mwcbbs with its -p option, it lists the four Contents
files. When you select one, mwcbbs asks you to enter a search date. If
you enter a search date, mwcbbs prints only those entries that are dated
later than that date. If you do not enter a date, it prints every entry in
the Contents file entries.
Entries are printed to the file mwcbbs. When the entries have been printed,
mwcbbs automatically exits to the shell.
See Also
commands,
UUCP
COHERENT Tutorial: UUCP, Remote Communications Utility
Notes
mwcbbs does not work correctly until you have correctly configured UUCP to
contact the Mark Williams bulletin board. For details on how to do so, see
the tutorial UUCP, Remote Communications Utility in the front of the
COHERENT manual.
The charges for downloading a large set of files via a long-distance
telephone call can be quite heavy. Much depends upon the speed of your
modem and the time you place your call. Caveat utilitor!