2014-11-03 23:04:24 +03:00
|
|
|
/*
|
|
|
|
Copyright 2014 CoreOS, Inc.
|
|
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
you may not use this file except in compliance with the License.
|
|
|
|
You may obtain a copy of the License at
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
package raft
|
|
|
|
|
|
|
|
import (
|
|
|
|
"bytes"
|
|
|
|
"fmt"
|
|
|
|
|
|
|
|
pb "github.com/coreos/etcd/raft/raftpb"
|
|
|
|
)
|
|
|
|
|
2014-12-26 04:04:33 +03:00
|
|
|
func (st StateType) MarshalJSON() ([]byte, error) {
|
|
|
|
return []byte(fmt.Sprintf("%q", st.String())), nil
|
|
|
|
}
|
|
|
|
|
2014-11-26 03:21:50 +03:00
|
|
|
// uint64Slice implements sort interface
|
|
|
|
type uint64Slice []uint64
|
|
|
|
|
|
|
|
func (p uint64Slice) Len() int { return len(p) }
|
|
|
|
func (p uint64Slice) Less(i, j int) bool { return p[i] < p[j] }
|
|
|
|
func (p uint64Slice) Swap(i, j int) { p[i], p[j] = p[j], p[i] }
|
|
|
|
|
|
|
|
func min(a, b uint64) uint64 {
|
|
|
|
if a > b {
|
|
|
|
return b
|
|
|
|
}
|
|
|
|
return a
|
|
|
|
}
|
|
|
|
|
|
|
|
func max(a, b uint64) uint64 {
|
|
|
|
if a > b {
|
|
|
|
return a
|
|
|
|
}
|
|
|
|
return b
|
|
|
|
}
|
|
|
|
|
2014-12-05 21:45:05 +03:00
|
|
|
func IsLocalMsg(m pb.Message) bool { return m.Type == pb.MsgHup || m.Type == pb.MsgBeat }
|
|
|
|
|
2015-01-14 22:42:30 +03:00
|
|
|
func IsResponseMsg(m pb.Message) bool {
|
|
|
|
return m.Type == pb.MsgAppResp || m.Type == pb.MsgVoteResp || m.Type == pb.MsgHeartbeatResp
|
|
|
|
}
|
2014-12-05 21:45:05 +03:00
|
|
|
|
2015-01-21 22:12:58 +03:00
|
|
|
// EntryFormatter can be implemented by the application to provide human-readable formatting
|
|
|
|
// of entry data. Nil is a valid EntryFormatter and will use a default format.
|
|
|
|
type EntryFormatter func([]byte) string
|
|
|
|
|
2014-11-03 23:04:24 +03:00
|
|
|
// DescribeMessage returns a concise human-readable description of a
|
|
|
|
// Message for debugging.
|
2015-01-21 22:12:58 +03:00
|
|
|
func (f EntryFormatter) DescribeMessage(m pb.Message) string {
|
2014-11-03 23:04:24 +03:00
|
|
|
var buf bytes.Buffer
|
|
|
|
fmt.Fprintf(&buf, "%d->%d %s Term:%d Log:%d/%d", m.From, m.To, m.Type, m.Term, m.LogTerm, m.Index)
|
|
|
|
if m.Reject {
|
|
|
|
fmt.Fprintf(&buf, " Rejected")
|
|
|
|
}
|
|
|
|
if m.Commit != 0 {
|
|
|
|
fmt.Fprintf(&buf, " Commit:%d", m.Commit)
|
|
|
|
}
|
|
|
|
if len(m.Entries) > 0 {
|
|
|
|
fmt.Fprintf(&buf, " Entries:[")
|
|
|
|
for _, e := range m.Entries {
|
2015-01-21 22:12:58 +03:00
|
|
|
buf.WriteString(f.DescribeEntry(e))
|
2014-11-03 23:04:24 +03:00
|
|
|
}
|
|
|
|
fmt.Fprintf(&buf, "]")
|
|
|
|
}
|
|
|
|
if !IsEmptySnap(m.Snapshot) {
|
|
|
|
fmt.Fprintf(&buf, " Snapshot:%v", m.Snapshot)
|
|
|
|
}
|
|
|
|
return buf.String()
|
|
|
|
}
|
|
|
|
|
|
|
|
// DescribeEntry returns a concise human-readable description of an
|
|
|
|
// Entry for debugging.
|
2015-01-21 22:12:58 +03:00
|
|
|
func (f EntryFormatter) DescribeEntry(e pb.Entry) string {
|
|
|
|
var formatted string
|
|
|
|
if f == nil {
|
|
|
|
formatted = fmt.Sprintf("%q", e.Data)
|
|
|
|
} else {
|
|
|
|
formatted = f(e.Data)
|
|
|
|
}
|
|
|
|
return fmt.Sprintf("%d/%d %s %s", e.Term, e.Index, e.Type, formatted)
|
|
|
|
}
|
|
|
|
|
|
|
|
// DescribeMessage returns a concise human-readable description of a
|
|
|
|
// Message for debugging using the default formatter.
|
|
|
|
func DescribeMessage(m pb.Message) string {
|
|
|
|
return EntryFormatter(nil).DescribeMessage(m)
|
|
|
|
}
|
|
|
|
|
|
|
|
// DescribeEntry returns a concise human-readable description of an
|
|
|
|
// Entry for debugging using the default formatter.
|
2014-11-03 23:04:24 +03:00
|
|
|
func DescribeEntry(e pb.Entry) string {
|
2015-01-21 22:12:58 +03:00
|
|
|
return EntryFormatter(nil).DescribeEntry(e)
|
2014-11-03 23:04:24 +03:00
|
|
|
}
|