gc: Add GCStateManager which is planned to be the replacement of SafePointManager (#9169)

ref #8978

Add `GCStateManager` which is planned to be the replacement of `SafePointManager`.

This is part of the refactor task #8978 . The new module is not yet used until the next PR updates the gRPC service interfaces.

Signed-off-by: MyonKeminta <[email protected]>

Co-authored-by: ti-chi-bot[bot] <108142056+ti-chi-bot[bot]@users.noreply.github.com>

Author: MyonKeminta

errors.toml

@@ -166,6 +166,11 @@ error = '''
 incorrect system time
 '''
 
+["PD:common:ErrInvalidArgument"]
+error = '''
+invalid argument for %s: %v
+'''
+
 ["PD:core:ErrNoStoreForRegionLeader"]
 error = '''
 can not remove store %d since there are no extra up store to store the leader
@@ -451,6 +456,36 @@ error = '''
 failed to convert a path to absolute path
 '''
 
+["PD:gc:ErrDecreasingGCSafePoint"]
+error = '''
+trying to update GC safe point to a smaller value, current value: %v, given: %v
+'''
+
+["PD:gc:ErrDecreasingTxnSafePoint"]
+error = '''
+trying to update txn safe point to a smaller value, current value: %v, given: %v
+'''
+
+["PD:gc:ErrGCBarrierTSBehindTxnSafePoint"]
+error = '''
+trying to set a GC barrier on ts %d which is already behind the txn safe point %d
+'''
+
+["PD:gc:ErrGCOnInvalidKeyspace"]
+error = '''
+trying to manage GC in keyspace %v where keyspace level GC is not enabled
+'''
+
+["PD:gc:ErrGCSafePointExceedsTxnSafePoint"]
+error = '''
+trying to update GC safe point to a too large value that exceeds the txn safe point, current value: %v, given: %v, current txn safe point: %v
+'''
+
+["PD:gc:ErrReservedGCBarrierID"]
+error = '''
+trying to set a GC barrier with a barrier ID that is reserved: %v
+'''
+
 ["PD:gin:ErrBindJSON"]
 error = '''
 bind JSON error

pkg/errs/errno.go

@@ -97,6 +97,7 @@ var (
 	ErrGetSourceStore      = errors.Normalize("failed to get the source store", errors.RFCCodeText("PD:common:ErrGetSourceStore"))
 	ErrGetTargetStore      = errors.Normalize("failed to get the target store", errors.RFCCodeText("PD:common:ErrGetTargetStore"))
 	ErrIncorrectSystemTime = errors.Normalize("incorrect system time", errors.RFCCodeText("PD:common:ErrIncorrectSystemTime"))
+	ErrInvalidArgument     = errors.Normalize("invalid argument for %s: %v", errors.RFCCodeText("PD:common:ErrInvalidArgument"))
 )
 
 // tso errors
@@ -548,3 +549,13 @@ var (
 	ErrNotFoundSchedulingPrimary = errors.Normalize("cannot find scheduling primary", errors.RFCCodeText("PD:mcs:ErrNotFoundSchedulingPrimary"))
 	ErrSchedulingServer          = errors.Normalize("scheduling server meets %v", errors.RFCCodeText("PD:mcs:ErrSchedulingServer"))
 )
+
+// GC errors
+var (
+	ErrGCOnInvalidKeyspace            = errors.Normalize("trying to manage GC in keyspace %v where keyspace level GC is not enabled", errors.RFCCodeText("PD:gc:ErrGCOnInvalidKeyspace"))
+	ErrDecreasingGCSafePoint          = errors.Normalize("trying to update GC safe point to a smaller value, current value: %v, given: %v", errors.RFCCodeText("PD:gc:ErrDecreasingGCSafePoint"))
+	ErrGCSafePointExceedsTxnSafePoint = errors.Normalize("trying to update GC safe point to a too large value that exceeds the txn safe point, current value: %v, given: %v, current txn safe point: %v", errors.RFCCodeText("PD:gc:ErrGCSafePointExceedsTxnSafePoint"))
+	ErrDecreasingTxnSafePoint         = errors.Normalize("trying to update txn safe point to a smaller value, current value: %v, given: %v", errors.RFCCodeText("PD:gc:ErrDecreasingTxnSafePoint"))
+	ErrGCBarrierTSBehindTxnSafePoint  = errors.Normalize("trying to set a GC barrier on ts %d which is already behind the txn safe point %d", errors.RFCCodeText("PD:gc:ErrGCBarrierTSBehindTxnSafePoint"))
+	ErrReservedGCBarrierID            = errors.Normalize("trying to set a GC barrier with a barrier ID that is reserved: %v", errors.RFCCodeText("PD:gc:ErrReservedGCBarrierID"))
+)