
/*__pxm_doc()
 *
 *	Legal	-	'RpcExec'
 *	-----
 *	The author of this software accepts no responsibility
 *	for damages resulting from its use and makes no
 *	warranty or representation, either express or implied,
 *	including but not limited to, any implied warranty of
 *	merchantability or fitness for a particular purpose.
 *	This software is provided "AS IS", and you, its user,
 *	assume all risks when using it.
 *
 *	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 *	!! THIS SOFTWARE IS FREEWARE !!!                          !!
 *	!! READ THE FILE 'LICENSE.TXT' BEFORE USING THIS SOFTWARE !!
 *	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 *
 */

Synopsis:

'RpcExec V1.0' is a handy little command line utility that consists of 
two programs:
A RPC server that executes commands (i.e. runs programs, batch files etc.) 
on the host it is installed on issued by the RPC client(s) running on any 
other machine(s).

Installation requirements:

-	Windows 95 or Windows NT 3.5x or higher 
	(TCP/IP stack MUST be installed)

-	about 42 KB free disk space ;-)



Introduction
------------

'RpcExec' uses the Microsoft Remote Procedure Call (RPC) mechanism to execute
commands on remote computers that run the 'RpcExec' server. This feature might 
come in handy when having to perform tasks that cannot be covered by just sharing
files using the Microsoft network facility as they rely on program execution on
a machine different to that you're working on.


Installation
------------

Just extract the files 'rpcexecs.exe' (server) and 'rpcexecc.exe' (client)
from the .zip archive and copy them to any directory of your choice.


Usage
-----

Start the 'RpcExec' server (rpcexecs.exe) on the machine you want to execute commands
on. Then use the client program (rpcexecc.exe) to issue the command(s) you want 
to execute. The command line syntax of the client is

rpcexecc <server> "<command>"

where <server> is either the hostname or the IP address of the machine the
'RpcExec' server is running on, "<command>" is the command to be executed.
NOTE that if the command takes arguments (e.g. "winword.exe /print mydoc.doc") BOTH
COMMAND AND ARGUMENTS MUST BE ENCLOSED IN DOUBLE QUOTES!
To shut down the server side, type

rpcexecc <server> /shutdown


Limitations
-----------

'RpcExec' is not able to perform tasks that require interaction. For example,
if you try to run 'rpcexecc foo.mynet.com "format c:"', it won't work because
'format.com' will ask you whether you are sure.


SECURITY !!!!!!!!!!!!!!!!!!!!!
------------------------------

NOTE THAT THE 'RpcExec' SERVER DOES _NOT_ PERFORM ANY SORT OF AUTHENTIFICATION !!!
Therefore, make sure that the machine running the 'RpcExec' server is not directly
accessible via Internet !!!
If you think this utility is useful, let us know. If there is a real need for
adding a security concept, we'll implement a simple client authentication in the next
version.
Additionally, we presume that you KNOW what you're doing, so there is no restriction
on the commands you can execute on the server machine.


Deinstallation
--------------

Delete the files 'rpcexecs.exe' and 'rpcexecc.exe'.


Technical Notes
---------------

'RpcExec' binds to port 513, aka 'login' in the UN*X world - we don't think neither
Win95 nor NT will use this one ...
The only protocol provided in this version is connection-oriented TCP over IP. 
If there is a need for you to use an other transport such as IPX/SPX, named pipes, 
NBT, UDP etc., please contact us (the only thing we certainly will not implement 
is local RPC - guess why). 


Comments and Suggestions
------------------------

Do not hesitate to send us your comments and suggestions. If you submit a bug
report, please remember to indicate the program version number, as well as the
operating system you are using (Windows 95 or Windows NT). Please enclose a
brief description of the bug you encountered and of the way to reproduce it.

You can either write us sending your message to

		ProXima GbR
		Ingenieurbuero fuer Software-
		Entwicklung und Consulting

		Wilhelmstr. 24/1

		74072 Heilbronn, Germany


 or use the slightly more modern way:

		Phone:	+49 7131 99 170-0
		Fax:	+49 7131 99 170-20

		CompuServe:	106571,2155
		EMail:		proxima@proxima.de
				ProXima_Engineering@compuserve.com
		WWW:		http://www.proxima.de


Revision list
-------------

V1.0		initial state			jk		13-Oct-1997
		 