logo

blog

My website can't be that messy, right? git clone https://anongit.hacktivis.me/git/blog.git/

buildsystems-conventions.shtml (3756B)

    

  1. <!DOCTYPE html>
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. 	<head>
  4. <!--#include file="/templates/head.shtml" -->
  5. 		<title>Buildsystems Conventions — lanodan’s cyber-home</title>
  6. 	</head>
  7. 	<body>
  8. <!--#include file="/templates/en/nav.shtml" -->
  9. 		<main class="section-count">
  10. 			<h1>Buildsystems Conventions</h1>
  11. 			<p>
  12. 				This only contains the common bits accross buildsystems, not the ones specific to a particular buildsystem or particular project.
  13. 			</p>
  15. 			<h2>Environment variables</h2>
  16. 			<h3>POSIX</h3>
  17. 			<dl>
  18. 				<dt><var>CC</var></dt>
  19. 				<dd>Command/path to target C Compiler</dd>
  20. 				<dt><var>CFLAGS</var></dt>
  21. 				<dd>
  22. 					Flags passed to target C Compiler.<br />
  23. 					Should not be expected to contain values such as <code>-std=c99</code>.
  24. 				</dd>
  25. 				<dt><var>LDFLAGS</var></dt>
  26. 				<dd>Linking flags passed to target Compiler</dd>
  28. 				<dt><var>YACC</var></dt>
  29. 				<dd>Command/path to <code>yacc(1)</code></dd>
  30. 				<dt><var>YFLAGS</var></dt>
  31. 				<dd>Flags passed to <code>yacc(1)</code></dd>
  33. 				<dt><var>LEX</var></dt>
  34. 				<dd>Command/path to <code>lex(1)</code></dd>
  35. 				<dt><var>LFLAGS</var></dt>
  36. 				<dd>Flags passed to <code>lex(1)</code></dd>
  38. 				<dt><var>AR</var></dt>
  39. 				<dd>Command/path to <code>ar(1)</code></dd>
  40. 				<dt><var>ARFLAGS</var></dt>
  41. 				<dd>
  42. 					Flags passed to <code>ar(1)</code>.<br />
  43. 					Default for <code>make(1)</code> specified as <code>-rv</code> by POSIX.1-2008.
  44. 				</dd>
  46. 				<dt><var>FC</var></dt>
  47. 				<dd>Command/path to target Fortran Compiler</dd>
  48. 				<dt><var>FFLAGS</var></dt>
  49. 				<dd>Flags passed to target Fortran Compiler</dd>
  50. 			</dl>
  52. 			<h3>Widespread but nor formally specified</h3>
  53. 			<dl>
  54. 				<dt><var>RANLIB</var></dt>
  55. 				<dd>
  56. 					Command/path to <code>ranlib(1)</code>.<br />
  57. 					Usually not needed anymore due to modern <code>ar(1)</code> implementations maintaining their index.
  58. 				</dd>
  60. 				<!-- Linux Kernel -->
  61. 				<dt><var>CROSS_COMPILE</var></dt>
  62. 				<dd>
  63. 					Command prefix before default values of target-specific commands like <var>CC</var>, <var>AR</var>, <var>FC</var>, <var>RANLIB</var>, …<br />
  64. 					For example it can be set to <samp><code>CROSS_COMPILE=x86_64-pc-linux-musl-</code></samp>
  65. 				</dd>
  67. 				<!-- Linux Kernel, onetrueawk, ... -->
  68. 				<dt><var>HOSTCC</var></dt>
  69. 				<dd>Command/path to build host C Compiler</dd>
  70. 				<dt><var>HOSTCCFLAGS</var></dt>
  71. 				<dd>Flags passed to build host C Compiler</dd>
  73. 				<!-- Linux Kernel -->
  74. 				<dt><var>CXX</var></dt>
  75. 				<dd>Command/path to target C++ Compiler</dd>
  76. 				<dt><var>HOSTCXX</var></dt>
  77. 				<dd>Command/path to build host C++ Compiler</dd>
  78. 				<dt><var>HOSTCXXFLAGS</var></dt>
  79. 				<dd>Flags passed to build host C++ Compiler</dd>
  81. 				<!-- mksh, own projects -->
  82. 				<dt><var>LDSTATIC</var></dt>
  83. 				<dd>
  84. 					Flag(s) to enable static linking passed to target compiler when building executables.<br />
  85. 					For example <samp><code>LDSTATIC=-static</code></samp>
  86. 				</dd>
  88. 				<!-- pretty much all makefiles -->
  89. 				<dt><var>PREFIX</var></dt>
  90. 				<dd>Common prefix for installation directories, typically defaulting to <code>/usr/local</code></dd>
  91. 				<dt><var>BINDIR</var></dt>
  92. 				<dd>Installation directory for executables, typically defaulting to <code>${PREFIX}/bin</code></dd>
  93. 				<dt><var>MANDIR</var></dt>
  94. 				<dd>Installation directory for manpages, typically defaulting to <code>${PREFIX}/share/man</code></dd>
  96. 				<!-- pretty much all makefiles -->
  97. 				<dt><var>DESTDIR</var></dt>
  98. 				<dd>
  99. 					Sets the destination directory for installation into a different root,
  100. 					for example a temporary installation directory later copied into
  101. 					a distro package or the <code>/</code>
  102. 				</dd>
  103. 			</dl>
  104. 		</main>
  105. <!--#include file="/templates/en/footer.shtml" -->
  106. 	</body>
  107. </html>