trc_find_first ， trc_find_next 或 trc_compare 子例程

用途

查找自变量的第一个或下一个出现项，或者将当前条目与自变量进行比较。

库

libtrace.a

语法

#include <sys/libtrace.h>

int trc_find_first (handle, argp, ret)
trc_log_handle_t handle;
trc_logsearch_t *argp;
trc_read_t *ret;

int trc_find_next (handle, argp, ret)
trc_log_handle_t handle;
trc_logsearch_t *argp;
trc_read_t *ret;

int trc_compare (handle, argp)
trc_log_handle_t handle;
trc_logsearch_t *argp;

描述

trc_find_first 子例程找到与 阿尔格普 参数所指向的自变量匹配的跟踪日志条目的第一次出现。 trc_find_next 子例程从日志对象中的当前位置开始查找该自变量的下一个实例。 如果搜索自变量指针 阿尔格普为 NULL ，那么将使用来自先前搜索的自变量。 trc_find_first 和 trc_find_next 子例程都返回找到的项。 如果句柄的标志字段同时包含 TRC_MULTI_MERGE 和 TRC_REMOVE_DUPS ，那么 trc_find_first 和 trc_find_next 将使用存在于其他跟踪源中的当前事件的任何重复条目。 所使用的条目数将在 trchi_dupcount 或 trcri_dupcount 变量中返回 (根据分别是已处理的数据项还是原始数据项)。

trc_compare 子例程用来根据自变量检查当前条目。 未读取任何数据。 它在实现出口条件时很有用，您需要根据某些条件来查找条目，然后检查不是正常搜索的一部分的出口条件。

参数

搜索参数由三个部分组成，即运算符， 特尔斯奥普以及左右两边。

可以轻松识别运算符值，因为它们的格式为 TLS_OP_...。 运算符分为两个类别，即叶运算符和复合运算符。 叶运算符是用于将左边的字段与右边的值进行比较的运算符。 复合运算符用于将两个表达式 (例如) 与组合的表达式进行比较。

返回值

成功完成后， trc_find_first， trc_find_next和 trc_compare 子例程将返回 0。

错误代码

示例

1. 查找程序 mypgm的 SVC 挂钩 101 和 104。

   {
                     int rv;
                     trc_loghandle_t h;
                     trc_read_t r;
                     trc_logsearch_t t1, t2, t3, t4, t5;
   
                     /* Setup the leaf search arguments. */
                     t1.tls_op = TLS_OP_EQUAL;
                     t1.tls_field = TLS_MATCH_HOOKID;
                     t1.tls_ushortvalue = 0x101;
                     t2.tls_op = TLS_OP_EQUAL;
                     t2.tls_field = TLS_MATCH_HOOKID;
                     t2.tls_ushortvalue = 0x104;
                     t3.tls_op = TLS_OP_EQUAL;
                     t3.tls_field = TLS_MATCH_PROCNAME;
                     t3.tls_strvalue = "mypgm";
                     /* Join the items and form a single search tree. */
                     t4.tls_op = TLS_OP_AND;
                     t4.tls_left = &t1
                     t4.tls_right = &t2
                     t5.tls_op = TLS_OP_AND;
                     t5.tls_left = &t4
                     t5.tls_right = &t3
                     /* Open the default trace log object. */
                     rv = trc_open("", "", TRC_LOGREAD|TRC_LOGPROC, >h);
                     if (rv) {
                             trc_perror(h, rv, "open");
                             return(rv);
                     }
                     /* Do the search. */
                     rv = trc_find_first(h, &t5, &r);
                     if (rv) {
                             trc_perror(h, rv, "find test");
                             return(rv);
                     }
   
                     ...
             }

   请注意，与此搜索匹配的后续条目可能会返回以下内容:

   rv = trc_find_next(h, NULL, &r);

   在查找之后，可以使用 trc_find_next 来更改搜索参数，而无需重新开始搜索。 换言之， trc_find_first 始终从文件开头开始，而 trc_find_next 则从文件中的当前位置开始，但其中任何一个都可以更改搜索参数。

2. 查找程序 mypgm的 SVC 挂钩 101 和 104。 使用单个自变量来搜索两个挂钩标识。

   {
                     int rv;
                     trc_loghandle_t h;
                     trc_read_t r;
                     trc_logsearch_t t1, t2, t3;
                     trc_hookset_t hs;
   
                     /* Setup the hook set. */
                     trc_hkemptyset(hs);
                     (void)trc_hkaddset(hs, 0x101);
                     (void)trc_hkaddset(hs, 0x104);
                     /* Setup the leaf search arguments. */
                     t1.tls_op = TLS_OP_EQUAL;
                     t1.tls_field = TLS_MATCH_HOOKSET;
                     t1.tls_hooksetvalue = hs;
                     t2.tls_op = TLS_OP_EQUAL;
                     t2.tls_field = TLS_MATCH_PROCNAME;
                     t2.tls_strvalue = "mypgm";
                     /* Join the items and form a single search tree. */
                     t3.tls_op = TLS_OP_AND;
                     t3.tls_left = &t1
                     t3.tls_right = &t2
                     /* Open the default trace log object. */
                     rv = trc_open("", "", TRC_LOGREAD|TRC_LOGPROC, &h);
                     if (rv) {
                             trc_perror(h, rv, "open");
                             return(rv);
                     }
                     /* Do the search. */
                     rv = trc_find_first(h, &t3, &r);
                     if (rv) {
                             trc_perror(h, rv, "find test");
                             return(rv);
                     }
   
                     ...
             }

3. 您可以使用 trc_hookset64_t 类型找到程序 米普姆 的挂钩 101,104 和 1AB1 。 Hook 101 和 104 等于 0x1010 和 0x1040。

   {
                     int rv;
                     trc_loghandle_t h;
                     trc_read_t r;
                     trc_logsearch_t t1, t2, t3;
                     trc_hookset64_t hs;
   
                     /* Setup the hook set. */
                     trc_hkemptyset64(hs);
                     (void)trc_hkaddset64(hs, 0x1010);
                     (void)trc_hkaddset64(hs, 0x1040);
                     (void)trc_hkaddset64(hs, 0x1AB1);
   
                     /* Setup the leaf search arguments. */
                     t1.tls_op = TLS_OP_EQUAL;
                     t1.tls_field = TLS_MATCH_HOOKSET64;
                     t1.tls_hooksetvalue = hs;
                     t2.tls_op = TLS_OP_EQUAL;
                     t2.tls_field = TLS_MATCH_PROCNAME;
                     t2.tls_strvalue = "mypgm";
                     /* Join the items and form a single search tree. */
                     t3.tls_op = TLS_OP_AND;
                     t3.tls_left = &t1
                     t3.tls_right = &t2
                     /* Open the default trace log object. */
                     rv = trc_open("", "", TRC_LOGREAD|TRC_LOGPROC, &h);
                     if (rv) {
                             trc_perror(h, rv, "open");
                             return(rv);
                     }
                     /* Do the search. */
                     rv = trc_find_first(h, &t3, &r);
                     if (rv) {
                             trc_perror(h, rv, "find test");
                             return(rv);
                     }
   
                     . . .
             }