From: David Goulet Date: Tue, 5 Dec 2017 19:30:47 +0000 (-0500) Subject: control: Improve ADD_ONION helper function comments X-Git-Tag: tor-0.3.3.1-alpha~161^2~1 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c094802697fe10a3f24dbb3f506c51a78f5c7a4f;p=thirdparty%2Ftor.git control: Improve ADD_ONION helper function comments Signed-off-by: David Goulet --- diff --git a/src/or/control.c b/src/or/control.c index d84ce7d639..f1960b8849 100644 --- a/src/or/control.c +++ b/src/or/control.c @@ -4449,10 +4449,17 @@ handle_control_hspost(control_connection_t *conn, } /* Helper function for ADD_ONION that adds an ephemeral service depending on - * the given hs_version. The pk's type defers depending on the version so the - * caller should make sure those two matches. Both port_cfgs and auth_clients - * are now owned by the hidden service subsystem so the caller must stop - * accessing them. + * the given hs_version. + * + * The secret key in pk depends on the hs_version. The ownership of the key + * used in pk is given to the HS subsystem so the caller must stop accessing + * it after. + * + * The port_cfgs is a list of service port. Ownership transfered to service. + * The max_streams refers to the MaxStreams= key. + * The max_streams_close_circuit refers to the MaxStreamsCloseCircuit key. + * The auth_type is the authentication type of the clients in auth_clients. + * The ownership of that list is transfered to the service. * * On success (RSAE_OKAY), the address_out points to a newly allocated string * containing the onion address without the .onion part. On error, address_out