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
25

OPTIONS

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

HOSTRANGED SUPPORT

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

DIAGNOSTICS

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

REPORTING BUGS

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

COPYRIGHT

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