1IDISCOVER(8)                System Manager's Manual               IDISCOVER(8)
2
3
4

NAME

6       ipmiutil_discover - discover IPMI LAN-enabled nodes
7

SYNOPSIS

9       idiscover [-abegisx]
10
11

DESCRIPTION

13       idiscover  is  a  program  that  uses IPMI LAN commands to discover any
14       nodes on the LAN that are available, by probing the  RMCP  port  (623.)
15       on  those  nodes.   This  utility uses IPMI LAN, so no IPMI drivers are
16       needed.  There are three methods that can be used:
17       -a   = broadcast RMCP ping method (default)
18       -g   = GetChannelAuthCap command method
19       else = specific RMCP ping method
20
21       A beginning IP address can be specified with -b for broadcast and  spe‐
22       cific methods. An ending IP can be specified for non-broadcast methods.
23
24

OPTIONS

26       Command line options are described below.
27
28       -a     All  nodes,  use the broadcast ping method.  This is the default
29              if no options are specified.  This will detect the first enabled
30              ethernet  interface,  and  defaults  to  the  broadcast  address
31              x.x.x.255 (where x.x.x.x is IP address) unless  -b  is  used  to
32              specify otherwise.
33
34       -b <ip>
35              Beginning  IP  address,  required,  unless  using broadcast with
36              defaults.  This could be a specific IP address, or  a  broadcast
37              address, ending in 255, if the broadcast method (-a) is used.
38
39       -e <ip>
40              Endign  IP address of the range.  Not used for broadcast method.
41              If this is not specified, a range of one IP address matching the
42              beginning IP is assumed.
43
44       -g     Use the GetChannelAuthenticationCapabilities command method over
45              IPMI LAN instead of the RMCP ping.  Not compatible  with  broad‐
46              cast.   This  may  be  useful if the vendor BMC does not support
47              RMCP ping for some reason.
48
49       -i eth0
50              The interface name to use when sending the probes.  The  default
51              is to detect the first enabled ethernet interface (e.g. eth0).
52
53       -m     shows  MAC  address.  Uses the broadcast ping method, but uses a
54              raw socket so that  the  MAC  address  can  be  displayed.  This
55              detects  the  first  enabled ethernet interface, and defaults to
56              the broadcast address 255.255.255.255 like -a.   Using  -m  with
57              raw sockets requires root privilege.
58
59       -r N   Repeat the ping N times to each node.  Default is to send 1 ping
60              per node.
61
62       -x     Causes extra debug messages to be displayed.
63
64
65

EXAMPLES

67           idiscover -a -b 192.168.1.255
68       Sends a broadcast RMCP ping to discover IPMI LAN nodes on the specified
69       subnet.
70
71           idiscover -b 192.168.1.100 -e 192.168.1.254
72       Sends RMCP pings to a range of IP addresses.
73
74           idiscover -g -b 192.168.1.100 -e 192.168.1.254
75       Sends GetChannelAuthCap commands to a range of IP addresses.
76
77
78

SEE ALSO

80       ipmiutil(8)    ialarms(8)   iconfig(8)   icmd(8)   ievents(8)   ifru(8)
81       igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8)
82       isol(8) iwdt(8)
83
84

WARNINGS

86       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil
87       and any bug fix list.
88
89
91       Copyright (C) 2009  Kontron America, Inc.
92
93       See the file COPYING in the distribution  for  more  details  regarding
94       redistribution.
95
96       This  utility  is  distributed  in the hope that it will be useful, but
97       WITHOUT ANY WARRANTY.
98
99

AUTHOR

101       Andy Cress <arcress at users.sourceforge.net>
102
103
104
105
106                           Version 1.0: 02 May 2007               IDISCOVER(8)
Impressum