Changeset 4652 in CLRX


Ignore:
Timestamp:
Sep 21, 2018, 3:11:28 PM (4 weeks ago)
Author:
matszpk
Message:

CLRadeonExtender: Doc: Add sample usages for clrxasm and clrxdisasm. Some small updates in documentation.

Location:
CLRadeonExtender/trunk
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • CLRadeonExtender/trunk/doc/ClrxAsmInvoke.md

    r4404 r4652  
    151151it returns 1 and prints the error messages to stderr.
    152152
     153### Sample usage
     154
     155Following sample usages:
     156
     157* `clrxasm -o output.clo source.clrx`
     158
     159    Assemble source code 'source.clrx' to binary output 'output.clo'.
     160
     161* `clrxasm -bamdcl2 -6 -t240500 -o output.clo source.clrx`
     162
     163    Assemble source code 'source.clrx' to AMD OpenCL 2.0  binary format output 'output.clo' with
     16464-bits and for driver version 240500.
  • CLRadeonExtender/trunk/doc/ClrxDisasm.md

    r4418 r4652  
    99structure of the binaries (kernels and their configuration). Output of that program
    1010can be used as input to the CLRX assembler if option '--all' will be used.
     11
     12A disassembler can detect automatically binary format, bitness of the binary.
    1113
    1214### Invoking a disassembler
     
    128130and prints the error messages to stderr
    129131   
    130 ### Sample usage
     132### Sample usages
    131133
    132 Below is sample usage of the `clrxdisasm`:
     134Following sample usages:
    133135
    134 ```
    135 clrxdisasm -a DCT.amd.0
    136 ```
     136* `clrxdisasm -aC source.clo`
     137
     138    Disassemble binary file source.clo. Print addresess, opcodes, metadata in human readable form.
     139
     140* `clrxdisasm -a source.clo`
     141
     142    Disassemble binary file source.clo. Print addresess, opcodes, metadata in machine readable form
     143(enough rarely used).
     144
     145* `clrxdisasm -aC -t240400 source.clo`
     146
     147    Disassemble binary file source.clo including AMD driver version 240400.
     148Print addresess, opcodes, metadata in human readable form.
     149
     150* `clrxdisasm -aCHL -t240400 source.clo`
     151
     152    Disassemble binary file AMD OpenCL 2.0 source.clo including AMD driver version 240400 in
     153new HSA layout form (like ROCm).
     154Print addresess, opcodes, metadata in human readable HSA config form.
     155
     156* `clrxdisasm -aC -gBonaire source.clo`
     157
     158    Disassemble binary file source.clo for Bonaire GPU device. It can be used while
     159disassemblying GalliumCompute binaries. Print addresess, opcodes, metadata in human readable form.
     160
     161* `clrxdisasm -aC -t170000 --llvmVersion=40000 -gBonaire source.clo`
     162
     163    Disassemble new GalliumCompute (for new MesaOpenCL 17.0.0 or later and LLVM 4.0.0 or later)
     164binary file source.clo for Bonaire GPU device.
     165Print addresess, opcodes, metadata in human readable form.
  • CLRadeonExtender/trunk/programs/clrxasm.pod

    r4404 r4652  
    154154=back
    155155
     156=head1 SAMPLE USAGE
     157
     158Following sample usages:
     159
     160=over 8
     161
     162=item clrxasm -o output.clo source.clrx
     163
     164Assemble source code 'source.clrx' to binary output 'output.clo'.
     165
     166=item clrxasm -bamdcl2 -6 -t240500 -o output.clo source.clrx
     167
     168Assemble source code 'source.clrx' to AMD OpenCL 2.0  binary format output 'output.clo' with
     16964-bits and for driver version 240500.
     170
     171=back
     172
    156173=head1 RETURN VALUE
    157174
  • CLRadeonExtender/trunk/programs/clrxdisasm.pod

    r4418 r4652  
    2222structure of the binaries (kernels and their configuration). Output of that program
    2323can be used as input to the CLRX assembler if option '--all' will be used.
     24
     25A disassembler can detect automatically binary format, bitness of the binary.
    2426
    2527=head1 OPTIONS
     
    128130=back
    129131
     132=head1 SAMPLE USAGE
     133
     134Following sample usages:
     135
     136=over 8
     137
     138=item clrxdisasm -aC source.clo
     139
     140Disassemble binary file source.clo. Print addresess, opcodes, metadata in human readable form.
     141
     142=item clrxdisasm -a source.clo
     143
     144Disassemble binary file source.clo. Print addresess, opcodes, metadata in machine readable form
     145(enough rarely used).
     146
     147=item clrxdisasm -aC -t240400 source.clo
     148
     149Disassemble binary file source.clo including AMD driver version 240400.
     150Print addresess, opcodes, metadata in human readable form.
     151
     152=item clrxdisasm -aCHL -t240400 source.clo
     153
     154Disassemble binary file AMD OpenCL 2.0 source.clo including AMD driver version 240400 in
     155new HSA layout form (like ROCm).
     156Print addresess, opcodes, metadata in human readable HSA config form.
     157
     158=item clrxdisasm -aC -gBonaire source.clo
     159
     160Disassemble binary file source.clo for Bonaire GPU device. It can be used while
     161disassemblying GalliumCompute binaries. Print addresess, opcodes, metadata in human readable form.
     162
     163=item clrxdisasm -aC -t170000 --llvmVersion=40000 -gBonaire source.clo
     164
     165Disassemble new GalliumCompute (for new MesaOpenCL 17.0.0 or later and LLVM 4.0.0 or later)
     166binary file source.clo for Bonaire GPU device.
     167Print addresess, opcodes, metadata in human readable form.
     168
     169=back
     170
    130171=head1 RETURN VALUE
    131172
Note: See TracChangeset for help on using the changeset viewer.