trxpatch(1M)                                                   trxpatch(1M)

NAME
     trxpatch - define the internal system buffer size of tracex with a
     reboot

SYNOPSIS
     /opt/SItracex/bin/trxpatch kernelfile buffersize

DESCRIPTION
     A data buffer is required in the operating system kernel for a tracex
     measurement. Using the trxpatch command, the buffer size of the ker-
     nelfile kernel can be changed permanently to buffersize KB. The system
     must, however, then be rebooted. The active Reliant UNIX kernel is not
     affected by this call.

     The size of the tracex buffer is limited to a maximum of 256 KB. (sin-
     gle processor machines: 128 KB).

NOTES
     Operating systems are supplied with 5 pages of buffer size by default.
     This is generally insufficient.

     It is recommended to keep between 40 KB and 256 KB free depending on
     the number of processors.

     With single processor machines, it is recommended to keep 128 KB free.

     The use of trxpatch is recommended if reboots occur frequently within
     a measurement sequence. If this is not the case, trxsetbuf(1M) can be
     used, which does not necessitate a reboot. Neither command is mutually
     exclusive.

     In multiprocessor systems, the microsecond timer used by tracex only
     functions approx. 3 minutes after the system is booted.

     Detailed instructions and, in particular, a description of all meas-
     urement points (events) known to tracex, as well as the format of the
     files, can be found in the /home/tracex/doc/trxman00 file.

SEE ALSO
     snap(1M), trxsetbuf(1M), txc(1M), entab(4), tracex(5).















Page 1                       Reliant UNIX 5.44                Printed 11/98