2017-06-20 18:56:24 +00:00
|
|
|
nodelist(8) -- List confluent nodes and their attributes
|
2016-10-04 19:10:53 +00:00
|
|
|
=========================================================
|
|
|
|
|
|
|
|
|
|
## SYNOPSIS
|
|
|
|
|
|
2017-06-20 18:56:24 +00:00
|
|
|
`nodelist <noderange>`
|
2023-08-15 13:58:10 +00:00
|
|
|
`nodelist <noderange> [-b] [-d] {string} <nodeattribute>...`
|
2016-10-04 19:10:53 +00:00
|
|
|
|
|
|
|
|
## DESCRIPTION
|
|
|
|
|
|
|
|
|
|
**nodelist** queries the confluent server to get information about nodes. In
|
|
|
|
|
the simplest form, it simply takes the given noderange(5) and lists the
|
|
|
|
|
matching nodes, one line at a time.
|
|
|
|
|
|
|
|
|
|
If a list of node attribute names are given, the value of those are also
|
|
|
|
|
displayed. If `-b` is specified, it will also display information on
|
|
|
|
|
how inherited and expression based attributes are defined. There is more
|
|
|
|
|
information on node attributes in nodeattributes(5) man page.
|
|
|
|
|
|
2019-03-28 15:12:36 +00:00
|
|
|
Attributes may be specified by wildcard, for example `net.*switch` will report
|
|
|
|
|
all attributes that begin with `net.` and end with `switch`.
|
|
|
|
|
|
2016-10-04 19:10:53 +00:00
|
|
|
## OPTIONS
|
|
|
|
|
|
|
|
|
|
* `-b`, `--blame`:
|
|
|
|
|
Annotate inherited and expression based attributes to show their base value.
|
2023-08-15 13:58:10 +00:00
|
|
|
* `-d`, `--delim`:
|
|
|
|
|
Choose a delimiter to separat the values. Default - ENTER.
|
2016-10-04 19:10:53 +00:00
|
|
|
## EXAMPLES
|
|
|
|
|
* Listing matching nodes of a simple noderange:
|
|
|
|
|
`# nodelist n1-n4`
|
|
|
|
|
`n1`
|
|
|
|
|
`n2`
|
|
|
|
|
`n3`
|
|
|
|
|
`n4`
|
|
|
|
|
|
|
|
|
|
* Getting an attribute of nodes matching a noderange:
|
|
|
|
|
`# nodelist n1,n2 hardwaremanagement.manager`
|
|
|
|
|
`n1: hardwaremanagement.manager: 172.30.3.1`
|
|
|
|
|
`n2: hardwaremanagement.manager: 172.30.3.2`
|
|
|
|
|
|
|
|
|
|
* Getting a group of attributes while determining what group defines them:
|
|
|
|
|
`# nodelist n1,n2 hardwaremanegement --blame`
|
|
|
|
|
`n1: hardwaremanagement.manager: 172.30.3.1`
|
|
|
|
|
`n1: hardwaremanagement.method: ipmi (inherited from group everything)`
|
|
|
|
|
`n1: hardwaremanagement.switch: r8e1`
|
|
|
|
|
`n1: hardwaremanagement.switchport: 14`
|
|
|
|
|
`n2: hardwaremanagement.manager: 172.30.3.2`
|
|
|
|
|
`n2: hardwaremanagement.method: ipmi (inherited from group everything)`
|
|
|
|
|
`n2: hardwaremanagement.switch: r8e1`
|
|
|
|
|
`n2: hardwaremanagement.switchport: 2`
|
