Error Code Explanation#
Mooncake TransferEngine#
TransferEngine may generate various types of errors during execution. For most APIs, the return value indicates the error reason. For details, refer to mooncake-transfer-engine/include/error.h.
Group |
Return Value |
Description |
|---|---|---|
Normal |
0 |
Normal execution |
Error Args |
ERR_INVALID_ARGUMENT |
Input parameters are incorrect (and cannot be detailed into other items in this group) |
ERR_TOO_MANY_REQUESTS |
The number of requests passed by the user when calling the |
|
ERR_ADDRESS_NOT_REGISTERED |
The source address and/or target address in the request initiated by the user are not registered (including the situation where it has been registered locally but not uploaded to the metadata server) |
|
ERR_BATCH_BUSY |
Reclaim a |
|
ERR_DEVICE_NOT_FOUND |
No available RDMA device to execute the user’s request |
|
ERR_ADDRESS_OVERLAPPED |
Registering overlapping memory areas multiple times |
|
Handshake |
ERR_DNS |
Local server name is not a valid DNS hostname or IP address, preventing other nodes from handshaking with this node |
ERR_SOCKET |
Errors related to TCP Socket during the handshake process |
|
ERR_MALFORMED_JSON |
Data format error during handshake exchange |
|
ERR_REJECT_HANDSHAKE |
Peer rejects the handshake due to peer’s errors |
|
Other |
ERR_METADATA |
Failed to communicate with metadata server |
ERR_ENDPOINT |
Exceptions during the creation and use of |
|
ERR_NUMA |
The system does not support numa interface |
|
ERR_CLOCK |
The system does not support |
|
ERR_MEMORY |
Out of memory |
Mooncake Store#
Mooncake Store may generate various types of errors during execution. For most APIs, the return value indicates the error reason. For details, refer to mooncake-store/include/types.h.
Group |
Return Value |
Description |
|---|---|---|
Normal |
0 |
Operation successful |
Internal |
INTERNAL_ERROR (-1) |
Internal error occurred |
Buffer Allocation |
BUFFER_OVERFLOW (-10) |
Insufficient buffer space |
Segment Selection |
SHARD_INDEX_OUT_OF_RANGE (-100) |
Shard index is out of bounds |
SEGMENT_NOT_FOUND (-101) |
No available segments found |
|
SEGMENT_ALREADY_EXISTS (-102) |
Segment already exists |
|
Handle Selection |
NO_AVAILABLE_HANDLE (-200) |
Memory allocation failed due to insufficient space. |
Version |
INVALID_VERSION (-300) |
Invalid version |
Key |
INVALID_KEY (-400) |
Invalid key |
Engine |
WRITE_FAIL (-500) |
Write operation failed |
Parameter |
INVALID_PARAMS (-600) |
Invalid parameters |
Engine Operation |
INVALID_WRITE (-700) |
Invalid write operation |
INVALID_READ (-701) |
Invalid read operation |
|
INVALID_REPLICA (-702) |
Invalid replica operation |
|
REPLICA_IS_NOT_READY (-703) |
Replica is not ready |
|
OBJECT_NOT_FOUND (-704) |
Object not found |
|
OBJECT_ALREADY_EXISTS (-705) |
Object already exists |
|
OBJECT_HAS_LEASE (-706) |
Object has lease |
|
Transfer |
TRANSFER_FAIL (-800) |
Transfer operation failed |
RPC |
RPC_FAIL (-900) |
RPC operation failed |
High Availability |
ETCD_OPERATION_ERROR (-1000) |
etcd operation failed |
ETCD_KEY_NOT_EXIST (-1001) |
Key not found in etcd |
|
ETCD_TRANSACTION_FAIL (-1002) |
etcd transaction failed |
|
ETCD_CTX_CANCELLED (-1003) |
etcd context cancelled |
|
UNAVAILABLE_IN_CURRENT_STATUS (-1010) |
Request cannot be done in current status |
|
UNAVAILABLE_IN_CURRENT_MODE (-1011) |
Request cannot be done in current mode |
|
File |
FILE_NOT_FOUND (-1100) |
File not found |
FILE_OPEN_FAIL (-1101) |
Error opening file or writing to an existing file |
|
FILE_READ_FAIL (-1102) |
Error reading file |
|
FILE_WRITE_FAIL (-1103) |
Error writing file |
|
FILE_INVALID_BUFFER (-1104) |
File buffer is wrong |
|
FILE_LOCK_FAIL (-1105) |
File lock operation failed |
|
FILE_INVALID_HANDLE (-1106) |
Invalid file handle |