probevctrl 命令

用途

更改并显示 ProbeVue 动态跟踪参数以及 ProbeVue 会话。

语法

probevctrl [ -c attribute = value ] [ -C ] [ -f { milli|micro }] [ -d sessionID ] [ -l ] [ -n attribute = value ] [ -p ] [-s { probevue_session_id }] [ -t ] [ -u user-list ] [-T { show|start|stop|reset }]

描述

probevctrl 命令更改并显示了 ProbeVue 动态跟踪参数、每个处理器跟踪缓冲区大小、已使用的引脚内存、拥有会话的用户、启动会话的进程的标识以及会话是否具有 ProbeVue 会话的内核探测器的信息。

缺省情况下，启用 ProbeVue。 当 ProbeVue 会话处于活动状态时，尝试禁用 ProbeVue 将失败。

标志

-c

指定无用户 ProbeVue 参数。 该标志的参数可使用逗号分隔或者使用双引号引起来且之间用逗号或空格分隔。 如果没有指定 -p 或 -t 标志与该标志一起使用，在当前引导和下一个引导会话中新值都将有效。 有效的 attribute-value 对如下所示：

trace= {on | off}

指定 ProbeVue 必须启用还是禁用。

default_buffer_size=default_buffer_size

指定每个处理器跟踪缓冲区的缺省大小（以 KB 为单位）。 它将舍入到下一个 4KB 页面。

max_total_mem_size=max_total_mem_size

指定整个 ProbeVue 框架可以使用的最大引脚内存（以 MB 为单位）。

default_read_rate=default_read_rate

指定跟踪使用者读取 ProbeVue 缓冲区的缺省周期（以毫秒为单位）。

stack_size=stack_size_in_4Kpages

指定每个处理器的计算堆栈大小（以 KB 为单位）。 它将舍入到下一个 4KB 页面。

local_table_size=数目

指定每个处理器的本地表大小（按 KB 计）。 临时字符串将使用为本地表分配的一半空间。 缺省值设置为 4 KB。

min_interval=时间间隔 (毫秒)

指定全局 root 用户在时间间隔探针中允许的最小时间间隔。

num_pagefaults=数目

指定用于处理页面的缺页故障的数量上下文。 指定 ProbeVue 框架初始化期间预分配的上下文缺页故障数。

num_threads_traced=数目

指定在 ProbeVue 会话具有线程局部变量时可以支持的最大线程数。 ProbeVue 框架的所有线程本地变量分配在开始一个会话。使用此属性指定的最大线程数。

max_net_buf_size=数目

指定探测器操作 net 所使用的每 CPU 缓冲区的最大大小（按字节计）。

max_intr_systrcprb_time=数目

指定在中断上下文中启动探测器操作 systrace 时，该探测器操作可能要用于运行的最长时间（按毫秒计）。

max_intr_sysprocprb_time=数目

指定在中断上下文中启动探测器操作 sysproc 时，该探测器操作可能要用于运行的最长时间（按毫秒计）。

max_intr_ioprb_time=数目

指定在中断上下文中启动探测器操作 io 时，该探测器操作可能要用于运行的最长时间（按毫秒计）。

max_intr_netprb_time=数目

指定在中断上下文中启动探测器操作 net 时，该探测器操作可能要用于运行的最长时间（按毫秒计）。

async_stats_fetch_interval=数目

指定用来访存系统统计信息的异步访存时间间隔（以毫秒计）。 此属性是适用于所有 ProbeVue 会话的全局值。 ProbeVue 将根据此值来设置异步访存时间间隔。 该可调参数的缺省值为 1000 毫秒。 可调参数值的更改不会影响正在运行的会话，并且所指定的值只用于新会话。

fetch_stats_async_only={yes | no}

指定即使可以进行同步访存，也必须以异步方式访存所有系统统计信息。 此参数的缺省值为 no。 可调值中的更改不影响正在运行的会话，并且指定的值将仅用于新会话。

max_intr_cpuboundprb_time=数目

指定在中断上下文中启动探测器操作 CPU-bound interval 时，该探测器操作可能要用于运行的最长时间（按毫秒计）。

-C

将 ProbeVue 会话可调参数设置为初始值。 -C 选项使用系统的当前配置来确定要设置的配置初始值（高配置或者低配置），并更新当前引导参数和下一个引导参数。 有关可调参数的高配置值和低配置值的更多信息，请参阅 ProbeVue 动态跟踪工具 主题。

注: 在使用 -C 标志之前，请确保没有活动的 ProbeVue 会话。

-d sessionId

显示对指定会话启用的探测器的列表。 当您指定all作为会话标识，那么探测器的用户可以查看的所有 ProbeVue 会话的显示。 ProbeVue 会话及其关联会话标识的列表可以使用 probevctrl 命令来获取。

-f

指定探测器操作的时间耗用数据需要采用的显示格式。 可以将 -f 选项与 -T 选项一起使用，该选项将显示对于特定会话的操作。 可能的格式如下：

milli

以毫秒为单位显示时间。

micro

以微秒为单位显示时间。

缺省格式为 milli。

-l

列出 ProbeVue 配置参数的当前值。 如果未指定 -p 或 -t 标志，将显示当前引导会话的参数值。

-n

指定常规用户的可配置参数。 该选项的参数可使用逗号分隔或者使用双引号引起来且之间用逗号或空格分隔。 如果没有指定 -p 或 -t 标志与该标志一起使用，在当前引导和下一个引导会话中新值都将有效。 有效的 attribute-value 对如下所示：

max_mem_size=max_mem_size

指定 ProbeVue 会话可以使用的最大引脚内存（以 MB 为单位）。

max_sessions=MAX_sessn

指定允许的最大并发会话数。

min_read_rate=min_read_rate

指定常规用户可以请求跟踪使用者读取其跟踪缓冲区的最小周期（以毫秒为单位）。

pin_mem_dvar_pc=pin_mem_dvar_pc

指定可以为动态类型变量的动态数据结构分配的内存的百分比。 此内存可以用于堆栈跟踪和联合阵列类型动态变量。 此参数的值设置在 10 到 100 范围内。 缺省值为 50。

-p

指定必须更新并显示下一个引导的缺省值。

-s probevue_session_id

指定要对其执行操作的会话。 此标志必须与 -T 标志配合使用。

-u

指定必须列出其 ProbeVue 会话的用户列表（用逗号隔开）。 如果未指定 -u 标志，那么将显示用户可以查看的所有 ProbeVue 会话。 具有 aix.ras.probevue.manage 权限的用户可以查看系统中所有的 ProbeVue 会话。 没有此权限的用户只能查看他们拥有的 ProbeVue 会话。

-t

指定必须更新并显示当前引导会话的缺省值。

-T show | start | stop | reset

指定是否对由 -s 标志所指定的会话显示、启动、停止或重置探测器操作概要分析。 -s 标志必须与此标志一起使用。

示例

1. 要修改下一个引导缺省缓冲区大小并打开动态跟踪，请输入：

   probevctrl -c trace=on,default_buffer_size=8 -p

   或

   probevctrl -c "trace=on default_buffer_size=8" -p

2. 要列出下一个引导 ProbeVue 配置，请输入：

   probevctrl -l -p

3. 要列出当前 ProbeVue 配置，请输入：

   probevctrl -l -t

4. 要列出所有 ProbeVue 会话，请输入：

   probevctrl

5. 如果要列出用户 guest 拥有的所有 ProbeVue 会话，请输入以下命令：

   probevctrl -u guest

6. 如果要在下一次引导时将为动态数据结构（堆栈跟踪和联合阵列）分配的锁定内存百分比从缺省值 50 增大为 75，请输入以下命令：

   probevctrl -n  pin_mem_dvar_pc = 75