Skip to content

Vatyx/NamedPipeCapture

Repository files navigation

NamedPipeCapture

A Windows tool that can be used to stream data from named pipe between two other process to Wireshark through a named pipe

Installation

Download the latest version from the releases page.
Make sure NamedPipeLauncher.exe and NamedPipeCapturex64.dll is in the same directory

Usage

There are 3 mandatory parameters, 2 optional parameters and 2 commands that can be used.

Mandatory Parameters

  • --input (shorthand -i): Specify the named pipe that will be captured (Ex: \myinputpipe)
  • --output (shorthand -o): Specify the named pipe that the data will be sent to (Ex: \\.\pipe\myoutputpipe)
  • --processid (shorthand -p): Specify the process whose functions will be overwritten

Optional Parameters

  • --clientport (shorthand -c): Specify the client-side port. If the process writes something to the pipe, this port will represent the source of the data transfer. If the process reads something from the pipe, this port will be recorded as the destination.
  • --serverport (shorthand -s): Specify the port that will represent any external process reading/writing to the target named pipe.

Commands

  • --load (shorthand -l): Load the DLL into the targeted process and open the output named pipe
  • --unload (shorthand -u): Unload the DLL from the application and close the output named pipe

Example

> NamedPipeCapture.exe --input \mynamedpipe --output \\.\pipe\myoutputpipe -processid 21457 -c 50 -s 51 --load

This will target the process with the id 21457, and the named pipe in the process with the name mynamedpipe. The data will be streamed to the named pipe myoutputpipe with the client port 50 and the server port 51

To stop the capture, run the unload command with the same process id

> NamedPipeCapture.exe -processid 21457 --unload

Streaming Data (using Wireshark)

Once the --load command has been executed on a process, the data can be seen in real time through Wireshark. Note that data will only begin to be captured once Wireshark has connected to the named pipe specified by the --output parameter.

  1. Open up Wireshark and go to Capture -> Interfaces Tutorial
  2. Click on Options on the bottom of the Interfaces window Tutorial
  3. Click on Manage Interfaces near the top right of the Capture Options window Tutorial
  4. Click on New on the left under the pipe tab and put the name of the output named pipe that was specified earlier Tutorial
  5. Click Save and Close the window. (The error "The link type of interface [your pipe] was not specified" may pop up which is fine. Just close it.)
  6. The newly added named pipe should be listed along with other interfaces in the Capture Options window. Make sure the capture tick box is ticked and then click on start in the bottom right hand corner. Tutorial

Data should now be streaming into Wireshark in real time! Tutorial

#Make sure Wireshark has stopped capturing data before the DLL is unloaded from the process.

About

A Windows tool that can be used to stream data from named pipe between two other process to Wireshark

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages