Intel® Trace Analyzer and Collector User and Reference Guide

ID 767272
Date 3/31/2023
Public
Document Table of Contents

Protocol File

The protocol file lists all options with their values used when the program was started and can be used to restart an application with exactly the same options.

The protocol file is generated along with the tracefile, has the same basename and the .prot extension. It has the same syntax and entries as a Intel® Trace Collector configuration file.

All options are listed, even if they were not present in the original configuration. This way you can find about for example, the default value of SYNCED‑HOST/CLUSTER on your machine. Comments tell where the value came from (default, modified by user, default value set explicitly by the user).

Besides the configuration entries, the protocol file contains some entries that are only informative. They are all introduced by the keyword INFO. The following information entries are supported:

INFO NUMPROCS

Syntax:<num>

Description: Number of processes in MPI_COMM_WORLD.

INFO CLUSTERDEF

Syntax:<name>[<rank>:<pid>]+

Description: For clustered systems, the processes with Unix process ID <pid> and rank in MPI_COMM_WORLD<rank> are running on the cluster node <name>. There will be one line per cluster node.

INFO PROCESS

Syntax:<rank>"<hostname>" "<IP>" <pid>

Description: For each process identified by its MPI <rank>, the <hostname> as returned by gethostname(), the <pid> from getpid() and all <IP> addresses that <hostname> translates into with gethostbyname() are given. IP addresses are converted to string with ntoa() and separated with commas. Both hostname and IP string might be empty, if the information was not available.

INFO BINMODE

Syntax:<mode>

Description: Records the floating-point and integer-length execution mode used by the application.

There may be other INFO entries that represent statistical data about the program run. Their syntax is explained in the file itself.