1.3 KiB
1.3 KiB
控制台与审计合同
- 每行一个单字母命令和空白分隔十进制整数,允许空行、行尾
#注释;超出整数范围或未知命令返回 -2,不改业务状态。语法断行错误退出65。正常EOF退出0。 - 每条命令先输出
E 序号 RESULT 返回码 值 附加值,再输出S 序号和业务状态以及审计状态。序号从1开始。Y/Z为只读诊断,仍计入审计。 - Y age 查询执行此命令前最近第 age 条记录,age=0为最近,最多8条;返回原返回码/原值/原序号。不存在返回 -2/0/0。Z channel 查询A..Z对应0..25的命令累计调用和负返回次数,返回0/调用数/负返回数;非法channel返回-2/0/0。
- 审计状态依次是 sequence、非负返回次数、负返回次数、非负返回的值之和、32位fingerprint、非负返回值的最小和最大值、历史条数;尚无非负返回时min/max=0。其后按从新到旧输出8条记录(sequence、命令ASCII、返回码、值),空记录四个0;其后按A..Z输出调用数和负返回数。业务R不清除审计。
- fingerprint初值2166136261。每条命令依次混入序号、ASCII命令、符号扩展到64位的返回码、64位值;每数以低字节先出8次,逐字节执行
state=(state XOR byte)*16777619 mod 2^32。状态和事件均为观察,不在应用内断言正确性。