trcgenkt 数据链路控制 (DLC) 设备的内核服务

用途

记录 DLC 跟踪通道的跟踪事件 (包含时间戳记)。

语法

#include <sys/trchkid.h>
void trcgenkt (chan, hk_word, data_word, len, buf)
unsigned int  chan,  hk_word,  data_word,  len;
char * buf;

参数

描述
指定用于跟踪会话的通道号。 此数字是从 特尔开始 子例程获取的。
hk_word 包含 /usr/include/sys/trchkid.h 文件中定义的跟踪挂钩标识。 使用挂钩标识注册的链接跟踪条目的类型包括:
CHKWD_SYSX_DLC_START
启动链接站完成
hkwd_sysx_dlc_timer
超时完成数
hkwd_sysx_dlc_xmit
传输完成
hkwd_sysx_dlc_recv
接收完成
hkwd_sysx_dlc_halt
停止链路站完成
数据字 指定跟踪数据格式字段。 此字段根据挂钩标识而变化。 以下每个定义都位于 /usr/include/sys/gdlextcb.h 文件中:
  • 第一个半字始终包含数据链路协议字段,包括下列其中一个定义:
    DLC_DL_SDLC
    SDLC
    DLC_DL_HDLC
    HDLC
    DLC_DL_BSC
    Bisync
    DLC_DL_ASC
    ASYNC
    DLC_DL_PCNET
    PC 网络
    DLC_DL_ETHER
    标准以太网
    DLC_DL_802_3
    IEEE 802.3
    DLC_DL_TOKEN
    令牌环
 
  • 在启动或停止链路站完成时,第二个半字包含正在使用的物理链路协议:
    DLC_PL_EIA232
    EIA-232D 电信业
    DLC_PL_EIA366
    EIA-366 自动拨号
    DLC_PL_X21
    CCITT X.21 数据网络
    DLC_PL_PCNET
    PC 网络宽带
    DLC_PL_ETHER
    标准基带以太网
    DLC_PL_SMART
    智能调制解调器自动拨号
    DLC_PL_802_3
    IEEE 802.3 基带以太网
    DLC_PL_TBUS
    IEEE 802.4 令牌总线
    DLC_PL_TRING
    IEEE 802.5 令牌环
    DLC_PL_EIA422
    EIA-422 电信业
    DLC_PL_V35
    CCITT V.35 电信公司
    DLC_PL_V25BIS
    CCITT V.25 bis 电信自动拨号
 
  • 在超时完成时,第二个半字包含超时出现的类型:
    dlc_to_slow_poll
    慢速站轮询
    dlc_too_idle_poll
    空闲站轮询
    DLC_TO_ABORT
    链路站异常中止
    DLC_TO_INACT
    链路站接收不活动状态
    dlc_too_failsafe
    命令故障安全
    DLC_TO_REPOLL_T1
    命令重新轮询
    DLC_TO_ACK_T2
    I 帧确认
 
  • 在发送完成时,将第二半字设置为正在发送的数据链路控制字节。 某些传输包仅具有单个控制字节; 在此情况下,不会显示第二个控制字节。
  • 在接收完成时,将第二个半字设置为接收到的数据链路控制字节。 某些接收包仅具有单个控制字节; 在这种情况下,不显示第二个控制字节。
len 指定由 布夫 参数指定的特定于条目的数据的长度 (以字节计)。
布夫 指定指向特定于条目的数据的指针,该数据包含:
启动链路站完成
链路站诊断标记以及远程站的名称和地址。
超时完成数
未记录任何特定数据。
传输完成
前 80 个字节或所有已传输的数据,具体取决于短/长跟踪选项。
接收完成项
前 80 个字节或所有接收到的数据,具体取决于短/长跟踪选项。
停止链路站完成
链路站诊断标记,远程站的名称和地址,以及结果代码。

描述

如果指定跟踪通道的跟踪会话处于活动状态,那么 特尔根克特 内核服务会记录跟踪事件。 如果跟踪会话未处于活动状态,那么 特尔根克特 内核服务仅返回。 特尔根克特 内核服务位于锁定的内核内存中。

特尔根克特 内核服务用于记录跟踪条目,该条目由 hk_word 条目, 数据字 条目,可变数目的跟踪数据字节数和时间戳记组成。

执行环境

可以从 流程中断 环境中调用 特尔根克特 内核服务。

返回值

特尔根克特 内核服务没有任何返回值。