Libcurl - Revision history

Yellows8 at 19:41, 10 May 2020

2020-05-10T17:41:12Z

← Older revision		Revision as of 21:41, 10 May 2020
Line 1:		Line 1:
	This page documents the libcurl package used by official sw. This is statically linked in the main-codebin, on old versions (~v2.x) this was a subsdk NSO. This page does not apply to the libcurl build included in the browser OSS NRO.		This page documents the libcurl package used by official sw. This is statically linked in the main-codebin, on old versions (~v2.x) this was a subsdk NSO. This page does not apply to the libcurl build included in the browser OSS NRO.

	~~With~~ sdkver 10.x, this is built with support for NGHTTP2 with the relevant [[SSL_services\|Alpn]] cmds being used for this.		Starting with sdkver 10.x, this is built with support for NGHTTP2 with the relevant [[SSL_services\|Alpn]] cmds being used for this.

	The changes to libcurl compared to the original libcurl are documented below, etc.		The changes to libcurl compared to the original libcurl are documented below, etc.
Line 46:		Line 46:

	== SSL_CTX_FUNCTION ==		== SSL_CTX_FUNCTION ==
	This funcptr is called with the same params as normal, with the context ptr being {sdknso container object for [[SSL_services#ISslContext\|ISslContext]]}.		This funcptr is called with the same params as normal, with the context ptr being {sdknso container object for [[SSL_services#ISslContext\|ISslContext]]}. If this funcptr returns non-zero, the CURLcode is set to CURLE_ABORTED_BY_CALLBACK.

	This is only used if [[#UNK502]] is not set, in which case an error is thrown if this funcptr is not set. An error is also thrown afterwards if the context wasn't created.		This is only used if [[#UNK502]] is not set, in which case an error is thrown if this funcptr is not set. An error is also thrown afterwards if the context wasn't created.
Line 113:		Line 113:

	This is used during Curl_resolver_getaddrinfo. See also [[#URL]].		This is used during Curl_resolver_getaddrinfo. See also [[#URL]].

			= CURLcode =
			This section documents the custom CURLcode values.

			{\| class="wikitable" border="1"
			\|-
			! Value
			! Description
			\|-
			\| 95 \|\| {sdknso container object for [[SSL_services#ISslContext\|ISslContext]]} isn't initialized.
			\|-
			\| 96 \|\| nnsslContextGetContextId failed.
			\|-
			\| 98 \|\| Ptr is NULL.
			\|}

Yellows8: /* PROXYAUTOCONFIG */

2020-05-10T17:25:54Z

PROXYAUTOCONFIG

← Older revision		Revision as of 21:25, 10 May 2020
Line 57:		Line 57:
	A warning is printed if this option is set when CURLOPT_PROXY is already set - in which case CURLOPT_PROXY is freed.		A warning is printed if this option is set when CURLOPT_PROXY is already set - in which case CURLOPT_PROXY is freed.

	This option controls whether to load the system proxy from [[Network_Interface_services#GetCurrentNetworkProfile\|nifm]]. The code handling this option was added to the start of the inlined create_conn_helper_init_proxy func.		This option controls whether to load the system proxy from [[Network_Interface_services#GetCurrentNetworkProfile\|nifm]]. The code handling this option was added to the start of the inlined create_conn_helper_init_proxy func. The loaded proxy info is written to the CURLOPT PROXY* options as needed.

	== UNK501 ==		== UNK501 ==

Yellows8: /* SSL_CTX_FUNCTION */

2020-05-10T17:16:28Z

SSL_CTX_FUNCTION

← Older revision		Revision as of 21:16, 10 May 2020
Line 50:		Line 50:
	This is only used if [[#UNK502]] is not set, in which case an error is thrown if this funcptr is not set. An error is also thrown afterwards if the context wasn't created.		This is only used if [[#UNK502]] is not set, in which case an error is thrown if this funcptr is not set. An error is also thrown afterwards if the context wasn't created.

	The user must create the [[SSL_services#ISslContext\|ISslContext]] using this funcptr, with all required ISslContext initialization - no cmds are used by the caller with ISslContext besides [[SSL_services#CreateConnection\|CreateConnection]].		The user must create the [[SSL_services#ISslContext\|ISslContext]] using this funcptr, with all required ISslContext initialization - no cmds are used by the caller with ISslContext besides [[SSL_services#CreateConnection\|CreateConnection]] (the caller doesn't use [[SSL_services#CreateContext\|CreateContext]], the user must).

	== PROXYAUTOCONFIG ==		== PROXYAUTOCONFIG ==

Yellows8: /* CURLOPT */

2020-05-10T17:12:02Z

CURLOPT

@@ Line 14: / Line 14: @@
 |-
 | [[#URL]] || STRINGPOINT || 2 || 10002 ||
 |-
 | [[#PROXYAUTOCONFIG]] || LONG || 500 || 500 || 1
@@ Line 19: / Line 21: @@
 | [[#UNK501]] || LONG || 501 || 501 || 0
 |-
-| || OBJECTPOINT/STRINGPOINT || 502 || 10502 ||
+| [[#UNK502]] || OBJECTPOINT || 502 || 10502 ||
 |-
-| || FUNCTIONPOINT || 503 || 20503 ||
+| [[#UNK503]] || FUNCTIONPOINT || 503 || 20503 ||
 |-
-| || FUNCTIONPOINT || 504 || 20504 ||
+| [[#UNK504]] || FUNCTIONPOINT || 504 || 20504 ||
 |-
-| || OBJECTPOINT/STRINGPOINT || 505 || 10505 ||
+| [[#UNK505]] || OBJECTPOINT || 505 || 10505 ||
 |-
 | [[#UNK506]] || LONG || 506 || 506 || 0
@@ Line 42: / Line 44: @@
 Afterwards, ResolveEx is used with the first output string from the latter sscanf as the input. Then the final URL is constructed with the output from ResolveEx.
 == PROXYAUTOCONFIG ==
@@ Line 54: / Line 63: @@
 This controls the value of the DataCheck [[SSL_services#VerifyOption|VerifyOption]] bit.
 == UNK506 ==

Yellows8: /* CURLOPT */

2020-05-10T15:10:09Z

CURLOPT

← Older revision		Revision as of 19:10, 10 May 2020
Line 21:		Line 21:
	\| \|\| OBJECTPOINT/STRINGPOINT \|\| 502 \|\| 10502 \|\|		\| \|\| OBJECTPOINT/STRINGPOINT \|\| 502 \|\| 10502 \|\|
	\|-		\|-
	\| \|\| FUNCTIONPOINT \|\| 503 \|\| \|\|		\| \|\| FUNCTIONPOINT \|\| 503 \|\| 20503 \|\|
	\|-		\|-
	\| \|\| FUNCTIONPOINT \|\| 504 \|\| \|\|		\| \|\| FUNCTIONPOINT \|\| 504 \|\| 20504 \|\|
	\|-		\|-
	\| \|\| OBJECTPOINT/STRINGPOINT \|\| 505 \|\| 10505 \|\|		\| \|\| OBJECTPOINT/STRINGPOINT \|\| 505 \|\| 10505 \|\|

Yellows8: /* CURLOPT */

2020-05-10T15:08:07Z

CURLOPT

← Older revision		Revision as of 19:08, 10 May 2020
Line 7:		Line 7:
	= CURLOPT =		= CURLOPT =

	The 50X options are custom, the default values for some of these are set in Curl_init_userdefined.		The 50X/900 options are custom, the default values for some of these are set in Curl_init_userdefined.

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
	! CINIT name \|\| CINIT type \|\| CINIT number \|\| CURLoption value \|\| Default value		! CINIT name \|\| CINIT type \|\| CINIT number \|\| CURLoption value \|\| Default value
			\|-
			\| [[#URL]] \|\| STRINGPOINT \|\| 2 \|\| 10002 \|\|
	\|-		\|-
	\| [[#PROXYAUTOCONFIG]] \|\| LONG \|\| 500 \|\| 500 \|\| 1		\| [[#PROXYAUTOCONFIG]] \|\| LONG \|\| 500 \|\| 500 \|\| 1
Line 17:		Line 19:
	\| [[#UNK501]] \|\| LONG \|\| 501 \|\| 501 \|\| 0		\| [[#UNK501]] \|\| LONG \|\| 501 \|\| 501 \|\| 0
	\|-		\|-
	\| \|\| \|\| 502 \|\| \|\|		\| \|\| OBJECTPOINT/STRINGPOINT \|\| 502 \|\| 10502 \|\|
	\|-		\|-
	\| \|\| \|\| 503 \|\| \|\|		\| \|\| FUNCTIONPOINT \|\| 503 \|\| \|\|
	\|-		\|-
	\| \|\| \|\| 504 \|\| \|\|		\| \|\| FUNCTIONPOINT \|\| 504 \|\| \|\|
	\|-		\|-
	\| \|\| \|\| 505 \|\| \|\|		\| \|\| OBJECTPOINT/STRINGPOINT \|\| 505 \|\| 10505 \|\|
	\|-		\|-
	\| [[#UNK506]] \|\| LONG \|\| 506 \|\| 506 \|\| 0		\| [[#UNK506]] \|\| LONG \|\| 506 \|\| 506 \|\| 0
	\|-		\|-
	\| [[#UNK507]] \|\| LONG \|\| 507 \|\| 507 \|\|		\| [[#UNK507]] \|\| LONG \|\| 507 \|\| 507 \|\|
			\|-
			\| [[#UNK900]] \|\| LONG \|\| 900 \|\| 900 \|\|
	\|}		\|}

			== URL ==
			The following only runs when the [[#UNK900]] flag is not set, otherwise the URL is set directly using the input string.

			This was patched to use various string functionality and [[Sockets_services#nsd:u.2C_nsd:a\|ResolveEx]] (only used if needed). sscanf is used twice with the following two format strings, with the input URL. If the first one returns <=1 and the second one returns <=0, the input URL is just copied to state, otherwise this continues with using ResolveEx etc. Format strings:
			* "%15[^\n:]://%[^\n/?:]%[^\n]"
			* "%[^\n/?:]%[^\n]"

			Afterwards, ResolveEx is used with the first output string from the latter sscanf as the input. Then the final URL is constructed with the output from ResolveEx.

	== PROXYAUTOCONFIG ==		== PROXYAUTOCONFIG ==
Line 51:		Line 64:

	This controls the value of the [[SSL_services#OptionType\|SkipDefaultVerify]] option flag.		This controls the value of the [[SSL_services#OptionType\|SkipDefaultVerify]] option flag.

			== UNK900 ==
			This option is handled as a bool.

			This is used during Curl_resolver_getaddrinfo. See also [[#URL]].

Yellows8: /* CURLOPT */

2020-05-10T02:56:29Z

CURLOPT

← Older revision		Revision as of 06:56, 10 May 2020
Line 6:		Line 6:

	= CURLOPT =		= CURLOPT =

			The 50X options are custom, the default values for some of these are set in Curl_init_userdefined.

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
Line 13:		Line 15:
	\| [[#PROXYAUTOCONFIG]] \|\| LONG \|\| 500 \|\| 500 \|\| 1		\| [[#PROXYAUTOCONFIG]] \|\| LONG \|\| 500 \|\| 500 \|\| 1
	\|-		\|-
	\| \|\| LONG \|\| 501 \|\| 501 \|\|		\| [[#UNK501]] \|\| LONG \|\| 501 \|\| 501 \|\| 0
	\|-		\|-
	\| \|\| ~~LONG~~ \|\| 502 \|\| ~~502~~ \|\|		\| \|\| \|\| 502 \|\| \|\|
	\|-		\|-
	\| \|\| ~~LONG~~ \|\| 503 \|\| ~~503~~ \|\|		\| \|\| \|\| 503 \|\| \|\|
	\|-		\|-
	\| \|\| ~~LONG~~ \|\| 504 \|\| ~~504~~ \|\|		\| \|\| \|\| 504 \|\| \|\|
	\|-		\|-
	\| \|\| ~~LONG~~ \|\| 505 \|\| ~~505~~ \|\|		\| \|\| \|\| 505 \|\| \|\|
	\|-		\|-
	\| \|\| LONG \|\| 506 \|\| 506 \|\|		\| [[#UNK506]] \|\| LONG \|\| 506 \|\| 506 \|\| 0
	\|-		\|-
	\| \|\| LONG \|\| 507 \|\| 507 \|\|		\| [[#UNK507]] \|\| LONG \|\| 507 \|\| 507 \|\|
	\|}		\|}

Line 34:		Line 36:

	This option controls whether to load the system proxy from [[Network_Interface_services#GetCurrentNetworkProfile\|nifm]]. The code handling this option was added to the start of the inlined create_conn_helper_init_proxy func.		This option controls whether to load the system proxy from [[Network_Interface_services#GetCurrentNetworkProfile\|nifm]]. The code handling this option was added to the start of the inlined create_conn_helper_init_proxy func.

			== UNK501 ==
			This option is handled as a bool.

			This controls the value of the DataCheck [[SSL_services#VerifyOption\|VerifyOption]] bit.

			== UNK506 ==
			This option is handled as a bool.

			This is used during Curl_resolver_getaddrinfo.

			== UNK507 ==
			This option is handled as a bool.

			This controls the value of the [[SSL_services#OptionType\|SkipDefaultVerify]] option flag.

Yellows8: Created page with "This page documents the libcurl package used by official sw. This is statically linked in the main-codebin, on old versions (~v2.x) this was a subsdk NSO. This page does not a..."

2020-05-10T01:31:51Z

Created page with "This page documents the libcurl package used by official sw. This is statically linked in the main-codebin, on old versions (~v2.x) this was a subsdk NSO. This page does not a..."

New page

This page documents the libcurl package used by official sw. This is statically linked in the main-codebin, on old versions (~v2.x) this was a subsdk NSO. This page does not apply to the libcurl build included in the browser OSS NRO.

With sdkver 10.x, this is built with support for NGHTTP2 with the relevant [[SSL_services|Alpn]] cmds being used for this.

The changes to libcurl compared to the original libcurl are documented below, etc.

= CURLOPT =

{| class="wikitable" border="1"
|-
! CINIT name || CINIT type || CINIT number || CURLoption value || Default value
|-
| [[#PROXYAUTOCONFIG]] || LONG || 500 || 500 || 1
|-
| || LONG || 501 || 501 ||
|-
| || LONG || 502 || 502 ||
|-
| || LONG || 503 || 503 ||
|-
| || LONG || 504 || 504 ||
|-
| || LONG || 505 || 505 ||
|-
| || LONG || 506 || 506 ||
|-
| || LONG || 507 || 507 ||
|}

== PROXYAUTOCONFIG ==
This option is handled as a bool.

A warning is printed if this option is set when CURLOPT_PROXY is already set - in which case CURLOPT_PROXY is freed.

This option controls whether to load the system proxy from [[Network_Interface_services#GetCurrentNetworkProfile|nifm]]. The code handling this option was added to the start of the inlined create_conn_helper_init_proxy func.