123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285 |
- <!DOCTYPE html>
- <html lang="en">
- <head>
- <title>GoAhead FAQ</title>
- <!-- Copyright Embedthis Software. All Rights Reserved. -->
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
- <meta charset="utf-8" />
- <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
- <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0">
- <meta name="description" content="Simple, fast, secure embedded web server" />
- <link href='https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700|Open+Sans:300italic,400,300,700'
- rel='stylesheet' type='text/css'>
- <link href='https://fonts.googleapis.com/css?family=Julius+Sans+One' rel='stylesheet' type='text/css'>
-
- <link href="../images/favicon.ico" rel="shortcut icon" />
- <link href="../lib/semantic-ui/semantic.min.css" rel="stylesheet" type="text/css" />
- <link href="../css/all.min.css" rel="stylesheet" type="text/css" />
- <link href="../css/api.min.css" rel="stylesheet" type="text/css" />
-
- </head>
- <body class="show-sidebar">
- <div class="sidebar">
- <div class="ui large left vertical inverted labeled menu">
- <div class="item">
- <a href="../" class="logo">GoAhead Docs</a>
- </div>
- <div class="item">
- <a href="../">
- <b>General</b>
- </a>
- <div class="menu">
- <a class="item" href="../">GoAhead Overview</a>
- <a class="item" href="../users/features.html">GoAhead Features</a>
- <a class="item" href="https://embedthis.com/goahead/download.html">Download</a>
- <a class="item" href="../licensing/">Licensing</a>
- </div>
- </div>
- <div class="item">
- <a href="../start/">
- <b>Getting Started</b>
- </a>
- <div class="menu">
- <a class="item" href="../start/quick.html">Quick Start</a>
- <a class="item" href="../start/installing.html">Installing GoAhead</a>
- <a class="item" href="../start/running.html">Running GoAhead</a>
- <a class="item" href="../start/releaseNotes.html">Release Notes</a>
- <a class="item" href="../start/faq.html">GoAhead FAQ</a>
- <a class="item" href="../start/source.html">Building from Source</a>
- </div>
- </div>
- <div class="item">
- <a href="../users/"><b>User's Guide</b></a>
- <div class="menu">
- <a class="item" href="../users/ports.html">Ports and Binding</a>
- <a class="item" href="../users/routing.html">Routing Requests</a>
- <a class="item" href="../users/handlers.html">Request Handlers</a>
- <a class="item" href="../users/js.html">Embedded Javascript</a>
- <a class="item" href="../users/jst.html">Javascript Templates</a>
- <a class="item" href="../users/goactions.html">GoActions</a>
- <a class="item" href="../users/cgi.html">CGI Programs</a>
- <a class="item" href="../users/authentication.html">User Authentication</a>
- <a class="item" href="../users/logFiles.html">Log Files</a>
- <a class="item" href="../users/ssl.html">Secure Sockets (SSL)</a>
- <a class="item" href="../users/security.html">Security Considerations</a>
- <a class="item" href="../users/man.html">Man Pages</a>
- </div>
- </div>
- <div class="item">
- <a href="../developers/">Developer's Guide</a>
- <div class="menu">
- <a class="item" href="../developers/embedding.html">Embedding GoAhead</a>
- <a class="item" href="../developers/handlers.html">Creating GoAhead Handlers</a>
- <a class="item" href="../developers/authstore.html">Creating Password Verifiers</a>
- <a class="item" href="../developers/migrating.html">Migrating to GoAhead 3</a>
- <a class="item" href="../developers/rom.html">Serving Pages from ROM</a>
- </div>
- </div>
- <div class="item">
- <a href="../ref/">Reference Guide</a>
- <div class="menu">
- <a class="item" href="../ref/compatibility.html">Compatibility</a>
- <a class="item" href="../ref/native.html">API Library</a>
- <a class="item" href="../ref/architecture.html">GoAhead Architecture</a>
- <a class="item" href="../standards/http.html">HTTP References</a>
- </div>
- </div>
- <div class="item">
- <a href="../developers/project.html">Project Resources</a>
- <div class="menu">
- <a class="item" href="http://goo.gl/IGbiio">Official GoAhead News</a>
- <a class="item" href="https://embedthis.com/goahead/">GoAhead Web Site</a>
- <a class="item" href="https://github.com/embedthis/goahead">Source Code Repository</a>
- <a class="item" href="https://github.com/embedthis/goahead/issues/99">GoAhead Security Alerts</a>
- <a class="item" href="https://github.com/embedthis/goahead/issues">Project Issue Database</a>
- <a class="item" href="https://github.com/embedthis/goahead/releases">Change Log</a>
- <a class="item" href="https://github.com/embedthis/goahead/milestones">Roadmap</a>
- <a class="item" href="https://embedthis.com/developers/contributors.html">Contributors Agreement</a>
- </div>
- </div>
- <div class="item">
- <b>Links</b>
- <div class="menu">
- <a class="item" href="https://embedthis.com/">Embedthis Web Site</a>
- <a class="item" href="https://embedthis.com/blog/">Embedthis Blog</a>
- <a class="item" href="http://twitter.com/embedthat">Twitter</a>
- </div>
- </div>
- </div>
- </div>
- <div class="ui inverted masthead">
- <div class="ui fixed inverted menu">
- <div class="ui sidebar-launch button">
- <i class="icon list layout"></i>
- </div>
- <div class="right menu">
- <a class="item" href="https://embedthis.com/">Embedthis</a>
- <a class="item" href="https://embedthis.com/goahead/">GoAhead Site</a>
- <span class="desktop-only">
- <a class="item" href="http://goo.gl/9bL9rM">GoAhead News</a>
- <a class="item" href="https://github.com/embedthis/goahead">Repository</a>
- <a class="item" href="https://embedthis.com/blog/">Blog</a>
- <a class="item" href="https://twitter.com/embedthat">Twitter</a>
- </span>
- </div>
- </div>
-
- <div class="ui breadcrumb">
- <a class="section" href="../">Home</a>
-
- <div class="divider">/</div>
- <a class="section" href="../start/">
- Getting Started
- </a>
-
-
- <div class="divider">/</div>
- <a class="active section" href="faq.html">GoAhead FAQ</a>
-
- </div>
-
- <iframe class="version desktop-only" src="../version.html"></iframe>
- </div>
- <div class="content">
- <h1>GoAhead™ FAQ</h1>
- <p>If you don't find the answers you need here, please consult the <a href="../developers/project.html">Project Resources</a>
- and perhaps submit an issue/bug request on the <a href="https://github.com/embedthis/goahead/issues">GitHub repository</a>.</p>
- <a id="questions"></a>
- <div class="questions">
- <h3>General Questions</h3>
- <ul>
- <li><a href="#history">Why is Embedthis Software supporting and distributing the GoAhead WebServer?</a></li>
- <li><a href="#compare">How does the GoAhead WebServer compare with Appweb?</a></li>
- <li><a href="#runTimeModules">Can I disable features to minimize memory footprint at run-time?</a></li>
- <li><a href="#upload">How can I upload large files?</a></li>
- </ul>
- <h3>Building Questions</h3>
- <ul>
- <li><a href="#disableFeatures">When I build the source, can I disable features at compile
- time?</a></li>
- </ul>
- <h3>Diagnostic Questions</h3>
- <ul>
- <li><a href="#trace">How can I trouble-shoot with trace?</a></li>
- </ul>
- <h3>Embedded Questions</h3>
- <ul>
- <li><a href="#minimalFootprint">How small can I make GoAhead?</a></li>
- <li><a href="#cross">How can I cross compile?</a></li>
- </ul>
- <a id="answers"></a>
- <div class="answers">
- <h2>Answers</h2>
- <p class="question"><a id="history"></a>Why is Embedthis Software supporting and distributing
- the GoAhead WebServer?</p>
- <div class="answer">
- The GoAhead WebServer was originally written by Michael O'Brien, CEO of Embedthis and it remains a very
- popular to this day. With the acquisition of GoAhead by Oracle, Oracle asked Embedthis to support existing
- GoAhead WebServer customers and to offer commercial licenses for the GoAhead WebServer.
- </div>
- <a id="compare"></a>
- <p class="question">How does the GoAhead WebServer compare with Appweb?</p>
- <div class="answer">
- <p>The GoAhead WebServer is a simple, compact web server that has been widely ported to many embedded
- operating systems. Appweb is faster and more powerful — but requires more memory. If you need a very
- simple, low end web server and have little memory available, the GoAhead WebServer is ideal. If you need
- higher performance and extended security, then Appweb is the right choice.</p>
- </div>
- <a id="runTimeModules"></a>
- <p class="question">Can I disable features to minimize memory footprint at run-time?</p>
- <div class="answer">
- <p>Yes. GoAhead has build-time configuration settings to select required features and minimize
- memory footprint. See <a href="source.html">Building from Source</a> for details of
- the configuration options.</p>
- </div>
- <p class="question"><a id="upload"></a>How can I upload large files?</p>
- <div class="answer">
- <p>You need to increase the LimitRequestBody limit in the goahead.conf file. This imposes a maximum
- upload file size. Some samples have a MAX_FILE_SIZE input field in the HTML form. This however, is
- just a hint to the browser, and is only processed by some browsers.</p>
- </div>
- <p class="question"><a id="disableFeatures"></a>When I build from the source, can I
- disable features at compile time?</p>
- <div class="answer">
- <p>Yes. When GoAhead is built from source, a single bld.h header controls exactly what features and
- modules are built into the server. For example, if you don't require SSL support,
- and you wish to minimize memory footprint, you can run:</p>
- <code>./configure --without ssl</code>
- </div><a id="trace"></a>
- <p class="question">How can I trouble-shoot with trace?</p>
- <div class="answer">
- <p>Run goahead or winGoAhead with the logging switch "-l". The logging switch takes the following
- parameters:</p>
- <code>goahead -l logName[:logLevel][.maxSize]</code>
- <p>Where logLevel is a number between 0 and 9. Zero is the least verbose. To debug HTTP requests, a
- level of 6 provides the detail of all the request / response exchanges. MaxSize is the maximum size of
- the log file in MB. When the maximum size is exceeded, the log file will be rotated to logName.old and
- a new log file will be started.</p>
- </div>
- <p class="question"><a id="minimalFootprint"></a>How small can I make GoAhead?</p>
- <div class="answer">
- <p>GoAhead 3 has about 115K of code. For a minimal footprint on GoAhead, use:</p>
- <code>./configure --without all --set cgi=false --set javascript=false</code>
- <p>This will disable most features including CGI and Javascript but still provide a running web server.
- <p>Things to consider when building small:</p>
- <ul>
- <li>Disable all possible features. In particular, disable the CGI and Javascript handlers</li>
- <li>Don't build DEBUG. Use: <em>./configure -release</em></li>
- <li>Use a small C-Library such as uClibc on embedded Linux systems</li>
- </ul>
- </div>
- <p class="question"><a id="cross"></a>How can I cross compile?</p>
- <div class="answer">
- <p>The GoAhead configure command has switches to specify the <b>build</b> system and the target system
- that will <b>host</b> GoAhead. For example:</p>
- <code>./configure --platform vxworks-arm</code>
- <p>When cross compiling, you also need to tell configure about your cross-compilation tool chain. This
- means the names of your compiler, library archiver, and other utilities and flags. The configure program
- listens to the settings of the AR, CC, NM, RANLIB, STRIP, CFLAGS, IFLAGS and LDFLAGS environment
- variables and will pass their values into the build system. These will be used to define the
- cross-compilation tool chain. You can also specify an alternate build tool chain by using the same
- variables but with a BUILD_ prefix. For example:</p>
- <code>DIR=/path/to/cross-tools ; \
- AR=$DIR/bin/ar.exe \
- CC=$DIR/bin/cc.exe \
- LD=$DIR/bin/cc.exe \
- NM=$DIR/nm.exe \
- RANLIB=$DIR/ranlib.exe \
- STRIP=$DIR/strip.exe \
- CFLAGS="-I$DIR/include \
- ./configure --debug --platform linux-arm</code>
- <p>For more details, please read:
- <a href="https://embedthis.com/makeme/doc/users/cross.html">Cross-Compiling</a> in the MakeMe
- online documentation.</p>
- </div>
- </div>
- <h2>Need more help?</h2>
- <p>If you have any further questions, please consult the <a href="../developers/project.html">Project Resources</a>
- and perhaps submit an issue/bug request on the <a href="https://github.com/embedthis/goahead/issues">GitHub repository</a>.</p>
- </div>
- <div class="terms ui basic center aligned segment">
- <p>© Embedthis Software, 2003-2015. All rights reserved.</p>
- </div>
- <script src="../lib/jquery/jquery.min.js"></script>
- <script src="../lib/semantic-ui/semantic.min.js"></script>
- <script src="../scripts/sidebar.min.js"></script>
-
-
- </body>
- </html>
|