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

NAME

6       idiscover (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              255.255.255.255 unless -b is used.
32
33       -b <ip>
34              Beginning IP address,  required,  unless  using  broadcast  with
35              defaults.   This  could be a specific IP address, or a broadcast
36              address, ending in 255, if the broadcast method (-a) is used.
37
38       -e <ip>
39              Endign IP address of the range.  Not used for broadcast  method.
40              If this is not specified, a range of one IP address matching the
41              beginning IP is assumed.
42
43       -g     Use the GetChannelAuthenticationCapabilities command method over
44              IPMI  LAN  instead of the RMCP ping.  Not compatible with broad‐
45              cast.  This may be useful if the vendor  BMC  does  not  support
46              RMCP ping for some reason.
47
48       -r N   Repeat the ping N times to each node.  Default is to send 1 ping
49              per node.
50
51       -i eth0
52              The interface name to use when sending the probes.  The  default
53              is to detect the first enabled ethernet interface (e.g. eth0).
54
55       -x     Causes extra debug messages to be displayed.
56
57
58

EXAMPLES

60           idiscover -a -b 192.168.1.255
61       Sends a broadcast RMCP ping to discover IPMI LAN nodes on the specified
62       subnet.
63
64           idiscover -b 192.168.1.100 -e 192.168.1.254
65       Sends RMCP pings to a range of IP addresses.
66
67           idiscover -g -b 192.168.1.100 -e 192.168.1.254
68       Sends GetChannelAuthCap commands to a range of IP addresses.
69
70
71

SEE ALSO

73       ipmiutil(8)   ialarms(8)   iconfig(8)   icmd(8)   ievents(8)    ifru(8)
74       igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8)
75       isol(8) iwdt(8)
76
77

WARNINGS

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

84       Copyright (C) 2009  Kontron America, Inc.
85
86       See  the  file  COPYING  in the distribution for more details regarding
87       redistribution.
88
89       This utility is distributed in the hope that it  will  be  useful,  but
90       WITHOUT ANY WARRANTY.
91
92

AUTHOR

94       Andy Cress <arcress at users.sourceforge.net>
95
96
97
98
99                           Version 1.0: 02 May 2007               IDISCOVER(8)
Impressum