suricata smtp协议解析源码注释三

本篇文章开始对主要函数的代码做注释，有的部分语句尚未理解，没有做注释。    

一。行数据处理函数SMTPGetLine

SMTPParse-> SMTPGetLine

这个函数就是在收到的数据中查找\r\n，分成行，（SMTPState*）state->current_line指针指向每行的第一个字符，每行数据不包含\r\n，state->current_line_len保存解析到的行数据长度，不包含\r\n，SMTPProcessRequest和SMTPProcessReply处理时就处理这两个变量，如果找不到\r\n，说明数据不够，进行缓存，如此反复。

二。客户端到服务器请求的入口函数SMTPProcessRequest

SMTPParse->SMTPProcessRequest

static int SMTPProcessRequest(SMTPState *state, Flow *f,
                              AppLayerParserState *pstate)
{
    SCEnter();
    //state->curr_tx始终指向当前的tmtp事务结构体指针
    SMTPTransaction *tx = state->curr_tx;

    //第一次解析则生成事务结构体SMTPTransaction
    if (state->curr_tx == NULL || (state->curr_tx->done && !NoNewTx(state))) {
        tx = SMTPTransactionCreate();
        if (tx == NULL)
            return -1;
        state->curr_tx = tx;
        TAILQ_INSERT_TAIL(&state->tx_list, tx, next);
        tx->tx_id = state->tx_cnt++; //事务ID自增
    }

    //这个标志说明是否看到了服务器返回第一个响应，这个响应指的是连接服务器后返回的欢迎信息，
    //在客户端收到服务器响应时解析并设置这标志，如果没有设置则认为服务器没有欢迎信息，
    //于是设置解析事件标志
    if (!(state->parser_state & SMTP_PARSER_STATE_FIRST_REPLY_SEEN)) {
        SMTPSetEvent(state, SMTP_DECODER_EVENT_NO_SERVER_WELCOME_MESSAGE);
    }

    //如果不是data命令模式，也就是还没遇到data命令，这时就去查找普通交互命令，
    //这段代码比较简单，不用多说，就是字符串匹配smtp的命令，只需要注意匹配命令后
    //的处理，比如设置state->current_command为当前解析到的命令标识，
    //设置解析状态state->parser_state
    /* there are 2 commands that can push it into this COMMAND_DATA mode -
     * STARTTLS and DATA */
    if (!(state->parser_state & SMTP_PARSER_STATE_COMMAND_DATA_MODE)) {
        int r = 0;

        if (state->current_line_len >= 8 &&
            SCMemcmpLowercase("starttls", state->current_line, 8) == 0) {
            state->current_command = SMTP_COMMAND_STARTTLS;
        } else if (state->current_line_len >= 4 &&
                   SCMemcmpLowercase("data", state->current_line, 4) == 0) {
            //这个分支匹配到data命令后的处理，设置当前命令和解析状态，设置当前命令在
            //客户端响应数据解析时会使用
            state->current_command = SMTP_COMMAND_DATA;
            //如果配置了允许mime解码才进行mime解码
            if (smtp_config.decode_mime) {
                if (tx->mime_state) {
                    //这几行代码不是太明白，为啥重新分配结构体
                    /* We have 2 chained mails and did not detect the end
                     * of first one. So we start a new transaction. */
                    tx->mime_state->state_flag = PARSE_ERROR;
                    SMTPSetEvent(state, SMTP_DECODER_EVENT_UNPARSABLE_CONTENT);
                    tx = SMTPTransactionCreate();
                    if (tx == NULL)
                        return -1;
                    state