raft_test.go 31 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165
  1. package raft
  2. import (
  3. "bytes"
  4. "fmt"
  5. "math/rand"
  6. "reflect"
  7. "sort"
  8. "testing"
  9. pb "github.com/coreos/etcd/raft/raftpb"
  10. )
  11. // nextEnts returns the appliable entries and updates the applied index
  12. func nextEnts(r *raft) (ents []pb.Entry) {
  13. ents = r.raftLog.nextEnts()
  14. r.raftLog.resetNextEnts()
  15. return ents
  16. }
  17. type Interface interface {
  18. Step(m pb.Message) error
  19. ReadMessages() []pb.Message
  20. }
  21. func TestLeaderElection(t *testing.T) {
  22. tests := []struct {
  23. *network
  24. state StateType
  25. }{
  26. {newNetwork(nil, nil, nil), StateLeader},
  27. {newNetwork(nil, nil, nopStepper), StateLeader},
  28. {newNetwork(nil, nopStepper, nopStepper), StateCandidate},
  29. {newNetwork(nil, nopStepper, nopStepper, nil), StateCandidate},
  30. {newNetwork(nil, nopStepper, nopStepper, nil, nil), StateLeader},
  31. // three logs further along than 0
  32. {newNetwork(nil, ents(1), ents(2), ents(1, 3), nil), StateFollower},
  33. // logs converge
  34. {newNetwork(ents(1), nil, ents(2), ents(1), nil), StateLeader},
  35. }
  36. for i, tt := range tests {
  37. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  38. sm := tt.network.peers[1].(*raft)
  39. if sm.state != tt.state {
  40. t.Errorf("#%d: state = %s, want %s", i, sm.state, tt.state)
  41. }
  42. if g := sm.Term; g != 1 {
  43. t.Errorf("#%d: term = %d, want %d", i, g, 1)
  44. }
  45. }
  46. }
  47. func TestLogReplication(t *testing.T) {
  48. tests := []struct {
  49. *network
  50. msgs []pb.Message
  51. wcommitted int64
  52. }{
  53. {
  54. newNetwork(nil, nil, nil),
  55. []pb.Message{
  56. {From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}},
  57. },
  58. 2,
  59. },
  60. {
  61. newNetwork(nil, nil, nil),
  62. []pb.Message{
  63. {From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}},
  64. {From: 1, To: 2, Type: msgHup},
  65. {From: 1, To: 2, Type: msgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}},
  66. },
  67. 4,
  68. },
  69. }
  70. for i, tt := range tests {
  71. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  72. for _, m := range tt.msgs {
  73. tt.send(m)
  74. }
  75. for j, x := range tt.network.peers {
  76. sm := x.(*raft)
  77. if sm.raftLog.committed != tt.wcommitted {
  78. t.Errorf("#%d.%d: committed = %d, want %d", i, j, sm.raftLog.committed, tt.wcommitted)
  79. }
  80. ents := make([]pb.Entry, 0)
  81. for _, e := range nextEnts(sm) {
  82. if e.Data != nil {
  83. ents = append(ents, e)
  84. }
  85. }
  86. props := make([]pb.Message, 0)
  87. for _, m := range tt.msgs {
  88. if m.Type == msgProp {
  89. props = append(props, m)
  90. }
  91. }
  92. for k, m := range props {
  93. if !bytes.Equal(ents[k].Data, m.Entries[0].Data) {
  94. t.Errorf("#%d.%d: data = %d, want %d", i, j, ents[k].Data, m.Entries[0].Data)
  95. }
  96. }
  97. }
  98. }
  99. }
  100. func TestSingleNodeCommit(t *testing.T) {
  101. tt := newNetwork(nil)
  102. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  103. tt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  104. tt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  105. sm := tt.peers[1].(*raft)
  106. if sm.raftLog.committed != 3 {
  107. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 3)
  108. }
  109. }
  110. // TestCannotCommitWithoutNewTermEntry tests the entries cannot be committed
  111. // when leader changes, no new proposal comes in and ChangeTerm proposal is
  112. // filtered.
  113. func TestCannotCommitWithoutNewTermEntry(t *testing.T) {
  114. tt := newNetwork(nil, nil, nil, nil, nil)
  115. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  116. // 0 cannot reach 2,3,4
  117. tt.cut(1, 3)
  118. tt.cut(1, 4)
  119. tt.cut(1, 5)
  120. tt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  121. tt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  122. sm := tt.peers[1].(*raft)
  123. if sm.raftLog.committed != 1 {
  124. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 1)
  125. }
  126. // network recovery
  127. tt.recover()
  128. // avoid committing ChangeTerm proposal
  129. tt.ignore(msgApp)
  130. // elect 1 as the new leader with term 2
  131. tt.send(pb.Message{From: 2, To: 2, Type: msgHup})
  132. // no log entries from previous term should be committed
  133. sm = tt.peers[2].(*raft)
  134. if sm.raftLog.committed != 1 {
  135. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 1)
  136. }
  137. tt.recover()
  138. // still be able to append a entry
  139. tt.send(pb.Message{From: 2, To: 2, Type: msgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  140. if sm.raftLog.committed != 5 {
  141. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 5)
  142. }
  143. }
  144. // TestCommitWithoutNewTermEntry tests the entries could be committed
  145. // when leader changes, no new proposal comes in.
  146. func TestCommitWithoutNewTermEntry(t *testing.T) {
  147. tt := newNetwork(nil, nil, nil, nil, nil)
  148. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  149. // 0 cannot reach 2,3,4
  150. tt.cut(1, 3)
  151. tt.cut(1, 4)
  152. tt.cut(1, 5)
  153. tt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  154. tt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  155. sm := tt.peers[1].(*raft)
  156. if sm.raftLog.committed != 1 {
  157. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 1)
  158. }
  159. // network recovery
  160. tt.recover()
  161. // elect 1 as the new leader with term 2
  162. // after append a ChangeTerm entry from the current term, all entries
  163. // should be committed
  164. tt.send(pb.Message{From: 2, To: 2, Type: msgHup})
  165. if sm.raftLog.committed != 4 {
  166. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 4)
  167. }
  168. }
  169. func TestDuelingCandidates(t *testing.T) {
  170. a := newRaft(-1, nil, 0, 0) // k, id are set later
  171. b := newRaft(-1, nil, 0, 0)
  172. c := newRaft(-1, nil, 0, 0)
  173. nt := newNetwork(a, b, c)
  174. nt.cut(1, 3)
  175. nt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  176. nt.send(pb.Message{From: 3, To: 3, Type: msgHup})
  177. nt.recover()
  178. nt.send(pb.Message{From: 3, To: 3, Type: msgHup})
  179. wlog := &raftLog{ents: []pb.Entry{{}, pb.Entry{Data: nil, Term: 1, Index: 1}}, committed: 1}
  180. tests := []struct {
  181. sm *raft
  182. state StateType
  183. term int64
  184. raftLog *raftLog
  185. }{
  186. {a, StateFollower, 2, wlog},
  187. {b, StateFollower, 2, wlog},
  188. {c, StateFollower, 2, newLog()},
  189. }
  190. for i, tt := range tests {
  191. if g := tt.sm.state; g != tt.state {
  192. t.Errorf("#%d: state = %s, want %s", i, g, tt.state)
  193. }
  194. if g := tt.sm.Term; g != tt.term {
  195. t.Errorf("#%d: term = %d, want %d", i, g, tt.term)
  196. }
  197. base := ltoa(tt.raftLog)
  198. if sm, ok := nt.peers[1+int64(i)].(*raft); ok {
  199. l := ltoa(sm.raftLog)
  200. if g := diffu(base, l); g != "" {
  201. t.Errorf("#%d: diff:\n%s", i, g)
  202. }
  203. } else {
  204. t.Logf("#%d: empty log", i)
  205. }
  206. }
  207. }
  208. func TestCandidateConcede(t *testing.T) {
  209. tt := newNetwork(nil, nil, nil)
  210. tt.isolate(1)
  211. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  212. tt.send(pb.Message{From: 3, To: 3, Type: msgHup})
  213. // heal the partition
  214. tt.recover()
  215. data := []byte("force follower")
  216. // send a proposal to 2 to flush out a msgApp to 0
  217. tt.send(pb.Message{From: 3, To: 3, Type: msgProp, Entries: []pb.Entry{{Data: data}}})
  218. a := tt.peers[1].(*raft)
  219. if g := a.state; g != StateFollower {
  220. t.Errorf("state = %s, want %s", g, StateFollower)
  221. }
  222. if g := a.Term; g != 1 {
  223. t.Errorf("term = %d, want %d", g, 1)
  224. }
  225. wantLog := ltoa(&raftLog{ents: []pb.Entry{{}, {Data: nil, Term: 1, Index: 1}, {Term: 1, Index: 2, Data: data}}, committed: 2})
  226. for i, p := range tt.peers {
  227. if sm, ok := p.(*raft); ok {
  228. l := ltoa(sm.raftLog)
  229. if g := diffu(wantLog, l); g != "" {
  230. t.Errorf("#%d: diff:\n%s", i, g)
  231. }
  232. } else {
  233. t.Logf("#%d: empty log", i)
  234. }
  235. }
  236. }
  237. func TestSingleNodeCandidate(t *testing.T) {
  238. tt := newNetwork(nil)
  239. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  240. sm := tt.peers[1].(*raft)
  241. if sm.state != StateLeader {
  242. t.Errorf("state = %d, want %d", sm.state, StateLeader)
  243. }
  244. }
  245. func TestOldMessages(t *testing.T) {
  246. tt := newNetwork(nil, nil, nil)
  247. // make 0 leader @ term 3
  248. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  249. tt.send(pb.Message{From: 2, To: 2, Type: msgHup})
  250. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  251. // pretend we're an old leader trying to make progress
  252. tt.send(pb.Message{From: 1, To: 1, Type: msgApp, Term: 1, Entries: []pb.Entry{{Term: 1}}})
  253. l := &raftLog{
  254. ents: []pb.Entry{
  255. {}, {Data: nil, Term: 1, Index: 1},
  256. {Data: nil, Term: 2, Index: 2}, {Data: nil, Term: 3, Index: 3},
  257. },
  258. committed: 3,
  259. }
  260. base := ltoa(l)
  261. for i, p := range tt.peers {
  262. if sm, ok := p.(*raft); ok {
  263. l := ltoa(sm.raftLog)
  264. if g := diffu(base, l); g != "" {
  265. t.Errorf("#%d: diff:\n%s", i, g)
  266. }
  267. } else {
  268. t.Logf("#%d: empty log", i)
  269. }
  270. }
  271. }
  272. // TestOldMessagesReply - optimization - reply with new term.
  273. func TestProposal(t *testing.T) {
  274. tests := []struct {
  275. *network
  276. success bool
  277. }{
  278. {newNetwork(nil, nil, nil), true},
  279. {newNetwork(nil, nil, nopStepper), true},
  280. {newNetwork(nil, nopStepper, nopStepper), false},
  281. {newNetwork(nil, nopStepper, nopStepper, nil), false},
  282. {newNetwork(nil, nopStepper, nopStepper, nil, nil), true},
  283. }
  284. for i, tt := range tests {
  285. send := func(m pb.Message) {
  286. defer func() {
  287. // only recover is we expect it to panic so
  288. // panics we don't expect go up.
  289. if !tt.success {
  290. e := recover()
  291. if e != nil {
  292. t.Logf("#%d: err: %s", i, e)
  293. }
  294. }
  295. }()
  296. tt.send(m)
  297. }
  298. data := []byte("somedata")
  299. // promote 0 the leader
  300. send(pb.Message{From: 1, To: 1, Type: msgHup})
  301. send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Data: data}}})
  302. wantLog := newLog()
  303. if tt.success {
  304. wantLog = &raftLog{ents: []pb.Entry{{}, {Data: nil, Term: 1, Index: 1}, {Term: 1, Index: 2, Data: data}}, committed: 2}
  305. }
  306. base := ltoa(wantLog)
  307. for i, p := range tt.peers {
  308. if sm, ok := p.(*raft); ok {
  309. l := ltoa(sm.raftLog)
  310. if g := diffu(base, l); g != "" {
  311. t.Errorf("#%d: diff:\n%s", i, g)
  312. }
  313. } else {
  314. t.Logf("#%d: empty log", i)
  315. }
  316. }
  317. sm := tt.network.peers[1].(*raft)
  318. if g := sm.Term; g != 1 {
  319. t.Errorf("#%d: term = %d, want %d", i, g, 1)
  320. }
  321. }
  322. }
  323. func TestProposalByProxy(t *testing.T) {
  324. data := []byte("somedata")
  325. tests := []*network{
  326. newNetwork(nil, nil, nil),
  327. newNetwork(nil, nil, nopStepper),
  328. }
  329. for i, tt := range tests {
  330. // promote 0 the leader
  331. tt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  332. // propose via follower
  333. tt.send(pb.Message{From: 2, To: 2, Type: msgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  334. wantLog := &raftLog{ents: []pb.Entry{{}, {Data: nil, Term: 1, Index: 1}, {Term: 1, Data: data, Index: 2}}, committed: 2}
  335. base := ltoa(wantLog)
  336. for i, p := range tt.peers {
  337. if sm, ok := p.(*raft); ok {
  338. l := ltoa(sm.raftLog)
  339. if g := diffu(base, l); g != "" {
  340. t.Errorf("#%d: diff:\n%s", i, g)
  341. }
  342. } else {
  343. t.Logf("#%d: empty log", i)
  344. }
  345. }
  346. sm := tt.peers[1].(*raft)
  347. if g := sm.Term; g != 1 {
  348. t.Errorf("#%d: term = %d, want %d", i, g, 1)
  349. }
  350. }
  351. }
  352. func TestCommit(t *testing.T) {
  353. tests := []struct {
  354. matches []int64
  355. logs []pb.Entry
  356. smTerm int64
  357. w int64
  358. }{
  359. // single
  360. {[]int64{1}, []pb.Entry{{}, {Term: 1}}, 1, 1},
  361. {[]int64{1}, []pb.Entry{{}, {Term: 1}}, 2, 0},
  362. {[]int64{2}, []pb.Entry{{}, {Term: 1}, {Term: 2}}, 2, 2},
  363. {[]int64{1}, []pb.Entry{{}, {Term: 2}}, 2, 1},
  364. // odd
  365. {[]int64{2, 1, 1}, []pb.Entry{{}, {Term: 1}, {Term: 2}}, 1, 1},
  366. {[]int64{2, 1, 1}, []pb.Entry{{}, {Term: 1}, {Term: 1}}, 2, 0},
  367. {[]int64{2, 1, 2}, []pb.Entry{{}, {Term: 1}, {Term: 2}}, 2, 2},
  368. {[]int64{2, 1, 2}, []pb.Entry{{}, {Term: 1}, {Term: 1}}, 2, 0},
  369. // even
  370. {[]int64{2, 1, 1, 1}, []pb.Entry{{}, {Term: 1}, {Term: 2}}, 1, 1},
  371. {[]int64{2, 1, 1, 1}, []pb.Entry{{}, {Term: 1}, {Term: 1}}, 2, 0},
  372. {[]int64{2, 1, 1, 2}, []pb.Entry{{}, {Term: 1}, {Term: 2}}, 1, 1},
  373. {[]int64{2, 1, 1, 2}, []pb.Entry{{}, {Term: 1}, {Term: 1}}, 2, 0},
  374. {[]int64{2, 1, 2, 2}, []pb.Entry{{}, {Term: 1}, {Term: 2}}, 2, 2},
  375. {[]int64{2, 1, 2, 2}, []pb.Entry{{}, {Term: 1}, {Term: 1}}, 2, 0},
  376. }
  377. for i, tt := range tests {
  378. prs := make(map[int64]*progress)
  379. for j := 0; j < len(tt.matches); j++ {
  380. prs[int64(j)] = &progress{tt.matches[j], tt.matches[j] + 1}
  381. }
  382. sm := &raft{raftLog: &raftLog{ents: tt.logs}, prs: prs, HardState: pb.HardState{Term: tt.smTerm}}
  383. sm.maybeCommit()
  384. if g := sm.raftLog.committed; g != tt.w {
  385. t.Errorf("#%d: committed = %d, want %d", i, g, tt.w)
  386. }
  387. }
  388. }
  389. // ensure that the Step function ignores the message from old term and does not pass it to the
  390. // acutal stepX function.
  391. func TestStepIgnoreOldTermMsg(t *testing.T) {
  392. called := false
  393. fakeStep := func(r *raft, m pb.Message) {
  394. called = true
  395. }
  396. sm := newRaft(1, []int64{1}, 0, 0)
  397. sm.step = fakeStep
  398. sm.Term = 2
  399. sm.Step(pb.Message{Type: msgApp, Term: sm.Term - 1})
  400. if called == true {
  401. t.Errorf("stepFunc called = %v , want %v", called, false)
  402. }
  403. }
  404. // TestHandleMsgApp ensures:
  405. // 1. Reply false if log doesn’t contain an entry at prevLogIndex whose term matches prevLogTerm.
  406. // 2. If an existing entry conflicts with a new one (same index but different terms),
  407. // delete the existing entry and all that follow it; append any new entries not already in the log.
  408. // 3. If leaderCommit > commitIndex, set commitIndex = min(leaderCommit, index of last new entry).
  409. func TestHandleMsgApp(t *testing.T) {
  410. tests := []struct {
  411. m pb.Message
  412. wIndex int64
  413. wCommit int64
  414. wDenied bool
  415. }{
  416. // Ensure 1
  417. {pb.Message{Type: msgApp, Term: 2, LogTerm: 3, Index: 2, Commit: 3}, 2, 0, true}, // previous log mismatch
  418. {pb.Message{Type: msgApp, Term: 2, LogTerm: 3, Index: 3, Commit: 3}, 2, 0, true}, // previous log non-exist
  419. // Ensure 2
  420. {pb.Message{Type: msgApp, Term: 2, LogTerm: 1, Index: 1, Commit: 1}, 2, 1, false},
  421. {pb.Message{Type: msgApp, Term: 2, LogTerm: 0, Index: 0, Commit: 1, Entries: []pb.Entry{{Term: 2}}}, 1, 1, false},
  422. {pb.Message{Type: msgApp, Term: 2, LogTerm: 2, Index: 2, Commit: 3, Entries: []pb.Entry{{Term: 2}, {Term: 2}}}, 4, 3, false},
  423. {pb.Message{Type: msgApp, Term: 2, LogTerm: 2, Index: 2, Commit: 4, Entries: []pb.Entry{{Term: 2}}}, 3, 3, false},
  424. {pb.Message{Type: msgApp, Term: 2, LogTerm: 1, Index: 1, Commit: 4, Entries: []pb.Entry{{Term: 2}}}, 2, 2, false},
  425. // Ensure 3
  426. {pb.Message{Type: msgApp, Term: 2, LogTerm: 2, Index: 2, Commit: 2}, 2, 2, false},
  427. {pb.Message{Type: msgApp, Term: 2, LogTerm: 2, Index: 2, Commit: 4}, 2, 2, false}, // commit upto min(commit, last)
  428. }
  429. for i, tt := range tests {
  430. sm := &raft{
  431. state: StateFollower,
  432. HardState: pb.HardState{Term: 2},
  433. raftLog: &raftLog{committed: 0, ents: []pb.Entry{{}, {Term: 1}, {Term: 2}}},
  434. }
  435. sm.handleAppendEntries(tt.m)
  436. if sm.raftLog.lastIndex() != tt.wIndex {
  437. t.Errorf("#%d: lastIndex = %d, want %d", i, sm.raftLog.lastIndex(), tt.wIndex)
  438. }
  439. if sm.raftLog.committed != tt.wCommit {
  440. t.Errorf("#%d: committed = %d, want %d", i, sm.raftLog.committed, tt.wCommit)
  441. }
  442. m := sm.ReadMessages()
  443. if len(m) != 1 {
  444. t.Fatalf("#%d: msg = nil, want 1", i)
  445. }
  446. if m[0].Denied != tt.wDenied {
  447. t.Errorf("#%d: denied = %v, want %v", i, m[0].Denied, tt.wDenied)
  448. }
  449. }
  450. }
  451. func TestRecvMsgVote(t *testing.T) {
  452. tests := []struct {
  453. state StateType
  454. i, term int64
  455. voteFor int64
  456. wdenied bool
  457. }{
  458. {StateFollower, 0, 0, None, true},
  459. {StateFollower, 0, 1, None, true},
  460. {StateFollower, 0, 2, None, true},
  461. {StateFollower, 0, 3, None, false},
  462. {StateFollower, 1, 0, None, true},
  463. {StateFollower, 1, 1, None, true},
  464. {StateFollower, 1, 2, None, true},
  465. {StateFollower, 1, 3, None, false},
  466. {StateFollower, 2, 0, None, true},
  467. {StateFollower, 2, 1, None, true},
  468. {StateFollower, 2, 2, None, false},
  469. {StateFollower, 2, 3, None, false},
  470. {StateFollower, 3, 0, None, true},
  471. {StateFollower, 3, 1, None, true},
  472. {StateFollower, 3, 2, None, false},
  473. {StateFollower, 3, 3, None, false},
  474. {StateFollower, 3, 2, 2, false},
  475. {StateFollower, 3, 2, 1, true},
  476. {StateLeader, 3, 3, 1, true},
  477. {StateCandidate, 3, 3, 1, true},
  478. }
  479. for i, tt := range tests {
  480. sm := newRaft(1, []int64{1}, 0, 0)
  481. sm.state = tt.state
  482. switch tt.state {
  483. case StateFollower:
  484. sm.step = stepFollower
  485. case StateCandidate:
  486. sm.step = stepCandidate
  487. case StateLeader:
  488. sm.step = stepLeader
  489. }
  490. sm.HardState = pb.HardState{Vote: tt.voteFor}
  491. sm.raftLog = &raftLog{ents: []pb.Entry{{}, {Term: 2}, {Term: 2}}}
  492. sm.Step(pb.Message{Type: msgVote, From: 2, Index: tt.i, LogTerm: tt.term})
  493. msgs := sm.ReadMessages()
  494. if g := len(msgs); g != 1 {
  495. t.Fatalf("#%d: len(msgs) = %d, want 1", i, g)
  496. continue
  497. }
  498. if g := msgs[0].Denied; g != tt.wdenied {
  499. t.Errorf("#%d, m.Denied = %d, want %d", i, g, tt.wdenied)
  500. }
  501. }
  502. }
  503. func TestStateTransition(t *testing.T) {
  504. tests := []struct {
  505. from StateType
  506. to StateType
  507. wallow bool
  508. wterm int64
  509. wlead int64
  510. }{
  511. {StateFollower, StateFollower, true, 1, None},
  512. {StateFollower, StateCandidate, true, 1, None},
  513. {StateFollower, StateLeader, false, -1, None},
  514. {StateCandidate, StateFollower, true, 0, None},
  515. {StateCandidate, StateCandidate, true, 1, None},
  516. {StateCandidate, StateLeader, true, 0, 1},
  517. {StateLeader, StateFollower, true, 1, None},
  518. {StateLeader, StateCandidate, false, 1, None},
  519. {StateLeader, StateLeader, true, 0, 1},
  520. }
  521. for i, tt := range tests {
  522. func() {
  523. defer func() {
  524. if r := recover(); r != nil {
  525. if tt.wallow == true {
  526. t.Errorf("%d: allow = %v, want %v", i, false, true)
  527. }
  528. }
  529. }()
  530. sm := newRaft(1, []int64{1}, 0, 0)
  531. sm.state = tt.from
  532. switch tt.to {
  533. case StateFollower:
  534. sm.becomeFollower(tt.wterm, tt.wlead)
  535. case StateCandidate:
  536. sm.becomeCandidate()
  537. case StateLeader:
  538. sm.becomeLeader()
  539. }
  540. if sm.Term != tt.wterm {
  541. t.Errorf("%d: term = %d, want %d", i, sm.Term, tt.wterm)
  542. }
  543. if sm.lead != tt.wlead {
  544. t.Errorf("%d: lead = %d, want %d", i, sm.lead, tt.wlead)
  545. }
  546. }()
  547. }
  548. }
  549. func TestAllServerStepdown(t *testing.T) {
  550. tests := []struct {
  551. state StateType
  552. wstate StateType
  553. wterm int64
  554. windex int64
  555. }{
  556. {StateFollower, StateFollower, 3, 1},
  557. {StateCandidate, StateFollower, 3, 1},
  558. {StateLeader, StateFollower, 3, 2},
  559. }
  560. tmsgTypes := [...]int64{msgVote, msgApp}
  561. tterm := int64(3)
  562. for i, tt := range tests {
  563. sm := newRaft(1, []int64{1, 2, 3}, 0, 0)
  564. switch tt.state {
  565. case StateFollower:
  566. sm.becomeFollower(1, None)
  567. case StateCandidate:
  568. sm.becomeCandidate()
  569. case StateLeader:
  570. sm.becomeCandidate()
  571. sm.becomeLeader()
  572. }
  573. for j, msgType := range tmsgTypes {
  574. sm.Step(pb.Message{From: 2, Type: msgType, Term: tterm, LogTerm: tterm})
  575. if sm.state != tt.wstate {
  576. t.Errorf("#%d.%d state = %v , want %v", i, j, sm.state, tt.wstate)
  577. }
  578. if sm.Term != tt.wterm {
  579. t.Errorf("#%d.%d term = %v , want %v", i, j, sm.Term, tt.wterm)
  580. }
  581. if int64(len(sm.raftLog.ents)) != tt.windex {
  582. t.Errorf("#%d.%d index = %v , want %v", i, j, len(sm.raftLog.ents), tt.windex)
  583. }
  584. wlead := int64(2)
  585. if msgType == msgVote {
  586. wlead = None
  587. }
  588. if sm.lead != wlead {
  589. t.Errorf("#%d, sm.lead = %d, want %d", i, sm.lead, None)
  590. }
  591. }
  592. }
  593. }
  594. func TestLeaderAppResp(t *testing.T) {
  595. tests := []struct {
  596. index int64
  597. denied bool
  598. wmsgNum int
  599. windex int64
  600. wcommitted int64
  601. }{
  602. {-1, true, 1, 1, 0}, // bad resp; leader does not commit; reply with log entries
  603. {2, false, 2, 2, 2}, // good resp; leader commits; broadcast with commit index
  604. }
  605. for i, tt := range tests {
  606. // sm term is 1 after it becomes the leader.
  607. // thus the last log term must be 1 to be committed.
  608. sm := newRaft(1, []int64{1, 2, 3}, 0, 0)
  609. sm.raftLog = &raftLog{ents: []pb.Entry{{}, {Term: 0}, {Term: 1}}}
  610. sm.becomeCandidate()
  611. sm.becomeLeader()
  612. sm.ReadMessages()
  613. sm.Step(pb.Message{From: 2, Type: msgAppResp, Index: tt.index, Term: sm.Term, Denied: tt.denied})
  614. msgs := sm.ReadMessages()
  615. if len(msgs) != tt.wmsgNum {
  616. t.Errorf("#%d msgNum = %d, want %d", i, len(msgs), tt.wmsgNum)
  617. }
  618. for j, msg := range msgs {
  619. if msg.Index != tt.windex {
  620. t.Errorf("#%d.%d index = %d, want %d", i, j, msg.Index, tt.windex)
  621. }
  622. if msg.Commit != tt.wcommitted {
  623. t.Errorf("#%d.%d commit = %d, want %d", i, j, msg.Commit, tt.wcommitted)
  624. }
  625. }
  626. }
  627. }
  628. // When the leader receives a heartbeat tick, it should
  629. // send a msgApp with m.Index = 0, m.LogTerm=0 and empty entries.
  630. func TestBcastBeat(t *testing.T) {
  631. offset := int64(1000)
  632. // make a state machine with log.offset = 1000
  633. s := pb.Snapshot{
  634. Index: offset,
  635. Term: 1,
  636. Nodes: []int64{1, 2, 3},
  637. }
  638. sm := newRaft(1, []int64{1, 2, 3}, 0, 0)
  639. sm.Term = 1
  640. sm.restore(s)
  641. sm.becomeCandidate()
  642. sm.becomeLeader()
  643. for i := 0; i < 10; i++ {
  644. sm.appendEntry(pb.Entry{})
  645. }
  646. sm.Step(pb.Message{Type: msgBeat})
  647. msgs := sm.ReadMessages()
  648. if len(msgs) != 2 {
  649. t.Fatalf("len(msgs) = %v, want 1", len(msgs))
  650. }
  651. tomap := map[int64]bool{2: true, 3: true}
  652. for i, m := range msgs {
  653. if m.Type != msgApp {
  654. t.Fatalf("#%d: type = %v, want = %v", i, m.Type, msgApp)
  655. }
  656. if m.Index != 0 {
  657. t.Fatalf("#%d: prevIndex = %d, want %d", i, m.Index, 0)
  658. }
  659. if m.LogTerm != 0 {
  660. t.Fatalf("#%d: prevTerm = %d, want %d", i, m.LogTerm, 0)
  661. }
  662. if !tomap[m.To] {
  663. t.Fatalf("#%d: unexpected to %d", i, m.To)
  664. } else {
  665. delete(tomap, m.To)
  666. }
  667. if len(m.Entries) != 0 {
  668. t.Fatalf("#%d: len(entries) = %d, want 0", i, len(m.Entries))
  669. }
  670. }
  671. }
  672. // tests the output of the statemachine when receiving msgBeat
  673. func TestRecvMsgBeat(t *testing.T) {
  674. tests := []struct {
  675. state StateType
  676. wMsg int
  677. }{
  678. {StateLeader, 2},
  679. // candidate and follower should ignore msgBeat
  680. {StateCandidate, 0},
  681. {StateFollower, 0},
  682. }
  683. for i, tt := range tests {
  684. sm := newRaft(1, []int64{1, 2, 3}, 0, 0)
  685. sm.raftLog = &raftLog{ents: []pb.Entry{{}, {Term: 0}, {Term: 1}}}
  686. sm.Term = 1
  687. sm.state = tt.state
  688. switch tt.state {
  689. case StateFollower:
  690. sm.step = stepFollower
  691. case StateCandidate:
  692. sm.step = stepCandidate
  693. case StateLeader:
  694. sm.step = stepLeader
  695. }
  696. sm.Step(pb.Message{From: 1, To: 1, Type: msgBeat})
  697. msgs := sm.ReadMessages()
  698. if len(msgs) != tt.wMsg {
  699. t.Errorf("%d: len(msgs) = %d, want %d", i, len(msgs), tt.wMsg)
  700. }
  701. for _, m := range msgs {
  702. if m.Type != msgApp {
  703. t.Errorf("%d: msg.type = %v, want %v", i, m.Type, msgApp)
  704. }
  705. }
  706. }
  707. }
  708. func TestRestore(t *testing.T) {
  709. s := pb.Snapshot{
  710. Index: defaultCompactThreshold + 1,
  711. Term: defaultCompactThreshold + 1,
  712. Nodes: []int64{1, 2, 3},
  713. }
  714. sm := newRaft(1, []int64{1, 2}, 0, 0)
  715. if ok := sm.restore(s); !ok {
  716. t.Fatal("restore fail, want succeed")
  717. }
  718. if sm.raftLog.lastIndex() != s.Index {
  719. t.Errorf("log.lastIndex = %d, want %d", sm.raftLog.lastIndex(), s.Index)
  720. }
  721. if sm.raftLog.term(s.Index) != s.Term {
  722. t.Errorf("log.lastTerm = %d, want %d", sm.raftLog.term(s.Index), s.Term)
  723. }
  724. sg := int64Slice(sm.nodes())
  725. sw := int64Slice(s.Nodes)
  726. sort.Sort(sg)
  727. sort.Sort(sw)
  728. if !reflect.DeepEqual(sg, sw) {
  729. t.Errorf("sm.Nodes = %+v, want %+v", sg, sw)
  730. }
  731. if !reflect.DeepEqual(sm.raftLog.snapshot, s) {
  732. t.Errorf("snapshot = %+v, want %+v", sm.raftLog.snapshot, s)
  733. }
  734. if ok := sm.restore(s); ok {
  735. t.Fatal("restore succeed, want fail")
  736. }
  737. }
  738. func TestProvideSnap(t *testing.T) {
  739. s := pb.Snapshot{
  740. Index: defaultCompactThreshold + 1,
  741. Term: defaultCompactThreshold + 1,
  742. Nodes: []int64{1, 2},
  743. }
  744. sm := newRaft(1, []int64{1}, 0, 0)
  745. // restore the statemachin from a snapshot
  746. // so it has a compacted log and a snapshot
  747. sm.restore(s)
  748. sm.becomeCandidate()
  749. sm.becomeLeader()
  750. // force set the next of node 1, so that
  751. // node 1 needs a snapshot
  752. sm.prs[2].next = sm.raftLog.offset
  753. sm.Step(pb.Message{From: 2, To: 1, Type: msgAppResp, Index: -1, Denied: true})
  754. msgs := sm.ReadMessages()
  755. if len(msgs) != 1 {
  756. t.Fatalf("len(msgs) = %d, want 1", len(msgs))
  757. }
  758. m := msgs[0]
  759. if m.Type != msgSnap {
  760. t.Errorf("m.Type = %v, want %v", m.Type, msgSnap)
  761. }
  762. }
  763. func TestRestoreFromSnapMsg(t *testing.T) {
  764. s := pb.Snapshot{
  765. Index: defaultCompactThreshold + 1,
  766. Term: defaultCompactThreshold + 1,
  767. Nodes: []int64{1, 2},
  768. }
  769. m := pb.Message{Type: msgSnap, From: 1, Term: 2, Snapshot: s}
  770. sm := newRaft(2, []int64{1, 2}, 0, 0)
  771. sm.Step(m)
  772. if !reflect.DeepEqual(sm.raftLog.snapshot, s) {
  773. t.Errorf("snapshot = %+v, want %+v", sm.raftLog.snapshot, s)
  774. }
  775. }
  776. func TestSlowNodeRestore(t *testing.T) {
  777. nt := newNetwork(nil, nil, nil)
  778. nt.send(pb.Message{From: 1, To: 1, Type: msgHup})
  779. nt.isolate(3)
  780. for j := 0; j < defaultCompactThreshold+1; j++ {
  781. nt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{}}})
  782. }
  783. lead := nt.peers[1].(*raft)
  784. nextEnts(lead)
  785. lead.compact(nil)
  786. nt.recover()
  787. // trigger a snapshot
  788. nt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{}}})
  789. follower := nt.peers[3].(*raft)
  790. if !reflect.DeepEqual(follower.raftLog.snapshot, lead.raftLog.snapshot) {
  791. t.Errorf("follower.snap = %+v, want %+v", follower.raftLog.snapshot, lead.raftLog.snapshot)
  792. }
  793. // trigger a commit
  794. nt.send(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{}}})
  795. if follower.raftLog.committed != lead.raftLog.committed {
  796. t.Errorf("follower.comitted = %d, want %d", follower.raftLog.committed, lead.raftLog.committed)
  797. }
  798. }
  799. // TestStepConfig tests that when raft step msgProp in EntryConfChange type,
  800. // it appends the entry to log and sets pendingConf to be true.
  801. func TestStepConfig(t *testing.T) {
  802. // a raft that cannot make progress
  803. r := newRaft(1, []int64{1, 2}, 0, 0)
  804. r.becomeCandidate()
  805. r.becomeLeader()
  806. index := r.raftLog.lastIndex()
  807. r.Step(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Type: pb.EntryConfChange}}})
  808. if g := r.raftLog.lastIndex(); g != index+1 {
  809. t.Errorf("index = %d, want %d", g, index+1)
  810. }
  811. if r.pendingConf != true {
  812. t.Errorf("pendingConf = %v, want true", r.pendingConf)
  813. }
  814. }
  815. // TestStepIgnoreConfig tests that if raft step the second msgProp in
  816. // EntryConfChange type when the first one is uncommitted, the node will deny
  817. // the proposal and keep its original state.
  818. func TestStepIgnoreConfig(t *testing.T) {
  819. // a raft that cannot make progress
  820. r := newRaft(1, []int64{1, 2}, 0, 0)
  821. r.becomeCandidate()
  822. r.becomeLeader()
  823. r.Step(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Type: pb.EntryConfChange}}})
  824. index := r.raftLog.lastIndex()
  825. pendingConf := r.pendingConf
  826. r.Step(pb.Message{From: 1, To: 1, Type: msgProp, Entries: []pb.Entry{{Type: pb.EntryConfChange}}})
  827. if g := r.raftLog.lastIndex(); g != index {
  828. t.Errorf("index = %d, want %d", g, index)
  829. }
  830. if r.pendingConf != pendingConf {
  831. t.Errorf("pendingConf = %v, want %v", r.pendingConf, pendingConf)
  832. }
  833. }
  834. // TestRecoverPendingConfig tests that new leader recovers its pendingConf flag
  835. // based on uncommitted entries.
  836. func TestRecoverPendingConfig(t *testing.T) {
  837. tests := []struct {
  838. entType pb.EntryType
  839. wpending bool
  840. }{
  841. {pb.EntryNormal, false},
  842. {pb.EntryConfChange, true},
  843. }
  844. for i, tt := range tests {
  845. r := newRaft(1, []int64{1, 2}, 0, 0)
  846. r.appendEntry(pb.Entry{Type: tt.entType})
  847. r.becomeCandidate()
  848. r.becomeLeader()
  849. if r.pendingConf != tt.wpending {
  850. t.Errorf("#%d: pendingConf = %v, want %v", i, r.pendingConf, tt.wpending)
  851. }
  852. }
  853. }
  854. // TestRecoverDoublePendingConfig tests that new leader will panic if
  855. // there exist two uncommitted config entries.
  856. func TestRecoverDoublePendingConfig(t *testing.T) {
  857. func() {
  858. defer func() {
  859. if err := recover(); err == nil {
  860. t.Errorf("expect panic, but nothing happens")
  861. }
  862. }()
  863. r := newRaft(1, []int64{1, 2}, 0, 0)
  864. r.appendEntry(pb.Entry{Type: pb.EntryConfChange})
  865. r.appendEntry(pb.Entry{Type: pb.EntryConfChange})
  866. r.becomeCandidate()
  867. r.becomeLeader()
  868. }()
  869. }
  870. // TestAddNode tests that addNode could update pendingConf and peer list correctly.
  871. func TestAddNode(t *testing.T) {
  872. r := newRaft(1, []int64{1}, 0, 0)
  873. r.pendingConf = true
  874. r.addNode(2)
  875. if r.pendingConf != false {
  876. t.Errorf("pendingConf = %v, want false", r.pendingConf)
  877. }
  878. nodes := r.nodes()
  879. sort.Sort(int64Slice(nodes))
  880. wnodes := []int64{1, 2}
  881. if !reflect.DeepEqual(nodes, wnodes) {
  882. t.Errorf("nodes = %v, want %v", nodes, wnodes)
  883. }
  884. }
  885. // TestRemoveNode tests that removeNode could update pendingConf and peer list correctly.
  886. func TestRemoveNode(t *testing.T) {
  887. r := newRaft(1, []int64{1, 2}, 0, 0)
  888. r.pendingConf = true
  889. r.removeNode(2)
  890. if r.pendingConf != false {
  891. t.Errorf("pendingConf = %v, want false", r.pendingConf)
  892. }
  893. w := []int64{1}
  894. if g := r.nodes(); !reflect.DeepEqual(g, w) {
  895. t.Errorf("nodes = %v, want %v", g, w)
  896. }
  897. }
  898. func TestPromotable(t *testing.T) {
  899. id := int64(1)
  900. tests := []struct {
  901. peers []int64
  902. wp bool
  903. }{
  904. {[]int64{1}, true},
  905. {[]int64{1, 2, 3}, true},
  906. {[]int64{}, false},
  907. {[]int64{2, 3}, false},
  908. }
  909. for i, tt := range tests {
  910. r := &raft{id: id, prs: make(map[int64]*progress)}
  911. for _, id := range tt.peers {
  912. r.prs[id] = &progress{}
  913. }
  914. if g := r.promotable(); g != tt.wp {
  915. t.Errorf("#%d: promotable = %v, want %v", i, g, tt.wp)
  916. }
  917. }
  918. }
  919. func ents(terms ...int64) *raft {
  920. ents := []pb.Entry{{}}
  921. for _, term := range terms {
  922. ents = append(ents, pb.Entry{Term: term})
  923. }
  924. sm := &raft{raftLog: &raftLog{ents: ents}}
  925. sm.reset(0)
  926. return sm
  927. }
  928. type network struct {
  929. peers map[int64]Interface
  930. dropm map[connem]float64
  931. ignorem map[int64]bool
  932. }
  933. // newNetwork initializes a network from peers.
  934. // A nil node will be replaced with a new *stateMachine.
  935. // A *stateMachine will get its k, id.
  936. // When using stateMachine, the address list is always [0, n).
  937. func newNetwork(peers ...Interface) *network {
  938. size := len(peers)
  939. peerAddrs := make([]int64, size)
  940. for i := 0; i < size; i++ {
  941. peerAddrs[i] = 1 + int64(i)
  942. }
  943. npeers := make(map[int64]Interface, size)
  944. for i, p := range peers {
  945. id := peerAddrs[i]
  946. switch v := p.(type) {
  947. case nil:
  948. sm := newRaft(id, peerAddrs, 0, 0)
  949. npeers[id] = sm
  950. case *raft:
  951. v.id = id
  952. v.prs = make(map[int64]*progress)
  953. for i := 0; i < size; i++ {
  954. v.prs[peerAddrs[i]] = &progress{}
  955. }
  956. v.reset(0)
  957. npeers[id] = v
  958. case *blackHole:
  959. npeers[id] = v
  960. default:
  961. panic(fmt.Sprintf("unexpected state machine type: %T", p))
  962. }
  963. }
  964. return &network{
  965. peers: npeers,
  966. dropm: make(map[connem]float64),
  967. ignorem: make(map[int64]bool),
  968. }
  969. }
  970. func (nw *network) send(msgs ...pb.Message) {
  971. for len(msgs) > 0 {
  972. m := msgs[0]
  973. p := nw.peers[m.To]
  974. p.Step(m)
  975. msgs = append(msgs[1:], nw.filter(p.ReadMessages())...)
  976. }
  977. }
  978. func (nw *network) drop(from, to int64, perc float64) {
  979. nw.dropm[connem{from, to}] = perc
  980. }
  981. func (nw *network) cut(one, other int64) {
  982. nw.drop(one, other, 1)
  983. nw.drop(other, one, 1)
  984. }
  985. func (nw *network) isolate(id int64) {
  986. for i := 0; i < len(nw.peers); i++ {
  987. nid := int64(i) + 1
  988. if nid != id {
  989. nw.drop(id, nid, 1.0)
  990. nw.drop(nid, id, 1.0)
  991. }
  992. }
  993. }
  994. func (nw *network) ignore(t int64) {
  995. nw.ignorem[t] = true
  996. }
  997. func (nw *network) recover() {
  998. nw.dropm = make(map[connem]float64)
  999. nw.ignorem = make(map[int64]bool)
  1000. }
  1001. func (nw *network) filter(msgs []pb.Message) []pb.Message {
  1002. mm := make([]pb.Message, 0)
  1003. for _, m := range msgs {
  1004. if nw.ignorem[m.Type] {
  1005. continue
  1006. }
  1007. switch m.Type {
  1008. case msgHup:
  1009. // hups never go over the network, so don't drop them but panic
  1010. panic("unexpected msgHup")
  1011. default:
  1012. perc := nw.dropm[connem{m.From, m.To}]
  1013. if n := rand.Float64(); n < perc {
  1014. continue
  1015. }
  1016. }
  1017. mm = append(mm, m)
  1018. }
  1019. return mm
  1020. }
  1021. type connem struct {
  1022. from, to int64
  1023. }
  1024. type blackHole struct{}
  1025. func (blackHole) Step(pb.Message) error { return nil }
  1026. func (blackHole) ReadMessages() []pb.Message { return nil }
  1027. var nopStepper = &blackHole{}