/usr/share/gocode/src/github.com/hashicorp/serf/command/members.go is in golang-github-hashicorp-serf-dev 0.6.4~ds1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 | package command
import (
"flag"
"fmt"
"github.com/hashicorp/serf/command/agent"
"github.com/mitchellh/cli"
"github.com/ryanuber/columnize"
"net"
"strings"
)
// MembersCommand is a Command implementation that queries a running
// Serf agent what members are part of the cluster currently.
type MembersCommand struct {
Ui cli.Ui
}
// A container of member details. Maintaining a command-specific struct here
// makes sense so that the agent.Member struct can evolve without changing the
// keys in the output interface.
type Member struct {
detail bool
Name string `json:"name"`
Addr string `json:"addr"`
Port uint16 `json:"port"`
Tags map[string]string `json:"tags"`
Status string `json:"status"`
Proto map[string]uint8 `json:"protocol"`
}
type MemberContainer struct {
Members []Member `json:"members"`
}
func (c MemberContainer) String() string {
var result []string
for _, member := range c.Members {
tags := strings.Join(agent.MarshalTags(member.Tags), ",")
line := fmt.Sprintf("%s|%s|%s|%s",
member.Name, member.Addr, member.Status, tags)
if member.detail {
line += fmt.Sprintf(
"|Protocol Version: %d|Available Protocol Range: [%d, %d]",
member.Proto["version"], member.Proto["min"], member.Proto["max"])
}
result = append(result, line)
}
return columnize.SimpleFormat(result)
}
func (c *MembersCommand) Help() string {
helpText := `
Usage: serf members [options]
Outputs the members of a running Serf agent.
Options:
-detailed Additional information such as protocol verions
will be shown (only affects text output format).
-format If provided, output is returned in the specified
format. Valid formats are 'json', and 'text' (default)
-name=<regexp> If provided, only members matching the regexp are
returned. The regexp is anchored at the start and end,
and must be a full match.
-role=<regexp> If provided, output is filtered to only nodes matching
the regular expression for role
'-role' is deprecated in favor of '-tag role=foo'.
The regexp is anchored at the start and end, and must be
a full match.
-status=<regexp> If provided, output is filtered to only nodes matching
the regular expression for status
-tag <key>=<regexp> If provided, output is filtered to only nodes with the
tag <key> with value matching the regular expression.
tag can be specified multiple times to filter on
multiple keys. The regexp is anchored at the start and end,
and must be a full match.
-rpc-addr=127.0.0.1:7373 RPC address of the Serf agent.
-rpc-auth="" RPC auth token of the Serf agent.
`
return strings.TrimSpace(helpText)
}
func (c *MembersCommand) Run(args []string) int {
var detailed bool
var roleFilter, statusFilter, nameFilter, format string
var tags []string
cmdFlags := flag.NewFlagSet("members", flag.ContinueOnError)
cmdFlags.Usage = func() { c.Ui.Output(c.Help()) }
cmdFlags.BoolVar(&detailed, "detailed", false, "detailed output")
cmdFlags.StringVar(&roleFilter, "role", "", "role filter")
cmdFlags.StringVar(&statusFilter, "status", "", "status filter")
cmdFlags.StringVar(&format, "format", "text", "output format")
cmdFlags.Var((*agent.AppendSliceValue)(&tags), "tag", "tag filter")
cmdFlags.StringVar(&nameFilter, "name", "", "name filter")
rpcAddr := RPCAddrFlag(cmdFlags)
rpcAuth := RPCAuthFlag(cmdFlags)
if err := cmdFlags.Parse(args); err != nil {
return 1
}
// Deprecation warning for role
if roleFilter != "" {
c.Ui.Output("Deprecation warning: 'Role' has been replaced with 'Tags'")
tags = append(tags, fmt.Sprintf("role=%s", roleFilter))
}
reqtags, err := agent.UnmarshalTags(tags)
if err != nil {
c.Ui.Error(fmt.Sprintf("Error: %s", err))
return 1
}
client, err := RPCClient(*rpcAddr, *rpcAuth)
if err != nil {
c.Ui.Error(fmt.Sprintf("Error connecting to Serf agent: %s", err))
return 1
}
defer client.Close()
members, err := client.MembersFiltered(reqtags, statusFilter, nameFilter)
if err != nil {
c.Ui.Error(fmt.Sprintf("Error retrieving members: %s", err))
return 1
}
result := MemberContainer{}
for _, member := range members {
addr := net.TCPAddr{IP: member.Addr, Port: int(member.Port)}
result.Members = append(result.Members, Member{
detail: detailed,
Name: member.Name,
Addr: addr.String(),
Port: member.Port,
Tags: member.Tags,
Status: member.Status,
Proto: map[string]uint8{
"min": member.DelegateMin,
"max": member.DelegateMax,
"version": member.DelegateCur,
},
})
}
output, err := formatOutput(result, format)
if err != nil {
c.Ui.Error(fmt.Sprintf("Encoding error: %s", err))
return 1
}
c.Ui.Output(string(output))
return 0
}
func (c *MembersCommand) Synopsis() string {
return "Lists the members of a Serf cluster"
}
|