libwebsockets.dox 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417
  1. # Doxyfile 1.8.11
  2. #---------------------------------------------------------------------------
  3. # Project related configuration options
  4. #---------------------------------------------------------------------------
  5. DOXYFILE_ENCODING = UTF-8
  6. PROJECT_NAME = "libwebsockets"
  7. PROJECT_NUMBER =
  8. PROJECT_BRIEF = "Lightweight C library for HTML5 websockets"
  9. PROJECT_LOGO = "./test-apps/libwebsockets.org-logo.svg"
  10. OUTPUT_DIRECTORY = "doc"
  11. CREATE_SUBDIRS = NO
  12. ALLOW_UNICODE_NAMES = NO
  13. OUTPUT_LANGUAGE = English
  14. BRIEF_MEMBER_DESC = YES
  15. REPEAT_BRIEF = YES
  16. ABBREVIATE_BRIEF =
  17. ALWAYS_DETAILED_SEC = NO
  18. INLINE_INHERITED_MEMB = NO
  19. FULL_PATH_NAMES = YES
  20. STRIP_FROM_PATH =
  21. STRIP_FROM_INC_PATH =
  22. SHORT_NAMES = NO
  23. JAVADOC_AUTOBRIEF = NO
  24. QT_AUTOBRIEF = NO
  25. MULTILINE_CPP_IS_BRIEF = NO
  26. INHERIT_DOCS = YES
  27. SEPARATE_MEMBER_PAGES = NO
  28. TAB_SIZE = 8
  29. ALIASES =
  30. TCL_SUBST =
  31. OPTIMIZE_OUTPUT_FOR_C = YES
  32. OPTIMIZE_OUTPUT_JAVA = NO
  33. OPTIMIZE_FOR_FORTRAN = NO
  34. OPTIMIZE_OUTPUT_VHDL = NO
  35. EXTENSION_MAPPING =
  36. MARKDOWN_SUPPORT = YES
  37. AUTOLINK_SUPPORT = YES
  38. BUILTIN_STL_SUPPORT = NO
  39. CPP_CLI_SUPPORT = NO
  40. SIP_SUPPORT = NO
  41. IDL_PROPERTY_SUPPORT = YES
  42. DISTRIBUTE_GROUP_DOC = NO
  43. GROUP_NESTED_COMPOUNDS = NO
  44. SUBGROUPING = YES
  45. INLINE_GROUPED_CLASSES = NO
  46. INLINE_SIMPLE_STRUCTS = NO
  47. TYPEDEF_HIDES_STRUCT = NO
  48. LOOKUP_CACHE_SIZE = 0
  49. #---------------------------------------------------------------------------
  50. # Build related configuration options
  51. #---------------------------------------------------------------------------
  52. EXTRACT_ALL = NO
  53. EXTRACT_PRIVATE = NO
  54. EXTRACT_PACKAGE = NO
  55. EXTRACT_STATIC = NO
  56. EXTRACT_LOCAL_CLASSES = YES
  57. EXTRACT_LOCAL_METHODS = NO
  58. EXTRACT_ANON_NSPACES = NO
  59. HIDE_UNDOC_MEMBERS = NO
  60. HIDE_UNDOC_CLASSES = NO
  61. HIDE_FRIEND_COMPOUNDS = NO
  62. HIDE_IN_BODY_DOCS = NO
  63. INTERNAL_DOCS = NO
  64. CASE_SENSE_NAMES = YES
  65. HIDE_SCOPE_NAMES = NO
  66. HIDE_COMPOUND_REFERENCE= NO
  67. SHOW_INCLUDE_FILES = YES
  68. SHOW_GROUPED_MEMB_INC = YES
  69. FORCE_LOCAL_INCLUDES = NO
  70. INLINE_INFO = YES
  71. SORT_MEMBER_DOCS = YES
  72. SORT_BRIEF_DOCS = NO
  73. SORT_MEMBERS_CTORS_1ST = NO
  74. SORT_GROUP_NAMES = YES
  75. SORT_BY_SCOPE_NAME = NO
  76. STRICT_PROTO_MATCHING = YES
  77. GENERATE_TODOLIST = YES
  78. GENERATE_TESTLIST = YES
  79. GENERATE_BUGLIST = YES
  80. GENERATE_DEPRECATEDLIST= YES
  81. ENABLED_SECTIONS =
  82. MAX_INITIALIZER_LINES = 30
  83. SHOW_USED_FILES = YES
  84. SHOW_FILES = YES
  85. SHOW_NAMESPACES = YES
  86. FILE_VERSION_FILTER =
  87. LAYOUT_FILE =
  88. CITE_BIB_FILES =
  89. #---------------------------------------------------------------------------
  90. # Configuration options related to warning and progress messages
  91. #---------------------------------------------------------------------------
  92. QUIET = NO
  93. WARNINGS = YES
  94. WARN_IF_UNDOCUMENTED = NO
  95. WARN_IF_DOC_ERROR = YES
  96. WARN_NO_PARAMDOC = NO
  97. WARN_AS_ERROR = NO
  98. WARN_FORMAT = "$file:$line: $text"
  99. WARN_LOGFILE =
  100. #---------------------------------------------------------------------------
  101. # Configuration options related to the input files
  102. #---------------------------------------------------------------------------
  103. INPUT = include/libwebsockets.h \
  104. include/libwebsockets/lws-adopt.h \
  105. include/libwebsockets/lws-async-dns.h \
  106. include/libwebsockets/lws-bb-i2c.h \
  107. include/libwebsockets/lws-bb-spi.h \
  108. include/libwebsockets/lws-button.h \
  109. include/libwebsockets/lws-callbacks.h \
  110. include/libwebsockets/lws-cgi.h \
  111. include/libwebsockets/lws-client.h \
  112. include/libwebsockets/lws-context-vhost.h \
  113. include/libwebsockets/lws-dbus.h \
  114. include/libwebsockets/lws-detailed-latency.h \
  115. include/libwebsockets/lws-diskcache.h \
  116. include/libwebsockets/lws-display.h \
  117. include/libwebsockets/lws-dll2.h \
  118. include/libwebsockets/lws-dsh.h \
  119. include/libwebsockets/lws-esp32.h \
  120. include/libwebsockets/lws-eventlib-exports.h \
  121. include/libwebsockets/lws-freertos.h \
  122. include/libwebsockets/lws-fts.h \
  123. include/libwebsockets/lws-genaes.h \
  124. include/libwebsockets/lws-gencrypto.h \
  125. include/libwebsockets/lws-genec.h \
  126. include/libwebsockets/lws-genhash.h \
  127. include/libwebsockets/lws-genrsa.h \
  128. include/libwebsockets/lws-gpio.h \
  129. include/libwebsockets/lws-http.h \
  130. include/libwebsockets/lws-i2c.h \
  131. include/libwebsockets/lws-ili9341-spi.h \
  132. include/libwebsockets/lws-jose.h \
  133. include/libwebsockets/lws-jwe.h \
  134. include/libwebsockets/lws-jwk.h \
  135. include/libwebsockets/lws-jws.h \
  136. include/libwebsockets/lws-led.h \
  137. include/libwebsockets/lws-lejp.h \
  138. include/libwebsockets/lws-logs.h \
  139. include/libwebsockets/lws-lwsac.h \
  140. include/libwebsockets/lws-misc.h \
  141. include/libwebsockets/lws-mqtt.h \
  142. include/libwebsockets/lws-netdev.h \
  143. include/libwebsockets/lws-network-helper.h \
  144. include/libwebsockets/lws-protocols-plugins.h \
  145. include/libwebsockets/lws-purify.h \
  146. include/libwebsockets/lws-pwm.h \
  147. include/libwebsockets/lws-retry.h \
  148. include/libwebsockets/lws-ring.h \
  149. include/libwebsockets/lws-secure-streams-client.h \
  150. include/libwebsockets/lws-secure-streams.h \
  151. include/libwebsockets/lws-secure-streams-policy.h \
  152. include/libwebsockets/lws-sequencer.h \
  153. include/libwebsockets/lws-service.h \
  154. include/libwebsockets/lws-settings.h \
  155. include/libwebsockets/lws-sha1-base64.h \
  156. include/libwebsockets/lws-smd.h \
  157. include/libwebsockets/lws-spa.h \
  158. include/libwebsockets/lws-spi.h \
  159. include/libwebsockets/lws-ssd1306-i2c.h \
  160. include/libwebsockets/lws-state.h \
  161. include/libwebsockets/lws-stats.h \
  162. include/libwebsockets/lws-struct.h \
  163. include/libwebsockets/lws-system.h \
  164. include/libwebsockets/lws-test-sequencer.h \
  165. include/libwebsockets/lws-threadpool.h \
  166. include/libwebsockets/lws-timeout-timer.h \
  167. include/libwebsockets/lws-tokenize.h \
  168. include/libwebsockets/lws-vfs.h \
  169. include/libwebsockets/lws-write.h \
  170. include/libwebsockets/lws-writeable.h \
  171. include/libwebsockets/lws-ws-close.h \
  172. include/libwebsockets/lws-ws-ext.h \
  173. include/libwebsockets/lws-ws-state.h \
  174. include/libwebsockets/lws-x509.h \
  175. plugins/ssh-base/include/lws-plugin-ssh.h \
  176. ./READMEs/mainpage.md \
  177. ./READMEs/README.async-dns.md \
  178. ./READMEs/README.build.md \
  179. ./READMEs/README.ci.md \
  180. ./READMEs/README.coding.md \
  181. ./READMEs/README.content-security-policy.md \
  182. ./READMEs/README.contributing.md \
  183. ./READMEs/README.crypto-apis.md \
  184. ./READMEs/README.detailed-latency.md \
  185. ./READMEs/README.esp32.md \
  186. ./READMEs/README.generic-sessions.md \
  187. ./READMEs/README.generic-table.md \
  188. ./READMEs/README.h2-long-poll.md \
  189. ./READMEs/README.http-fallback.md \
  190. ./READMEs/README.lws_dll.md \
  191. ./READMEs/README.lws_sequencer.md \
  192. ./READMEs/README.lws_struct.md \
  193. ./READMEs/README.lws_sul.md \
  194. ./READMEs/README.lwsws.md \
  195. ./READMEs/README-plugin-sshd-base.md \
  196. ./READMEs/README.plugin-acme.md \
  197. ./READMEs/README.porting.md \
  198. ./READMEs/README.problems.md \
  199. ./READMEs/README.release-policy.md \
  200. ./READMEs/README.test-apps.md \
  201. ./READMEs/README.unix-domain-reverse-proxy.md \
  202. ./READMEs/README.vulnerability-reporting.md \
  203. ./doc-assets
  204. INPUT_ENCODING = UTF-8
  205. FILE_PATTERNS = lib/*.c *.md *.png include/*.h
  206. RECURSIVE = NO
  207. EXCLUDE =
  208. EXCLUDE_SYMLINKS = NO
  209. EXCLUDE_PATTERNS =
  210. EXCLUDE_SYMBOLS =
  211. EXAMPLE_PATH =
  212. EXAMPLE_PATTERNS =
  213. EXAMPLE_RECURSIVE = NO
  214. IMAGE_PATH = doc-assets
  215. INPUT_FILTER =
  216. FILTER_PATTERNS =
  217. FILTER_SOURCE_FILES = NO
  218. FILTER_SOURCE_PATTERNS =
  219. USE_MDFILE_AS_MAINPAGE = mainpage.md
  220. #---------------------------------------------------------------------------
  221. # Configuration options related to source browsing
  222. #---------------------------------------------------------------------------
  223. SOURCE_BROWSER = NO
  224. INLINE_SOURCES = YES
  225. STRIP_CODE_COMMENTS = YES
  226. REFERENCED_BY_RELATION = NO
  227. REFERENCES_RELATION = NO
  228. REFERENCES_LINK_SOURCE = YES
  229. SOURCE_TOOLTIPS = YES
  230. USE_HTAGS = NO
  231. VERBATIM_HEADERS = YES
  232. #---------------------------------------------------------------------------
  233. # Configuration options related to the alphabetical class index
  234. #---------------------------------------------------------------------------
  235. ALPHABETICAL_INDEX = YES
  236. COLS_IN_ALPHA_INDEX = 5
  237. IGNORE_PREFIX =
  238. #---------------------------------------------------------------------------
  239. # Configuration options related to the HTML output
  240. #---------------------------------------------------------------------------
  241. GENERATE_HTML = YES
  242. HTML_OUTPUT = html
  243. HTML_FILE_EXTENSION = .html
  244. HTML_HEADER =
  245. HTML_FOOTER =
  246. HTML_STYLESHEET =
  247. HTML_EXTRA_STYLESHEET =
  248. HTML_EXTRA_FILES =
  249. HTML_COLORSTYLE_HUE = 220
  250. HTML_COLORSTYLE_SAT = 100
  251. HTML_COLORSTYLE_GAMMA = 80
  252. HTML_TIMESTAMP = NO
  253. HTML_DYNAMIC_SECTIONS = NO
  254. HTML_INDEX_NUM_ENTRIES = 100
  255. GENERATE_DOCSET = NO
  256. DOCSET_FEEDNAME = "Doxygen generated docs"
  257. DOCSET_BUNDLE_ID = org.doxygen.Project
  258. DOCSET_PUBLISHER_ID = org.doxygen.Publisher
  259. DOCSET_PUBLISHER_NAME = Publisher
  260. GENERATE_HTMLHELP = NO
  261. CHM_FILE =
  262. HHC_LOCATION =
  263. GENERATE_CHI = NO
  264. CHM_INDEX_ENCODING =
  265. BINARY_TOC = NO
  266. TOC_EXPAND = NO
  267. GENERATE_QHP = NO
  268. QCH_FILE =
  269. QHP_NAMESPACE = org.doxygen.Project
  270. QHP_VIRTUAL_FOLDER = doc
  271. QHP_CUST_FILTER_NAME =
  272. QHP_CUST_FILTER_ATTRS =
  273. QHP_SECT_FILTER_ATTRS =
  274. QHG_LOCATION =
  275. GENERATE_ECLIPSEHELP = NO
  276. ECLIPSE_DOC_ID = org.doxygen.Project
  277. DISABLE_INDEX = NO
  278. GENERATE_TREEVIEW = YES
  279. ENUM_VALUES_PER_LINE = 4
  280. TREEVIEW_WIDTH = 250
  281. EXT_LINKS_IN_WINDOW = NO
  282. FORMULA_FONTSIZE = 10
  283. FORMULA_TRANSPARENT = YES
  284. USE_MATHJAX = NO
  285. MATHJAX_FORMAT = HTML-CSS
  286. MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
  287. MATHJAX_EXTENSIONS =
  288. MATHJAX_CODEFILE =
  289. SEARCHENGINE = NO
  290. SERVER_BASED_SEARCH = NO
  291. EXTERNAL_SEARCH = NO
  292. SEARCHENGINE_URL =
  293. SEARCHDATA_FILE = searchdata.xml
  294. EXTERNAL_SEARCH_ID =
  295. EXTRA_SEARCH_MAPPINGS =
  296. #---------------------------------------------------------------------------
  297. # Configuration options related to the LaTeX output
  298. #---------------------------------------------------------------------------
  299. GENERATE_LATEX = NO
  300. LATEX_OUTPUT = latex
  301. LATEX_CMD_NAME = latex
  302. MAKEINDEX_CMD_NAME = makeindex
  303. COMPACT_LATEX = NO
  304. PAPER_TYPE = a4
  305. EXTRA_PACKAGES =
  306. LATEX_HEADER =
  307. LATEX_FOOTER =
  308. LATEX_EXTRA_STYLESHEET =
  309. LATEX_EXTRA_FILES =
  310. PDF_HYPERLINKS = YES
  311. USE_PDFLATEX = YES
  312. LATEX_BATCHMODE = NO
  313. LATEX_HIDE_INDICES = NO
  314. LATEX_SOURCE_CODE = NO
  315. LATEX_BIB_STYLE = plain
  316. LATEX_TIMESTAMP = NO
  317. #---------------------------------------------------------------------------
  318. # Configuration options related to the RTF output
  319. #---------------------------------------------------------------------------
  320. GENERATE_RTF = NO
  321. RTF_OUTPUT = rtf
  322. COMPACT_RTF = NO
  323. RTF_HYPERLINKS = NO
  324. RTF_STYLESHEET_FILE =
  325. RTF_EXTENSIONS_FILE =
  326. RTF_SOURCE_CODE = NO
  327. #---------------------------------------------------------------------------
  328. # Configuration options related to the man page output
  329. #---------------------------------------------------------------------------
  330. GENERATE_MAN = NO
  331. MAN_OUTPUT = man
  332. MAN_EXTENSION = .3
  333. MAN_SUBDIR =
  334. MAN_LINKS = NO
  335. #---------------------------------------------------------------------------
  336. # Configuration options related to the XML output
  337. #---------------------------------------------------------------------------
  338. GENERATE_XML = NO
  339. XML_OUTPUT = xml
  340. XML_PROGRAMLISTING = YES
  341. #---------------------------------------------------------------------------
  342. # Configuration options related to the DOCBOOK output
  343. #---------------------------------------------------------------------------
  344. GENERATE_DOCBOOK = NO
  345. DOCBOOK_OUTPUT = docbook
  346. DOCBOOK_PROGRAMLISTING = NO
  347. #---------------------------------------------------------------------------
  348. # Configuration options for the AutoGen Definitions output
  349. #---------------------------------------------------------------------------
  350. GENERATE_AUTOGEN_DEF = NO
  351. #---------------------------------------------------------------------------
  352. # Configuration options related to the Perl module output
  353. #---------------------------------------------------------------------------
  354. GENERATE_PERLMOD = NO
  355. PERLMOD_LATEX = NO
  356. PERLMOD_PRETTY = YES
  357. PERLMOD_MAKEVAR_PREFIX =
  358. #---------------------------------------------------------------------------
  359. # Configuration options related to the preprocessor
  360. #---------------------------------------------------------------------------
  361. ENABLE_PREPROCESSING = YES
  362. MACRO_EXPANSION = NO
  363. EXPAND_ONLY_PREDEF = NO
  364. SEARCH_INCLUDES = YES
  365. INCLUDE_PATH = ./include
  366. INCLUDE_FILE_PATTERNS =
  367. PREDEFINED =
  368. EXPAND_AS_DEFINED =
  369. SKIP_FUNCTION_MACROS = YES
  370. #---------------------------------------------------------------------------
  371. # Configuration options related to external references
  372. #---------------------------------------------------------------------------
  373. TAGFILES =
  374. GENERATE_TAGFILE =
  375. ALLEXTERNALS = NO
  376. EXTERNAL_GROUPS = YES
  377. EXTERNAL_PAGES = YES
  378. PERL_PATH = /usr/bin/perl
  379. #---------------------------------------------------------------------------
  380. # Configuration options related to the dot tool
  381. #---------------------------------------------------------------------------
  382. CLASS_DIAGRAMS = YES
  383. MSCGEN_PATH =
  384. DIA_PATH =
  385. HIDE_UNDOC_RELATIONS = YES
  386. HAVE_DOT = NO
  387. DOT_NUM_THREADS = 0
  388. DOT_FONTNAME = Helvetica
  389. DOT_FONTSIZE = 10
  390. DOT_FONTPATH =
  391. CLASS_GRAPH = YES
  392. COLLABORATION_GRAPH = YES
  393. GROUP_GRAPHS = YES
  394. UML_LOOK = NO
  395. UML_LIMIT_NUM_FIELDS = 10
  396. TEMPLATE_RELATIONS = NO
  397. INCLUDE_GRAPH = YES
  398. INCLUDED_BY_GRAPH = YES
  399. CALL_GRAPH = NO
  400. CALLER_GRAPH = NO
  401. GRAPHICAL_HIERARCHY = YES
  402. DIRECTORY_GRAPH = YES
  403. DOT_IMAGE_FORMAT = png
  404. INTERACTIVE_SVG = NO
  405. DOT_PATH =
  406. DOTFILE_DIRS =
  407. MSCFILE_DIRS =
  408. DIAFILE_DIRS =
  409. PLANTUML_JAR_PATH =
  410. PLANTUML_INCLUDE_PATH =
  411. DOT_GRAPH_MAX_NODES = 50
  412. MAX_DOT_GRAPH_DEPTH = 0
  413. DOT_TRANSPARENT = NO
  414. DOT_MULTI_TARGETS = NO
  415. GENERATE_LEGEND = YES
  416. DOT_CLEANUP = YES