Added custom I/O control support to the CIFS server to support the client

side Windows application to expose repo specific functions such as check in/out.

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@2058 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/filesys/server/filesys/FileName.java

@@ -48,8 +48,6 @@ public final class FileName
     public static String buildPath(String dev, String path, String filename, char sep)
     {
 
-        // Debug.println ( "BuildPath: dev=" + dev + ", path=" + path + ",filename=" + filename);
-
         // Build the path string
 
         StringBuffer fullPath = new StringBuffer();
@@ -102,10 +100,6 @@ public final class FileName
                 fullPath.append(filename);
         }
 
-        // Debug
-
-        // Debug.println ( "BuildPath: " + fullPath.toString ());
-
         // Convert the file seperator characters in the path if we are not using the normal
         // DOS file seperator character.
 

source/java/org/alfresco/filesys/server/filesys/IOControlNotImplementedException.java

@@ -0,0 +1,48 @@
+/*
+ * Copyright (C) 2005 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific
+ * language governing permissions and limitations under the
+ * License.
+ */
+
+package org.alfresco.filesys.server.filesys;
+
+/**
+ * I/O Control Not Implemented Exception Class
+ * 
+ * <p>This exception may be thrown by an IOCtlInterface implementation.
+ * 
+ * @author gkspencer
+ */
+public class IOControlNotImplementedException extends Exception
+{
+    private static final long serialVersionUID = -7107739317519497749L;
+
+    /**
+     * Default constructor.
+     */
+    public IOControlNotImplementedException()
+    {
+        super();
+    }
+
+    /**
+     * Class constructor.
+     * 
+     * @param s java.lang.String
+     */
+    public IOControlNotImplementedException(String s)
+    {
+        super(s);
+    }
+}

source/java/org/alfresco/filesys/server/filesys/IOCtlInterface.java

@@ -0,0 +1,50 @@
+/*
+ * Copyright (C) 2005 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific
+ * language governing permissions and limitations under the
+ * License.
+ */
+
+package org.alfresco.filesys.server.filesys;
+
+import org.alfresco.filesys.server.SrvSession;
+import org.alfresco.filesys.smb.SMBException;
+import org.alfresco.filesys.util.DataBuffer;
+
+/**
+ * IO Control Interface
+ * 
+ * <p>Optional interface that a DiskInterface driver can implement to enable NT I/O control function
+ * processing.
+ * 
+ * @author gkspencer
+ */
+public interface IOCtlInterface
+{
+    /**
+     * Process a filesystem I/O control request
+     * 
+     * @param sess Server session
+     * @param tree Tree connection.
+     * @param ctrlCode I/O control code
+     * @param fid File id
+     * @param dataBuf I/O control specific input data
+     * @param isFSCtrl true if this is a filesystem control, or false for a device control
+     * @param filter if bit0 is set indicates that the control applies to the share root handle
+     * @return DataBuffer
+     * @exception IOControlNotImplementedException
+     * @exception SMBException
+     */
+    public DataBuffer processIOControl(SrvSession sess, TreeConnection tree, int ctrlCode, int fid, DataBuffer dataBuf,
+            boolean isFSCtrl, int filter) throws IOControlNotImplementedException, SMBException;
+}