goahead.txt 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. GOAHEAD(1) User Commands GOAHEAD(1)
  2. NAME
  3. goahead- Embedded HTTP Web Server
  4. SYNOPSIS
  5. goahead [options] [documents] [[IP][:port] ...]
  6. goahead
  7. --auth authFile
  8. --background
  9. --debugger
  10. --home directory
  11. --log logSpec
  12. --route routeFile
  13. --version
  14. --verbose
  15. [IP][:port] [documents]
  16. DESCRIPTION
  17. GoAhead is popular, simple embedded HTTP web server. It is a fast,
  18. small-footprint, single-threaded, standards-based, portable server
  19. developed for use by embedded devices and applications. It can run as
  20. a stand-alone web server or the GoAhead library can be embedded in
  21. applications.
  22. GoAhead supports HTTP/1.1, SSL, digest, basic and web-form authentica-
  23. tion, chunked transfers, file upload and sandbox security limits.
  24. When goahead is built, it is configured to open a port for HTTP
  25. requests and optionally one for SSL. However, if goahead is invoked
  26. with an IP address or port number on the command line, GoAhead will
  27. listen on these ports instead. If the PORT component is omitted, GoA-
  28. head will listen on port 80. If the IP address is omitted and a port is
  29. supplied, GoAhead will listen on all network interfaces.
  30. OPTIONS
  31. --auth filename
  32. Define the name of the authentication configuration file. This
  33. is by default auth.txt. If GoAhead is built with PAM support
  34. (Unix Pluggable Authentication Modules), then passwords will be
  35. authenticated from the system password database.
  36. --debugger
  37. Run GoAhead in debug mode and disable all timeouts. This dis-
  38. ables request and session timeouts. The -d option is an alias
  39. for --debugger.
  40. --log logSpec
  41. Name the GoAhead log file. This will override the ErrorLog
  42. directive in the configuration file. When the maximum size is
  43. exceeded, the log file will be rotated to logName.old and a new
  44. log file will be started. The -l option is an alias for --log.
  45. The syntax is:
  46. --log logName[:logLevel][.maxSize]
  47. --home directory
  48. Define the server home directory for GoAhead.
  49. --route routeFile
  50. This option overrides the default route configuration file name
  51. of "route.txt". When GoAhead starts, it reads the route configu-
  52. ration file to load URI routes. These routes define what actions
  53. should be taken when various client requests are received.
  54. --verbose
  55. Shorthand for --log stdout:4. The -v option is an alias for
  56. --verbose.
  57. --version
  58. Output the product version number.
  59. REPORTING BUGS
  60. Report bugs to <dev@embedthis.com>.
  61. COPYRIGHT
  62. Copyright (C) Embedthis Software.
  63. SEE ALSO
  64. gopass, webcomp
  65. goahead March 2014 GOAHEAD(1)