ipmidetect(8)

1Ipmidetect(8)                     Ipmidetect                     Ipmidetect(8)
2
3
4

NAME

6       ipmidetect - list detected and/or undetected IPMI interfaces in a clus‐
7       ter
8

SYNOPSIS

10       ipmidetect [OPTION...] [NODES...]
11

DESCRIPTION

13       ipmidetect lists which IPMI nodes have been detected or undetected in a
14       cluster.   This information is provided by the libipmidetect(3) library
15       and ipmidetectd(8) daemon.
16
17       ipmidetect will output the status of each IPMI node configured with ip‐
18       midetectd(8)  unless  they  are  specified  on the command line. If the
19       first node listed is "-", nodes will be read in  from  standard  input.
20       The  nodes can be listed in hostrange format, comma separated lists, or
21       space separated lists. See the section below on HOSTRANGED SUPPORT  for
22       instructions on how to list hosts in range format. The hostnames listed
23       must be the shortened names of hostnames.
24

OPTIONS

26       -h STRING, --hostname=STRING
27              server hostname (default=localhost)
28
29       -p INT, --port=INT
30              server port (default=8649)
31
32       -d, --detected
33              List only detected nodes
34
35       -u, --undetected
36              List only undetected nodes
37
38       -q, --hostrange
39              List nodes in hostrange format (default)
40
41       -c, --comma
42              List nodes in comma separated list
43
44       -n, --newline
45              List nodes in newline separated list
46
47       -s, --space
48              List nodes in space separated list
49
50       -V, --version
51              Print version and exit
52

HOSTRANGED SUPPORT

54       Multiple hosts can be input either as an explicit comma separated lists
55       of  hosts  or  a  range of hostnames in the general form: prefix[n-m,l-
56       k,...], where n < m and l < k, etc. The later form should not  be  con‐
57       fused  with  regular expression character classes (also denoted by []).
58       For example, foo[19] does not represent foo1 or foo9, but rather repre‐
59       sents a degenerate range: foo19.
60
61       This  range  syntax  is  meant only as a convenience on clusters with a
62       prefixNN naming convention and specification of ranges  should  not  be
63       considered  necessary -- the list foo1,foo9 could be specified as such,
64       or by the range foo[1,9].
65
66       Some examples of range usage follow:
67           foo[01-05] instead of foo01,foo02,foo03,foo04,foo05
68           foo[7,9-10] instead of foo7,foo9,foo10
69           foo[0-3] instead of foo0,foo1,foo2,foo3
70
71       As a reminder to the reader, some shells will interpret brackets ([ and
72       ])  for  pattern matching. Depending on your shell, it may be necessary
73       to enclose ranged lists within quotes.
74

DIAGNOSTICS

76       The exit value of ipmidetect depends on the options  performed  on  the
77       command  line.  If the default output is used, the exit value will be 0
78       if the command succeeds without error. If the --detected option is used
79       and no undetected nodes have been discovered, the exit value will be 0.
80       If undetected nodes are found, the exit value will be 1. If the --unde‐
81       tected  option  is used and no detected nodes have been discovered, the
82       exit value will be 0. If detected nodes are found, the exit value  will
83       be 1. On errors, the exit value will be 2.
84

REPORTING BUGS

86       Report bugs to <freeipmi-users@gnu.org> or <freeipmi-devel@gnu.org>.
87

COPYRIGHT

89       Copyright (C) 2007-2015 Lawrence Livermore National Security, LLC.
90       Copyright (C) 2007 The Regents of the University of California.
91
92       This program is free software; you can redistribute it and/or modify it
93       under the terms of the GNU General Public License as published  by  the
94       Free  Software Foundation; either version 3 of the License, or (at your
95       option) any later version.
96