nihilist/tor
1
0
Fork 0
mirror of https://gitlab.torproject.org/tpo/core/tor.git synced 2024-11-28 14:23:30 +01:00
Code Issues Packages Projects Releases Wiki Activity

versions: Improve the protover summary comments

Browse Source 
Part of 33222.
This commit is contained in:
teor 2020-05-15 23:34:00 +10:00
parent a702e92c82
commit 277baf676b
1 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
src/core/or/versions.c
View File

@ -408,6 +408,10 @@ static strmap_t *protover_summary_map = NULL;
/** /**
* Helper. Given a non-NULL protover string <b>protocols</b>, set <b>out</b> * Helper. Given a non-NULL protover string <b>protocols</b>, set <b>out</b>
* to its summary, and memoize the result in <b>protover_summary_map</b>. * to its summary, and memoize the result in <b>protover_summary_map</b>.
*
* If the protover string does not contain any recognised protocols, sets
* protocols_known, but does not set any other flags. (Empty strings are also
* treated this way.)
*/ */
static void static void
memoize_protover_summary(protover_summary_flags_t *out, memoize_protover_summary(protover_summary_flags_t *out,
@ -485,6 +489,13 @@ memoize_protover_summary(protover_summary_flags_t *out,
/** Summarize the protocols listed in <b>protocols</b> into <b>out</b>, /** Summarize the protocols listed in <b>protocols</b> into <b>out</b>,
* falling back or correcting them based on <b>version</b> as appropriate. * falling back or correcting them based on <b>version</b> as appropriate.
*
* If protocols and version are both NULL, returns a summary with no flags
* set.
*
* If the protover string does not contain any recognised protocols, and the
* version is not recognised, sets protocols_known, but does not set any other
* flags. (Empty strings are also treated this way.)
*/ */
void void
summarize_protover_flags(protover_summary_flags_t *out, summarize_protover_flags(protover_summary_flags_t *out,