CrossCore Embedded Studio 2.8.0 C/C++ Compiler Manual for ...

1 CCES C/C++ Compiler Manual for SHARC. Processors (Includes SHARC+ and ARM Processors). Revision , March 2018. Part Number 82-100117-01. analog devices , Inc. One Technology Way Norwood, MA 02062-9106. Copyright Information 2018 analog devices , Inc., ALL RIGHTS RESERVED. This document may not be reproduced in any form without prior, express written consent from analog devices , Inc. Printed in the USA. Disclaimer analog devices , Inc. reserves the right to change this product without prior notice. Information furnished by Ana- log devices is believed to be accurate and reliable. However, no responsibility is assumed by analog devices for its use; nor for any infringement of patents or other rights of third parties which may result from its use. No license is granted by implication or otherwise under the patent rights of analog devices , Inc.

2 Trademark and Service Mark Notice The analog devices logo, Blackfin, Blackin+, CrossCore , EngineerZone, EZ-Board, EZ-KIT, EZ-KIT Lite, EZ-Ex- tender, SHARC, SHARC+, and VisualDSP++ are registered trademarks of analog devices , Inc. EZ-KIT Mini is a trademark of analog devices , Inc. All other brand and product names are trademarks or service marks of their respective owners. CCES C/C++ Compiler Manual for SHARC Processors ii Contents Preface Purpose of This 1 1. Intended 1 1. Manual Contents .. 1 1. What's New in this Manual .. 1 2. Technical Support .. 1 2. Supported Processors .. 1 2. Product Information .. 1 3. analog devices 1 3. EngineerZone .. 1 3. Notation Conventions .. 1 3. Compiler C/C++ Compiler 2 2. Compiler Components .. 2 3. Compiler Command-Line 2 4. Running the 2 5. processor 2 7.

3 Compiler Command-Line Switches .. 2 9. C/C++ Mode Selection Switch 2 17. -c89 .. 2 18. -c99 .. 2 18. -c++ .. 2 18. -c++11 .. 2 18. -g++ .. 2 18. C/C++ Compiler Common Switch Descriptions .. 2 19. sourcefile .. 2 19. -@ 2 19. CCES C/C++ Compiler Manual for SHARC Processors iii -A name[tokens] .. 2 19. -absolute-path-dependencies .. 2 20. 2 20. -alttok .. 2 20. 2 21. -annotate .. 2 21. -annotate-loop-instr .. 2 21. -asms-safe-in-simd-for-loops .. 2 21. 2 21. -build-lib .. 2 22. 2 22. 2 22. -char-size[-8|-32] .. 2 22. 2 22. -component .. 2 22. -const-read-write .. 2 22. 2 23. -D macro[=definition].. 2 23. -dependency-add-target target .. 2 23. -double-size[-32|-64] .. 2 23. 2 23. -dry .. 2 24. -dryrun .. 2 24. 2 24. -ED .. 2 24. -EE .. 2 24. -eh .. 2 24. -enum-is-int .. 2 25. -extra-keywords.

4 2 25. 2 25. -file-attr name[=value] .. 2 25. iv CCES C/C++ Compiler Manual for SHARC Processors -flags-{asm| Compiler |ipa|lib|link|mem|pr elink} switch[, switch2[, ..]] .. 2 25. -float-to-int .. 2 26. 2 26. -fp-associative .. 2 26. -full-version .. 2 26. -fx-contract .. 2 26. -fx-rounding-mode-biased .. 2 27. 2 27. -fx-rounding-mode-unbiased .. 2 27. 2 27. -glite .. 2 27. -gnu-style-dependencies .. 2 27. 2 28. -HH .. 2 28. -h[elp] .. 2 28. -I directory[{,|;} ] .. 2 28. -I- .. 2 29. 2 29. -include filename .. 2 29. -ipa .. 2 29. -L directory[{;|,} directory ] .. 2 29. -l library .. 2 29. -linear-simd .. 2 30. 2 30. -loop-simd .. 2 30. 2 30. -MD .. 2 30. -MM .. 2 31. -Mo filename .. 2 31. -Mt name .. 2 31. CCES C/C++ Compiler Manual for SHARC Processors v -map filename .. 2 31. -mem.

5 2 31. -multiline .. 2 31. -never-inline .. 2 31. 2 32. -no-alttok .. 2 32. -no-annotate .. 2 32. -no-annotate-loop-instr .. 2 32. -no-assume-vols-are-iops .. 2 32. 2 32. 2 33. -no-const-strings .. 2 33. -no-db .. 2 33. 2 33. -no-eh .. 2 33. -no-extra-keywords .. 2 33. -no-fp-associative .. 2 34. -no-fx-contract .. 2 34. -no-linear-simd .. 2 34. -no-loop-simd .. 2 34. 2 34. -no-mem .. 2 34. -no-multiline .. 2 34. -no-progress-rep-timeout .. 2 35. -no-rtcheck .. 2 35. 2 35. -no-rtcheck-div-zero .. 2 35. 2 35. -no-rtcheck-null-ptr .. 2 36. -no-rtcheck-shift-check .. 2 36. 2 36. 2 36. vi CCES C/C++ Compiler Manual for SHARC Processors 2 36. 2 37. 2 37. 2 37. 2 37. 2 37. 2 37. 2 38. 2 38. -no-workaround workaround_id[, workaround_id ] .. 2 38. 2 38. -nwc .. 2 38. -O[0|1] .. 2 38. -Oa .. 2 39.

6 -Os .. 2 39. -Ov num .. 2 39. -o 2 40. 2 40. -overlay-clobbers 2 40. 2 41. -PP .. 2 41. -p .. 2 41. -path-{ asm | Compiler | ipa | lib | link | prelink } 2 41. -path-install 2 41. -path-output directory .. 2 41. -path-temp directory .. 2 41. -pgo-session session-id .. 2 42. -pguide .. 2 42. -pplist filename .. 2 42. -proc processor .. 2 43. 2 43. CCES C/C++ Compiler Manual for SHARC Processors vii -progress-rep-func .. 2 43. 2 44. -progress-rep-timeout .. 2 44. -progress-rep-timeout-secs 2 44. -R directory[{:|,} directory ] .. 2 44. -R- .. 2 44. -reserve register[, register ] .. 2 44. -restrict-hardware-loops maximum .. 2 44. 2 45. 2 45. 2 46. -rtcheck-heap .. 2 46. 2 46. -rtcheck-shift-check .. 2 46. 2 47. 2 47. 2 47. 2 47. 2 47. 2 47. -sectionid=section_name[, id= ] .. 2 48. 2 49.

7 2 49. -si-revision version .. 2 49. 2 49. -structs-do-not-overlap .. 2 49. -swc .. 2 50. -syntax-only .. 2 50. 2 50. -T 2 50. 2 50. viii CCES C/C++ Compiler Manual for SHARC Processors 2 51. -U macro .. 2 51. -unsigned-bitfield .. 2 51. 2 51. 2 51. 2 52. -W{annotation|error|remark|suppress|warn } number[, number ..] .. 2 52. -Wannotations .. 2 52. -Werror-limit number .. 2 52. 2 52. -Wremarks .. 2 52. -Wterse .. 2 53. 2 53. -warn-component .. 2 53. -warn-protos .. 2 53. -workaround workaround_id[, workaround_id ] .. 2 53. -xref filename .. 2 53. C Mode (MISRA) Compiler Switch Descriptions .. 2 54. -misra .. 2 54. -misra-linkdir directory .. 2 54. 2 54. 2 54. -misra-strict .. 2 55. -misra-suppress-advisory .. 2 55. 2 55. -Wmis_suppress rule_number[, rule_number] .. 2 55. -Wmis_warn rule_number[, rule_number].

8 2 55. MISRA-C Command-Line Switch 2 55. C++ Mode Compiler Switch Descriptions .. 2 56. -anach .. 2 56. 2 56. CCES C/C++ Compiler Manual for SHARC Processors ix 2 57. -full-dependency-inclusion .. 2 57. 2 57. -no-anach .. 2 57. -no-friend-injection .. 2 57. -no-implicit-inclusion .. 2 58. 2 58. 2 58. 2 58. 2 58. Environment Variables Used by the Compiler .. 2 58. Data Type and Data Type Sizes .. 2 59. Integer Data Types .. 2 61. Floating-Point Data 2 61. Optimization 2 62. Optimization Levels .. 2 62. Interprocedural 2 63. Interaction With 2 64. Controlling Silicon Revision and Anomaly Workarounds Within the Compiler .. 2 64. Using the -si-revision Switch .. 2 65. Using the -workaround Switch .. 2 66. Using the -no-workaround Switch .. 2 66. Interactions Between the Silicon Revision and Workaround Switches.

9 2 66. Anomalies in Assembly Sources .. 2 67. Using 2 67. Building Byte-Addressed Applications From C/C++ .. 2 68. Data Formats and Calling Conventions .. 2 68. Sizes of Native Types .. 2 68. Endianness .. 2 69. Symbol Names .. 2 70. Byte-Addressed Memory Alias .. 2 70. x CCES C/C++ Compiler Manual for SHARC Processors Changes to Call-Preserved Registers .. 2 70. Mixed Char-Size 2 71. Building a Mixed Char-Size 2 71. How to Use Different Char Sizes 2 71. Type 2 72. Simple Interfaces .. 2 73. Constructing Complex Byte-Addressed and Word-Addressed Interfaces .. 2 74. The byte_addressed and word_addressed Keywords .. 2 74. Prohibited Constructs in Interface Regions .. 2 76. Using Sub-Word Types in Word-Addressed Code .. 2 77. Use of typedefs .. 2 77. Function Pointers .. 2 78. Using Byte-Addressed and Word-Addressed Interfaces with C++.

10 2 78. Assembly Code .. 2 79. Memory Alias Spaces Compared .. 2 79. Using Word-Addressed Assembly Code Within a Byte-Addressed Application .. 2 80. #pragma 2 81. Char-Size Agnostic Assembly Code .. 2 81. Defining Byte-Addressed Data in Assembly .. 2 82. Byte-Addressed C structs in Assembly .. 2 82. Using Native Fixed-Point Types .. 2 83. Fixed-Point Type 2 83. Native Fixed-Point 2 84. Native Fixed-Point Constants .. 2 85. A Motivating 2 85. Fixed-Point Arithmetic 2 85. Data Type Conversions and Fixed-Point 2 86. Bit-Pattern Conversion Functions: bitsfx and 2 87. Arithmetic Operators for Fixed-Point Types .. 2 87. 2 89. Rounding 2 90. CCES C/C++ Compiler Manual for SHARC Processors xi Arithmetic Library Functions .. 2 91. divifx .. 2 91. idivfx .. 2 92. fxdivi .. 2 92. 2 93. 2 94. roundfx.