DataMuseum.dk

top - download

    Length: 6046 (0x179e)
    Names: »cord.1m«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat1/cord.1m« 

Default Hex Dump

0x0000…0020 0a 0a 0a 5f 08 4f 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 20 5f 08 4d 5f 08 61 5f 08 6e 5f   ┆   _ O_ n_ l_ i_ n_ e _ M_ a_ n_┆
0x0020…0040 08 75 5f 08 61 5f 08 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 55 73 65 72 20 43 6f 6d 6d 61 6e   ┆ u_ a_ l             User Comman┆
0x0040…0060 64 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 72 64 28 31 6d 29 0a 0a 0a 0a   ┆ds                  cord(1m)    ┆
0x0060…0080 4e 08 4e 08 4e 08 4e 41 08 41 08 41 08 41 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 0a 20 20 20   ┆N N N NA A A AM M M ME E E E    ┆
0x0080…00a0 20 20 63 6f 72 64 20 2d 20 72 65 61 72 72 61 6e 67 65 73 20 70 72 6f 63 65 64 75 72 65 73 20 69   ┆  cord - rearranges procedures i┆
0x00a0…00c0 6e 20 61 6e 20 65 78 65 63 75 74 61 62 6c 65 20 66 69 6c 65 20 74 6f 20 66 61 63 69 6c 2d 0a 20   ┆n an executable file to facil-  ┆
0x00c0…00e0 20 20 20 20 69 74 61 74 65 20 62 65 74 74 65 72 20 63 61 63 68 65 20 6d 61 70 70 69 6e 67 2e 0a   ┆    itate better cache mapping. ┆
0x00e0…0100 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 41 08 41   ┆ S S S SY Y Y YN N N NT T T TA A┆
0x0100…0120 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 72   ┆ A AX X X X      c c c co o o or┆
0x0120…0140 08 72 08 72 08 72 64 08 64 08 64 08 64 20 5b 08 5b 08 5b 08 5b 2d 08 2d 08 2d 08 2d 76 08 76 08   ┆ r r rd d d d [ [ [ [- - - -v v ┆
0x0140…0160 76 08 76 5d 08 5d 08 5d 08 5d 20 5b 08 5b 08 5b 08 5b 2d 08 2d 08 2d 08 2d 6f 08 6f 08 6f 08 6f   ┆v v] ] ] ] [ [ [ [- - - -o o o o┆
0x0160…0180 20 5f 08 6f 5f 08 75 5f 08 74 5f 08 66 5f 08 69 5f 08 6c 5f 08 65 5d 08 5d 08 5d 08 5d 20 5b 08   ┆ _ o_ u_ t_ f_ i_ l_ e] ] ] ] [ ┆
0x0180…01a0 5b 08 5b 08 5b 2d 08 2d 08 2d 08 2d 66 08 66 08 66 08 66 5d 08 5d 08 5d 08 5d 20 5b 08 5b 08 5b   ┆[ [ [- - - -f f f f] ] ] ] [ [ [┆
0x01a0…01c0 08 5b 2d 08 2d 08 2d 08 2d 63 08 63 08 63 08 63 20 5f 08 63 5f 08 61 5f 08 63 5f 08 68 5f 08 65   ┆ [- - - -c c c c _ c_ a_ c_ h_ e┆
0x01c0…01e0 5f 08 73 5f 08 69 5f 08 7a 5f 08 65 5d 08 5d 08 5d 08 5d 20 5b 08 5b 08 5b 08 5b 2d 08 2d 08 2d   ┆_ s_ i_ z_ e] ] ] ] [ [ [ [- - -┆
0x01e0…0200 08 2d 70 08 70 08 70 08 70 20 5f 08 6d 5f 08 61 5f 08 78 5f 08 70 5f 08 68 5f 08 61 5f 08 73 5f   ┆ -p p p p _ m_ a_ x_ p_ h_ a_ s_┆
0x0200…0220 08 65 5f 08 73 5d 08 5d 08 5d 08 5d 0a 20 20 20 20 20 5f 08 6f 5f 08 62 5f 08 6a 5f 5f 08 66 5f   ┆ e_ s] ] ] ]      _ o_ b_ j__ f_┆
0x0220…0240 08 69 5f 08 6c 5f 08 65 20 5f 08 72 5f 08 65 5f 08 6f 5f 08 72 5f 08 64 5f 08 65 5f 08 72 5f 5f   ┆ i_ l_ e _ r_ e_ o_ r_ d_ e_ r__┆
0x0240…0260 08 66 5f 08 69 5f 08 6c 5f 08 65 0a 0a 44 08 44 08 44 08 44 45 08 45 08 45 08 45 53 08 53 08 53   ┆ f_ i_ l_ e  D D D DE E E ES S S┆
0x0260…0280 08 53 43 08 43 08 43 08 43 52 08 52 08 52 08 52 49 08 49 08 49 08 49 50 08 50 08 50 08 50 54 08   ┆ SC C C CR R R RI I I IP P P PT ┆
0x0280…02a0 54 08 54 08 54 49 08 49 08 49 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20   ┆T T TI I I IO O O ON N N N      ┆
0x02a0…02c0 54 68 65 20 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 72 08 72 08 72 08 72 64 08 64 08 64 08 64   ┆The c c c co o o or r r rd d d d┆
0x02c0…02e0 20 63 6f 6d 6d 61 6e 64 20 72 65 61 72 72 61 6e 67 65 73 20 70 72 6f 63 65 64 75 72 65 73 20 69   ┆ command rearranges procedures i┆
0x02e0…0300 6e 20 61 6e 20 65 78 65 63 74 61 62 6c 65 0a 20 20 20 20 20 6f 62 6a 65 63 74 20 66 69 6c 65 20   ┆n an exectable      object file ┆
0x0300…0320 74 6f 20 6d 61 78 69 6d 69 7a 65 20 65 66 66 69 63 69 65 6e 63 79 20 69 6e 20 61 20 6d 61 63 68   ┆to maximize efficiency in a mach┆
0x0320…0340 69 6e 65 27 73 20 63 61 63 68 65 2e 20 20 42 79 0a 20 20 20 20 20 72 65 61 72 72 61 6e 67 69 6e   ┆ine's cache.  By      rearrangin┆
0x0340…0360 67 20 74 68 65 20 70 72 6f 63 65 64 75 72 65 73 20 70 72 6f 70 65 72 6c 79 2c 20 77 65 20 65 6e   ┆g the procedures properly, we en┆
0x0360…0380 64 20 75 70 20 72 65 64 75 63 69 6e 67 20 74 68 65 0a 20 20 20 20 20 69 6e 73 74 72 75 63 74 69   ┆d up reducing the      instructi┆
0x0380…03a0 6f 6e 20 63 61 63 68 65 20 6d 69 73 73 20 72 61 74 65 73 2e 20 20 43 08 43 08 43 08 43 6f 08 6f   ┆on cache miss rates.  C C C Co o┆
0x03a0…03c0 08 6f 08 6f 72 08 72 08 72 08 72 64 08 64 08 64 08 64 20 64 6f 65 73 20 6e 6f 74 20 61 74 74 65   ┆ o or r r rd d d d does not atte┆
0x03c0…03e0 6d 70 74 20 74 6f 0a 20 20 20 20 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 63 6f 72 72 65 63   ┆mpt to      determine the correc┆
0x03e0…0400 74 20 6f 72 64 65 72 69 6e 67 2c 20 62 75 74 20 69 73 20 67 69 76 65 6e 20 61 20 5f 08 72 5f 08   ┆t ordering, but is given a _ r_ ┆
0x0400…0420 65 5f 08 6f 5f 08 72 5f 08 64 5f 08 65 5f 08 72 20 66 69 6c 65 0a 20 20 20 20 20 63 6f 6e 74 61   ┆e_ o_ r_ d_ e_ r file      conta┆
0x0420…0440 69 6e 69 6e 67 20 74 68 65 20 64 65 73 69 72 65 64 20 70 72 6f 63 65 64 75 72 65 20 6f 72 64 65   ┆ining the desired procedure orde┆
0x0440…0460 72 2e 20 20 54 68 65 20 72 65 6f 72 64 65 72 20 66 69 6c 65 20 69 73 0a 20 20 20 20 20 67 65 6e   ┆r.  The reorder file is      gen┆
0x0460…0480 65 72 61 74 65 64 20 62 79 20 74 68 65 20 5f 08 66 5f 08 74 5f 08 6f 5f 08 63 20 70 72 6f 67 72   ┆erated by the _ f_ t_ o_ c progr┆
0x0480…04a0 61 6d 2c 20 77 68 69 63 68 20 69 6e 20 74 75 72 6e 20 67 65 6e 65 72 61 74 65 73 20 61 0a 20 20   ┆am, which in turn generates a   ┆
0x04a0…04c0 20 20 20 5f 08 72 5f 08 65 5f 08 6f 5f 08 72 5f 08 64 5f 08 65 5f 08 72 20 66 69 6c 65 20 66 72   ┆   _ r_ e_ o_ r_ d_ e_ r file fr┆
0x04c0…04e0 6f 6d 20 61 20 73 65 74 20 6f 66 20 70 72 6f 66 69 6c 65 20 66 65 65 64 62 61 63 6b 20 66 69 6c   ┆om a set of profile feedback fil┆
0x04e0…0500 65 73 20 28 73 65 65 0a 20 20 20 20 20 5f 08 70 5f 08 72 5f 08 6f 5f 08 66 28 5f 08 31 29 29 2e   ┆es (see      _ p_ r_ o_ f(_ 1)).┆
0x0500…0520 0a 0a 20 20 20 20 20 50 72 6f 63 65 73 73 65 64 20 6c 69 6e 65 73 20 69 6e 20 74 68 65 20 5f 08   ┆       Processed lines in the _ ┆
0x0520…0540 72 5f 08 65 5f 08 6f 5f 08 72 5f 08 64 5f 08 65 5f 08 72 20 66 69 6c 65 20 61 72 65 20 63 61 6c   ┆r_ e_ o_ r_ d_ e_ r file are cal┆
0x0540…0560 6c 65 64 20 70 72 6f 63 65 64 75 72 65 0a 20 20 20 20 20 6c 69 6e 65 73 2e 20 20 45 61 63 68 20   ┆led procedure      lines.  Each ┆
0x0560…0580 70 72 6f 63 65 64 75 72 65 20 6c 69 6e 65 20 6d 75 73 74 20 62 65 20 6f 6e 20 61 20 73 65 70 61   ┆procedure line must be on a sepa┆
0x0580…05a0 72 61 74 65 20 73 6f 75 72 63 65 0a 20 20 20 20 20 6c 69 6e 65 2e 20 20 45 61 63 68 20 70 72 6f   ┆rate source      line.  Each pro┆
0x05a0…05c0 63 65 64 75 72 65 20 6c 69 6e 65 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 73 6f 75   ┆cedure line must contain the sou┆
0x05c0…05e0 72 63 65 20 6e 61 6d 65 20 6f 66 0a 20 20 20 20 20 74 68 65 20 66 69 6c 65 2c 20 66 6f 6c 6c 6f   ┆rce name of      the file, follo┆
0x05e0…0600 77 65 64 20 62 79 20 61 20 62 6c 61 6e 6b 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 71 75 61   ┆wed by a blank followed by a qua┆
0x0600…0620 6c 69 66 69 65 64 20 70 72 6f 2d 0a 20 20 20 20 20 63 65 64 75 72 65 20 6e 61 6d 65 2e 20 20 4e   ┆lified pro-      cedure name.  N┆
0x0620…0640 65 73 74 65 64 20 70 72 6f 63 65 64 75 72 65 73 20 6d 75 73 74 20 62 65 20 71 75 61 6c 69 66 69   ┆ested procedures must be qualifi┆
0x0640…0660 65 64 20 78 2e 79 20 77 68 65 72 65 0a 20 20 20 20 20 78 20 69 73 20 74 68 65 20 6f 75 74 65 72   ┆ed x.y where      x is the outer┆
0x0660…0680 20 70 72 6f 63 65 64 75 72 65 2e 20 20 41 20 6e 65 77 6c 69 6e 65 20 6f 72 20 62 6c 61 6e 6b 20   ┆ procedure.  A newline or blank ┆
0x0680…06a0 63 61 6e 20 66 6f 6c 6c 6f 77 20 74 68 65 0a 20 20 20 20 20 70 72 6f 63 65 64 75 72 65 20 6e 61   ┆can follow the      procedure na┆
0x06a0…06c0 6d 65 3a 0a 0a 20 20 20 20 20 66 08 66 08 66 08 66 6f 08 6f 08 6f 08 6f 6f 08 6f 08 6f 08 6f 2e   ┆me:       f f f fo o o oo o o o.┆
0x06c0…06e0 08 2e 08 2e 08 2e 63 08 63 08 63 08 63 20 62 08 62 08 62 08 62 61 08 61 08 61 08 61 72 08 72 08   ┆ . . .c c c c b b b ba a a ar r ┆
0x06e0…0700 72 08 72 20 28 65 76 65 72 79 74 68 69 6e 67 20 65 6c 73 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69   ┆r r (everything else following i┆
0x0700…0720 73 20 69 67 6e 6f 72 65 64 29 0a 0a 0a 20 20 20 20 20 4c 69 6e 65 73 20 62 65 67 69 6e 6e 69 6e   ┆s ignored)        Lines beginnin┆
0x0720…0740 67 20 77 69 74 68 20 23 08 23 08 23 08 23 20 61 72 65 20 63 6f 6d 6d 65 6e 74 73 2c 20 6c 69 6e   ┆g with # # # # are comments, lin┆
0x0740…0760 65 73 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 24 08 24 08 24 08 24 0a 20 20 20 20 20 61   ┆es beginning with $ $ $ $      a┆
0x0760…0780 72 65 20 63 6f 6e 73 69 64 65 72 65 64 20 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 72 08 72 08   ┆re considered c c c co o o or r ┆
0x0780…07a0 72 08 72 64 08 64 08 64 08 64 20 64 69 72 65 63 74 69 76 65 20 6c 69 6e 65 73 2e 20 54 68 65 20   ┆r rd d d d directive lines. The ┆
0x07a0…07c0 6f 6e 6c 79 20 64 69 72 65 63 74 69 76 65 0a 20 20 20 20 20 63 75 72 72 65 6e 74 6c 79 20 75 6e   ┆only directive      currently un┆
0x07c0…07e0 64 65 72 73 74 6f 6f 64 20 69 73 20 24 08 24 08 24 08 24 5f 08 70 5f 08 68 5f 08 61 5f 08 73 5f   ┆derstood is $ $ $ $_ p_ h_ a_ s_┆
0x07e0…0800 08 65 2e 20 20 54 68 69 73 20 64 69 72 65 63 74 69 76 65 20 77 69 6c 6c 20 63 6f 6e 2d 0a 20 20   ┆ e.  This directive will con-   ┆
0x0800…0820 20 20 20 73 69 64 65 72 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 66 69 6c 65 20 28 75   ┆   sider the rest of the file (u┆
0x0820…0840 6e 74 69 6c 20 74 68 65 20 65 6e 64 20 6f 66 20 66 69 6c 65 20 6f 72 20 6e 65 78 74 0a 20 20 20   ┆ntil the end of file or next    ┆
0x0840…0860 20 20 24 08 24 08 24 08 24 5f 08 70 5f 08 68 5f 08 61 5f 08 73 5f 08 65 29 20 61 73 20 61 20 6e   ┆  $ $ $ $_ p_ h_ a_ s_ e) as a n┆
0x0860…0880 65 77 20 70 68 61 73 65 20 6f 66 20 74 68 65 20 70 72 6f 67 72 61 6d 20 61 6e 64 20 77 69 6c 6c   ┆ew phase of the program and will┆
0x0880…08a0 20 6f 72 64 65 72 20 74 68 65 0a 20 20 20 20 20 70 72 6f 63 65 64 75 72 65 73 20 61 63 63 6f 72   ┆ order the      procedures accor┆
0x08a0…08c0 64 69 6e 67 6c 79 2e 20 20 41 20 70 72 6f 63 65 64 75 72 65 20 6d 61 79 20 61 70 70 65 61 72 20   ┆dingly.  A procedure may appear ┆
0x08c0…08e0 69 6e 20 6d 6f 72 65 20 74 68 61 6e 0a 20 20 20 20 20 6f 6e 65 20 70 68 61 73 65 2c 20 72 65 73   ┆in more than      one phase, res┆
0x08e0…0900 75 6c 74 69 6e 67 20 69 6e 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 63 6f 70 79 20 6f 66 20   ┆ulting in more than one copy of ┆
0x0900…0920 69 74 20 69 6e 20 74 68 65 0a 20 20 20 20 20 66 69 6e 61 6c 20 62 69 6e 61 72 79 2e 20 20 46 69   ┆it in the      final binary.  Fi┆
0x0920…0940 72 73 74 2c 20 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 72 08 72 08 72 08 72 64 08 64 08 64 08   ┆rst, c c c co o o or r r rd d d ┆
0x0940…0960 64 20 77 69 6c 6c 20 74 72 79 20 74 6f 20 72 65 6c 6f 63 61 74 65 20 70 72 6f 63 65 64 75 72 65   ┆d will try to relocate procedure┆
0x0960…0980 0a 20 20 20 20 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 61 20 63 6f 70 79 20 6f 66 20 74 68   ┆      references to a copy of th┆
0x0980…09a0 65 20 70 72 6f 63 65 64 75 72 65 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 74 68 65 0a 20 20 20   ┆e procedure belonging to the    ┆
0x09a0…09c0 20 20 72 65 71 75 65 73 74 69 6e 67 20 70 68 61 73 65 3b 20 6f 74 68 65 72 77 69 73 65 20 69 74   ┆  requesting phase; otherwise it┆
0x09c0…09e0 20 77 69 6c 6c 20 72 65 6c 6f 63 61 74 65 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 73 0a 20 20   ┆ will relocate the references   ┆
0x09e0…0a00 20 20 20 74 6f 20 61 20 72 61 6e 64 6f 6d 20 63 6f 70 79 2e 0a 0a 20 20 20 20 20 57 65 20 73 75   ┆   to a random copy.       We su┆
0x0a00…0a20 67 67 65 73 74 20 79 6f 75 20 75 73 65 20 74 68 65 20 2d 08 2d 08 2d 08 2d 63 08 63 08 63 08 63   ┆ggest you use the - - - -c c c c┆
0x0a20…0a40 6f 08 6f 08 6f 08 6f 72 08 72 08 72 08 72 64 08 64 08 64 08 64 20 6f 70 74 69 6f 6e 20 74 6f 20   ┆o o o or r r rd d d d option to ┆
0x0a40…0a60 61 20 63 6f 6d 70 69 6c 65 72 20 64 72 69 76 65 72 0a 20 20 20 20 20 6c 69 6b 65 20 5f 08 63 5f   ┆a compiler driver      like _ c_┆
0x0a60…0a80 08 63 28 5f 08 31 29 20 72 61 74 68 65 72 20 74 68 61 6e 20 65 78 65 63 75 74 65 20 63 6f 72 64   ┆ c(_ 1) rather than execute cord┆
0x0a80…0aa0 20 64 69 72 65 63 74 6c 79 2e 20 20 43 08 43 08 43 08 43 6f 08 6f 08 6f 08 6f 72 08 72 08 72 08   ┆ directly.  C C C Co o o or r r ┆
0x0aa0…0ac0 72 64 08 64 08 64 08 64 20 6f 70 74 69 6f 6e 73 0a 20 20 20 20 20 63 61 6e 20 62 65 20 73 70 65   ┆rd d d d options      can be spe┆
0x0ac0…0ae0 63 69 66 69 65 64 20 77 69 74 68 20 2d 5f 08 57 5f 08 7a 2c 5f 08 63 5f 08 6f 5f 08 72 5f 08 64   ┆cified with -_ W_ z,_ c_ o_ r_ d┆
0x0ae0…0b00 5f 08 61 5f 08 72 5f 08 67 5f 08 30 2c 5f 08 63 5f 08 6f 5f 08 72 5f 08 64 5f 08 61 5f 08 72 5f   ┆_ a_ r_ g_ 0,_ c_ o_ r_ d_ a_ r_┆
0x0b00…0b20 08 67 5f 08 31 2c 2e 2e 2e 2e 20 20 49 66 20 79 6f 75 0a 20 20 20 20 20 68 61 76 65 20 74 6f 20   ┆ g_ 1,....  If you      have to ┆
0x0b20…0b40 72 75 6e 20 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 72 08 72 08 72 08 72 64 08 64 08 64 08 64   ┆run c c c co o o or r r rd d d d┆
0x0b40…0b60 20 62 79 20 68 61 6e 64 2c 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 6f 20 72 75 6e 20 69 74   ┆ by hand, you may want to run it┆
0x0b60…0b80 20 6f 6e 63 65 20 77 69 74 68 0a 20 20 20 20 20 74 68 65 20 64 72 69 76 65 72 20 75 73 69 6e 67   ┆ once with      the driver using┆
0x0b80…0ba0 20 74 68 65 20 2d 08 2d 08 2d 08 2d 76 08 76 08 76 08 76 20 66 6c 61 67 20 6f 6e 20 61 20 73 69   ┆ the - - - -v v v v flag on a si┆
0x0ba0…0bc0 6d 70 6c 65 20 70 72 6f 67 72 61 6d 2e 20 20 54 68 69 73 20 77 69 6c 6c 0a 20 20 20 20 20 65 6e   ┆mple program.  This will      en┆
0x0bc0…0be0 61 62 6c 65 20 79 6f 75 20 74 6f 20 73 65 65 20 74 68 65 20 65 78 61 63 74 20 70 61 73 73 65 73   ┆able you to see the exact passes┆
0x0be0…0c00 20 61 6e 64 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 0a 20 20 20 20 20 69 6e 76 6f 6c 76 65 64   ┆ and the arguments      involved┆
0x0c00…0c20 20 69 6e 20 75 73 69 6e 67 20 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 72 08 72 08 72 08 72 64   ┆ in using c c c co o o or r r rd┆
0x0c20…0c40 08 64 08 64 08 64 2e 0a 0a 20 20 20 20 20 5f 08 4f 5f 08 62 5f 08 6a 20 69 73 20 61 6e 20 65 78   ┆ d d d.       _ O_ b_ j is an ex┆
0x0c40…0c60 65 63 75 74 61 62 6c 65 20 6f 62 6a 65 63 74 20 66 69 6c 65 20 77 69 74 68 20 69 74 73 20 72 65   ┆ecutable object file with its re┆
0x0c60…0c80 6c 6f 63 61 74 69 6f 6e 20 69 6e 66 6f 72 2d 0a 20 20 20 20 20 6d 61 74 69 6f 6e 20 69 6e 74 61   ┆location infor-      mation inta┆
0x0c80…0ca0 63 74 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 61 63 68 69 65 76 65 64 20 62 79 20 70 61 73 73   ┆ct. This can be achieved by pass┆
0x0ca0…0cc0 69 6e 67 20 74 68 65 20 2d 5f 08 72 20 2d 5f 08 7a 20 2d 5f 08 64 0a 20 20 20 20 20 6f 70 74 69   ┆ing the -_ r -_ z -_ d      opti┆
0x0cc0…0ce0 6f 6e 73 20 74 6f 20 74 68 65 20 6c 69 6e 6b 65 72 2c 20 5f 08 6c 5f 08 64 28 5f 08 31 29 2e 20   ┆ons to the linker, _ l_ d(_ 1). ┆
0x0ce0…0d00 20 54 68 65 20 6c 69 6e 6b 65 72 20 6f 70 74 69 6f 6e 20 2d 5f 08 72 20 6d 61 69 6e 2d 0a 20 20   ┆ The linker option -_ r main-   ┆
0x0d00…0d20 20 20 20 74 61 69 6e 73 20 72 65 6c 6f 63 61 74 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20   ┆   tains relocation information ┆
0x0d20…0d40 69 6e 20 74 68 65 20 6f 62 6a 65 63 74 20 66 69 6c 65 2c 20 62 75 74 20 77 69 6c 6c 0a 20 20 20   ┆in the object file, but will    ┆
0x0d40…0d60 20 20 6e 6f 74 20 6d 61 6b 65 20 69 74 20 61 20 5f 08 5a 5f 08 4d 5f 08 41 5f 08 47 5f 08 49 5f   ┆  not make it a _ Z_ M_ A_ G_ I_┆
0x0d60…0d80 08 43 20 66 69 6c 65 20 28 68 65 6e 63 65 20 2d 5f 08 7a 29 2e 20 20 49 74 20 61 6c 73 6f 20 77   ┆ C file (hence -_ z).  It also w┆
0x0d80…0da0 69 6c 6c 20 6e 6f 74 0a 20 20 20 20 20 61 6c 6c 6f 63 61 74 65 20 63 6f 6d 6d 6f 6e 20 76 61 72   ┆ill not      allocate common var┆
0x0da0…0dc0 69 61 62 6c 65 73 20 28 68 65 6e 63 65 20 2d 5f 08 64 29 20 61 73 20 69 74 20 77 6f 75 6c 64 20   ┆iables (hence -_ d) as it would ┆
0x0dc0…0de0 77 69 74 68 6f 75 74 20 74 68 65 0a 20 20 20 20 20 6f 70 74 69 6f 6e 2e 0a 0a 0a 0a 0a 0a 0a 0a   ┆without the      option.        ┆
0x0de0…0e00 0a 20 20 20 20 20 57 08 57 08 57 08 57 41 08 41 08 41 08 41 52 08 52 08 52 08 52 4e 08 4e 08 4e   ┆      W W W WA A A AR R R RN N N┆
0x0e00…0e20 08 4e 49 08 49 08 49 08 49 4e 08 4e 08 4e 08 4e 47 08 47 08 47 08 47 3a 08 3a 08 3a 08 3a 20 53   ┆ NI I I IN N N NG G G G: : : : S┆
0x0e20…0e40 69 6e 63 65 20 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 72 08 72 08 72 08 72 64 08 64 08 64 08   ┆ince c c c co o o or r r rd d d ┆
0x0e40…0e60 64 20 77 6f 72 6b 73 20 66 72 6f 6d 20 61 6e 20 69 6e 70 75 74 20 6c 69 73 74 20 6f 66 20 70 72   ┆d works from an input list of pr┆
0x0e60…0e80 6f 63 65 64 75 72 65 73 0a 20 20 20 20 20 67 65 6e 65 72 61 74 65 64 20 66 72 6f 6d 20 70 72 6f   ┆ocedures      generated from pro┆
0x0e80…0ea0 66 69 6c 65 20 6f 75 74 70 75 74 2c 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 20 62 69 6e 61 72   ┆file output, the resulting binar┆
0x0ea0…0ec0 79 20 69 73 20 64 61 74 61 0a 20 20 20 20 20 64 65 70 65 6e 64 65 6e 74 2e 20 20 49 6e 20 6f 74   ┆y is data      dependent.  In ot┆
0x0ec0…0ee0 68 65 72 20 77 6f 72 64 73 2c 20 69 74 20 6d 61 79 20 6f 6e 6c 79 20 70 65 72 66 6f 72 6d 20 77   ┆her words, it may only perform w┆
0x0ee0…0f00 65 6c 6c 20 6f 6e 20 74 68 65 0a 20 20 20 20 20 73 61 6d 65 20 69 6e 70 75 74 20 64 61 74 61 20   ┆ell on the      same input data ┆
0x0f00…0f20 74 68 61 74 20 67 65 6e 65 72 61 74 65 64 20 74 68 65 20 70 72 6f 66 69 6c 65 20 69 6e 66 6f 72   ┆that generated the profile infor┆
0x0f20…0f40 6d 61 74 69 6f 6e 2c 20 61 6e 64 0a 20 20 20 20 20 6d 61 79 20 70 65 72 66 6f 72 6d 20 77 6f 72   ┆mation, and      may perform wor┆
0x0f40…0f60 73 65 20 74 68 61 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 62 69 6e 61 72 79 20 6f 6e 20 6f   ┆se than the original binary on o┆
0x0f60…0f80 74 68 65 72 20 64 61 74 61 2e 0a 20 20 20 20 20 46 75 72 74 68 65 72 6d 6f 72 65 2c 20 69 66 20   ┆ther data.      Furthermore, if ┆
0x0f80…0fa0 74 68 65 20 68 6f 74 20 61 72 65 61 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 64 6f 6e 27 74   ┆the hot areas in the cache don't┆
0x0fa0…0fc0 20 66 69 74 20 77 65 6c 6c 0a 20 20 20 20 20 69 6e 74 6f 20 6f 6e 65 20 63 61 63 68 65 70 61 67   ┆ fit well      into one cachepag┆
0x0fc0…0fe0 65 2c 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 63 61 6e 20 64 65 67 72 61 64 65 2e 0a 0a 20 20 20   ┆e, performance can degrade.     ┆
0x0fe0…1000 20 20 54 68 65 20 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 72 08 72 08 72 08 72 64 08 64 08 64   ┆  The c c c co o o or r r rd d d┆
0x1000…1020 08 64 20 63 6f 6d 6d 61 6e 64 20 61 63 63 65 70 74 73 20 74 68 65 73 65 20 6f 70 74 69 6f 6e 73   ┆ d command accepts these options┆
0x1020…1040 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 2d 08 2d 08 2d 08 2d 76 08 76 08 76 08 76 20 20 20 50 72   ┆:            - - - -v v v v   Pr┆
0x1040…1060 69 6e 74 20 76 65 72 62 6f 73 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 20 54 68 69 73 20 69   ┆int verbose information.  This i┆
0x1060…1080 6e 63 6c 75 64 65 73 20 6c 69 73 74 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74   ┆ncludes listing                t┆
0x1080…10a0 68 6f 73 65 20 70 72 6f 63 65 64 75 72 65 73 20 63 6f 6e 73 69 64 65 72 65 64 20 70 61 72 74 20   ┆hose procedures considered part ┆
0x10a0…10c0 6f 66 20 6f 74 68 65 72 20 70 72 6f 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 65 64   ┆of other pro-                ced┆
0x10c0…10e0 75 72 65 73 20 61 6e 64 20 63 61 6e 6e 6f 74 20 62 65 20 72 65 61 72 72 61 6e 67 65 64 20 28 74   ┆ures and cannot be rearranged (t┆
0x10e0…1100 68 65 73 65 20 61 72 65 20 62 61 73 69 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61   ┆hese are basi-                ca┆
0x1100…1120 6c 6c 79 20 61 73 73 65 6d 62 6c 65 72 20 70 72 6f 63 65 64 75 72 65 73 20 74 68 61 74 20 6d 61   ┆lly assembler procedures that ma┆
0x1120…1140 79 20 63 6f 6e 74 61 69 6e 20 72 65 6c 61 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74   ┆y contain rela-                t┆
0x1140…1160 69 76 65 20 62 72 61 6e 63 68 65 73 20 74 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 64 75 72 65 73   ┆ive branches to other procedures┆
0x1160…1180 20 72 61 74 68 65 72 20 74 68 61 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 6f   ┆ rather than                relo┆
0x1180…11a0 63 61 74 61 62 6c 65 20 6f 6e 65 73 29 2e 20 20 54 68 65 20 6c 69 73 74 69 6e 67 20 61 6c 73 6f   ┆catable ones).  The listing also┆
0x11a0…11c0 20 6c 69 73 74 73 20 74 68 6f 73 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 72 6f 63   ┆ lists those                proc┆
0x11c0…11e0 65 64 75 72 65 73 20 69 6e 20 74 68 65 20 66 6c 69 70 70 65 64 20 61 72 65 61 20 28 69 66 20 61   ┆edures in the flipped area (if a┆
0x11e0…1200 6e 79 29 20 61 6e 64 20 61 20 6d 61 70 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 69   ┆ny) and a map-                pi┆
0x1200…1220 6e 67 20 6f 66 20 6f 6c 64 20 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 6e 65 77 2e 0a 0a 20 20 20 20   ┆ng of old location to new.      ┆
0x1220…1240 20 20 20 20 20 20 2d 08 2d 08 2d 08 2d 66 08 66 08 66 08 66 20 20 20 46 6c 69 70 20 74 68 65 20   ┆      - - - -f f f f   Flip the ┆
0x1240…1260 66 69 72 73 74 20 63 61 63 68 65 70 61 67 65 20 73 69 7a 65 20 70 72 6f 63 65 64 75 72 65 73 2e   ┆first cachepage size procedures.┆
0x1260…1280 20 20 54 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 73 73 75 6d 70 74 69 6f 6e 20   ┆  The                assumption ┆
0x1280…12a0 77 68 65 6e 20 63 6f 72 64 20 77 61 73 20 77 72 69 74 74 65 6e 20 77 61 73 20 74 68 61 74 20 70   ┆when cord was written was that p┆
0x12a0…12c0 72 6f 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 65 64 75 72 65 73 20 77 6f 75 6c 64   ┆ro-                cedures would┆
0x12c0…12e0 20 62 65 20 72 65 6f 72 64 65 72 65 64 20 62 79 20 70 72 6f 63 65 64 75 72 65 20 64 65 6e 73 69   ┆ be reordered by procedure densi┆
0x12e0…1300 74 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 79 63 6c 65 73 2f 62 79 74 65 29 2e   ┆ty                (cycles/byte).┆
0x1300…1320 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 74 68 65 20 64   ┆  This option ensures that the d┆
0x1320…1340 65 6e 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 65 73 74 20 70 61 72 74 20 6f 66 20   ┆en-                sest part of ┆
0x1340…1360 65 61 63 68 20 70 61 67 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 66 69 72 73 74 0a 20 20   ┆each page following the first   ┆
0x1360…1380 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 63 68 65 70 61 67 65 20 77 6f 75 6c 64 20 63 6f 6e   ┆             cachepage would con┆
0x1380…13a0 66 6c 69 63 74 20 77 69 74 68 20 74 68 65 20 6c 65 61 73 74 2d 64 65 6e 73 65 20 70 61 72 74 0a   ┆flict with the least-dense part ┆
0x13a0…13c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 63 61 63 68   ┆               of the first cach┆
0x13c0…13e0 65 70 61 67 65 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 2d 08 2d 08 2d 08 2d 63 08 63 08 63 08 63   ┆epage.            - - - -c c c c┆
0x13e0…1400 20 63 08 63 08 63 08 63 61 08 61 08 61 08 61 63 08 63 08 63 08 63 68 08 68 08 68 08 68 65 08 65   ┆ c c c ca a a ac c c ch h h he e┆
0x1400…1420 08 65 08 65 73 08 73 08 73 08 73 69 08 69 08 69 08 69 7a 08 7a 08 7a 08 7a 65 08 65 08 65 08 65   ┆ e es s s si i i iz z z ze e e e┆
0x1420…1440 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 70 65 63 69 66 79 20 74 68 65 20 63 61 63 68   ┆                Specify the cach┆
0x1440…1460 65 73 69 7a 65 20 28 69 6e 20 62 79 74 65 73 29 20 6f 66 20 74 68 65 20 6d 61 63 68 69 6e 65 20   ┆esize (in bytes) of the machine ┆
0x1460…1480 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 68 69 63 68 20 79 6f 75 20 77 61 6e 74   ┆on                which you want┆
0x1480…14a0 20 74 6f 20 65 78 65 63 75 74 65 2e 20 20 54 68 69 73 20 6f 6e 6c 79 20 61 66 66 65 63 74 73 20   ┆ to execute.  This only affects ┆
0x14a0…14c0 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 08 2d 08 2d 08 2d 66 08 66 08 66 08   ┆the                - - - -f f f ┆
0x14c0…14e0 66 20 6f 70 74 69 6f 6e 2e 20 20 49 66 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 2c 20 36 35 35   ┆f option.  If not specified, 655┆
0x14e0…1500 33 36 20 69 73 20 75 73 65 64 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 2d 08 2d 08 2d 08 2d 6f 08   ┆36 is used.            - - - -o ┆
0x1500…1520 6f 08 6f 08 6f 20 6f 08 6f 08 6f 08 6f 75 08 75 08 75 08 75 74 08 74 08 74 08 74 70 08 70 08 70   ┆o o o o o o ou u u ut t t tp p p┆
0x1520…1540 08 70 75 08 75 08 75 08 75 74 08 74 08 74 08 74 66 08 66 08 66 08 66 69 08 69 08 69 08 69 6c 08   ┆ pu u u ut t t tf f f fi i i il ┆
0x1540…1560 6c 08 6c 08 6c 65 08 65 08 65 08 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 70 65 63   ┆l l le e e e                Spec┆
0x1560…1580 69 66 69 65 73 20 74 68 65 20 6f 75 74 70 75 74 20 66 69 6c 65 2e 20 49 66 20 6e 6f 74 20 73 70   ┆ifies the output file. If not sp┆
0x1580…15a0 65 63 69 66 69 65 64 2c 20 5f 08 61 2e 5f 08 6f 5f 08 75 5f 08 74 0a 20 20 20 20 20 20 20 20 20   ┆ecified, _ a._ o_ u_ t          ┆
0x15a0…15c0 20 20 20 20 20 20 69 73 20 75 73 65 64 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 2d 08 2d 08 2d 08   ┆      is used.            - - - ┆
0x15c0…15e0 2d 70 08 70 08 70 08 70 20 70 08 70 08 70 08 70 68 08 68 08 68 08 68 61 08 61 08 61 08 61 73 08   ┆-p p p p p p p ph h h ha a a as ┆
0x15e0…1600 73 08 73 08 73 65 08 65 08 65 08 65 6d 08 6d 08 6d 08 6d 61 08 61 08 61 08 61 78 08 78 08 78 08   ┆s s se e e em m m ma a a ax x x ┆
0x1600…1620 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 6d   ┆x                specifies the m┆
0x1620…1640 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 70 68 61 73 65 73 20 61 6c 6c 6f 77 65 64 2e 20 54 68   ┆aximum number phases allowed. Th┆
0x1640…1660 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 66 61 75 6c 74 20 69 73 20 32 30 2e 0a   ┆e                default is 20. ┆
0x1660…1680 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08 45 08 45 20 41 08 41 08 41 08 41 4c 08   ┆ S S S SE E E EE E E E A A A AL ┆
0x1680…16a0 4c 08 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20 55 73 65 72 20 43 6f   ┆L L LS S S SO O O O      User Co┆
0x16a0…16c0 6d 6d 61 6e 64 73 20 28 31 29 3a 20 70 72 6f 66 2c 20 66 74 6f 63 2c 20 63 63 2c 20 6c 64 0a 20   ┆mmands (1): prof, ftoc, cc, ld  ┆
0x16c0…16e0 20 20 20 20 54 08 54 08 54 08 54 58 08 58 08 58 08 58 20 50 08 50 08 50 08 50 72 08 72 08 72 08   ┆    T T T TX X X X P P P Pr r r ┆
0x16e0…1700 72 6f 08 6f 08 6f 08 6f 67 08 67 08 67 08 67 72 08 72 08 72 08 72 61 08 61 08 61 08 61 6d 08 6d   ┆ro o o og g g gr r r ra a a am m┆
0x1700…1720 08 6d 08 6d 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 72 08 72 08 72 08 72 27 08 27 08 27 08 27   ┆ m mm m m me e e er r r r' ' ' '┆
0x1720…1740 73 08 73 08 73 08 73 20 47 08 47 08 47 08 47 75 08 75 08 75 08 75 69 08 69 08 69 08 69 64 08 64   ┆s s s s G G G Gu u u ui i i id d┆
0x1740…1760 08 64 08 64 65 08 65 08 65 08 65 0a 0a 4d 61 72 63 68 20 31 39 38 39 20 20 20 20 20 20 20 20 20   ┆ d de e e e  March 1989         ┆
0x1760…1780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 58 20 55 73   ┆                           TX Us┆
0x1780…179e 65 72 27 73 20 52 65 66 65 72 65 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a         ┆er's Reference                ┆