home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / NPIPE.ZIP / NPIPE.DOC next >
Text File  |  1991-06-11  |  2KB  |  79 lines
  1. NPIPE.DOC Version 1.0
  2. 10-June-1991
  3. Theo Jenetopulos
  4.  
  5. This program is provided for public use.  The program must be distributed as
  6. is and may not be modified.  No fees may be charged for the use or
  7. distribution of this program, other than the normal on-line fees of public
  8. data services.
  9.  
  10. ---- Using NPIPE ----
  11.  
  12. NPIPE was written to allow OS/2 programs to redirect output, through a named
  13. pipe to another session.  The program is most useful for viewing  output
  14. from PM programs that write to standard out.  This is very helpful when
  15. trying to debug PM messages such as WM_PAINT, that can't easily be worked
  16. on with a debugger.
  17.  
  18. The syntax is:
  19.  
  20. NPIPE /W pipename    (writes standard out to the pipe name you provide)
  21.  or
  22. NPIPE /R pipename    (reads the named pipe and writes it to standard out)
  23.  
  24.  
  25.  
  26. ---- Examples ----
  27. Simple Demo:
  28. OS/2 Window #1 
  29.     NPIPE /R TEST
  30.  
  31. OS/2 Window #2 
  32.     DIR | NPIPE /W TEST
  33.  
  34. The directory listing will display in window #1.
  35.  
  36.  
  37. Useful Demo:
  38. OS/2 Window #1
  39.     NPIPE /R MYPIPE
  40.  
  41. OS/2 Window #2
  42.     HELLO | NPIPE /W MYPIPE
  43.  
  44. Data written to stdout from the Presentation Manager Program will be
  45. displayed in Window #1.
  46.  
  47.  
  48.  
  49. ----Warning----
  50. The reader and the writer do their best to wait for the other to get there
  51. before using the pipe but stdout appears buffer about 512 bytes of data 
  52. before filling.  If you have a PM program that outputs a lot of data to 
  53. stdout before you get the reader side of the pipe going you may cause thread
  54. 1 to freeze up which will stop your PM message loop.  To avoid this you
  55. should start the reader side first.
  56.  
  57. You can duplicate this using my HELLO program by starting the writer and 
  58. causing 10-12 paints to occur.  The program will lock. You can hit Ctl-Esc
  59. and wait for the 'not responding' message from OS/2.  After killing the
  60. program, start up the reader in another window - it will clear the stdout
  61. of the writer and allow the filter to terminate normally.
  62.  
  63.  
  64.  
  65.  
  66. ---- Future -----
  67. Please let me know if you find this program useful, if you find bugs,
  68. or performance problems or would like to see additional features.
  69.  
  70. So far the only feature I am considering adding is to allow a sever
  71. name to be specified for remote named pipes.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.