Usage of Polaris with KAP

Polaris may use KAP as a Fortran scanner by simply setting the Polaris switch ``kap_scanner'' to ``1''. This will replace the normal Polaris scanner with KAP. In this mode, KAP will do nothing but serve as a scanner - it would not try to optimize the program.

KAP may also be used as a stand-alone restructurer whose data structures may be transfered to Polaris via a file containing Polaris Exchange Format (PEF) data. This file may be read into Polaris via . . . ???.

The current version of KAP/Polaris is version ``k220203''. It may be found in sp51:/user2/polaris/kap.

The following are Polaris-specific command line switches for KAP:

-cust=...

same as -customer=...

-cust=sgi

Produce Fortran code with DOACROSS directives suitable for an SGI Challenge. If no -customer switch is given, KAP will default to this case.

-cust=pcf

Produce Fortran code with PCF directives.

-cust=pefoutput

Produce ASCII Polaris Exchange Format output in the compile file. Only Fortran is generated.

-cust=pefoutput,binary

Produce binary version of the Polaris Exchange Format in the compile file. Currently 0 is used as the version and -1 for an unknown length.

-cmp= <filename>

Redirects the compile output to <filename>. By default KAP produces a file with the same base name as the input file but with the extension .cmp.

Examples:

kap sample1.f -cust=pefoutput The above command will produce the ASCII version of the Polaris Exchange Format in the file sample1.cmp.

kap sample1.f -customer=pefoutput,binary -cmp=sample1.pef The above command will produce the binary version of the Polaris Exchange Format in the file sample1.pef.

• KAP specialty directives
• Example source file with directives: