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
18       ipmidetectd(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, --help
27              Print help and exit
28
29       -v, --version
30              Print version and exit
31
32       -o STRING, --hostname=STRING
33              server hostname (default=localhost)
34
35       -p INT, --port=INT
36              server port (default=8649)
37
38       -d, --detected
39              List only detected nodes
40
41       -u, --undetected
42              List only undetected nodes
43
44       -q, --hostrange
45              List nodes in hostrange format (default)
46
47       -c, --comma
48              List nodes in comma separated list
49
50       -n, --newline
51              List nodes in newline separated list
52
53       -s, --space
54              List nodes in space separated list
55

HOSTRANGED SUPPORT

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

DIAGNOSTICS

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

REPORTING BUGS

89       Report bugs to <freeipmi-users@gnu.org> or <freeipmi-devel@gnu.org>.
90

COPYRIGHT

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