NAME

       ipmiutil_discover - discover IPMI LAN-enabled nodes

SYNOPSIS

       idiscover [-abegisx]

DESCRIPTION

       idiscover  is  a program that uses IPMI LAN commands to discover any nodes on the LAN that are available,
       by probing the RMCP port (623.)  on those nodes.  This utility uses IPMI LAN,  so  no  IPMI  drivers  are
       needed.  There are three methods that can be used:
       -a   = broadcast RMCP ping method (default)
       -g   = GetChannelAuthCap command method
       else = specific RMCP ping method

       A  beginning  IP address can be specified with -b for broadcast and specific methods. An ending IP can be
       specified for non-broadcast methods.

OPTIONS

       Command line options are described below.

       -a     All nodes, use the broadcast ping method.  This is the default if no options are specified.   This
              will  detect the first enabled ethernet interface, and defaults to the broadcast address x.x.x.255
              (where x.x.x.x is IP address) unless -b is used to specify otherwise.

       -b <ip>
              Beginning IP address, required, unless using broadcast with defaults.  This could be a specific IP
              address, or a broadcast address, ending in 255, if the broadcast method (-a) is used.

       -e <ip>
              Endign IP address of the range.  Not used for broadcast method.  If this is not specified, a range
              of one IP address matching the beginning IP is assumed.

       -g     Use the GetChannelAuthenticationCapabilities command method over IPMI  LAN  instead  of  the  RMCP
              ping.   Not compatible with broadcast.  This may be useful if the vendor BMC does not support RMCP
              ping for some reason.

       -i eth0
              The interface name to use when sending the probes.  The default is to  detect  the  first  enabled
              ethernet interface (e.g. eth0).

       -m     shows  MAC address.  Uses the broadcast ping method, but uses a raw socket so that the MAC address
              can be displayed. This detects the first enabled ethernet interface, and defaults to the broadcast
              address 255.255.255.255 like -a.  Using -m with raw sockets requires root privilege.

       -r N   Repeat the ping N times to each node.  Default is to send 1 ping per node.

       -x     Causes extra debug messages to be displayed.

EXAMPLES

           idiscover -a -b 192.168.1.255
       Sends a broadcast RMCP ping to discover IPMI LAN nodes on the specified subnet.

           idiscover -b 192.168.1.100 -e 192.168.1.254
       Sends RMCP pings to a range of IP addresses.

           idiscover -g -b 192.168.1.100 -e 192.168.1.254
       Sends GetChannelAuthCap commands to a range of IP addresses.

SEE ALSO

       ipmiutil(8)  ialarms(8)  iconfig(8)  icmd(8) ievents(8) ifru(8) igetevent(8) ihealth(8) ilan(8) ireset(8)
       isel(8) isensor(8) iserial(8) isol(8) iwdt(8)

WARNINGS

       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil and any bug fix list.

COPYRIGHT

       Copyright (C) 2009  Kontron America, Inc.

       See the file COPYING in the distribution for more details regarding redistribution.

       This utility is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.

AUTHOR

       Andy Cress <arcress at users.sourceforge.net>

                                            Version 1.0: 02 May 2007                                IDISCOVER(8)