README.txt for brc / B Remote Console 1.0

by Vickle Chan Mingwah, September 2002

This file provides description about brc / B Remote Console 1.0 and 
some important notes about this public domain program.

***** Description *****

This is a remote console sofware for DOS environments, which requires 
the host and the client PC are connected through a direct serial link 
( a null cable modem linking the two PCs' serial ports ). The software 
consists of two programs, one called bser.com, acting as the server, a 
TSR running background on the host PC; the other bcli.com, the remote 
console (or the client), running on the client PC, sending DOS 
commands to and getting back outputs from the host. Supported OSes are 
MS-DOS 3.3+, MS Windows 95/98/98SE.

This software was (Jan 2000) a project for a undergraduate course of 
assembly languages, demonstrating UART/RS232/Serial Port programming 
in asm. The full source codes in asm are provided. And a very detailed 
document -- manual.pdf -- is provided too, but in Simplified Chinese 
language only. The source codes and the precompiled binaries of this 
software are in public domain. Please refer to the Copyright Issues 
below.

***** Files in Package*****

2002-09-26  17:01     5,027  bcli.asm       
                             -- Source code for bcli.com
2002-09-20  21:09       264  bcli.com       
                             -- The client, compiled with MASM 5.0
2002-09-26  17:00     7,838  bser.asm
                             -- Source code for bser.com
2002-09-20  21:09       478  bser.com
                             -- The server, compiled with MASM 5.0
2002-09-20  21:39   320,595  manual.pdf
                             -- Detailed description in Chinese
   -- --      --      3,423  readme.txt
                             -- This very file

***** Copyright Issues *****

The software, all files included in the package (listed above) except 
the file manual.pdf (see below), was released in public domain by its 
original author Vickle Chan Mingwah, and is considered a public 
domain software, or freeware, which means any one can freely use, 
modify, and redistribute this software for any purpose as he/she 
likes. And since the time this software went to public domain, its 
original author has *NO* responsibility for any consequence of using 
this software or any of its deriving forms.

The file *manual.pdf*, as an exception to the other files in the 
package, remains strictly copyrighted by Vickle Chan Mingwah. 
Redistributing the file as-is (without any modifications) is granted 
to everyone. All other rights of the file are reserved.

I suggest you keep this copyright note even you modify this software, 
though it is not required. :-)

***** Usage *****

Compile the source code with Microsoft MASM 5.0 (higher version or 
other compatible asm compilers might also work), and link it into a 
.COM executable.

Connect two PCs with a null modem cable, which connecting through 
RS232 serial ports.

Run bser.com (the server) and bcli.com (the client) respectively on 
each PC. The supported OSes are DOS 3.3 or higher and WIN9x. There are 
some additional command line arguments available. Refer to the source 
code.

For more details about the program, please refer to the accompanying 
Manual.pdf, which is in Chinese.
 
__END_OF_README.TXT__