ciscodump --extcap-interfaces
ciscodump --extcap-interface=<interface> --extcap-dlts
ciscodump --extcap-interface=<interface> --extcap-config
ciscodump --extcap-interface=<interface> --fifo=<path to file or pipe> --capture --remote-host=remoterouter --remote-port=22 --remote-username=user --remote-interface=<the router interface>
Supported interfaces:
Examples:
permit ip host MYHOST any, permit ip any host MYHOST (capture the traffic for MYHOST)
deny ip host MYHOST any, deny ip any host MYHOST, permit ip any any (capture all the traffic except MYHOST)
ciscodump --help
To see program version:
ciscodump --version
To see interfaces:
ciscodump --extcap-interfaces
Only one interface (cisco) is supported.
Output:
interface {value=cisco}{display=SSH remote capture}
To see interface DLTs:
ciscodump --extcap-interface=cisco --extcap-dlts
Output:
dlt {number=147}{name=cisco}{display=Remote capture dependent DLT}
To see interface configuration options:
ciscodump --extcap-interface=cisco --extcap-config
Output:
ciscodump --extcap-interface=cisco --extcap-config
arg {number=0}{call=--remote-host}{display=Remote SSH server address}
{type=string}{tooltip=The remote SSH host. It can be both an IP address or a hostname}
{required=true}
arg {number=1}{call=--remote-port}{display=Remote SSH server port}{type=unsigned}
{default=22}{tooltip=The remote SSH host port (1-65535)}{range=1,65535}
arg {number=2}{call=--remote-username}{display=Remote SSH server username}{type=string}
{default=<current user>}{tooltip=The remote SSH username. If not provided, the current
user will be used}
arg {number=3}{call=--remote-password}{display=Remote SSH server password}{type=string}
{tooltip=The SSH password, used when other methods (SSH agent or key files) are unavailable.}
arg {number=4}{call=--sshkey}{display=Path to SSH private key}{type=fileselect}
{tooltip=The path on the local filesystem of the private ssh key}
arg {number=5}{call--sshkey-passphrase}{display=SSH key passphrase}
{type=string}{tooltip=Passphrase to unlock the SSH private key}
arg {number=6}{call=--remote-interface}{display=Remote interface}{type=string}
{required=true}{tooltip=The remote network interface used for capture}
arg {number=7}{call=--remote-filter}{display=Remote capture filter}{type=string}
{default=(null)}{tooltip=The remote capture filter}
arg {number=8}{call=--remote-count}{display=Packets to capture}{type=unsigned}{required=true}
{tooltip=The number of remote packets to capture.}
To capture:
ciscodump --extcap-interface cisco --fifo=/tmp/cisco.pcap --capture --remote-host 192.168.1.10
--remote-username user --remote-interface gigabit0/0
--remote-filter "permit ip host 192.168.1.1 any, permit ip any host 192.168.1.1"
NOTE: Packet count is mandatory, hence the capture will start after this number.
Another known issues is related to the number of captured packets (--remote-count). Due to the nature of the capture buffer, ciscodump waits for the capture to complete and then issues the command to show it. It means that if the user specifies a number of packets above the currently captured, the show command is never shown. Not only is the count of the maximum number of captured packets, but it is also the _exact_ number of expected packets.
HTML versions of the Wireshark project man pages are available at: <https://www.wireshark.org/docs/man-pages>.
Original Author -------- ------ Dario Lombardo <lomato[AT]gmail.com>