1 files changed, 40 insertions, 0 deletions
diff --git a/java/gov/nist/javax/sip/SipProviderExt.java b/java/gov/nist/javax/sip/SipProviderExt.java
new file mode 100644
index 0000000..d955aca
--- /dev/null
+++ b/java/gov/nist/javax/sip/SipProviderExt.java
@@ -0,0 +1,40 @@
+package gov.nist.javax.sip;
+
+import javax.sip.SipProvider;
+
+/**
+ * Extensions to SipProvider under consideration for Version 2.0.
+ * 
+ * @since 2.0
+ */
+
+public interface SipProviderExt extends SipProvider {
+    /**
+     * Sets a flag that indicates that automatic error handling is enabled for this dialog (the
+     * default when automatic dialog support is enabled). This flag is set by default to TRUE when
+     * the Dialog is automatically created by the provider ( automatic dialog support is true) and
+     * set to FALSE by default when the Dialog is created under program control ( automatic dialog
+     * support is false). When this flag is set to true, the stack will automatically send the
+     * following errors :
+     * 
+     * <ul>
+     * <li> <b>500 Request Out of Order </b> for in-dialog requests that arrive out of order.
+     * <li> <b>482 Loop Detected </b> When a loop is detected for merged INVITE requests.
+     * <li> <b>400 Bad request </b> when a REFER is sent without a matching refer-to dialog.
+     * </ul>
+     * If this flag is set to false, the stack will not drop out of sequence ACKs but will pass
+     * these up to the application for handling.
+     * 
+     * This flag is automatically set to true if any of the the following conditions is true:
+     * <ul>
+     * <li>The Back To Back User Agent flag is enabled for the Dialog.</li>
+     * <li>The Automatic Dialog Support flag is enabled for the Dialog </li>
+     * </ul>
+     * 
+     * This flag should only be set at the time of Dialog creation ( before the Dialog has seen its first
+     * request or response). If set subsequently, the behavior of the flag is undefined.
+     * 
+     * @since 2.0
+     */
+    public void setDialogErrorsAutomaticallyHandled();
+}