home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / network / nmptoy.zip / NMPTOY.DOC < prev    next >
Text File  |  1992-01-02  |  3KB  |  55 lines
  1.  
  2.  
  3. Nmptoy.exe is a program that can be used to conveniently learn about
  4. the characteristics of the named pipe APIs. It's based on COW.
  5.  
  6. Inside the program, the command menu are divided into 3 categories:
  7.     - General commands 1, 2, and 3 for the APIs that can be called
  8. from either side of the named pipe. 
  9.     - Server commands for the APIs that can only be called from the
  10. server (or the maker) side of the named pipe.
  11.     - Client commands for the APIs that can only be called from the
  12. client (or the opener) side of the named pipe.
  13.  
  14. Inside the main window there are two sets of FOCUS WINDOWs. The focus
  15. windows are required for connected named pipe; one focus window is needed
  16. to represent what happens on one side of the pipe.
  17. The focus window set consists of a status window, a write window, and 
  18. a read window. 
  19.  
  20. The status window consists of a focus indicator, a blocking command 
  21. indicator, blocking command name, blocking command status, number of 
  22. bytes written, number of bytes read, named pipe handle, and named pipe 
  23. name. 
  24.  
  25. An example of what happens in the focus window is described below.
  26. If DosConnectNmPipe command is issued against a server handle, it will be 
  27. "attached" to an available focus window; the focus indicator will be 
  28. highlighted, and the blocking (command) indicator will also be highlighted 
  29. since DosConnect is a blocking type command. When the pipe is opened on the 
  30. other side, the blocking indicator is dehighlighted, and the status is 
  31. displayed.
  32.  
  33. The blocking type commands are DosConnect, DosWrite, DosRead, Dos-
  34. Transact, DosCall, DosWait. The nonblocking type command completion
  35. status is displayed through window dialog.
  36.  
  37. The main window also displays the inventory of handle/named pipes that 
  38. are made and opened. The information are listed as follows:
  39.     Ends: Server or client.
  40.     Type: Full duplex, server to client, or client to server.
  41.     Open Mode: in hex format.
  42.     Pipe Mode: in hex format.
  43.     Out buffer: buffer for server to client pipe. Initially it is 0
  44.             to get actual number do DosQNmPipeInfo.
  45.     In buffer: buffer for client to server pipe.
  46.     Focus window: if handle is focused you'll see W1 or W2.
  47.     Semaphore: if handle is attached to a semaphore you'll see *.
  48.     Handle: in hex format.
  49.     Name:
  50.     
  51. The program is limited to 3 Named pipes made; if you want to 
  52. make a new named pipe after reaching the limit, you have to close an 
  53. existing one.
  54.  
  55.