source.html 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>Source Code</title>
  5. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  6. <meta charset="utf-8">
  7. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  8. <meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1">
  9. <meta name="description" content="GoAhead web server">
  10. <link href='https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700|Open+Sans:300italic,400,300,700' rel='stylesheet' type='text/css'>
  11. <link href='https://fonts.googleapis.com/css?family=Julius+Sans+One' rel='stylesheet' type='text/css'>
  12. <link href="../images/favicon.ico" rel="shortcut icon">
  13. <link href="../lib/semantic-ui/semantic.min.css" rel="stylesheet" type="text/css">
  14. <link href="../css/all.min.css" rel="stylesheet" type="text/css">
  15. <link href="../css/api.min.css" rel="stylesheet" type="text/css">
  16. </head>
  17. <body class="show-sidebar">
  18. <div class="sidebar">
  19. <div class="ui large left vertical inverted labeled menu">
  20. <div class="item">
  21. <a href="../" class="logo">GoAhead Docs</a>
  22. </div>
  23. <div class="item">
  24. <a href="../">
  25. <b>General</b>
  26. </a>
  27. <div class="menu">
  28. <a class="item" href="../">GoAhead Overview</a>
  29. <a class="item" href="../users/features.html">GoAhead Features</a>
  30. <a class="item" href="https://embedthis.com/goahead/download.html">Download</a>
  31. <a class="item" href="../licensing/">Licensing</a>
  32. </div>
  33. </div>
  34. <div class="item">
  35. <a href="../start/">
  36. <b>Getting Started</b>
  37. </a>
  38. <div class="menu">
  39. <a class="item" href="../start/quick.html">Quick Start</a>
  40. <a class="item" href="../start/installing.html">Installing GoAhead</a>
  41. <a class="item" href="../start/running.html">Running GoAhead</a>
  42. <a class="item" href="../start/releaseNotes.html">Release Notes</a>
  43. <a class="item" href="../start/faq.html">GoAhead FAQ</a>
  44. <a class="item" href="../start/source.html">Building from Source</a>
  45. </div>
  46. </div>
  47. <div class="item">
  48. <a href="../users/"><b>User's Guide</b></a>
  49. <div class="menu">
  50. <a class="item" href="../users/ports.html">Ports and Binding</a>
  51. <a class="item" href="../users/routing.html">Routing Requests</a>
  52. <a class="item" href="../users/handlers.html">Request Handlers</a>
  53. <a class="item" href="../users/js.html">Embedded Javascript</a>
  54. <a class="item" href="../users/jst.html">Javascript Templates</a>
  55. <a class="item" href="../users/goactions.html">GoActions</a>
  56. <a class="item" href="../users/cgi.html">CGI Programs</a>
  57. <a class="item" href="../users/authentication.html">User Authentication</a>
  58. <a class="item" href="../users/logFiles.html">Log Files</a>
  59. <a class="item" href="../users/ssl.html">Secure Sockets (SSL)</a>
  60. <a class="item" href="../users/security.html">Security Considerations</a>
  61. <a class="item" href="../users/man.html">Man Pages</a>
  62. </div>
  63. </div>
  64. <div class="item">
  65. <a href="../developers/">Developer's Guide</a>
  66. <div class="menu">
  67. <a class="item" href="../developers/embedding.html">Embedding GoAhead</a>
  68. <a class="item" href="../developers/handlers.html">Creating GoAhead Handlers</a>
  69. <a class="item" href="../developers/authstore.html">Creating Password Verifiers</a>
  70. <a class="item" href="../developers/migrating.html">Migrating to GoAhead 3/4</a>
  71. <a class="item" href="../developers/rom.html">Serving Pages from ROM</a>
  72. </div>
  73. </div>
  74. <div class="item">
  75. <a href="../ref/">Reference Guide</a>
  76. <div class="menu">
  77. <a class="item" href="../ref/compatibility.html">Compatibility</a>
  78. <a class="item" href="../ref/native.html">API Library</a>
  79. <a class="item" href="../ref/architecture.html">GoAhead Architecture</a>
  80. <a class="item" href="../standards/http.html">HTTP References</a>
  81. </div>
  82. </div>
  83. <div class="item">
  84. <a href="../developers/project.html">Project Resources</a>
  85. <div class="menu">
  86. <a class="item" href="https://embedthis.com/blog/categories/GoAhead/">GoAhead News</a>
  87. <a class="item" href="https://embedthis.com/goahead/">GoAhead Web Site</a>
  88. <a class="item" href="https://github.com/embedthis/goahead">Source Code Repository</a>
  89. <a class="item" href="https://github.com/embedthis/goahead/issues/99">GoAhead Security Alerts</a>
  90. <a class="item" href="https://github.com/embedthis/goahead/issues">Project Issue Database</a>
  91. <a class="item" href="https://github.com/embedthis/goahead/releases">Change Log</a>
  92. <a class="item" href="https://github.com/embedthis/goahead/milestones">Roadmap</a>
  93. <a class="item" href="https://embedthis.com/developers/contributors.html">Contributors Agreement</a>
  94. </div>
  95. </div>
  96. <div class="item">
  97. <b>Links</b>
  98. <div class="menu">
  99. <a class="item" href="https://embedthis.com/">Embedthis Web Site</a>
  100. <a class="item" href="https://embedthis.com/blog/">Embedthis Blog</a>
  101. <a class="item" href="http://twitter.com/embedthat">Twitter</a>
  102. </div>
  103. </div>
  104. </div>
  105. </div>
  106. <div class="ui inverted masthead">
  107. <div class="ui fixed inverted menu">
  108. <div class="ui sidebar-launch button">
  109. <i class="icon list layout"></i>
  110. </div>
  111. <div class="right menu">
  112. <a class="item" href="https://embedthis.com/">Embedthis</a>
  113. <a class="item" href="https://embedthis.com/goahead/">GoAhead Site</a>
  114. <span class="desktop-only">
  115. <a class="item" href="https://embedthis.com/blog/categories/GoAhead/">GoAhead News</a>
  116. <a class="item" href="https://github.com/embedthis/goahead">Repository</a>
  117. <a class="item" href="https://embedthis.com/blog/">Blog</a>
  118. <a class="item" href="https://twitter.com/embedthat">Twitter</a>
  119. </span>
  120. </div>
  121. </div>
  122. <div class="ui breadcrumb">
  123. <a class="section" href="../">Home</a>
  124. <div class="divider">/</div>
  125. <a class="section" href="../start/">
  126. Developer's Guide
  127. </a>
  128. <div class="divider">/</div>
  129. <a class="active section" href="source.html">Source Code</a>
  130. </div>
  131. <iframe class="version desktop-only" src="../version.html"></iframe>
  132. </div>
  133. <div class="content">
  134. <h1>Working with the GoAhead Source Code</h1>
  135. <p>GoAhead releases are available as source code distributions. Several build environments are supported:</p>
  136. <ul>
  137. <li>Linux — Linux 3 with GNU C/C++ or later</li>
  138. <li>Windows — Microsoft Windows 7 with Visual Studio 2017 or later</li>
  139. <li>Mac OS X — Mac OS X 10.11 (Yosemite) or later</li>
  140. </ul>
  141. <p>The source code has been designed to run on FreeBSD, Linux, Mac OS X, VxWorks and other operating systems. It has been tested under Fedora and Ubuntu Linux based on the Linux 3 Kernel, Microsoft Windows 7, 8 (32 and 64-bit), VxWorks 6.X and MAC OS X 10.11. </p>
  142. <p>GoAhead releases include all the required source files, headers, tools, and test framework to reconfigure, build, and verify GoAhead. The software supports three tools for building from source.
  143. <ul>
  144. <li>Make</li>
  145. <li><a href="https://embedthis.com/makeme/">MakeMe</a></li>
  146. <li>Visual Studio or Xcode projects</li>
  147. </ul>
  148. <p>Building via <em>make</em> is the simplest and quickest way to build. Use <em>make</em> if you want a default build or if you need to integrate GoAhead with an existing make-based build system. Build with <a href="https://embedthis.com/makeme/">MakeMe</a> if you want to customize or configure the software for your system, or if you need to cross-compile for another operating system or architecture. Use the IDE projects for Visual Studio or Xcode if you are most comfortable with these tools and want a default build.</p>
  149. <h3>Preferred Approach</h3>
  150. <p>We use the MakeMe tool internally for building and to generate the Makefiles, MakeMe and IDE projects. This cool tool generates clean, efficient makefiles and projects. The MakeMe project documents how to configure these generated Makefiles and projects on the MakeMe site. For full details, read on, courtesy of MakeMe:</p>
  151. <a class="ui green large right labeled icon button" href="https://embedthis.com/makeme/doc/source/">
  152. <i class="right long arrow icon"></i>Building from Source
  153. </a>
  154. <a id="get"></a>
  155. <h2>Accessing the Source Code</h2>
  156. <p>With each GoAhead release, a complete source code snapshot is provided. You can get the latest source code from the <a href="https://embedthis.com/goahead/download.html">download</a> site or you can access the <a href="https://github.com/embedthis/goahead">source code repository</a>.</p>
  157. <a id="repository"></a>
  158. <h3>Source Repository</h3>
  159. <p>The GoAhead source code is hosted in a Git repository. We provide open read-only access. Write access is available to regular contributing developers. To check out the source use this command:</p>
  160. <pre class="ui code segment">
  161. $ git clone http://github.com/embedthis/goahead
  162. </pre>
  163. <p>You can also view the repository at <a href="https://github.com/embedthis/goahead">https://github.com/embedthis/goahead</a>. This is also a convenient way to get the source code. Please use the <em>master</em> branch for the most recent stable snapshot. For daily builds, use the <em>dev</em> branch.</p>
  164. </div>
  165. <div class="terms ui basic center aligned segment">
  166. <p>&copy; Embedthis Software. All rights reserved.</p>
  167. </div>
  168. <script src="../lib/jquery/jquery.min.js"></script>
  169. <script src="../lib/semantic-ui/semantic.min.js"></script>
  170. <script src="../scripts/sidebar.min.js"></script>