ROS脚本语法使用教程.pdf

手册：脚本编写 1 手册:脚本编写 适用RouterOS版本: v3, v4及以上 脚本语言手册 这个手册对RouterOS 内置的强大脚本语言进行介绍。 脚本主机提供了一种方法来自动执行一些路由器维护任务，通过执行与某些事件相关的用户定义的脚本。 脚本可以存放在脚本库中，也可以直接写入控制台。触发脚本执行的事件包括，但是并不局限系统计划System Scheduler、traffic monitor工具 netwatch工具产生的事件。 行结构 RouterOS脚本被分成多行命令行，命令行一条接一条地执行，直到脚本结束或则发生运行时错误。 命令行 RouterOS 控制台使用以下的命令语法。 [prefix] [path] command [uparam] [param=[value]] .. [param=[value]] • [prefix]-: 或表明命令是ICE （接口配置环境）或者路径的/，可能需要或者不需要。 • [path] – 期望目录等级的相对路径，可能需要或者不需要。 • command –一条命令在特定的目录等级才可用。 • [uparam] –如果命令需要未命名参数，参数必须被指定。 • [params] – 命名参数和对应值的序列。 命令行结束通过通过 “;”表示，有时也通过换行(NEWLINE .)表示,命令行结束时换行(NEWLINE .)不是必须的。 单条命令在(), [] 或者{}中,不需要任何命令结束符，命令的结束是通过整个脚本内容来判断的。 :if ( true ) do={ :put lala } 每一条包含在另一条里的命令行，以[ ](方括号)开始和结束。 . :put [/ip route get [find gateway=]]; 请注意上面的命令行包含了三条命令行： • :put • /ip route get • find gateway= 命令行可以由多行物理行构成，通过以下的连接规则。 手册：脚本编写 2 物理行 一个物理行是被行尾结束符 (EOL)终止的字符序列，任何标准平台的行尾结束符都可以使用。 • unix – ASCII LF; • windows – ASCII CR LF; • mac – ASCII CR; 标准C风格的换行字符也可以被使用。 注释 以#开始，在物理行结束。空格或者任何其他的符号都不允许在#之前出现。如果# 出现在字符串中，就不会被当作注释，注 释被语法忽略。 # this is a comment # bad comment :global a; # bad comment :global myStr lala # this is not a comment 行连接 两行或者多个物理行可以通过反斜杠(\)连接成为一个逻辑行，通过反斜杠结束的行不支持注释，反斜杠无法延续注释。反 斜杠无法延续一个符号，字符串常量除外。当反斜杠在字符串常量之外的其他地方会被认为是非法的。 :if ($a = true \ and $b=false) do={ :put “$a $b”; } :if ($a = true \ # bad comment and $b=false) do={ :put “$a $b”; } # comment \ continued – invalid (syntax error) 符号间的空格 空格可以用来分隔符号。当两个符号间的连接被理解为一个不