Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ftoc(1) — Ultrix/UWS 4.5.1 RISC

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

cord(1)

pixie(1)

prof(1)

ftoc(1)  —  RISC

Name

ftoc − interface between prof and cord

Syntax

ftoc file1... 

Description

The ftoc command reads one or more feedback files produced by the −feedback option of the prof utililty, then writes a reorder file to stdout. The reorder file is intended for subsequent use by the cache-rearranging utility, cord.

The ftoc command interprets each feedback file to represent one phase of a program’s execution.  For example, should a program behave in two distinct ways depending on its input, you could create two different feedback files by executing the program twice with different input data.  Both the ftoc and the cord utilities understand that the information from the first file is distinct from that of the second file.

The reorder file consists of a list of lines of the form:

sourcefile procname.procname... n

The procname.procname...  variable represents an outer-to-inner list of nested procedures, and n is 10 times the percentage of the procedure’s density with respect to the total of the densities of all procedures. (Density is the ratio of a procedure’s total cycles to its total static instructions.) 

A line containing $phase separates information from different feedback files.

Example

To improve the instruction-cache performance of a program named hello, you could generate a new hello.cord program by executing the following commands:

cc -non_shared -o hello hello.c
pixie -o hello.pixie hello
hello.pixie
prof -pixie -feedback hello.feedback hello
ftoc hello.feedback > hello.reorder
cord -o hello.cord hello hello.reorder

See Also

cord(1), pixie(1), prof(1)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026