findbridge - Search for a CAT-DEV

Syntax

findbridge [options] [<name> | <ip-address> | <MAC-address>]

Options

-v Displays version information.
-h Display help.
-all Scan for all CAT-DEVs present on all enabled network interfaces.
-detail Must be used in conjunction with a <MAC-address>, <ip-address>, or the -all option. Displays detailed information about the CAT-DEV including IP address, MION firmware/FPGA version, and MAC address. SDK version installed, current boot mode, on/off state.
<name> The name of the CAT-DEV to find.
<ip_address> IP address of the CAT-DEV to find.
<mac_address> The MAC address of the CAT-DEV to find.

Description

The Host Bridge comes with a tool that allows a developer to search for a specific CAT-DEV on their network or to see all CAT-DEVs available on a network. This can also be used to see detailed information about the CAT-DEV, such as which boot mode a CAT-DEV is in, which SDK it has been updated to, and whether the CAT-DEV is in use or not.

NOTE:
Some features are only available with Host Bridge version 3.2.5.7 and above. (MION firmware 14.70)

Examples

Find a specific bridge by its name

> findbridge my-catdev
  
my-catdev                      : 10.20.30.100

Find all bridges connected to the network and get detailed information

> findbridge -all -detail
Scanning for bridges on interface 10.1.48.132...
Scanning for bridges on interface 169.254.74.78...

Note: Bridge Firmware older than 0.0.14.63 will not return some fields.

Bridge Name                    IP Address         FW Rev     FPGA        Mac Addr       SDK    Boot   Cafe
                                                              Rev                       Rev    Mode  On/Off
----------------------------------------------------------------------------------------------------  
MultiCDLab8                    10.20.30.225     0.0.14.72  13052071  00:25:5C:BA:0F:46  2.11.2  PCFS  OFF
PB-CATDEV3                     10.20.30.124     0.0.14.74  13052071  00:25:5C:BA:52:5E  2.11.5  PCFS  ON
PB-CATDEV4                     10.20.30.163     0.0.14.72  13052071  00:25:5C:BA:52:0A  2.9.22  NAND  OFF
00-25-5C-BA-51-94              10.20.30.174     0.0.14.60  13052071  00:25:5C:BA:51:94

See Also

setbridge

Revision History

2014-09-18 Placed topic in canonical API format.
2014-02-28 Initial version.


CONFIDENTIAL