msh.c 文件参考

#include <rtthread.h>
#include <string.h>
#include <errno.h>
#include "msh.h"
#include "shell.h"
#include <dlmodule.h>

msh.c 的引用(Include)关系图:

浏览该文件的源代码.

宏定义
#define	FINSH_ARG_MAX   8

类型定义
typedef int(*	cmd_function_t) (int argc, char **argv)

函数
	MSH_CMD_EXPORT_ALIAS (msh_help, help, RT-Thread shell help)
int	msh_exec (char *cmd, rt_size_t length)
void	msh_auto_complete (char *prefix)

宏定义说明

FINSH_ARG_MAX

#define FINSH_ARG_MAX   8

在文件 msh.c 第 19 行定义.

类型定义说明

cmd_function_t

typedef int(* cmd_function_t) (int argc, char **argv)

在文件 msh.c 第 33 行定义.

函数说明

MSH_CMD_EXPORT_ALIAS()

MSH_CMD_EXPORT_ALIAS	(	msh_help	,
		help	,
		RT-Thread shell	help )

引用了 shell.

msh_exec()

int msh_exec	(	char *	cmd,
		rt_size_t	length )

在文件 msh.c 第 540 行定义.

{
    int cmd_ret = 0;
 
    /* strim the beginning of command */
    while ((length > 0) && (*cmd  == ' ' || *cmd == '\t'))
    {
        cmd++;
        length--;
    }
 
    if (length == 0)
        return 0;
 
    /* Exec sequence:
     * 1. built-in command
     * 2. module(if enabled)
     */
    if (_msh_exec_cmd(cmd, length, &cmd_ret) == 0)
    {
        if(cmd_ret < 0)
        {
            rt_kprintf("%s: command failed %d.\n", cmd, cmd_ret);
        }
        return cmd_ret;
    }
#ifdef DFS_USING_POSIX
#ifdef DFS_USING_WORKDIR
    if (msh_exec_script(cmd, length) == 0)
    {
        return 0;
    }
#endif
 
#ifdef RT_USING_MODULE
    if (msh_exec_module(cmd, length) == 0)
    {
        return 0;
    }
#endif /* RT_USING_MODULE */
 
#ifdef RT_USING_SMART
    /* exec from msh_exec , debug = 0*/
    /* _msh_exec_lwp return is pid , <= 0 means failed */
    cmd_ret = _msh_exec_lwp(0, cmd, length);
    if (cmd_ret > 0)
    {
        return 0;
    }
#endif /* RT_USING_SMART */
#endif /* DFS_USING_POSIX */
 
    /* truncate the cmd at the first space. */
    {
        char *tcmd;
        tcmd = cmd;
        while (*tcmd != ' ' && *tcmd != '\0')
        {
            tcmd++;
        }
        *tcmd = '\0';
    }
#ifdef RT_USING_SMART
    if (cmd_ret == -EACCES)
    {
        rt_kprintf("%s: Permission denied.\n", cmd);
    }
    else
#endif
    {
        rt_kprintf("%s: command not found.\n", cmd);
    }
    return -1;
}

引用了 msh_exec_module(), msh_exec_script() , 以及 rt_kprintf.

函数调用图:

msh_auto_complete()

void msh_auto_complete

(

char *

prefix

)

在文件 msh.c 第 775 行定义.

{
    int length, min_length;
    const char *name_ptr, *cmd_name;
    struct finsh_syscall *index;
 
    min_length = 0;
    name_ptr = RT_NULL;
 
    if (*prefix == '\0')
    {
        msh_help(0, RT_NULL);
        return;
    }
 
#ifdef DFS_USING_POSIX
    /* check whether a spare in the command */
    {
        char *ptr;
 
        ptr = prefix + rt_strlen(prefix);
        while (ptr != prefix)
        {
            if (*ptr == ' ')
            {
                msh_auto_complete_path(ptr + 1);
                break;
            }
 
            ptr --;
        }
#if defined(RT_USING_MODULE) || defined(RT_USING_SMART)
        /* There is a chance that the user want to run the module directly. So
         * try to complete the file names. If the completed path is not a
         * module, the system won't crash anyway. */
        if (ptr == prefix)
        {
            msh_auto_complete_path(ptr);
        }
#endif /* RT_USING_MODULE */
    }
#endif /* DFS_USING_POSIX */
 
    /* checks in internal command */
    {
        for (index = _syscall_table_begin; index < _syscall_table_end; FINSH_NEXT_SYSCALL(index))
        {
            /* skip finsh shell function */
            cmd_name = (const char *) index->name;
            if (strncmp(prefix, cmd_name, strlen(prefix)) == 0)
            {
                if (min_length == 0)
                {
                    /* set name_ptr */
                    name_ptr = cmd_name;
                    /* set initial length */
                    min_length = strlen(name_ptr);
                }
 
                length = str_common(name_ptr, cmd_name);
                if (length < min_length)
                    min_length = length;
 
                rt_kprintf("%s\n", cmd_name);
            }
        }
    }
 
    /* auto complete string */
    if (name_ptr != NULL)
    {
        rt_strncpy(prefix, name_ptr, min_length);
    }
 
    return ;
}

引用了 _syscall_table_begin, _syscall_table_end, FINSH_NEXT_SYSCALL, finsh_syscall::name, rt_kprintf , 以及 RT_NULL.