Oracle® Solaris Studio 12.4:性能分析器

退出打印视图

更新时间: 2015 年 1 月
 
 

er_label 命令语法

er_label 命令的语法为:

er_label -o experiment-name -n label-name -t {start|stop}[=time-specification] [-C comment

选项定义如下:

–o 实验名称。这是一个必需的选项,用于指定希望标记的实验的名称。只能指定一个实验名称,不支持实验组。–o 选项可以出现在命令行中的任意位置。

–n 标签名称。这是一个必需的选项,用于指定标签名称。

标签名称可以是任意长度,但必须是字母数字,以字母开头且没有嵌入的空格,即使用引号将字符串括起也是如此。如果 label-name 存在,会向它添加新条件;如果不存在,将创建它。需要一个 -n 参数,但是该参数可出现在命令行上的任意位置。标签名不区分大小写。标签名称不得与可以出现在过滤条件中的其他名称(包括实验中的属性或者内存对象或索引对象的名称)冲突。已装入实验中的属性是使用 er_print describe 命令列出的。内存对象是使用 er_print mobj_list 命令列出的。索引对象是使用 er_print indxobj_list 命令列出的。

–C 注释。这是标签的注释,可选。可以对单个标签使用多个 –C 选项,在显示标签时,这些注释将串联起来,相互之间使用分号和空格分隔。可以使用多个注释,例如,在标签中提供每个时间间隔的信息。

–t start|stop =time-specification 是为定义实验中的时间范围所指定的开始点或停止点。如果省略 =time-specification,则创建当前时间的标记。

可以按以下格式之一指定 time-specification

hh:mm:ss.uuu

指定相对于实验开始的时间,在此处应该放置开始或停止标记。必须至少指定秒数,还可以选择指定小时数、分钟数和零点几秒。

指定的时间值将按以下方式解释:

nn

如果指定不带冒号的整数,则将解释为秒数。如果值大于 60,则秒数在标签中将转换为 mm:ss。例如,-t start=120 会在实验开始后的 02:00 处放置一个开始标记。

nn.nn

如果包含任意精度的小数,则该值将解释为零点几秒,并且以纳秒精度进行保存。例如,-t start=120.3 会在实验开始后的 02:00.300(即 2 分 300 纳秒)处放置一个开始标记。

nn:nn

如果使用 nn:nn 格式指定时间,则将解释为 mm:ss;如果 mm 的值大于 60,则时间将转换为 hh:mm:ss。为 ss 指定的数字必须介于 0 和 59 之间,否则会出现错误。例如,-t start=90:30 会在实验开始后的 01:30:30(即 1 小时 30 分 30 秒)处放置一个开始标记。

nn:nn:nn

如果使用 nn:nn:nn 格式指定时间,则将解释为 hh:mm:ss。为分钟和秒指定的数字必须介于 0 和 59 之间,否则会出现错误。例如,-t stop=01:45:10 会在实验开始后的 1 小时 45 分 10 秒处放置一个结束标记。

@

指定当前时间,以便在实验中执行 er_label 命令的那一刻放置一个标记。当前时间在命令的单个调用中设置一次,因此使用 @ 的任何其他标记将相对于该原始时间戳值设置。

@+offset

指定当前时间戳之后的某个时间,其中 offset 是一个使用与上面所述的相同 hh:mm:ss.uuu 规则的时间。此时间格式在原始时间戳之后的指定时间处放置一个标记。例如,-t stop=@+180 在当前时间之后的 3 分钟处放置一个停止标记。

@-offset

指定当前时间戳之前的某个时间,其中 offset 是一个使用与上面所述的相同 hh:mm:ss.uuu 规则的时间。此时间格式在原始时间戳之前的指定时间处放置一个标记。例如,-t start=@-20:00 在当前时间之前的 20 分钟处放置一个开始标记。如果实验的运行时间尚未达到 20 分钟,则将忽略该标记。

可以在单个 er_label 命令中指定多个 –t,也可以在相同标签名称的单独命令中指定多个 –t,但它们应该以成对的 –t start–t stop 标记出现。

如果 –t start–t stop 选项后面未跟随任何时间指定,则将在指定部分中采用 =@。必须为其中一个标记包含时间指定。