Protocol File

The protocol file has the same syntax and entries as a Intel® Trace Collector configuration file. Its extension is .prot, with the basename being the same as the tracefile. It lists all options with their values used when the program was started, thus it can be used to restart an application with exactly the same options.

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.

For more complete information about compiler optimizations, see our Optimization Notice.