System::Session::set_dtd_processing_state

Introduced : BIG-IP_v12.0.0
Sets the state for all future iControl SOAP requests whether or not to process SOAP requests received with Document Type Definitions (DTDs). This is set to STATE_DISABLED by default. Only administrators can set this value. This was introduced in BIG-IP_v12.0.0 to conform to SOAP specifications that disallow DTDs. SOAP requests that use DTDs will return a “parsing aborted” error and not parse the request. This will also set the “iControl.DTDParsing” DB variable to “enable” or “disable” respectively. If modifying the DB variable directly, restart httpd to make the changes go into effect.

Prototype

 set_dtd_processing_state(
    in EnabledState state
);

Parameters

Parameter Type Description
state EnabledState State to allow DTD parsing for SOAP requests.

Return Type

Type Description
void  

Exceptions

Exception Description
Common::AccessDenied Raised if the client credentials are not valid.
Common::InvalidArgument Raised if one of the arguments is invalid.
Common::OperationFailed Raised if an operation error occurs.

See Also

iControl ::
iControl :: System :: Session

Warning

The links to the sample code below are remnants of the old DevCentral wiki and will result in a 404 error. For best results, please copy the link text and search the codeshare directly on DevCentral.

Sample Code


Copyright © 1996-2012, F5 Networks, Inc. All rights reserved.

The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.