666112376d
Expose the XML Expat 2.7.2 APIs to tune protections against
"billion laughs" [1] attacks.
The exposed APIs are available on Expat parsers, that is,
parsers created by `xml.parsers.expat.ParserCreate()`, as:
- `parser.SetBillionLaughsAttackProtectionActivationThreshold(threshold)`, and
- `parser.SetBillionLaughsAttackProtectionMaximumAmplification(max_factor)`.
This completes the work in f04bea44c3,
and improves the existing related documentation.
[1]: https://en.wikipedia.org/wiki/Billion_laughs_attack
834 lines
29 KiB
C
Generated
834 lines
29 KiB
C
Generated
/*[clinic input]
|
|
preserve
|
|
[clinic start generated code]*/
|
|
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# include "pycore_gc.h" // PyGC_Head
|
|
# include "pycore_runtime.h" // _Py_SINGLETON()
|
|
#endif
|
|
#include "pycore_long.h" // _PyLong_UnsignedLongLong_Converter()
|
|
#include "pycore_modsupport.h" // _PyArg_UnpackKeywords()
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_SetReparseDeferralEnabled__doc__,
|
|
"SetReparseDeferralEnabled($self, enabled, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Enable/Disable reparse deferral; enabled by default with Expat >=2.6.0.");
|
|
|
|
#define PYEXPAT_XMLPARSER_SETREPARSEDEFERRALENABLED_METHODDEF \
|
|
{"SetReparseDeferralEnabled", (PyCFunction)pyexpat_xmlparser_SetReparseDeferralEnabled, METH_O, pyexpat_xmlparser_SetReparseDeferralEnabled__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetReparseDeferralEnabled_impl(xmlparseobject *self,
|
|
int enabled);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetReparseDeferralEnabled(PyObject *self, PyObject *arg)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
int enabled;
|
|
|
|
enabled = PyObject_IsTrue(arg);
|
|
if (enabled < 0) {
|
|
goto exit;
|
|
}
|
|
return_value = pyexpat_xmlparser_SetReparseDeferralEnabled_impl((xmlparseobject *)self, enabled);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_GetReparseDeferralEnabled__doc__,
|
|
"GetReparseDeferralEnabled($self, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Retrieve reparse deferral enabled status; always returns false with Expat <2.6.0.");
|
|
|
|
#define PYEXPAT_XMLPARSER_GETREPARSEDEFERRALENABLED_METHODDEF \
|
|
{"GetReparseDeferralEnabled", (PyCFunction)pyexpat_xmlparser_GetReparseDeferralEnabled, METH_NOARGS, pyexpat_xmlparser_GetReparseDeferralEnabled__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_GetReparseDeferralEnabled_impl(xmlparseobject *self);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_GetReparseDeferralEnabled(PyObject *self, PyObject *Py_UNUSED(ignored))
|
|
{
|
|
return pyexpat_xmlparser_GetReparseDeferralEnabled_impl((xmlparseobject *)self);
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_Parse__doc__,
|
|
"Parse($self, data, isfinal=False, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Parse XML data.\n"
|
|
"\n"
|
|
"\'isfinal\' should be true at end of input.");
|
|
|
|
#define PYEXPAT_XMLPARSER_PARSE_METHODDEF \
|
|
{"Parse", _PyCFunction_CAST(pyexpat_xmlparser_Parse), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, pyexpat_xmlparser_Parse__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_Parse_impl(xmlparseobject *self, PyTypeObject *cls,
|
|
PyObject *data, int isfinal);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_Parse(PyObject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# define KWTUPLE (PyObject *)&_Py_SINGLETON(tuple_empty)
|
|
#else
|
|
# define KWTUPLE NULL
|
|
#endif
|
|
|
|
static const char * const _keywords[] = {"", "", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "Parse",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[2];
|
|
PyObject *data;
|
|
int isfinal = 0;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 1, /*maxpos*/ 2, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
data = args[0];
|
|
if (nargs < 2) {
|
|
goto skip_optional_posonly;
|
|
}
|
|
isfinal = PyObject_IsTrue(args[1]);
|
|
if (isfinal < 0) {
|
|
goto exit;
|
|
}
|
|
skip_optional_posonly:
|
|
return_value = pyexpat_xmlparser_Parse_impl((xmlparseobject *)self, cls, data, isfinal);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_ParseFile__doc__,
|
|
"ParseFile($self, file, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Parse XML data from file-like object.");
|
|
|
|
#define PYEXPAT_XMLPARSER_PARSEFILE_METHODDEF \
|
|
{"ParseFile", _PyCFunction_CAST(pyexpat_xmlparser_ParseFile), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, pyexpat_xmlparser_ParseFile__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_ParseFile_impl(xmlparseobject *self, PyTypeObject *cls,
|
|
PyObject *file);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_ParseFile(PyObject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# define KWTUPLE (PyObject *)&_Py_SINGLETON(tuple_empty)
|
|
#else
|
|
# define KWTUPLE NULL
|
|
#endif
|
|
|
|
static const char * const _keywords[] = {"", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "ParseFile",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[1];
|
|
PyObject *file;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 1, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
file = args[0];
|
|
return_value = pyexpat_xmlparser_ParseFile_impl((xmlparseobject *)self, cls, file);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_SetBase__doc__,
|
|
"SetBase($self, base, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Set the base URL for the parser.");
|
|
|
|
#define PYEXPAT_XMLPARSER_SETBASE_METHODDEF \
|
|
{"SetBase", (PyCFunction)pyexpat_xmlparser_SetBase, METH_O, pyexpat_xmlparser_SetBase__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetBase_impl(xmlparseobject *self, const char *base);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetBase(PyObject *self, PyObject *arg)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
const char *base;
|
|
|
|
if (!PyUnicode_Check(arg)) {
|
|
_PyArg_BadArgument("SetBase", "argument", "str", arg);
|
|
goto exit;
|
|
}
|
|
Py_ssize_t base_length;
|
|
base = PyUnicode_AsUTF8AndSize(arg, &base_length);
|
|
if (base == NULL) {
|
|
goto exit;
|
|
}
|
|
if (strlen(base) != (size_t)base_length) {
|
|
PyErr_SetString(PyExc_ValueError, "embedded null character");
|
|
goto exit;
|
|
}
|
|
return_value = pyexpat_xmlparser_SetBase_impl((xmlparseobject *)self, base);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_GetBase__doc__,
|
|
"GetBase($self, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Return base URL string for the parser.");
|
|
|
|
#define PYEXPAT_XMLPARSER_GETBASE_METHODDEF \
|
|
{"GetBase", (PyCFunction)pyexpat_xmlparser_GetBase, METH_NOARGS, pyexpat_xmlparser_GetBase__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_GetBase_impl(xmlparseobject *self);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_GetBase(PyObject *self, PyObject *Py_UNUSED(ignored))
|
|
{
|
|
return pyexpat_xmlparser_GetBase_impl((xmlparseobject *)self);
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_GetInputContext__doc__,
|
|
"GetInputContext($self, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Return the untranslated text of the input that caused the current event.\n"
|
|
"\n"
|
|
"If the event was generated by a large amount of text (such as a start tag\n"
|
|
"for an element with many attributes), not all of the text may be available.");
|
|
|
|
#define PYEXPAT_XMLPARSER_GETINPUTCONTEXT_METHODDEF \
|
|
{"GetInputContext", (PyCFunction)pyexpat_xmlparser_GetInputContext, METH_NOARGS, pyexpat_xmlparser_GetInputContext__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_GetInputContext_impl(xmlparseobject *self);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_GetInputContext(PyObject *self, PyObject *Py_UNUSED(ignored))
|
|
{
|
|
return pyexpat_xmlparser_GetInputContext_impl((xmlparseobject *)self);
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_ExternalEntityParserCreate__doc__,
|
|
"ExternalEntityParserCreate($self, context, encoding=<unrepresentable>,\n"
|
|
" /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Create a parser for parsing an external entity based on the information passed to the ExternalEntityRefHandler.");
|
|
|
|
#define PYEXPAT_XMLPARSER_EXTERNALENTITYPARSERCREATE_METHODDEF \
|
|
{"ExternalEntityParserCreate", _PyCFunction_CAST(pyexpat_xmlparser_ExternalEntityParserCreate), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, pyexpat_xmlparser_ExternalEntityParserCreate__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_ExternalEntityParserCreate_impl(xmlparseobject *self,
|
|
PyTypeObject *cls,
|
|
const char *context,
|
|
const char *encoding);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_ExternalEntityParserCreate(PyObject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# define KWTUPLE (PyObject *)&_Py_SINGLETON(tuple_empty)
|
|
#else
|
|
# define KWTUPLE NULL
|
|
#endif
|
|
|
|
static const char * const _keywords[] = {"", "", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "ExternalEntityParserCreate",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[2];
|
|
const char *context;
|
|
const char *encoding = NULL;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 1, /*maxpos*/ 2, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
if (args[0] == Py_None) {
|
|
context = NULL;
|
|
}
|
|
else if (PyUnicode_Check(args[0])) {
|
|
Py_ssize_t context_length;
|
|
context = PyUnicode_AsUTF8AndSize(args[0], &context_length);
|
|
if (context == NULL) {
|
|
goto exit;
|
|
}
|
|
if (strlen(context) != (size_t)context_length) {
|
|
PyErr_SetString(PyExc_ValueError, "embedded null character");
|
|
goto exit;
|
|
}
|
|
}
|
|
else {
|
|
_PyArg_BadArgument("ExternalEntityParserCreate", "argument 1", "str or None", args[0]);
|
|
goto exit;
|
|
}
|
|
if (nargs < 2) {
|
|
goto skip_optional_posonly;
|
|
}
|
|
if (!PyUnicode_Check(args[1])) {
|
|
_PyArg_BadArgument("ExternalEntityParserCreate", "argument 2", "str", args[1]);
|
|
goto exit;
|
|
}
|
|
Py_ssize_t encoding_length;
|
|
encoding = PyUnicode_AsUTF8AndSize(args[1], &encoding_length);
|
|
if (encoding == NULL) {
|
|
goto exit;
|
|
}
|
|
if (strlen(encoding) != (size_t)encoding_length) {
|
|
PyErr_SetString(PyExc_ValueError, "embedded null character");
|
|
goto exit;
|
|
}
|
|
skip_optional_posonly:
|
|
return_value = pyexpat_xmlparser_ExternalEntityParserCreate_impl((xmlparseobject *)self, cls, context, encoding);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_SetParamEntityParsing__doc__,
|
|
"SetParamEntityParsing($self, flag, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Controls parsing of parameter entities (including the external DTD subset).\n"
|
|
"\n"
|
|
"Possible flag values are XML_PARAM_ENTITY_PARSING_NEVER,\n"
|
|
"XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE and\n"
|
|
"XML_PARAM_ENTITY_PARSING_ALWAYS. Returns true if setting the flag\n"
|
|
"was successful.");
|
|
|
|
#define PYEXPAT_XMLPARSER_SETPARAMENTITYPARSING_METHODDEF \
|
|
{"SetParamEntityParsing", (PyCFunction)pyexpat_xmlparser_SetParamEntityParsing, METH_O, pyexpat_xmlparser_SetParamEntityParsing__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetParamEntityParsing_impl(xmlparseobject *self, int flag);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetParamEntityParsing(PyObject *self, PyObject *arg)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
int flag;
|
|
|
|
flag = PyLong_AsInt(arg);
|
|
if (flag == -1 && PyErr_Occurred()) {
|
|
goto exit;
|
|
}
|
|
return_value = pyexpat_xmlparser_SetParamEntityParsing_impl((xmlparseobject *)self, flag);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
#if (XML_COMBINED_VERSION >= 19505)
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_UseForeignDTD__doc__,
|
|
"UseForeignDTD($self, flag=True, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Allows the application to provide an artificial external subset if one is not specified as part of the document instance.\n"
|
|
"\n"
|
|
"This readily allows the use of a \'default\' document type controlled by the\n"
|
|
"application, while still getting the advantage of providing document type\n"
|
|
"information to the parser. \'flag\' defaults to True if not provided.");
|
|
|
|
#define PYEXPAT_XMLPARSER_USEFOREIGNDTD_METHODDEF \
|
|
{"UseForeignDTD", _PyCFunction_CAST(pyexpat_xmlparser_UseForeignDTD), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, pyexpat_xmlparser_UseForeignDTD__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_UseForeignDTD_impl(xmlparseobject *self, PyTypeObject *cls,
|
|
int flag);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_UseForeignDTD(PyObject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# define KWTUPLE (PyObject *)&_Py_SINGLETON(tuple_empty)
|
|
#else
|
|
# define KWTUPLE NULL
|
|
#endif
|
|
|
|
static const char * const _keywords[] = {"", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "UseForeignDTD",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[1];
|
|
int flag = 1;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 0, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
if (nargs < 1) {
|
|
goto skip_optional_posonly;
|
|
}
|
|
flag = PyObject_IsTrue(args[0]);
|
|
if (flag < 0) {
|
|
goto exit;
|
|
}
|
|
skip_optional_posonly:
|
|
return_value = pyexpat_xmlparser_UseForeignDTD_impl((xmlparseobject *)self, cls, flag);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
#endif /* (XML_COMBINED_VERSION >= 19505) */
|
|
|
|
#if (XML_COMBINED_VERSION >= 20400)
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_SetBillionLaughsAttackProtectionActivationThreshold__doc__,
|
|
"SetBillionLaughsAttackProtectionActivationThreshold($self, threshold, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Sets the number of output bytes needed to activate protection against billion laughs attacks.\n"
|
|
"\n"
|
|
"The number of output bytes includes amplification from entity expansion\n"
|
|
"and reading DTD files.\n"
|
|
"\n"
|
|
"Parser objects usually have a protection activation threshold of 8 MiB,\n"
|
|
"but the actual default value depends on the underlying Expat library.\n"
|
|
"\n"
|
|
"Activation thresholds below 4 MiB are known to break support for DITA 1.3\n"
|
|
"payload and are hence not recommended.");
|
|
|
|
#define PYEXPAT_XMLPARSER_SETBILLIONLAUGHSATTACKPROTECTIONACTIVATIONTHRESHOLD_METHODDEF \
|
|
{"SetBillionLaughsAttackProtectionActivationThreshold", _PyCFunction_CAST(pyexpat_xmlparser_SetBillionLaughsAttackProtectionActivationThreshold), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, pyexpat_xmlparser_SetBillionLaughsAttackProtectionActivationThreshold__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetBillionLaughsAttackProtectionActivationThreshold_impl(xmlparseobject *self,
|
|
PyTypeObject *cls,
|
|
unsigned long long threshold);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetBillionLaughsAttackProtectionActivationThreshold(PyObject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# define KWTUPLE (PyObject *)&_Py_SINGLETON(tuple_empty)
|
|
#else
|
|
# define KWTUPLE NULL
|
|
#endif
|
|
|
|
static const char * const _keywords[] = {"", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "SetBillionLaughsAttackProtectionActivationThreshold",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[1];
|
|
unsigned long long threshold;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 1, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
if (!_PyLong_UnsignedLongLong_Converter(args[0], &threshold)) {
|
|
goto exit;
|
|
}
|
|
return_value = pyexpat_xmlparser_SetBillionLaughsAttackProtectionActivationThreshold_impl((xmlparseobject *)self, cls, threshold);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
#endif /* (XML_COMBINED_VERSION >= 20400) */
|
|
|
|
#if (XML_COMBINED_VERSION >= 20400)
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_SetBillionLaughsAttackProtectionMaximumAmplification__doc__,
|
|
"SetBillionLaughsAttackProtectionMaximumAmplification($self, max_factor,\n"
|
|
" /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Sets the maximum tolerated amplification factor for protection against billion laughs attacks.\n"
|
|
"\n"
|
|
"The amplification factor is calculated as \"(direct + indirect) / direct\"\n"
|
|
"while parsing, where \"direct\" is the number of bytes read from the primary\n"
|
|
"document in parsing and \"indirect\" is the number of bytes added by expanding\n"
|
|
"entities and reading external DTD files, combined.\n"
|
|
"\n"
|
|
"The \'max_factor\' value must be a non-NaN floating point value greater than\n"
|
|
"or equal to 1.0. Amplification factors greater than 30,000 can be observed\n"
|
|
"in the middle of parsing even with benign files in practice. In particular,\n"
|
|
"the activation threshold should be carefully chosen to avoid false positives.\n"
|
|
"\n"
|
|
"Parser objects usually have a maximum amplification factor of 100,\n"
|
|
"but the actual default value depends on the underlying Expat library.");
|
|
|
|
#define PYEXPAT_XMLPARSER_SETBILLIONLAUGHSATTACKPROTECTIONMAXIMUMAMPLIFICATION_METHODDEF \
|
|
{"SetBillionLaughsAttackProtectionMaximumAmplification", _PyCFunction_CAST(pyexpat_xmlparser_SetBillionLaughsAttackProtectionMaximumAmplification), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, pyexpat_xmlparser_SetBillionLaughsAttackProtectionMaximumAmplification__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetBillionLaughsAttackProtectionMaximumAmplification_impl(xmlparseobject *self,
|
|
PyTypeObject *cls,
|
|
float max_factor);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetBillionLaughsAttackProtectionMaximumAmplification(PyObject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# define KWTUPLE (PyObject *)&_Py_SINGLETON(tuple_empty)
|
|
#else
|
|
# define KWTUPLE NULL
|
|
#endif
|
|
|
|
static const char * const _keywords[] = {"", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "SetBillionLaughsAttackProtectionMaximumAmplification",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[1];
|
|
float max_factor;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 1, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
if (PyFloat_CheckExact(args[0])) {
|
|
max_factor = (float) (PyFloat_AS_DOUBLE(args[0]));
|
|
}
|
|
else
|
|
{
|
|
max_factor = (float) PyFloat_AsDouble(args[0]);
|
|
if (max_factor == -1.0 && PyErr_Occurred()) {
|
|
goto exit;
|
|
}
|
|
}
|
|
return_value = pyexpat_xmlparser_SetBillionLaughsAttackProtectionMaximumAmplification_impl((xmlparseobject *)self, cls, max_factor);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
#endif /* (XML_COMBINED_VERSION >= 20400) */
|
|
|
|
#if (XML_COMBINED_VERSION >= 20702)
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_SetAllocTrackerActivationThreshold__doc__,
|
|
"SetAllocTrackerActivationThreshold($self, threshold, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Sets the number of allocated bytes of dynamic memory needed to activate protection against disproportionate use of RAM.\n"
|
|
"\n"
|
|
"Parser objects usually have an allocation activation threshold of 64 MiB,\n"
|
|
"but the actual default value depends on the underlying Expat library.");
|
|
|
|
#define PYEXPAT_XMLPARSER_SETALLOCTRACKERACTIVATIONTHRESHOLD_METHODDEF \
|
|
{"SetAllocTrackerActivationThreshold", _PyCFunction_CAST(pyexpat_xmlparser_SetAllocTrackerActivationThreshold), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, pyexpat_xmlparser_SetAllocTrackerActivationThreshold__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetAllocTrackerActivationThreshold_impl(xmlparseobject *self,
|
|
PyTypeObject *cls,
|
|
unsigned long long threshold);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetAllocTrackerActivationThreshold(PyObject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# define KWTUPLE (PyObject *)&_Py_SINGLETON(tuple_empty)
|
|
#else
|
|
# define KWTUPLE NULL
|
|
#endif
|
|
|
|
static const char * const _keywords[] = {"", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "SetAllocTrackerActivationThreshold",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[1];
|
|
unsigned long long threshold;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 1, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
if (!_PyLong_UnsignedLongLong_Converter(args[0], &threshold)) {
|
|
goto exit;
|
|
}
|
|
return_value = pyexpat_xmlparser_SetAllocTrackerActivationThreshold_impl((xmlparseobject *)self, cls, threshold);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
#endif /* (XML_COMBINED_VERSION >= 20702) */
|
|
|
|
#if (XML_COMBINED_VERSION >= 20702)
|
|
|
|
PyDoc_STRVAR(pyexpat_xmlparser_SetAllocTrackerMaximumAmplification__doc__,
|
|
"SetAllocTrackerMaximumAmplification($self, max_factor, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Sets the maximum amplification factor between direct input and bytes of dynamic memory allocated.\n"
|
|
"\n"
|
|
"The amplification factor is calculated as \"allocated / direct\" while parsing,\n"
|
|
"where \"direct\" is the number of bytes read from the primary document in parsing\n"
|
|
"and \"allocated\" is the number of bytes of dynamic memory allocated in the parser\n"
|
|
"hierarchy.\n"
|
|
"\n"
|
|
"The \'max_factor\' value must be a non-NaN floating point value greater than\n"
|
|
"or equal to 1.0. Amplification factors greater than 100.0 can be observed\n"
|
|
"near the start of parsing even with benign files in practice. In particular,\n"
|
|
"the activation threshold should be carefully chosen to avoid false positives.\n"
|
|
"\n"
|
|
"Parser objects usually have a maximum amplification factor of 100,\n"
|
|
"but the actual default value depends on the underlying Expat library.");
|
|
|
|
#define PYEXPAT_XMLPARSER_SETALLOCTRACKERMAXIMUMAMPLIFICATION_METHODDEF \
|
|
{"SetAllocTrackerMaximumAmplification", _PyCFunction_CAST(pyexpat_xmlparser_SetAllocTrackerMaximumAmplification), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, pyexpat_xmlparser_SetAllocTrackerMaximumAmplification__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetAllocTrackerMaximumAmplification_impl(xmlparseobject *self,
|
|
PyTypeObject *cls,
|
|
float max_factor);
|
|
|
|
static PyObject *
|
|
pyexpat_xmlparser_SetAllocTrackerMaximumAmplification(PyObject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
# define KWTUPLE (PyObject *)&_Py_SINGLETON(tuple_empty)
|
|
#else
|
|
# define KWTUPLE NULL
|
|
#endif
|
|
|
|
static const char * const _keywords[] = {"", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "SetAllocTrackerMaximumAmplification",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[1];
|
|
float max_factor;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 1, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
if (PyFloat_CheckExact(args[0])) {
|
|
max_factor = (float) (PyFloat_AS_DOUBLE(args[0]));
|
|
}
|
|
else
|
|
{
|
|
max_factor = (float) PyFloat_AsDouble(args[0]);
|
|
if (max_factor == -1.0 && PyErr_Occurred()) {
|
|
goto exit;
|
|
}
|
|
}
|
|
return_value = pyexpat_xmlparser_SetAllocTrackerMaximumAmplification_impl((xmlparseobject *)self, cls, max_factor);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
#endif /* (XML_COMBINED_VERSION >= 20702) */
|
|
|
|
PyDoc_STRVAR(pyexpat_ParserCreate__doc__,
|
|
"ParserCreate($module, /, encoding=None, namespace_separator=None,\n"
|
|
" intern=<unrepresentable>)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Return a new XML parser object.");
|
|
|
|
#define PYEXPAT_PARSERCREATE_METHODDEF \
|
|
{"ParserCreate", _PyCFunction_CAST(pyexpat_ParserCreate), METH_FASTCALL|METH_KEYWORDS, pyexpat_ParserCreate__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_ParserCreate_impl(PyObject *module, const char *encoding,
|
|
const char *namespace_separator, PyObject *intern);
|
|
|
|
static PyObject *
|
|
pyexpat_ParserCreate(PyObject *module, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
|
|
|
|
#define NUM_KEYWORDS 3
|
|
static struct {
|
|
PyGC_Head _this_is_not_used;
|
|
PyObject_VAR_HEAD
|
|
Py_hash_t ob_hash;
|
|
PyObject *ob_item[NUM_KEYWORDS];
|
|
} _kwtuple = {
|
|
.ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)
|
|
.ob_hash = -1,
|
|
.ob_item = { &_Py_ID(encoding), &_Py_ID(namespace_separator), &_Py_ID(intern), },
|
|
};
|
|
#undef NUM_KEYWORDS
|
|
#define KWTUPLE (&_kwtuple.ob_base.ob_base)
|
|
|
|
#else // !Py_BUILD_CORE
|
|
# define KWTUPLE NULL
|
|
#endif // !Py_BUILD_CORE
|
|
|
|
static const char * const _keywords[] = {"encoding", "namespace_separator", "intern", NULL};
|
|
static _PyArg_Parser _parser = {
|
|
.keywords = _keywords,
|
|
.fname = "ParserCreate",
|
|
.kwtuple = KWTUPLE,
|
|
};
|
|
#undef KWTUPLE
|
|
PyObject *argsbuf[3];
|
|
Py_ssize_t noptargs = nargs + (kwnames ? PyTuple_GET_SIZE(kwnames) : 0) - 0;
|
|
const char *encoding = NULL;
|
|
const char *namespace_separator = NULL;
|
|
PyObject *intern = NULL;
|
|
|
|
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,
|
|
/*minpos*/ 0, /*maxpos*/ 3, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
|
|
if (!args) {
|
|
goto exit;
|
|
}
|
|
if (!noptargs) {
|
|
goto skip_optional_pos;
|
|
}
|
|
if (args[0]) {
|
|
if (args[0] == Py_None) {
|
|
encoding = NULL;
|
|
}
|
|
else if (PyUnicode_Check(args[0])) {
|
|
Py_ssize_t encoding_length;
|
|
encoding = PyUnicode_AsUTF8AndSize(args[0], &encoding_length);
|
|
if (encoding == NULL) {
|
|
goto exit;
|
|
}
|
|
if (strlen(encoding) != (size_t)encoding_length) {
|
|
PyErr_SetString(PyExc_ValueError, "embedded null character");
|
|
goto exit;
|
|
}
|
|
}
|
|
else {
|
|
_PyArg_BadArgument("ParserCreate", "argument 'encoding'", "str or None", args[0]);
|
|
goto exit;
|
|
}
|
|
if (!--noptargs) {
|
|
goto skip_optional_pos;
|
|
}
|
|
}
|
|
if (args[1]) {
|
|
if (args[1] == Py_None) {
|
|
namespace_separator = NULL;
|
|
}
|
|
else if (PyUnicode_Check(args[1])) {
|
|
Py_ssize_t namespace_separator_length;
|
|
namespace_separator = PyUnicode_AsUTF8AndSize(args[1], &namespace_separator_length);
|
|
if (namespace_separator == NULL) {
|
|
goto exit;
|
|
}
|
|
if (strlen(namespace_separator) != (size_t)namespace_separator_length) {
|
|
PyErr_SetString(PyExc_ValueError, "embedded null character");
|
|
goto exit;
|
|
}
|
|
}
|
|
else {
|
|
_PyArg_BadArgument("ParserCreate", "argument 'namespace_separator'", "str or None", args[1]);
|
|
goto exit;
|
|
}
|
|
if (!--noptargs) {
|
|
goto skip_optional_pos;
|
|
}
|
|
}
|
|
intern = args[2];
|
|
skip_optional_pos:
|
|
return_value = pyexpat_ParserCreate_impl(module, encoding, namespace_separator, intern);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
PyDoc_STRVAR(pyexpat_ErrorString__doc__,
|
|
"ErrorString($module, code, /)\n"
|
|
"--\n"
|
|
"\n"
|
|
"Returns string error for given number.");
|
|
|
|
#define PYEXPAT_ERRORSTRING_METHODDEF \
|
|
{"ErrorString", (PyCFunction)pyexpat_ErrorString, METH_O, pyexpat_ErrorString__doc__},
|
|
|
|
static PyObject *
|
|
pyexpat_ErrorString_impl(PyObject *module, long code);
|
|
|
|
static PyObject *
|
|
pyexpat_ErrorString(PyObject *module, PyObject *arg)
|
|
{
|
|
PyObject *return_value = NULL;
|
|
long code;
|
|
|
|
code = PyLong_AsLong(arg);
|
|
if (code == -1 && PyErr_Occurred()) {
|
|
goto exit;
|
|
}
|
|
return_value = pyexpat_ErrorString_impl(module, code);
|
|
|
|
exit:
|
|
return return_value;
|
|
}
|
|
|
|
#ifndef PYEXPAT_XMLPARSER_USEFOREIGNDTD_METHODDEF
|
|
#define PYEXPAT_XMLPARSER_USEFOREIGNDTD_METHODDEF
|
|
#endif /* !defined(PYEXPAT_XMLPARSER_USEFOREIGNDTD_METHODDEF) */
|
|
|
|
#ifndef PYEXPAT_XMLPARSER_SETBILLIONLAUGHSATTACKPROTECTIONACTIVATIONTHRESHOLD_METHODDEF
|
|
#define PYEXPAT_XMLPARSER_SETBILLIONLAUGHSATTACKPROTECTIONACTIVATIONTHRESHOLD_METHODDEF
|
|
#endif /* !defined(PYEXPAT_XMLPARSER_SETBILLIONLAUGHSATTACKPROTECTIONACTIVATIONTHRESHOLD_METHODDEF) */
|
|
|
|
#ifndef PYEXPAT_XMLPARSER_SETBILLIONLAUGHSATTACKPROTECTIONMAXIMUMAMPLIFICATION_METHODDEF
|
|
#define PYEXPAT_XMLPARSER_SETBILLIONLAUGHSATTACKPROTECTIONMAXIMUMAMPLIFICATION_METHODDEF
|
|
#endif /* !defined(PYEXPAT_XMLPARSER_SETBILLIONLAUGHSATTACKPROTECTIONMAXIMUMAMPLIFICATION_METHODDEF) */
|
|
|
|
#ifndef PYEXPAT_XMLPARSER_SETALLOCTRACKERACTIVATIONTHRESHOLD_METHODDEF
|
|
#define PYEXPAT_XMLPARSER_SETALLOCTRACKERACTIVATIONTHRESHOLD_METHODDEF
|
|
#endif /* !defined(PYEXPAT_XMLPARSER_SETALLOCTRACKERACTIVATIONTHRESHOLD_METHODDEF) */
|
|
|
|
#ifndef PYEXPAT_XMLPARSER_SETALLOCTRACKERMAXIMUMAMPLIFICATION_METHODDEF
|
|
#define PYEXPAT_XMLPARSER_SETALLOCTRACKERMAXIMUMAMPLIFICATION_METHODDEF
|
|
#endif /* !defined(PYEXPAT_XMLPARSER_SETALLOCTRACKERMAXIMUMAMPLIFICATION_METHODDEF) */
|
|
/*[clinic end generated code: output=81101a16a409daf6 input=a9049054013a1b77]*/
|