shmsg.c 文件参考

浏览源代码.

枚举
enum	{ STAT_NORMAL_KEY , STAT_ESC_KEY , STAT_MULTI_KEY }

函数
CHAR *	ShellGetInputBuf (ShellCB *shellCB)
STATIC VOID	ShellSaveHistoryCmd (const CHAR *string, ShellCB *shellCB)
	保存命令历史记录,这个函数写的不太好 更多...
STATIC VOID	ShellNotify (ShellCB *shellCB)
	发送解析事件 更多...
STATIC INT32	ShellCmdLineCheckUDRL (const CHAR ch, ShellCB *shellCB)
LITE_OS_SEC_TEXT_MINOR VOID	ShellCmdLineParse (CHAR c, pf_OUTPUT outputFunc, ShellCB *shellCB)
	对命令行内容解析 更多...
LITE_OS_SEC_TEXT_MINOR UINT32	ShellMsgTypeGet (CmdParsed *cmdParsed, const CHAR *cmdType)
	获取shell消息类型 更多...
STATIC UINT32	ShellMsgNameGetAndExec (CmdParsed *cmdParsed, const CHAR *output, UINT32 len)
	获取命令名称和参数,并执行 更多...
LITE_OS_SEC_TEXT_MINOR UINT32	ShellMsgParse (const VOID *msg)
	命令内容解析 更多...
LITE_OS_SEC_TEXT_MINOR UINT32	ShellEntry (UINTPTR param)
	读取命令行内容 更多...
STATIC VOID	ShellCmdProcess (ShellCB *shellCB)
LITE_OS_SEC_TEXT_MINOR UINT32	ShellTask (UINTPTR param1, UINTPTR param2, UINTPTR param3, UINTPTR param4)
	shell 任务,处理解析,执行命令 更多...
LITE_OS_SEC_TEXT_MINOR UINT32	ShellTaskInit (ShellCB *shellCB)
	给控制台注册一个shell客户端任务 更多...
LITE_OS_SEC_TEXT_MINOR UINT32	ShellEntryInit (ShellCB *shellCB)
	进入shell客户端任务初始化,这个任务负责编辑命令,处理命令产生的过程,例如如何处理方向键,退格键,回车键等 更多...

枚举类型说明

anonymous enum

anonymous enum

枚举值
STAT_NORMAL_KEY	普通的按键
STAT_ESC_KEY
STAT_MULTI_KEY

在文件 shmsg.c 第 109 行定义.

     {
    STAT_NORMAL_KEY,    ///< 普通的按键
    STAT_ESC_KEY,   //<ESC>键在VT控制规范中时控制的起始键
    STAT_MULTI_KEY  //组合键
};

函数说明

ShellCmdLineCheckUDRL()

STATIC INT32 ShellCmdLineCheckUDRL	(	const CHAR	ch,
		ShellCB *	shellCB
	)

在文件 shmsg.c 第 131 行定义.

{
    INT32 ret = LOS_OK;
    if (ch == 0x1b) { /* 0x1b: ESC *///按下<ESC>键(逃逸键)
        shellCB->shellKeyType = STAT_ESC_KEY;//代表控制开始
        return ret;
    } else if (ch == 0x5b) { /* 0x5b: first Key combination */ //为[键 ,遵循 vt100 规则
        if (shellCB->shellKeyType == STAT_ESC_KEY) {
            shellCB->shellKeyType = STAT_MULTI_KEY;
            return ret;
        }
    } else if (ch == 0x41) { /* up */   //上方向键
        if (shellCB->shellKeyType == STAT_MULTI_KEY) {
            OsShellHistoryShow(CMD_KEY_UP, shellCB);
            shellCB->shellKeyType = STAT_NORMAL_KEY;
            return ret;
        }
    } else if (ch == 0x42) { /* down *///下方向键
        if (shellCB->shellKeyType == STAT_MULTI_KEY) {
            shellCB->shellKeyType = STAT_NORMAL_KEY;
            OsShellHistoryShow(CMD_KEY_DOWN, shellCB);
            return ret;
        }
    } else if (ch == 0x43) { /* right *///右方向键
        if (shellCB->shellKeyType == STAT_MULTI_KEY) {
            shellCB->shellKeyType = STAT_NORMAL_KEY;
            return ret;
        }
    } else if (ch == 0x44) { /* left *///左方向键
        if (shellCB->shellKeyType == STAT_MULTI_KEY) {
            shellCB->shellKeyType = STAT_NORMAL_KEY;
            return ret;
        }
    }
    return LOS_NOK;
}

函数调用图:

这是这个函数的调用关系图:

ShellCmdLineParse()

LITE_OS_SEC_TEXT_MINOR VOID ShellCmdLineParse	(	CHAR	c,
		pf_OUTPUT	outputFunc,
		ShellCB *	shellCB
	)

对命令行内容解析

在文件 shmsg.c 第 168 行定义.

{
    const CHAR ch = c;
    INT32 ret;
    //不是回车键和字符串结束,且偏移量为0
    if ((shellCB->shellBufOffset == 0) && (ch != '\n') && (ch != '\0')) {
        (VOID)memset_s(shellCB->shellBuf, SHOW_MAX_LEN, 0, SHOW_MAX_LEN);//重置buf
    }
    //遇到回车或换行
    if ((ch == '\r') || (ch == '\n')) {
        if (shellCB->shellBufOffset < (SHOW_MAX_LEN - 1)) {
            shellCB->shellBuf[shellCB->shellBufOffset] = '\0';//字符串结束
        }
        shellCB->shellBufOffset = 0;
        (VOID)pthread_mutex_lock(&shellCB->keyMutex);
        OsShellCmdPush(shellCB->shellBuf, shellCB->cmdKeyLink);//解析回车或换行
        (VOID)pthread_mutex_unlock(&shellCB->keyMutex);
        ShellNotify(shellCB);//通知任务解析shell命令
        return;
    } else if ((ch == '\b') || (ch == 0x7F)) { /* backspace or delete(0x7F) */ //遇到删除键
        if ((shellCB->shellBufOffset > 0) && (shellCB->shellBufOffset < (SHOW_MAX_LEN - 1))) {
            shellCB->shellBuf[shellCB->shellBufOffset - 1] = '\0';//填充`\0`
            shellCB->shellBufOffset--;//buf减少
            outputFunc("\b \b");//回调入参函数
        }
        return;
    } else if (ch == 0x09) { /* 0x09: tab *///遇到tab键
        if ((shellCB->shellBufOffset > 0) && (shellCB->shellBufOffset < (SHOW_MAX_LEN - 1))) {
            ret = OsTabCompletion(shellCB->shellBuf, &shellCB->shellBufOffset);//解析tab键
            if (ret > 1) {
                outputFunc("OHOS # %s", shellCB->shellBuf);//回调入参函数
            }
        }
        return;
    }
    /* parse the up/down/right/left key */
    ret = ShellCmdLineCheckUDRL(ch, shellCB);//解析上下左右键
    if (ret == LOS_OK) {
        return;
    }
    
    if ((ch != '\n') && (ch != '\0')) {//普通的字符的处理
        if (shellCB->shellBufOffset < (SHOW_MAX_LEN - 1)) {//buf范围
            shellCB->shellBuf[shellCB->shellBufOffset] = ch;//直接加入
        } else {
            shellCB->shellBuf[SHOW_MAX_LEN - 1] = '\0';//加入字符串结束符
        }
        shellCB->shellBufOffset++;//偏移量增加
        outputFunc("%c", ch);//向终端输出字符
    }
 
    shellCB->shellKeyType = STAT_NORMAL_KEY;//普通字符
}

函数调用图:

ShellCmdProcess()

STATIC VOID ShellCmdProcess

(

ShellCB *

shellCB

)

在文件 shmsg.c 第 378 行定义.

{
    CHAR *buf = NULL;
    while (1) {
        buf = ShellGetInputBuf(shellCB);//获取命令buf
        if (buf == NULL) {
            break;
        }
        (VOID)ShellMsgParse(buf);//解析buf
        ShellSaveHistoryCmd(buf, shellCB);//保存到历史记录中
        shellCB->cmdMaskKeyLink = shellCB->cmdHistoryKeyLink;
    }
}

函数调用图:

这是这个函数的调用关系图:

ShellEntry()

LITE_OS_SEC_TEXT_MINOR UINT32 ShellEntry

(

UINTPTR

param

)

读取命令行内容

在文件 shmsg.c 第 345 行定义.

{
    CHAR ch;
    INT32 n = 0;
    ShellCB *shellCB = (ShellCB *)param;
 
    CONSOLE_CB *consoleCB = OsGetConsoleByID((INT32)shellCB->consoleID);//获取绑定的控制台,目的是从控制台读数据
    if (consoleCB == NULL) {
        PRINT_ERR("Shell task init error!\n");
        return 1;
    }
 
    (VOID)memset_s(shellCB->shellBuf, SHOW_MAX_LEN, 0, SHOW_MAX_LEN);//重置shell命令buf
 
    while (1) {
#ifdef LOSCFG_PLATFORM_CONSOLE
        if (!IsConsoleOccupied(consoleCB)) {//控制台是否被占用
#endif
            /* is console ready for shell ? */
            n = read(consoleCB->fd, &ch, 1);//系统调用,从控制台读取一个字符内容,字符一个个处理
            if (n == 1) {//如果能读到一个字符
                ShellCmdLineParse(ch, (pf_OUTPUT)dprintf, shellCB);
            }
            if (is_nonblock(consoleCB)) {//在非阻塞模式下暂停 50ms
                LOS_Msleep(50); /* 50: 50MS for sleep */
            }
#ifdef LOSCFG_PLATFORM_CONSOLE
        }
#endif
    }
}

函数调用图:

ShellEntryInit()

LITE_OS_SEC_TEXT_MINOR UINT32 ShellEntryInit

(

ShellCB *

shellCB

)

进入shell客户端任务初始化,这个任务负责编辑命令,处理命令产生的过程,例如如何处理方向键,退格键,回车键等

在文件 shmsg.c 第 450 行定义.

{
    UINT32 ret;
    CHAR *name = NULL;
    TSK_INIT_PARAM_S initParam = {0};
 
    if (shellCB->consoleID == CONSOLE_SERIAL) {//带串口功能的控制台
        name = SERIAL_ENTRY_TASK_NAME;
    } else if (shellCB->consoleID == CONSOLE_TELNET) {//带远程登录功能的控制台
        name = TELNET_ENTRY_TASK_NAME;
    } else {
        return LOS_NOK;
    }
 
    initParam.pfnTaskEntry = (TSK_ENTRY_FUNC)ShellEntry;//任务入口函数
    initParam.usTaskPrio   = 9; /* 9:shell task priority */
    initParam.auwArgs[0]   = (UINTPTR)shellCB;
    initParam.uwStackSize  = 0x1000;
    initParam.pcName       = name;  //任务名称
    initParam.uwResved     = LOS_TASK_STATUS_DETACHED;
 
    ret = LOS_TaskCreate(&shellCB->shellEntryHandle, &initParam);//创建shell任务
#ifdef LOSCFG_PLATFORM_CONSOLE
    (VOID)ConsoleTaskReg((INT32)shellCB->consoleID, shellCB->shellEntryHandle);//将shell注册到控制台
#endif
 
    return ret;
}

函数调用图:

这是这个函数的调用关系图:

ShellGetInputBuf()

CHAR * ShellGetInputBuf

(

ShellCB *

shellCB

)

在文件 shmsg.c 第 50 行定义.

{
    CmdKeyLink *cmdkey = shellCB->cmdKeyLink;//待处理的shell命令链表
    CmdKeyLink *cmdNode = NULL;
 
    (VOID)pthread_mutex_lock(&shellCB->keyMutex);
    if ((cmdkey == NULL) || LOS_ListEmpty(&cmdkey->list)) {//链表为空的处理
        (VOID)pthread_mutex_unlock(&shellCB->keyMutex);
        return NULL;
    }
 
    cmdNode = LOS_DL_LIST_ENTRY(cmdkey->list.pstNext, CmdKeyLink, list);//获取当前命令项
    LOS_ListDelete(&(cmdNode->list)); /* 'cmdNode' freed in history save process *///将自己摘出去,但在历史记录中还存在
    (VOID)pthread_mutex_unlock(&shellCB->keyMutex);
 
    return cmdNode->cmdString;//返回命令内容
}

函数调用图:

这是这个函数的调用关系图:

ShellMsgNameGetAndExec()

STATIC UINT32 ShellMsgNameGetAndExec	(	CmdParsed *	cmdParsed,
		const CHAR *	output,
		UINT32	len
	)

获取命令名称和参数,并执行

在文件 shmsg.c 第 247 行定义.

{
    UINT32 loop;
    UINT32 ret;
    const CHAR *tmpStr = NULL;
    BOOL quotes = FALSE;
    CHAR *msgName = (CHAR *)LOS_MemAlloc(m_aucSysMem0, len + 1);
    if (msgName == NULL) {
        PRINTK("malloc failure in %s[%d]\n", __FUNCTION__, __LINE__);
        return OS_INVALID;
    }
    /* Scan the 'output' string for command */
    /* Notice: Command string must not have any special name */
    for (tmpStr = output, loop = 0; (*tmpStr != '\0') && (loop < len);) {
        /* If reach a double quotes, switch the quotes matching status */
        if (*tmpStr == '\"') {
            SWITCH_QUOTES_STATUS(quotes);
            /* Ignore the double quote CHARactor itself */
            tmpStr++;
            continue;
        }
        /* If detected a space which the quotes matching status is false */
        /* which said has detected the first space for seperator, finish this scan operation */
        if ((*tmpStr == ' ') && (QUOTES_STATUS_CLOSE(quotes))) {
            break;
        }
        msgName[loop] = *tmpStr++;
        loop++;
    }
    msgName[loop] = '\0';
    /* Scan the command list to check whether the command can be found */
    ret = ShellMsgTypeGet(cmdParsed, msgName);
    PRINTK("\n");
    if (ret != LOS_OK) {
        PRINTK("%s:command not found", msgName);
    } else {
        (VOID)OsCmdExec(cmdParsed, (CHAR *)output);//真正的执行命令 output为输出设备
    }
    (VOID)LOS_MemFree(m_aucSysMem0, msgName);
    return ret;
}

函数调用图:

这是这个函数的调用关系图:

ShellMsgParse()

LITE_OS_SEC_TEXT_MINOR UINT32 ShellMsgParse

(

const VOID *

msg

)

命令内容解析

在文件 shmsg.c 第 289 行定义.

{
    CHAR *output = NULL;
    UINT32 len, cmdLen, newLen;
    CmdParsed cmdParsed;
    UINT32 ret = OS_INVALID;
    CHAR *buf = (CHAR *)msg;
    CHAR *newMsg = NULL;
    CHAR *cmd = "exec";
 
    if (msg == NULL) {
        goto END;
    }
 
    len = strlen(msg);
    /* 2: strlen("./") */
    if ((len > 2) && (buf[0] == '.') && (buf[1] == '/')) {
        cmdLen = strlen(cmd);
        newLen = len + 1 + cmdLen + 1;
        newMsg = (CHAR *)LOS_MemAlloc(m_aucSysMem0, newLen);
        if (newMsg == NULL) {
            PRINTK("malloc failure in %s[%d]\n", __FUNCTION__, __LINE__);
            goto END;
        }
        (VOID)memcpy_s(newMsg, newLen, cmd, cmdLen);
        newMsg[cmdLen] = ' ';
        (VOID)memcpy_s(newMsg + cmdLen + 1, newLen - cmdLen - 1,  (CHAR *)msg + 1, len);
        msg = newMsg;
        len = newLen - 1;
    }
    output = (CHAR *)LOS_MemAlloc(m_aucSysMem0, len + 1);
    if (output == NULL) {
        PRINTK("malloc failure in %s[%d]\n", __FUNCTION__, __LINE__);
        goto END;
    }//对字符串缓冲区,调用函数“OsCmdKeyShift”来挤压和清除无用或过多的空间
    /* Call function 'OsCmdKeyShift' to squeeze and clear useless or overmuch space if string buffer */
    ret = OsCmdKeyShift((CHAR *)msg, output, len + 1);
    if ((ret != LOS_OK) || (strlen(output) == 0)) {
        ret = OS_INVALID;
        goto END_FREE_OUTPUT;
    }
 
    (VOID)memset_s(&cmdParsed, sizeof(CmdParsed), 0, sizeof(CmdParsed));
 
    ret = ShellMsgNameGetAndExec(&cmdParsed, output, len);////获取命令名称和参数,并执行
 
END_FREE_OUTPUT:
    (VOID)LOS_MemFree(m_aucSysMem0, output);
END:
    if (newMsg != NULL) {
        (VOID)LOS_MemFree(m_aucSysMem0, newMsg);
    }
    return ret;
}

函数调用图:

这是这个函数的调用关系图:

ShellMsgTypeGet()

LITE_OS_SEC_TEXT_MINOR UINT32 ShellMsgTypeGet	(	CmdParsed *	cmdParsed,
		const CHAR *	cmdType
	)

获取shell消息类型

在文件 shmsg.c 第 222 行定义.

{
    CmdItemNode *curCmdItem = (CmdItemNode *)NULL;
    UINT32 len;
    UINT32 minLen;
    CmdModInfo *cmdInfo = OsCmdInfoGet();//获取全局变量
 
    if ((cmdParsed == NULL) || (cmdType == NULL)) {
        return OS_INVALID;
    }
 
    len = strlen(cmdType);
    LOS_DL_LIST_FOR_EACH_ENTRY(curCmdItem, &(cmdInfo->cmdList.list), CmdItemNode, list) {
        if ((len == strlen(curCmdItem->cmd->cmdKey)) &&
            (strncmp((CHAR *)(curCmdItem->cmd->cmdKey), cmdType, len) == 0)) {
            minLen = (len < CMD_KEY_LEN) ? len : CMD_KEY_LEN;
            (VOID)memcpy_s((CHAR *)(cmdParsed->cmdKeyword), CMD_KEY_LEN, cmdType, minLen);
            cmdParsed->cmdType = curCmdItem->cmd->cmdType;
            return LOS_OK;
        }
    }
 
    return OS_INVALID;
}

函数调用图:

这是这个函数的调用关系图:

ShellNotify()

STATIC VOID ShellNotify

(

ShellCB *

shellCB

)

发送解析事件

在文件 shmsg.c 第 104 行定义.

{
    (VOID)LOS_EventWrite(&shellCB->shellEvent, SHELL_CMD_PARSE_EVENT);
}

函数调用图:

ShellSaveHistoryCmd()

STATIC VOID ShellSaveHistoryCmd	(	const CHAR *	string,
		ShellCB *	shellCB
	)

保存命令历史记录,这个函数写的不太好

在文件 shmsg.c 第 68 行定义.

{
    CmdKeyLink *cmdHistory = shellCB->cmdHistoryKeyLink;//获取历史记录的源头
    CmdKeyLink *cmdkey = LOS_DL_LIST_ENTRY(string, CmdKeyLink, cmdString);// @note_good ,获取CmdKeyLink,这里挺秒的,通过局部字符串找到整体
    CmdKeyLink *cmdNxt = NULL;
 
    if ((string == NULL) || (strlen(string) == 0)) {
        return;
    }
 
    (VOID)pthread_mutex_lock(&shellCB->historyMutex);//对链表的操作都要拿互斥锁
    if (cmdHistory->count != 0) { //有历史记录的情况
        cmdNxt = LOS_DL_LIST_ENTRY(cmdHistory->list.pstPrev, CmdKeyLink, list);//获取最老的历史记录
        if (strcmp(string, cmdNxt->cmdString) == 0) {//比较是否一样,这个地方感觉很怪,只比较一个吗?
            (VOID)LOS_MemFree(m_aucSysMem0, (VOID *)cmdkey);
            (VOID)pthread_mutex_unlock(&shellCB->historyMutex);
            return;
        }
    }
 
    if (cmdHistory->count == CMD_HISTORY_LEN) {//历史记录已满,一删一添导致历史记录永远是满的,所以一旦跑进来了
        cmdNxt = LOS_DL_LIST_ENTRY(cmdHistory->list.pstNext, CmdKeyLink, list);//后续 ShellSaveHistoryCmd都会跑进来执行
        LOS_ListDelete(&(cmdNxt->list));//先删除一个最早插入的
        LOS_ListTailInsert(&(cmdHistory->list), &(cmdkey->list));//再从尾部挂入新的节点,变成最新的记录
        (VOID)LOS_MemFree(m_aucSysMem0, (VOID *)cmdNxt);//释放已经删除的节点, @note_thinking     , 建议和上一句换个位置,保证逻辑上的完整性
        (VOID)pthread_mutex_unlock(&shellCB->historyMutex);//释放互斥锁
        return;
    }
    //未满的情况下执行到此处
    LOS_ListTailInsert(&(cmdHistory->list), &(cmdkey->list));//从尾部插入
    cmdHistory->count++;//历史记录增加
 
    (VOID)pthread_mutex_unlock(&shellCB->historyMutex);//释放互斥锁
    return;
}

函数调用图:

这是这个函数的调用关系图:

ShellTask()

LITE_OS_SEC_TEXT_MINOR UINT32 ShellTask	(	UINTPTR	param1,
		UINTPTR	param2,
		UINTPTR	param3,
		UINTPTR	param4
	)

shell 任务,处理解析,执行命令

在文件 shmsg.c 第 392 行定义.

{
    UINT32 ret;
    ShellCB *shellCB = (ShellCB *)param1;
    (VOID)param2;
    (VOID)param3;
    (VOID)param4;
 
    while (1) {
        PRINTK("\nOHOS # ");//在没有事件的时候,会一直停留在此, 读取shell 输入事件 例如: cat weharmony.net 命令
        ret = LOS_EventRead(&shellCB->shellEvent,
                            0xFFF, LOS_WAITMODE_OR | LOS_WAITMODE_CLR, LOS_WAIT_FOREVER);
        if (ret == SHELL_CMD_PARSE_EVENT) {//获得解析命令事件
            ShellCmdProcess(shellCB);//处理命令 
        } else if (ret == CONSOLE_SHELL_KEY_EVENT) {//退出shell事件
            break;
        }
    }
    OsShellKeyDeInit((CmdKeyLink *)shellCB->cmdKeyLink);//
    OsShellKeyDeInit((CmdKeyLink *)shellCB->cmdHistoryKeyLink);
    (VOID)LOS_EventDestroy(&shellCB->shellEvent);//注销事件
    (VOID)LOS_MemFree((VOID *)m_aucSysMem0, shellCB);//释放shell控制块
    return 0;
}

函数调用图:

ShellTaskInit()

LITE_OS_SEC_TEXT_MINOR UINT32 ShellTaskInit

(

ShellCB *

shellCB

)

给控制台注册一个shell客户端任务

在文件 shmsg.c 第 425 行定义.

{
    CHAR *name = NULL;
    TSK_INIT_PARAM_S initParam = {0};
    //输入Shell命令的两种方式
    if (shellCB->consoleID == CONSOLE_SERIAL) { //通过串口工具
        name = SERIAL_SHELL_TASK_NAME;
    } else if (shellCB->consoleID == CONSOLE_TELNET) {//通过远程工具
        name = TELNET_SHELL_TASK_NAME;
    } else {
        return LOS_NOK;
    }
 
    initParam.pfnTaskEntry = (TSK_ENTRY_FUNC)ShellTask;//任务入口函数,主要是解析shell命令
    initParam.usTaskPrio   = 9; /* 9:shell task priority */
    initParam.auwArgs[0]   = (UINTPTR)shellCB;
    initParam.uwStackSize  = 0x3000;
    initParam.pcName       = name;
    initParam.uwResved     = LOS_TASK_STATUS_DETACHED;
 
    (VOID)LOS_EventInit(&shellCB->shellEvent);//初始化事件,以事件方式通知任务解析命令
 
    return LOS_TaskCreate(&shellCB->shellTaskHandle, &initParam);//创建任务
}

函数调用图:

这是这个函数的调用关系图: