home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / slipfree.zip / SlipFree.txt < prev   
Text File  |  1994-11-29  |  5KB  |  131 lines
  1.  
  2.                              SlipFree
  3.                       Version 1.0, 29-Nov-94
  4.   Requests COM port from SLIP, runs a program, returns COM port to SLIP
  5.  
  6.               mikel@networx.com <Mike Lempriere>
  7.  
  8. ------------------------------------------------------------------------------
  9.  
  10. WHAT IT DOES:
  11.  
  12.   SLIPFREE is a simple commandline program that facilitates COM port
  13.   access through SL/IP.
  14.  
  15.   SLIPFREE asks SLIP for access to the com port, then, once access is
  16.   granted, starts the program (supplied as an arg) that wants to use the
  17.   COM port.  Lastly, when the program ends, SLIPFREE then tells SLIP that
  18.   it's done, thus SLIP can go ahead and take back the COM port.
  19.  
  20.   This means you can start up all your SLIP networking deamons once, yet
  21.   use you modem for other things when you're not actually doing SLIP.
  22.  
  23. BIG UGLY CAVEAT:
  24.  
  25.   SLIP does not completely release the COM port.  Basically, all this
  26.   program does is make SLIP promise not to read/write the COM port
  27.   until we tell it we're done.  Most communications programs do an
  28.   exclusive open of the COM port, thus they will not tolerate SLIP's
  29.   having kept it open, even though SLIP won't be messing with it.  I
  30.   consider this poor design in SLIP, but there may be a reason for it
  31.   that I don't understand.
  32.  
  33.   In other words, this program may not have the desired effect; as an
  34.   example you will probably still have to shutdown SLIP fully before
  35.   being able to run a terminal emulator program.
  36.  
  37.   I've tested LOGICOMM this way; LOGICOMM demands exclusive access to
  38.   the COM port, thus will not run under SLIPFREE.  Please let me know if
  39.   you do find comm programs that do work this way <mikel@networx.com>.
  40.  
  41. ------------------------------------------------------------------------------
  42.  
  43. INSTALLATION:
  44.  
  45.   Merely unpack SLIPFREE.ZIP, then move SLIPFREE.EXE to a dir on your path.
  46.   I'd recommend moving SLIPFREE.TXT (this file) to the same dir so you can
  47.   find it later (unless you have a dir of loose docs, put it there).
  48.   SLIPFREE is a C++ program; the complete source file SLIPFREE.CPP is
  49.   included in the zip file in case you're inclined to look at the source,
  50.   as is a simple Makefile for building it.  They are not needed to run the
  51.   program.
  52.   There are no other support files used or needed for running or building.
  53.  
  54. ------------------------------------------------------------------------------
  55.  
  56. LICENSE JUNK:
  57.  
  58.   There are no requirements for using this program.
  59.  
  60.   Of course there are also no warranties.
  61.  
  62.   I do ask, however, that if you have Internet e-mail access, you drop me
  63.   a line of thanks (or criticism if you have suggestions/bug-reports).
  64.   Also indicate in your mail if you'd like to be notified of any future
  65.   renditions.
  66.  
  67.   If you find a bug, please e-mail me about it.  If you make any mods to
  68.   the source, please e-mail them to me so that I can incorporate them into
  69.   any future renditions.  If you have any suggestions for improvements to
  70.   SLIPFREE, I'd especially like to hear them, e-mail me; mikel@networx.com.
  71.  
  72. ------------------------------------------------------------------------------
  73.  
  74. USAGE:
  75.  
  76.   I wrote this thing, as I have a nifty modem that gets Caller ID info,
  77.   and has voice playback/record capablities.  I'm using my computer as a
  78.   voicemail system, as well as an Internet connection.
  79.  
  80.   So when I'm not running SLIP, I want a program of mine to be running,
  81.   talking to the modem, acting on the modem info like CallerID, Fax rcv,
  82.   Voice playback, etc.
  83.  
  84.   However, SLIP wants to control the modem.  I wouldn't mind just stopping
  85.   SLIP, but when you do that, a bunch of the other daemons croak, ie.
  86.   SENDMAIL and LAMPOP.  This means that to start my home control stuff,
  87.   I have to blow away all the TCP/IP daemons, and restart them again the
  88.   next time.
  89.  
  90.   SLIPFREE allows me to run request the COM port and run my program,
  91.   merely putting SLIP on hold until I want to reestablish the SLIP
  92.   connection, leaving the TCP/IP deamons all passively running.
  93.  
  94.   As it also knows how to wait until slip comes up, it can also be used to
  95.   run a program once SLIP has come up (similar to SLIPWAIT).
  96.  
  97. ------------------------------------------------------------------------------
  98.  
  99. COMMAND SUMMARY:
  100.  
  101.   Usage: SLIPFREE [switches] command [command args]
  102.  
  103.   SWITCHES:
  104.   -?, -h    This help screen.
  105.   -w#        Wait up to '#' seconds for SLIP to start.
  106.  
  107.   'command' will be executed as a command line,
  108.   with any remaining args passed as it's args.
  109.  
  110.   EXAMPLES:
  111.       SLIPFREE commn
  112.           runs 'commn' without your having to shutdown or restart slip.
  113.  
  114. ------------------------------------------------------------------------------
  115.  
  116. PORTING:
  117.  
  118.   The program is written in C++, although it's almost entirely C.  To pull
  119.   the C++ness out of it and compile it under start C would be a trivial
  120.   matter.
  121.  
  122.   The makefile has both an IBM and a Borland section (IBM default).  To
  123.   setup for Borland, merely edit the makefile commenting out the IBM lines
  124.   and uncommenting out the Borland lines.
  125.  
  126.   It compiles warning-free under IBM CSET++ 2.0 and Borland C++ 1.00.
  127.   If you modify it, or port it to a compiler other than these two, please
  128.   let me know <mikel@networx.com>.
  129.  
  130. ------------------------------------------------------------------------------
  131.