10.0;trmon (trace_monitor_utility), revision 1.0, 88/09/30 trmon (trace_monitor_utility) -print messages collected by trace modules on active Streams usage: [-h] | [-n name] | [-f format_file ] DESCRIPTION trmon prints STREAMS messages collected by instances of tracem modules pushed onto Streams with trconf. For each reported message, a header containing reporting instance id, sequence id, message type, timing information, and message direction is printed. The header is followed (if -f is used) by the contents of the data part of the message. OPTIONS -h Suppress printing of header output. -n name Give this trmon instance a name. name is an alpha-numeric string. If no name is given, the trmon instance will have the name trmonn, where n is its internal id. -f format_file Use format_file to specify the format to print the data part of the reported messages. This file is in ``modified C struct syntax.'' Customized output formats for any type of message can be formed by taking structure definitions from the header file of a protocol and making some minor modifications. The format file consists of a number of lines for each data field to be recognized as follows: string type [fieldname] [comment] where: string is a string delimited by double-quotes ("") and containing a printf format string, or a null string ("") meaning don't print this field. type is a C basic type, or dump, which produces a hexadecimal dump of the rest of the message (like od(1) -h), or raw, which outputs the raw bytes. fieldname is a C field identifier and is optional and ignored. comment is a C comment and is optional and ignored. EXAMPLES The following example causes trmon to choose its own name, and dump all messages it receives from all tracem instances. trmon -f dumpfile where dump_file is a file which contains: " " dump a; /* to dump the entire message */ The following example will cause trmon to name itself traceioctl and to format all messages it receives without header information. In this case, it is assumed that trconf will be used to configure a tracem instance that reports only on M_IOCTL messages, and to associate that tracing instance with this trmon instance. trmon -h -n traceioctl -f iocfile where iocfile is a file which contains: "cmd: %d," int ioc_cmd; /* ioctl command */ " uid: %u," unsigned short ioc_uid;/* effective uid */ " gid: %u," unsigned short ioc_gid;/* effective gid */ " id: %u," unsigned int ioc_id;/* ioctl id */ " count: %u," unsigned intioc_count;/* # bytes of data */ " error: %d," int ioc_error;/* error code */ " rval: %d\n" int ioc_rval;/* return value */ " " dump a; /* dump data */ SEE ALSO trconf, tracem, strinfo