// File: /workspace/github_c_makefile_star2_O1/nilyang[P]redis-tdd-annotation/src/cluster.c
// Function: getNodeByQuery
clusterNode *getNodeByQuery(redisClient *c, struct redisCommand *cmd, robj **argv, int argc, int *hashslot, int *error_code) {

    // 初始化为 NULL ，
    // 如果输入命令是无参数命令，那么 n 就会继续为 NULL
    clusterNode *n = NULL;

    robj *firstkey = NULL;
    int multiple_keys = 0;
    multiState *ms, _ms;
    multiCmd mc;
    int i, slot = 0, migrating_slot = 0, importing_slot = 0, missing_keys = 0;

    /* Set error code optimistically for the base case. */
    if (error_code) *error_code = REDIS_CLUSTER_REDIR_NONE;

    /* We handle all the cases as if they were EXEC commands, so we have
     * a common code path for everything */
    // 集群可以执行事务，
    // 但必须确保事务中的所有命令都是针对某个相同的键进行的
    // 这个 if 和接下来的 for 进行的就是这一合法性检测
    if (cmd->proc == execCommand) {
        /* If REDIS_MULTI flag is not set EXEC is just going to return an
         * error. */
        if (!(c->flags & REDIS_MULTI)) return myself;
        ms = &c->mstate;
    } else {
        /* In order to have a single codepath create a fake Multi State
         * structure if the client is not in MULTI/EXEC state, this way
         * we have a single codepath below. */
        ms = &_ms;
        _ms.commands = &mc;
        _ms.count = 1;
        mc.argv = argv;
        mc.argc = argc;
        mc.cmd = cmd;
    }

    /* Check that all the keys are in the same hash slot, and obtain this
     * slot and the node associated. */
    for (i = 0; i < ms->count; i++) {
        struct redisCommand *mcmd;
        robj **margv;
        int margc, *keyindex, numkeys, j;

        mcmd = ms->commands[i].cmd;
        margc = ms->commands[i].argc;
        margv = ms->commands[i].argv;

        // 定位命令的键位置
        keyindex = getKeysFromCommand(mcmd,margv,margc,&numkeys);
        // 遍历命令中的所有键
        for (j = 0; j < numkeys; j++) {
            robj *thiskey = margv[keyindex[j]];
            int thisslot = keyHashSlot((char*)thiskey->ptr,
                                       sdslen(thiskey->ptr));

            if (firstkey == NULL) {
                // 这是事务中第一个被处理的键
                // 获取该键的槽和负责处理该槽的节点
                /* This is the first key we see. Check what is the slot
                 * and node. */
                firstkey = thiskey;
                slot = thisslot;
                n = server.cluster->slots[slot];
                redisAssertWithInfo(c,firstkey,n != NULL);
                /* If we are migrating or importing this slot, we need to check
                 * if we have all the keys in the request (the only way we
                 * can safely serve the request, otherwise we return a TRYAGAIN
                 * error). To do so we set the importing/migrating state and
                 * increment a counter for every missing key. */
                if (n == myself &&
                    server.cluster->migrating_slots_to[slot] != NULL)
                {
                    migrating_slot = 1;
                } else if (server.cluster->importing_slots_from[slot] != NULL) {
                    importing_slot = 1;
                }
            } else {
                /* If it is not the first key, make sure it is exactly
                 * the same key as the first we saw. */
                if (!equalStringObjects(firstkey,thiskey)) {
                    if (slot != thisslot) {
                        /* Error: multiple keys from different slots. */
                        getKeysFreeResult(keyindex);
                        if (error_code)
                            *error_code = REDIS_CLUSTER_REDIR_CROSS_SLOT;
                        return NULL;
                    } else {
                        /* Flag this request as one with multiple different
                         * keys. */
                        multiple_keys = 1;
                    }
                }
            }

            /* Migarting / Improrting slot? Count keys we don't have. */
            if ((migrating_slot || importing_slot) &&
                lookupKeyRead(&server.db[0],thiskey) == NULL)
            {
                missing_keys++;
            }
        }
        getKeysFreeResult(keyindex);
    }

    /* No key at all in command? then we can serve the request
     * without redirections or errors. */
    if (n == NULL) return myself;

    /* Return the hashslot by reference. */
    if (hashslot) *hashslot = slot;

    /* This request is about a slot we are migrating into another instance?
     * Then if we have all the keys. */

    /* If we don't have all the keys and we are migrating the slot, send
     * an ASK redirection. */
    if (migrating_slot && missing_keys) {
        if (error_code) *error_code = REDIS_CLUSTER_REDIR_ASK;
        return server.cluster->migrating_slots_to[slot];
    }

    /* If we are receiving the slot, and the client correctly flagged the
     * request as "ASKING", we can serve the request. However if the request
     * involves multiple keys and we don't have them all, the only option is
     * to send a TRYAGAIN error. */
    if (importing_slot &&
        (c->flags & REDIS_ASKING || cmd->flags & REDIS_CMD_ASKING))
    {
        if (multiple_keys && missing_keys) {
            if (error_code) *error_code = REDIS_CLUSTER_REDIR_UNSTABLE;
            return NULL;
        } else {
            return myself;
        }
    }

    /* Handle the read-only client case reading from a slave: if this
     * node is a slave and the request is about an hash slot our master
     * is serving, we can reply without redirection. */
    if (c->flags & REDIS_READONLY &&
        cmd->flags & REDIS_CMD_READONLY &&
        nodeIsSlave(myself) &&
        myself->slaveof == n)
    {
        return myself;
    }

    /* Base case: just return the right node. However if this node is not
     * myself, set error_code to MOVED since we need to issue a rediretion. */
    if (n != myself && error_code) *error_code = REDIS_CLUSTER_REDIR_MOVED;

    // 返回负责处理槽 slot 的节点 n
    return n;
}

// Assembly:
pushq %rbp
pushq %r15
pushq %r14
pushq %r13
pushq %r12
pushq %rbx
subq $0x98, %rsp
testq %r9, %r9
je 0x562fc
movl $0x0, (%r9)
movq 0x8(%rsi), %rax
cmpq 0x6fbe9(%rip), %rax     # 0xc5ef0
je 0x5632d
leaq 0x68(%rsp), %rax
leaq 0x80(%rsp), %r10
movq %rax, (%r10)
movl $0x1, 0x8(%r10)
movq %rdx, (%rax)
movl %ecx, 0x8(%rax)
movq %rsi, 0x10(%rax)
jmp 0x56341
testb $0x8, 0x90(%rdi)
je 0x565f8
leaq 0x100(%rdi), %r10
cmpl $0x0, 0x8(%r10)
jle 0x5654f
movq %r8, 0x40(%rsp)
movq %rdi, 0x28(%rsp)
movq %rsi, 0x48(%rsp)
movq %r9, 0x30(%rsp)
xorl %ecx, %ecx
movq $0x0, 0x38(%rsp)
xorl %r14d, %r14d
movl $0x0, 0x14(%rsp)
movl $0x0, 0x18(%rsp)
movl $0x0, 0xc(%rsp)
movl $0x0, 0x10(%rsp)
xorl %ebp, %ebp
movq %r10, 0x50(%rsp)
movq (%r10), %rax
movq %rcx, 0x58(%rsp)
leaq (%rcx,%rcx,2), %rcx
movq 0x10(%rax,%rcx,8), %rdi
movl 0x8(%rax,%rcx,8), %edx
movq (%rax,%rcx,8), %rsi
movq %rsi, 0x60(%rsp)
leaq 0x1c(%rsp), %rcx
callq 0x32d32
movq %rax, 0x20(%rsp)
cmpl $0x0, 0x1c(%rsp)
setg %r13b
jle 0x564df
xorl %r15d, %r15d
movq %rbp, %rbx
movq 0x20(%rsp), %rax
movslq (%rax,%r15,4), %rax
movq 0x60(%rsp), %rcx
movq (%rcx,%rax,8), %r12
movq 0x8(%r12), %rdi
movl -0x8(%rdi), %esi
callq 0x511c2
movl %eax, %ebp
testq %r14, %r14
je 0x56410
movq %r14, %rdi
movq %r12, %rsi
callq 0x30c35
testl %eax, %eax
je 0x5645a
movl %ebx, %ebp
jmp 0x5647e
leaq 0x73b91(%rip), %rax     # 0xc9fa8
movq 0x7d0(%rax), %rax
movl %ebp, %ecx
movq 0x40028(%rax,%rcx,8), %rdx
testq %rdx, %rdx
je 0x56611
movq %rdx, 0x38(%rsp)
cmpq 0x881eb(%rip), %rdx     # 0xde628
je 0x5646b
cmpq $0x0, 0x20028(%rax,%rcx,8)
movl 0xc(%rsp), %eax
movl $0x1, %ecx
cmovnel %ecx, %eax
movl %eax, 0xc(%rsp)
jmp 0x5647b
cmpl %ebp, %ebx
movq %rbx, %rbp
jne 0x564c1
movl $0x1, 0x14(%rsp)
jmp 0x5647e
cmpq $0x0, 0x28(%rax,%rcx,8)
je 0x5643f
movl $0x1, 0x10(%rsp)
movq %r12, %r14
movb $0x1, %bl
movl 0x10(%rsp), %eax
orl 0xc(%rsp), %eax
je 0x564a6
leaq 0x73b17(%rip), %rax     # 0xc9fa8
movq 0x10(%rax), %rdi
movq %r12, %rsi
callq 0x3136a
cmpq $0x1, %rax
adcl $0x0, 0x18(%rsp)
testb %bl, %bl
je 0x564e9
incq %r15
movslq 0x1c(%rsp), %rax
cmpq %rax, %r15
setl %r13b
jl 0x563d4
jmp 0x564df
movq 0x20(%rsp), %rdi
callq 0x32d41
movq 0x30(%rsp), %rax
testq %rax, %rax
je 0x564db
movl $0x1, (%rax)
xorl %ebx, %ebx
jmp 0x564a6
movq 0x20(%rsp), %rdi
callq 0x32d41
testb $0x1, %r13b
jne 0x565f4
movq 0x58(%rsp), %rcx
incq %rcx
movq 0x50(%rsp), %r10
movslq 0x8(%r10), %rax
cmpq %rax, %rcx
jl 0x56395
cmpl $0x0, 0x10(%rsp)
setne %dl
cmpl $0x0, 0x18(%rsp)
setne %sil
andb %sil, %dl
cmpl $0x0, 0xc(%rsp)
sete %cl
cmpl $0x0, 0x14(%rsp)
setne %al
andb %sil, %al
movq 0x30(%rsp), %r9
movq 0x48(%rsp), %rsi
movq 0x28(%rsp), %rdi
movq 0x40(%rsp), %r8
movq 0x38(%rsp), %r10
jmp 0x5655a
movb $0x1, %cl
xorl %ebp, %ebp
xorl %edx, %edx
xorl %eax, %eax
xorl %r10d, %r10d
testq %r10, %r10
je 0x565f8
testq %r8, %r8
je 0x5656b
movl %ebp, (%r8)
testb %dl, %dl
je 0x56592
testq %r9, %r9
je 0x5657b
movl $0x3, (%r9)
leaq 0x73a26(%rip), %rax     # 0xc9fa8
movq 0x7d0(%rax), %rax
movl %ebp, %ecx
movq 0x28(%rax,%rcx,8), %rax
jmp 0x565ff
testb %cl, %cl
je 0x565d5
testb $0x2, 0x92(%rdi)
je 0x565bb
testb $0x2, 0x20(%rsi)
je 0x565bb
movq 0x8807c(%rip), %rax     # 0xde628
testb $0x2, 0x30(%rax)
je 0x565bb
cmpq %r10, 0x850(%rax)
je 0x565ff
testq %r9, %r9
je 0x565d0
cmpq 0x88061(%rip), %r10     # 0xde628
je 0x565d0
movl $0x4, (%r9)
movq %r10, %rax
jmp 0x565ff
testb $0x2, 0x91(%rdi)
jne 0x565e4
testb $0x10, 0x21(%rsi)
je 0x56596
testb %al, %al
je 0x565f8
testq %r9, %r9
je 0x565f4
movl $0x2, (%r9)
xorl %eax, %eax
jmp 0x565ff
movq 0x88029(%rip), %rax     # 0xde628
addq $0x98, %rsp
popq %rbx
popq %r12
popq %r13
popq %r14
popq %r15
popq %rbp
retq
leaq 0x42996(%rip), %rdx     # 0x98fae
leaq 0x4565e(%rip), %rcx     # 0x9bc7d
movq 0x28(%rsp), %rdi
movq %r12, %rsi
movl $0x1627, %r8d           # imm = 0x1627
callq 0x4d872
movl $0x1, %edi
callq 0x1f3b0