jellyfin/Emby.Server.Implementations/IO/SharpCifs/Smb/SmbFile.cs

// This code is derived from jcifs smb client library <jcifs at samba dot org>
// Ported by J. Arturo <webmaster at komodosoft dot net>
//  
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
// 
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
// 
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Text;
using SharpCifs.Dcerpc;
using SharpCifs.Dcerpc.Msrpc;
using SharpCifs.Netbios;
using SharpCifs.Util;
using SharpCifs.Util.Sharpen;

namespace SharpCifs.Smb
{
    /// <summary>This class represents a resource on an SMB network.</summary>
    /// <remarks>
    /// This class represents a resource on an SMB network. Mainly these
    /// resources are files and directories however an <code>SmbFile</code>
    /// may also refer to servers and workgroups. If the resource is a file or
    /// directory the methods of <code>SmbFile</code> follow the behavior of
    /// the well known
    /// <see cref="FilePath">Sharpen.FilePath</see>
    /// class. One fundamental difference
    /// is the usage of a URL scheme [1] to specify the target file or
    /// directory. SmbFile URLs have the following syntax:
    /// <blockquote><pre>
    /// smb://[[[domain;]username[:password]@]server[:port]/[[share/[dir/]file]]][?[param=value[param2=value2[...]]]
    /// </pre></blockquote>
    /// This example:
    /// <blockquote><pre>
    /// smb://storage15/public/foo.txt
    /// </pre></blockquote>
    /// would reference the file <code>foo.txt</code> in the share
    /// <code>public</code> on the server <code>storage15</code>. In addition
    /// to referencing files and directories, jCIFS can also address servers,
    /// and workgroups.
    /// <p>
    /// <font color="#800000"><i>Important: all SMB URLs that represent
    /// workgroups, servers, shares, or directories require a trailing slash '/'.
    /// </i></font>
    /// <p>
    /// When using the <tt>java.net.URL</tt> class with
    /// 'smb://' URLs it is necessary to first call the static
    /// <tt>jcifs.Config.registerSmbURLHandler();</tt> method. This is required
    /// to register the SMB protocol handler.
    /// <p>
    /// The userinfo component of the SMB URL (<tt>domain;user:pass</tt>) must
    /// be URL encoded if it contains reserved characters. According to RFC 2396
    /// these characters are non US-ASCII characters and most meta characters
    /// however jCIFS will work correctly with anything but '@' which is used
    /// to delimit the userinfo component from the server and '%' which is the
    /// URL escape character itself.
    /// <p>
    /// The server
    /// component may a traditional NetBIOS name, a DNS name, or IP
    /// address. These name resolution mechanisms and their resolution order
    /// can be changed (See <a href="../../../resolver.html">Setting Name
    /// Resolution Properties</a>). The servername and path components are
    /// not case sensitive but the domain, username, and password components
    /// are. It is also likely that properties must be specified for jcifs
    /// to function (See <a href="../../overview-summary.html#scp">Setting
    /// JCIFS Properties</a>). Here are some examples of SMB URLs with brief
    /// descriptions of what they do:
    /// <p>[1] This URL scheme is based largely on the <i>SMB
    /// Filesharing URL Scheme</i> IETF draft.
    /// <p><table border="1" cellpadding="3" cellspacing="0" width="100%">
    /// <tr bgcolor="#ccccff">
    /// <td colspan="2"><b>SMB URL Examples</b></td>
    /// <tr><td width="20%"><b>URL</b></td><td><b>Description</b></td></tr>
    /// <tr><td width="20%"><code>smb://users-nyc;miallen:mypass@angus/tmp/</code></td><td>
    /// This URL references a share called <code>tmp</code> on the server
    /// <code>angus</code> as user <code>miallen</code> who's password is
    /// <code>mypass</code>.
    /// </td></tr>
    /// <tr><td width="20%">
    /// <code>smb://Administrator:P%40ss@msmith1/c/WINDOWS/Desktop/foo.txt</code></td><td>
    /// A relativly sophisticated example that references a file
    /// <code>msmith1</code>'s desktop as user <code>Administrator</code>. Notice the '@' is URL encoded with the '%40' hexcode escape.
    /// </td></tr>
    /// <tr><td width="20%"><code>smb://angus/</code></td><td>
    /// This references only a server. The behavior of some methods is different
    /// in this context(e.g. you cannot <code>delete</code> a server) however
    /// as you might expect the <code>list</code> method will list the available
    /// shares on this server.
    /// </td></tr>
    /// <tr><td width="20%"><code>smb://myworkgroup/</code></td><td>
    /// This syntactically is identical to the above example. However if
    /// <code>myworkgroup</code> happends to be a workgroup(which is indeed
    /// suggested by the name) the <code>list</code> method will return
    /// a list of servers that have registered themselves as members of
    /// <code>myworkgroup</code>.
    /// </td></tr>
    /// <tr><td width="20%"><code>smb://</code></td><td>
    /// Just as <code>smb://server/</code> lists shares and
    /// <code>smb://workgroup/</code> lists servers, the <code>smb://</code>
    /// URL lists all available workgroups on a netbios LAN. Again,
    /// in this context many methods are not valid and return default
    /// values(e.g. <code>isHidden</code> will always return false).
    /// </td></tr>
    /// <tr><td width="20%"><code>smb://angus.foo.net/d/jcifs/pipes.doc</code></td><td>
    /// The server name may also be a DNS name as it is in this example. See
    /// <a href="../../../resolver.html">Setting Name Resolution Properties</a>
    /// for details.
    /// </td></tr>
    /// <tr><td width="20%"><code>smb://192.168.1.15/ADMIN$/</code></td><td>
    /// The server name may also be an IP address. See &lt;a
    /// href="../../../resolver.html"&gt;Setting Name Resolution Properties</a>
    /// for details.
    /// </td></tr>
    /// <tr><td width="20%">
    /// <code>smb://domain;username:password@server/share/path/to/file.txt</code></td><td>
    /// A prototypical example that uses all the fields.
    /// </td></tr>
    /// <tr><td width="20%"><code>smb://myworkgroup/angus/ &lt;-- ILLEGAL </code></td><td>
    /// Despite the hierarchial relationship between workgroups, servers, and
    /// filesystems this example is not valid.
    /// </td></tr>
    /// <tr><td width="20%">
    /// <code>smb://server/share/path/to/dir &lt;-- ILLEGAL </code></td><td>
    /// URLs that represent workgroups, servers, shares, or directories require a trailing slash '/'.
    /// </td></tr>
    /// <tr><td width="20%">
    /// <code>smb://MYGROUP/?SERVER=192.168.10.15</code></td><td>
    /// SMB URLs support some query string parameters. In this example
    /// the <code>SERVER</code> parameter is used to override the
    /// server name service lookup to contact the server 192.168.10.15
    /// (presumably known to be a master
    /// browser) for the server list in workgroup <code>MYGROUP</code>.
    /// </td></tr>
    /// </table>
    /// <p>A second constructor argument may be specified to augment the URL
    /// for better programmatic control when processing many files under
    /// a common base. This is slightly different from the corresponding
    /// <code>java.io.File</code> usage; a '/' at the beginning of the second
    /// parameter will still use the server component of the first parameter. The
    /// examples below illustrate the resulting URLs when this second contructor
    /// argument is used.
    /// <p><table border="1" cellpadding="3" cellspacing="0" width="100%">
    /// <tr bgcolor="#ccccff">
    /// <td colspan="3">
    /// <b>Examples Of SMB URLs When Augmented With A Second Constructor Parameter</b></td>
    /// <tr><td width="20%">
    /// <b>First Parameter</b></td><td><b>Second Parameter</b></td><td><b>Result</b></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://host/share/a/b/
    /// </code></td><td width="20%"><code>
    /// c/d/
    /// </code></td><td><code>
    /// smb://host/share/a/b/c/d/
    /// </code></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://host/share/foo/bar/
    /// </code></td><td width="20%"><code>
    /// /share2/zig/zag
    /// </code></td><td><code>
    /// smb://host/share2/zig/zag
    /// </code></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://host/share/foo/bar/
    /// </code></td><td width="20%"><code>
    /// ../zip/
    /// </code></td><td><code>
    /// smb://host/share/foo/zip/
    /// </code></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://host/share/zig/zag
    /// </code></td><td width="20%"><code>
    /// smb://foo/bar/
    /// </code></td><td><code>
    /// smb://foo/bar/
    /// </code></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://host/share/foo/
    /// </code></td><td width="20%"><code>
    /// ../.././.././../foo/
    /// </code></td><td><code>
    /// smb://host/foo/
    /// </code></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://host/share/zig/zag
    /// </code></td><td width="20%"><code>
    /// /
    /// </code></td><td><code>
    /// smb://host/
    /// </code></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://server/
    /// </code></td><td width="20%"><code>
    /// ../
    /// </code></td><td><code>
    /// smb://server/
    /// </code></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://
    /// </code></td><td width="20%"><code>
    /// myworkgroup/
    /// </code></td><td><code>
    /// smb://myworkgroup/
    /// </code></td></tr>
    /// <tr><td width="20%"><code>
    /// smb://myworkgroup/
    /// </code></td><td width="20%"><code>
    /// angus/
    /// </code></td><td><code>
    /// smb://myworkgroup/angus/ &lt;-- ILLEGAL<br />(But if you first create an <tt>SmbFile</tt> with 'smb://workgroup/' and use and use it as the first parameter to a constructor that accepts it with a second <tt>String</tt> parameter jCIFS will factor out the 'workgroup'.)
    /// </code></td></tr>
    /// </table>
    /// <p>Instances of the <code>SmbFile</code> class are immutable; that is,
    /// once created, the abstract pathname represented by an SmbFile object
    /// will never change.
    /// </remarks>
    /// <seealso cref="FilePath">Sharpen.FilePath</seealso>
    public class SmbFile : UrlConnection
    {
        internal const int ORdonly = 0x01;

        internal const int OWronly = 0x02;

        internal const int ORdwr = 0x03;

        internal const int OAppend = 0x04;

        internal const int OCreat = 0x0010;

        internal const int OExcl = 0x0020;

        internal const int OTrunc = 0x0040;

        /// <summary>
        /// When specified as the <tt>shareAccess</tt> constructor parameter,
        /// other SMB clients (including other threads making calls into jCIFS)
        /// will not be permitted to access the target file and will receive "The
        /// file is being accessed by another process" message.
        /// </summary>
        /// <remarks>
        /// When specified as the <tt>shareAccess</tt> constructor parameter,
        /// other SMB clients (including other threads making calls into jCIFS)
        /// will not be permitted to access the target file and will receive "The
        /// file is being accessed by another process" message.
        /// </remarks>
        public const int FileNoShare = 0x00;

        /// <summary>
        /// When specified as the <tt>shareAccess</tt> constructor parameter,
        /// other SMB clients will be permitted to read from the target file while
        /// this file is open.
        /// </summary>
        /// <remarks>
        /// When specified as the <tt>shareAccess</tt> constructor parameter,
        /// other SMB clients will be permitted to read from the target file while
        /// this file is open. This constant may be logically OR'd with other share
        /// access flags.
        /// </remarks>
        public const int FileShareRead = 0x01;

        /// <summary>
        /// When specified as the <tt>shareAccess</tt> constructor parameter,
        /// other SMB clients will be permitted to write to the target file while
        /// this file is open.
        /// </summary>
        /// <remarks>
        /// When specified as the <tt>shareAccess</tt> constructor parameter,
        /// other SMB clients will be permitted to write to the target file while
        /// this file is open. This constant may be logically OR'd with other share
        /// access flags.
        /// </remarks>
        public const int FileShareWrite = 0x02;

        /// <summary>
        /// When specified as the <tt>shareAccess</tt> constructor parameter,
        /// other SMB clients will be permitted to delete the target file while
        /// this file is open.
        /// </summary>
        /// <remarks>
        /// When specified as the <tt>shareAccess</tt> constructor parameter,
        /// other SMB clients will be permitted to delete the target file while
        /// this file is open. This constant may be logically OR'd with other share
        /// access flags.
        /// </remarks>
        public const int FileShareDelete = 0x04;

        /// <summary>
        /// A file with this bit on as returned by <tt>getAttributes()</tt> or set
        /// with <tt>setAttributes()</tt> will be read-only
        /// </summary>
        public const int AttrReadonly = 0x01;

        /// <summary>
        /// A file with this bit on as returned by <tt>getAttributes()</tt> or set
        /// with <tt>setAttributes()</tt> will be hidden
        /// </summary>
        public const int AttrHidden = 0x02;

        /// <summary>
        /// A file with this bit on as returned by <tt>getAttributes()</tt> or set
        /// with <tt>setAttributes()</tt> will be a system file
        /// </summary>
        public const int AttrSystem = 0x04;

        /// <summary>
        /// A file with this bit on as returned by <tt>getAttributes()</tt> is
        /// a volume
        /// </summary>
        public const int AttrVolume = 0x08;

        /// <summary>
        /// A file with this bit on as returned by <tt>getAttributes()</tt> is
        /// a directory
        /// </summary>
        public const int AttrDirectory = 0x10;

        /// <summary>
        /// A file with this bit on as returned by <tt>getAttributes()</tt> or set
        /// with <tt>setAttributes()</tt> is an archived file
        /// </summary>
        public const int AttrArchive = 0x20;

        internal const int AttrCompressed = 0x800;

        internal const int AttrNormal = 0x080;

        internal const int AttrTemporary = 0x100;

        internal const int AttrGetMask = 0x7FFF;

        internal const int AttrSetMask = 0x30A7;

        internal const int DefaultAttrExpirationPeriod = 5000;

        internal static readonly int HashDot = ".".GetHashCode();

        internal static readonly int HashDotDot = "..".GetHashCode();

        //internal static LogStream log = LogStream.GetInstance();
        public LogStream Log
        {
            get { return LogStream.GetInstance(); }
        }

        internal static long AttrExpirationPeriod;

        internal static bool IgnoreCopyToException;

        static SmbFile()
        {
            // Open Function Encoding
            // create if the file does not exist
            // fail if the file exists
            // truncate if the file exists
            // share access
            // file attribute encoding
            // extended file attribute encoding(others same as above)
            /*try
            {
                Sharpen.Runtime.GetType("jcifs.Config");
            }
            catch (TypeLoadException cnfe)
            {
                Sharpen.Runtime.PrintStackTrace(cnfe);
            }*/

            AttrExpirationPeriod = Config.GetLong("jcifs.smb.client.attrExpirationPeriod", DefaultAttrExpirationPeriod
                );
            IgnoreCopyToException = Config.GetBoolean("jcifs.smb.client.ignoreCopyToException"
                , true);
            Dfs = new Dfs();
        }

        /// <summary>
        /// Returned by
        /// <see cref="GetType()">GetType()</see>
        /// if the resource this <tt>SmbFile</tt>
        /// represents is a regular file or directory.
        /// </summary>
        public const int TypeFilesystem = 0x01;

        /// <summary>
        /// Returned by
        /// <see cref="GetType()">GetType()</see>
        /// if the resource this <tt>SmbFile</tt>
        /// represents is a workgroup.
        /// </summary>
        public const int TypeWorkgroup = 0x02;

        /// <summary>
        /// Returned by
        /// <see cref="GetType()">GetType()</see>
        /// if the resource this <tt>SmbFile</tt>
        /// represents is a server.
        /// </summary>
        public const int TypeServer = 0x04;

        /// <summary>
        /// Returned by
        /// <see cref="GetType()">GetType()</see>
        /// if the resource this <tt>SmbFile</tt>
        /// represents is a share.
        /// </summary>
        public const int TypeShare = 0x08;

        /// <summary>
        /// Returned by
        /// <see cref="GetType()">GetType()</see>
        /// if the resource this <tt>SmbFile</tt>
        /// represents is a named pipe.
        /// </summary>
        public const int TypeNamedPipe = 0x10;

        /// <summary>
        /// Returned by
        /// <see cref="GetType()">GetType()</see>
        /// if the resource this <tt>SmbFile</tt>
        /// represents is a printer.
        /// </summary>
        public const int TypePrinter = 0x20;

        /// <summary>
        /// Returned by
        /// <see cref="GetType()">GetType()</see>
        /// if the resource this <tt>SmbFile</tt>
        /// represents is a communications device.
        /// </summary>
        public const int TypeComm = 0x40;

        private string _canon;

        private string _share;

        private long _createTime;

        private long _lastModified;

        private int _attributes;

        private long _attrExpiration;

        private long _size;

        private long _sizeExpiration;

        private bool _isExists;

        private int _shareAccess = FileShareRead | FileShareWrite | FileShareDelete;

        private bool _enableDfs = Config.GetBoolean("jcifs.smb.client.enabledfs", false);

        private SmbComBlankResponse _blankResp;

        private DfsReferral _dfsReferral;

        protected internal static Dfs Dfs;

        internal NtlmPasswordAuthentication Auth;

        internal SmbTree Tree;

        internal string Unc;

        internal int Fid;

        internal int Type;

        internal bool Opened;

        internal int TreeNum;

        public bool EnableDfs
        {
            get { return _enableDfs; }
            set { _enableDfs = value; }
        }

        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such as
        /// a file or directory.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such as
        /// a file or directory. See the description and examples of smb URLs above.
        /// </remarks>
        /// <param name="url">A URL string</param>
        /// <exception cref="System.UriFormatException">
        /// If the <code>parent</code> and <code>child</code> parameters
        /// do not follow the prescribed syntax
        /// </exception>
        public SmbFile(string url)
            : this(new Uri(url))
        {
        }

        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory. The second parameter is a relative path from
        /// the <code>parent SmbFile</code>. See the description above for examples
        /// of using the second <code>name</code> parameter.
        /// </remarks>
        /// <param name="context">A base <code>SmbFile</code></param>
        /// <param name="name">A path string relative to the <code>parent</code> paremeter</param>
        /// <exception cref="System.UriFormatException">
        /// If the <code>parent</code> and <code>child</code> parameters
        /// do not follow the prescribed syntax
        /// </exception>
        /// <exception cref="UnknownHostException">If the server or workgroup of the <tt>context</tt> file cannot be determined
        /// 	</exception>
        public SmbFile(SmbFile context, string name)
            : this(context.IsWorkgroup0
                () ? new Uri("smb://" + name) : new Uri(context.Url.AbsoluteUri + name),
                context.Auth)
        {

            this._enableDfs = context.EnableDfs;

            if (!context.IsWorkgroup0())
            {
                Addresses = context.Addresses;

                if (context._share != null)
                {
                    Tree = context.Tree;
                    _dfsReferral = context._dfsReferral;
                }                
            }
        }

        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory. The second parameter is a relative path from
        /// the <code>parent</code>. See the description above for examples of
        /// using the second <code>chile</code> parameter.
        /// </remarks>
        /// <param name="context">A URL string</param>
        /// <param name="name">A path string relative to the <code>context</code> paremeter</param>
        /// <exception cref="System.UriFormatException">
        /// If the <code>context</code> and <code>name</code> parameters
        /// do not follow the prescribed syntax
        /// </exception>
        /*public SmbFile(string context, string name)
            : this(new Uri(new Uri(null, context), name))
        {
        }*/

        public SmbFile(string context, string name)
            : this(new Uri(context + name))
        {

        }


        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory.
        /// </remarks>
        /// <param name="url">A URL string</param>
        /// <param name="auth">The credentials the client should use for authentication</param>
        /// <exception cref="System.UriFormatException">If the <code>url</code> parameter does not follow the prescribed syntax
        /// 	</exception>
        public SmbFile(string url, NtlmPasswordAuthentication auth)
            : this(new Uri(url, UriKind.RelativeOrAbsolute),
             auth)
        {

        }

        /// <summary>Constructs an SmbFile representing a file on an SMB network.</summary>
        /// <remarks>
        /// Constructs an SmbFile representing a file on an SMB network. The
        /// <tt>shareAccess</tt> parameter controls what permissions other
        /// clients have when trying to access the same file while this instance
        /// is still open. This value is either <tt>FILE_NO_SHARE</tt> or any
        /// combination of <tt>FILE_SHARE_READ</tt>, <tt>FILE_SHARE_WRITE</tt>,
        /// and <tt>FILE_SHARE_DELETE</tt> logically OR'd together.
        /// </remarks>
        /// <param name="url">A URL string</param>
        /// <param name="auth">The credentials the client should use for authentication</param>
        /// <param name="shareAccess">Specifies what access other clients have while this file is open.
        /// 	</param>
        /// <exception cref="System.UriFormatException">If the <code>url</code> parameter does not follow the prescribed syntax
        /// 	</exception>
        public SmbFile(string url, NtlmPasswordAuthentication auth, int shareAccess)
            : this
                (new Uri(url), auth)
        {
            // Initially null; set by getUncPath; dir must end with '/'
            // Can be null
            // For getDfsPath() and getServerWithDfs()
            // Cannot be null
            // Initially null
            // Initially null; set by getUncPath; never ends with '/'
            // Initially 0; set by open()
            if ((shareAccess & ~(FileShareRead | FileShareWrite | FileShareDelete)) !=
                0)
            {
                throw new RuntimeException("Illegal shareAccess parameter");
            }
            this._shareAccess = shareAccess;
        }

        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory. The second parameter is a relative path from
        /// the <code>context</code>. See the description above for examples of
        /// using the second <code>name</code> parameter.
        /// </remarks>
        /// <param name="context">A URL string</param>
        /// <param name="name">A path string relative to the <code>context</code> paremeter</param>
        /// <param name="auth">The credentials the client should use for authentication</param>
        /// <exception cref="System.UriFormatException">
        /// If the <code>context</code> and <code>name</code> parameters
        /// do not follow the prescribed syntax
        /// </exception>
        public SmbFile(string context, string name, NtlmPasswordAuthentication auth)
            : this
                (new Uri(context + name)
                , auth)
        {

        }


        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory. The second parameter is a relative path from
        /// the <code>context</code>. See the description above for examples of
        /// using the second <code>name</code> parameter. The <tt>shareAccess</tt>
        /// parameter controls what permissions other clients have when trying
        /// to access the same file while this instance is still open. This
        /// value is either <tt>FILE_NO_SHARE</tt> or any combination
        /// of <tt>FILE_SHARE_READ</tt>, <tt>FILE_SHARE_WRITE</tt>, and
        /// <tt>FILE_SHARE_DELETE</tt> logically OR'd together.
        /// </remarks>
        /// <param name="context">A URL string</param>
        /// <param name="name">A path string relative to the <code>context</code> paremeter</param>
        /// <param name="auth">The credentials the client should use for authentication</param>
        /// <param name="shareAccess">Specifies what access other clients have while this file is open.
        /// 	</param>
        /// <exception cref="System.UriFormatException">
        /// If the <code>context</code> and <code>name</code> parameters
        /// do not follow the prescribed syntax
        /// </exception>
        public SmbFile(string context, string name, NtlmPasswordAuthentication auth, int
            shareAccess)
            : this(new Uri(context + name), auth)
        {
            if ((shareAccess & ~(FileShareRead | FileShareWrite | FileShareDelete)) !=
                0)
            {
                throw new RuntimeException("Illegal shareAccess parameter");
            }
            this._shareAccess = shareAccess;
        }

        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory. The second parameter is a relative path from
        /// the <code>context</code>. See the description above for examples of
        /// using the second <code>name</code> parameter. The <tt>shareAccess</tt>
        /// parameter controls what permissions other clients have when trying
        /// to access the same file while this instance is still open. This
        /// value is either <tt>FILE_NO_SHARE</tt> or any combination
        /// of <tt>FILE_SHARE_READ</tt>, <tt>FILE_SHARE_WRITE</tt>, and
        /// <tt>FILE_SHARE_DELETE</tt> logically OR'd together.
        /// </remarks>
        /// <param name="context">A base <code>SmbFile</code></param>
        /// <param name="name">A path string relative to the <code>context</code> file path</param>
        /// <param name="shareAccess">Specifies what access other clients have while this file is open.
        /// 	</param>
        /// <exception cref="System.UriFormatException">
        /// If the <code>context</code> and <code>name</code> parameters
        /// do not follow the prescribed syntax
        /// </exception>
        /// <exception cref="UnknownHostException"></exception>
        public SmbFile(SmbFile context, string name, int shareAccess)
            : this(context.IsWorkgroup0() ? new Uri("smb://" + name) : new Uri(
                          context.Url.AbsoluteUri + name), context.Auth)
        {
            if ((shareAccess & ~(FileShareRead | FileShareWrite | FileShareDelete)) !=
                0)
            {
                throw new RuntimeException("Illegal shareAccess parameter");
            }

            if (!context.IsWorkgroup0())
            {
                this.Addresses = context.Addresses;

                if (context._share != null || context.Tree != null)
                {
                    Tree = context.Tree;
                    _dfsReferral = context._dfsReferral;
                }
            }

            this._shareAccess = shareAccess;
            this._enableDfs = context.EnableDfs;
        }

        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory from a <tt>URL</tt> object.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory from a <tt>URL</tt> object.
        /// </remarks>
        /// <param name="url">The URL of the target resource</param>
        protected SmbFile(Uri url)
            : this(url, new NtlmPasswordAuthentication(url.GetUserInfo
                ()))
        {
        }

        /// <summary>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory from a <tt>URL</tt> object and an
        /// <tt>NtlmPasswordAuthentication</tt> object.
        /// </summary>
        /// <remarks>
        /// Constructs an SmbFile representing a resource on an SMB network such
        /// as a file or directory from a <tt>URL</tt> object and an
        /// <tt>NtlmPasswordAuthentication</tt> object.
        /// </remarks>
        /// <param name="url">The URL of the target resource</param>
        /// <param name="auth">The credentials the client should use for authentication</param>
        public SmbFile(Uri url, NtlmPasswordAuthentication auth)
        {
            this.Auth = auth ?? new NtlmPasswordAuthentication(url.GetUserInfo());
            Url = url;
            GetUncPath0();
        }

        /// <exception cref="System.UriFormatException"></exception>
        /// <exception cref="UnknownHostException"></exception>
        /*internal SmbFile(Jcifs.Smb.SmbFile context, string name, int type, int attributes
            , long createTime, long lastModified, long size)
            : this(context.IsWorkgroup0() ?
                new Uri(null, "smb://" + name + "/") : new Uri(context.url,
                name + ((attributes & ATTR_DIRECTORY) > 0 ? "/" : string.Empty)))*/
        internal SmbFile(SmbFile context, string name, int type, int attributes
            , long createTime, long lastModified, long size)
            : this(context.IsWorkgroup0() ?
                new Uri("smb://" + name + "/") : new Uri(context.Url.AbsoluteUri +
                name + ((attributes & AttrDirectory) > 0 ? "/" : string.Empty)))
        {
            Auth = context.Auth;
            if (context._share != null)
            {
                Tree = context.Tree;
                _dfsReferral = context._dfsReferral;
            }
            int last = name.Length - 1;
            if (name[last] == '/')
            {
                name = Runtime.Substring(name, 0, last);
            }
            if (context._share == null)
            {
                Unc = "\\";
            }
            else
            {
                if (context.Unc.Equals("\\"))
                {
                    Unc = '\\' + name;
                }
                else
                {
                    Unc = context.Unc + '\\' + name;
                }
            }

            if (!context.IsWorkgroup0())
            {
                Addresses = context.Addresses;
            }

            this._enableDfs = context.EnableDfs;

            this.Type = type;
            this._attributes = attributes;
            this._createTime = createTime;
            this._lastModified = lastModified;
            this._size = size;
            _isExists = true;
            _attrExpiration = _sizeExpiration = Runtime.CurrentTimeMillis() + AttrExpirationPeriod;
        }

        private SmbComBlankResponse Blank_resp()
        {
            if (_blankResp == null)
            {
                _blankResp = new SmbComBlankResponse();
            }
            return _blankResp;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void ResolveDfs(ServerMessageBlock request)
        {
            if (!_enableDfs)
            {
                Connect0();
                return;
            }

            if (request is SmbComClose)
            {
                return;
            }
            Connect0();
            DfsReferral dr = Dfs.Resolve(Tree.Session.transport.TconHostName, Tree.Share, Unc
                , Auth);
            if (dr != null)
            {
                string service = null;
                if (request != null)
                {
                    switch (request.Command)
                    {
                        case ServerMessageBlock.SmbComTransaction:
                        case ServerMessageBlock.SmbComTransaction2:
                            {
                                switch (((SmbComTransaction)request).SubCommand & 0xFF)
                                {
                                    case SmbComTransaction.Trans2GetDfsReferral:
                                        {
                                            break;
                                        }

                                    default:
                                        {
                                            service = "A:";
                                            break;
                                        }
                                }
                                break;
                            }

                        default:
                            {
                                service = "A:";
                                break;
                            }
                    }
                }
                DfsReferral start = dr;
                SmbException se = null;
                do
                {
                    try
                    {
                        if (Log.Level >= 2)
                        {
                            Log.WriteLine("DFS redirect: " + dr);
                        }
                        UniAddress addr = UniAddress.GetByName(dr.Server);
                        SmbTransport trans = SmbTransport.GetSmbTransport(addr, Url.Port);
                        trans.Connect();
                        Tree = trans.GetSmbSession(Auth).GetSmbTree(dr.Share, service);
                        if (dr != start && dr.Key != null)
                        {
                            dr.Map.Put(dr.Key, dr);
                        }
                        se = null;
                        break;
                    }
                    catch (IOException ioe)
                    {
                        if (ioe is SmbException)
                        {
                            se = (SmbException)ioe;
                        }
                        else
                        {
                            se = new SmbException(dr.Server, ioe);
                        }
                    }
                    dr = dr.Next;
                }
                while (dr != start);
                if (se != null)
                {
                    throw se;
                }
                if (Log.Level >= 3)
                {
                    Log.WriteLine(dr);
                }
                _dfsReferral = dr;
                if (dr.PathConsumed < 0)
                {
                    dr.PathConsumed = 0;
                }
                else
                {
                    if (dr.PathConsumed > Unc.Length)
                    {
                        dr.PathConsumed = Unc.Length;
                    }
                }
                string dunc = Runtime.Substring(Unc, dr.PathConsumed);
                if (dunc.Equals(string.Empty))
                {
                    dunc = "\\";
                }
                if (!dr.Path.Equals(string.Empty))
                {
                    dunc = "\\" + dr.Path + dunc;
                }
                Unc = dunc;
                if (request != null && request.Path != null && request.Path.EndsWith("\\") && dunc
                    .EndsWith("\\") == false)
                {
                    dunc += "\\";
                }
                if (request != null)
                {
                    request.Path = dunc;
                    request.Flags2 |= SmbConstants.Flags2ResolvePathsInDfs;
                }
            }
            else
            {
                if (Tree.InDomainDfs && !(request is NtTransQuerySecurityDesc) && !(request is SmbComClose
                    ) && !(request is SmbComFindClose2))
                {
                    throw new SmbException(NtStatus.NtStatusNotFound, false);
                }
                if (request != null)
                {
                    request.Flags2 &= ~SmbConstants.Flags2ResolvePathsInDfs;
                }
            }
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void Send(ServerMessageBlock request, ServerMessageBlock response
            )
        {
            for (; ; )
            {
                ResolveDfs(request);
                try
                {
                    Tree.Send(request, response);
                    break;
                }
                catch (DfsReferral dre)
                {
                    if (dre.ResolveHashes)
                    {
                        throw;
                    }
                    request.Reset();
                }
            }
        }

        internal static string QueryLookup(string query, string param)
        {
            char[] instr = query.ToCharArray();
            int i;
            int ch;
            int st;
            int eq;
            st = eq = 0;
            for (i = 0; i < instr.Length; i++)
            {
                ch = instr[i];
                if (ch == '&')
                {
                    if (eq > st)
                    {
                        string p = new string(instr, st, eq - st);
                        if (Runtime.EqualsIgnoreCase(p, param))
                        {
                            eq++;
                            return new string(instr, eq, i - eq);
                        }
                    }
                    st = i + 1;
                }
                else
                {
                    if (ch == '=')
                    {
                        eq = i;
                    }
                }
            }
            if (eq > st)
            {
                string p = new string(instr, st, eq - st);
                if (Runtime.EqualsIgnoreCase(p, param))
                {
                    eq++;
                    return new string(instr, eq, instr.Length - eq);
                }
            }
            return null;
        }

        internal UniAddress[] Addresses;

        internal int AddressIndex;

        /// <exception cref="UnknownHostException"></exception>
        internal virtual UniAddress GetAddress()
        {
            if (AddressIndex == 0)
            {
                return GetFirstAddress();
            }
            return Addresses[AddressIndex - 1];
        }

        /// <exception cref="UnknownHostException"></exception>
        internal virtual UniAddress GetFirstAddress()
        {
            AddressIndex = 0;
            string host = Url.GetHost();
            string path = Url.AbsolutePath;
            string query = Url.GetQuery();

            if (Addresses != null && Addresses.Length > 0)
            {
                return GetNextAddress();
            }

            if (query != null)
            {
                string server = QueryLookup(query, "server");
                if (!string.IsNullOrEmpty(server))
                {
                    Addresses = new UniAddress[1];
                    Addresses[0] = UniAddress.GetByName(server);
                    return GetNextAddress();
                }
                string address = QueryLookup(query, "address");
                if (!string.IsNullOrEmpty(address))
                {
                    byte[] ip = Extensions.GetAddressByName(address).GetAddressBytes();
                    Addresses = new UniAddress[1];
                    //addresses[0] = new UniAddress(IPAddress.Parse(host, ip));
                    Addresses[0] = new UniAddress(IPAddress.Parse(host));
                    return GetNextAddress();
                }
            }
            if (host.Length == 0)
            {
                try
                {
                    NbtAddress addr = NbtAddress.GetByName(NbtAddress.MasterBrowserName, 0x01, null);
                    Addresses = new UniAddress[1];
                    Addresses[0] = UniAddress.GetByName(addr.GetHostAddress());
                }
                catch (UnknownHostException uhe)
                {
                    NtlmPasswordAuthentication.InitDefaults();
                    if (NtlmPasswordAuthentication.DefaultDomain.Equals("?"))
                    {
                        throw;
                    }
                    Addresses = UniAddress.GetAllByName(NtlmPasswordAuthentication.DefaultDomain, true
                        );
                }
            }
            else
            {
                if (path.Length == 0 || path.Equals("/"))
                {
                    Addresses = UniAddress.GetAllByName(host, true);
                }
                else
                {
                    Addresses = UniAddress.GetAllByName(host, false);
                }
            }
            return GetNextAddress();
        }

        internal virtual UniAddress GetNextAddress()
        {
            UniAddress addr = null;
            if (AddressIndex < Addresses.Length)
            {
                addr = Addresses[AddressIndex++];
            }
            return addr;
        }

        internal virtual bool HasNextAddress()
        {
            return AddressIndex < Addresses.Length;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void Connect0()
        {
            try
            {
                Connect();
            }
            catch (UnknownHostException uhe)
            {
                throw new SmbException("Failed to connect to server", uhe);
            }
            catch (SmbException se)
            {
                throw;
            }
            catch (IOException ioe)
            {
                throw new SmbException("Failed to connect to server", ioe);
            }
        }

        /// <exception cref="System.IO.IOException"></exception>
        internal virtual void DoConnect()
        {
            SmbTransport trans;
            UniAddress addr;
            addr = GetAddress();

            if (Tree != null && Tree.Session.transport.Address.Equals(addr))
            {
                trans = Tree.Session.transport;
            }
            else
            {
                trans = SmbTransport.GetSmbTransport(addr, Url.Port);
                Tree = trans.GetSmbSession(Auth).GetSmbTree(_share, null);
            }


            string hostName = GetServerWithDfs();
            if (_enableDfs)
            {
                Tree.InDomainDfs = Dfs.Resolve(hostName, Tree.Share, null, Auth) != null;
            }
            if (Tree.InDomainDfs)
            {
                Tree.ConnectionState = 2;
            }
            try
            {
                if (Log.Level >= 3)
                {
                    Log.WriteLine("doConnect: " + addr);
                }
                Tree.TreeConnect(null, null);
            }
            catch (SmbAuthException sae)
            {
                NtlmPasswordAuthentication a;
                SmbSession ssn;
                if (_share == null)
                {
                    // IPC$ - try "anonymous" credentials
                    ssn = trans.GetSmbSession(NtlmPasswordAuthentication.Null);
                    Tree = ssn.GetSmbTree(null, null);
                    Tree.TreeConnect(null, null);
                }
                else
                {
                    if ((a = NtlmAuthenticator.RequestNtlmPasswordAuthentication(Url.ToString(), sae)
                        ) != null)
                    {
                        Auth = a;
                        ssn = trans.GetSmbSession(Auth);
                        Tree = ssn.GetSmbTree(_share, null);
                        Tree.InDomainDfs = Dfs.Resolve(hostName, Tree.Share, null, Auth) != null;
                        if (Tree.InDomainDfs)
                        {
                            Tree.ConnectionState = 2;
                        }
                        Tree.TreeConnect(null, null);
                    }
                    else
                    {
                        if (Log.Level >= 1 && HasNextAddress())
                        {
                            Runtime.PrintStackTrace(sae, Log);
                        }
                        throw;
                    }
                }
            }
        }

        /// <summary>It is not necessary to call this method directly.</summary>
        /// <remarks>
        /// It is not necessary to call this method directly. This is the
        /// <tt>URLConnection</tt> implementation of <tt>connect()</tt>.
        /// </remarks>
        /// <exception cref="System.IO.IOException"></exception>
        public void Connect()
        {
            SmbTransport trans;
            SmbSession ssn;
            UniAddress addr;
            if (IsConnected())
            {
                return;
            }
            GetUncPath0();
            GetFirstAddress();
            for (; ; )
            {
                try
                {
                    DoConnect();
                    return;
                }
                catch (SmbAuthException sae)
                {
                    throw;
                }
                catch (SmbException se)
                {
                    // Prevents account lockout on servers with multiple IPs
                    if (GetNextAddress() == null)
                    {
                        throw;
                    }
                    else
                    {
                        RemoveCurrentAddress();
                    }

                    if (Log.Level >= 3)
                    {
                        Runtime.PrintStackTrace(se, Log);
                    }
                }
            }
        }

        internal virtual bool IsConnected()
        {
            return Tree != null && Tree.ConnectionState == 2;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual int Open0(int flags, int access, int attrs, int options)
        {
            int f;
            Connect0();
            if (Log.Level >= 3)
            {
                Log.WriteLine("open0: " + Unc);
            }
            if (Tree.Session.transport.HasCapability(SmbConstants.CapNtSmbs))
            {
                SmbComNtCreateAndXResponse response = new SmbComNtCreateAndXResponse();
                SmbComNtCreateAndX request = new SmbComNtCreateAndX(Unc, flags, access, _shareAccess
                    , attrs, options, null);
                if (this is SmbNamedPipe)
                {
                    request.Flags0 |= 0x16;
                    request.DesiredAccess |= 0x20000;
                    response.IsExtended = true;
                }
                Send(request, response);
                f = response.Fid;
                _attributes = response.ExtFileAttributes & AttrGetMask;
                _attrExpiration = Runtime.CurrentTimeMillis() + AttrExpirationPeriod;
                _isExists = true;
            }
            else
            {
                SmbComOpenAndXResponse response = new SmbComOpenAndXResponse();
                Send(new SmbComOpenAndX(Unc, access, flags, null), response);
                f = response.Fid;
            }
            return f;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void Open(int flags, int access, int attrs, int options)
        {
            if (IsOpen())
            {
                return;
            }
            Fid = Open0(flags, access, attrs, options);
            Opened = true;
            TreeNum = Tree.TreeNum;
        }

        internal virtual bool IsOpen()
        {
            bool ans = Opened && IsConnected() && TreeNum == Tree.TreeNum;
            return ans;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void Close(int f, long lastWriteTime)
        {
            if (Log.Level >= 3)
            {
                Log.WriteLine("close: " + f);
            }
            Send(new SmbComClose(f, lastWriteTime), Blank_resp());
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void Close(long lastWriteTime)
        {
            if (IsOpen() == false)
            {
                return;
            }
            Close(Fid, lastWriteTime);
            Opened = false;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void Close()
        {
            Close(0L);
        }

        /// <summary>
        /// Returns the <tt>NtlmPasswordAuthentication</tt> object used as
        /// credentials with this file or pipe.
        /// </summary>
        /// <remarks>
        /// Returns the <tt>NtlmPasswordAuthentication</tt> object used as
        /// credentials with this file or pipe. This can be used to retrieve the
        /// username for example:
        /// <tt>
        /// String username = f.getPrincipal().getName();
        /// </tt>
        /// The <tt>Principal</tt> object returned will never be <tt>null</tt>
        /// however the username can be <tt>null</tt> indication anonymous
        /// credentials were used (e.g. some IPC$ services).
        /// </remarks>
        public virtual Principal GetPrincipal()
        {
            return Auth;
        }

        /// <summary>Returns the last component of the target URL.</summary>
        /// <remarks>
        /// Returns the last component of the target URL. This will
        /// effectively be the name of the file or directory represented by this
        /// <code>SmbFile</code> or in the case of URLs that only specify a server
        /// or workgroup, the server or workgroup will be returned. The name of
        /// the root URL <code>smb://</code> is also <code>smb://</code>. If this
        /// <tt>SmbFile</tt> refers to a workgroup, server, share, or directory,
        /// the name will include a trailing slash '/' so that composing new
        /// <tt>SmbFile</tt>s will maintain the trailing slash requirement.
        /// </remarks>
        /// <returns>
        /// The last component of the URL associated with this SMB
        /// resource or <code>smb://</code> if the resource is <code>smb://</code>
        /// itself.
        /// </returns>
        public virtual string GetName()
        {
            GetUncPath0();
            if (_canon.Length > 1)
            {
                int i = _canon.Length - 2;
                while (_canon[i] != '/')
                {
                    i--;
                }
                return Runtime.Substring(_canon, i + 1);
            }
            if (_share != null)
            {
                return _share + '/';
            }
            if (Url.GetHost().Length > 0)
            {
                return Url.GetHost() + '/';
            }
            return "smb://";
        }

        /// <summary>
        /// Everything but the last component of the URL representing this SMB
        /// resource is effectivly it's parent.
        /// </summary>
        /// <remarks>
        /// Everything but the last component of the URL representing this SMB
        /// resource is effectivly it's parent. The root URL <code>smb://</code>
        /// does not have a parent. In this case <code>smb://</code> is returned.
        /// </remarks>
        /// <returns>
        /// The parent directory of this SMB resource or
        /// <code>smb://</code> if the resource refers to the root of the URL
        /// hierarchy which incedentally is also <code>smb://</code>.
        /// </returns>
        public virtual string GetParent()
        {
            string str = Url.Authority;
            if (str.Length > 0)
            {
                StringBuilder sb = new StringBuilder("smb://");
                sb.Append(str);
                GetUncPath0();
                if (_canon.Length > 1)
                {
                    sb.Append(_canon);
                }
                else
                {
                    sb.Append('/');
                }
                str = sb.ToString();
                int i = str.Length - 2;
                while (str[i] != '/')
                {
                    i--;
                }
                return Runtime.Substring(str, 0, i + 1);
            }
            return "smb://";
        }

        /// <summary>Returns the full uncanonicalized URL of this SMB resource.</summary>
        /// <remarks>
        /// Returns the full uncanonicalized URL of this SMB resource. An
        /// <code>SmbFile</code> constructed with the result of this method will
        /// result in an <code>SmbFile</code> that is equal to the original.
        /// </remarks>
        /// <returns>The uncanonicalized full URL of this SMB resource.</returns>
        public virtual string GetPath()
        {
            return Url.ToString();
        }

        internal virtual string GetUncPath0()
        {
            if (Unc == null)
            {
                char[] instr = Url.LocalPath.ToCharArray();
                char[] outstr = new char[instr.Length];
                int length = instr.Length;
                int i;
                int o;
                int state;

                state = 0;
                o = 0;
                for (i = 0; i < length; i++)
                {
                    switch (state)
                    {
                        case 0:
                            {
                                if (instr[i] != '/')
                                {
                                    return null;
                                }
                                outstr[o++] = instr[i];
                                state = 1;
                                break;
                            }

                        case 1:
                            {
                                if (instr[i] == '/')
                                {
                                    break;
                                }
                                if (instr[i] == '.' && ((i + 1) >= length || instr[i + 1] == '/'))
                                {
                                    i++;
                                    break;
                                }
                                if ((i + 1) < length && instr[i] == '.' && instr[i + 1] == '.' && ((i + 2) >= length
                                                                                               || instr[i + 2] == '/'))
                                {
                                    i += 2;
                                    if (o == 1)
                                    {
                                        break;
                                    }
                                    do
                                    {
                                        o--;
                                    }
                                    while (o > 1 && outstr[o - 1] != '/');
                                    break;
                                }
                                state = 2;
                                goto case 2;
                            }

                        case 2:
                            {
                                if (instr[i] == '/')
                                {
                                    state = 1;
                                }
                                outstr[o++] = instr[i];
                                break;
                            }
                    }
                }
                _canon = new string(outstr, 0, o);
                if (o > 1)
                {
                    o--;
                    i = _canon.IndexOf('/', 1);
                    if (i < 0)
                    {
                        _share = Runtime.Substring(_canon, 1);
                        Unc = "\\";
                    }
                    else
                    {
                        if (i == o)
                        {
                            _share = Runtime.Substring(_canon, 1, i);
                            Unc = "\\";
                        }
                        else
                        {
                            _share = Runtime.Substring(_canon, 1, i);
                            Unc = Runtime.Substring(_canon, i, outstr[o] == '/' ? o : o + 1);
                            Unc = Unc.Replace('/', '\\');
                        }
                    }
                }
                else
                {
                    _share = null;
                    Unc = "\\";
                }
            }
            return Unc;
        }

        /// <summary>Retuns the Windows UNC style path with backslashs intead of forward slashes.
        /// 	</summary>
        /// <remarks>Retuns the Windows UNC style path with backslashs intead of forward slashes.
        /// 	</remarks>
        /// <returns>The UNC path.</returns>
        public virtual string GetUncPath()
        {
            GetUncPath0();
            if (_share == null)
            {
                return "\\\\" + Url.GetHost();
            }
            return "\\\\" + Url.GetHost() + _canon.Replace('/', '\\');
        }

        /// <summary>
        /// Returns the full URL of this SMB resource with '.' and '..' components
        /// factored out.
        /// </summary>
        /// <remarks>
        /// Returns the full URL of this SMB resource with '.' and '..' components
        /// factored out. An <code>SmbFile</code> constructed with the result of
        /// this method will result in an <code>SmbFile</code> that is equal to
        /// the original.
        /// </remarks>
        /// <returns>The canonicalized URL of this SMB resource.</returns>
        public virtual string GetCanonicalPath()
        {
            string str = Url.Authority;
            GetUncPath0();
            if (str.Length > 0)
            {
                return "smb://" + Url.Authority + _canon;
            }
            return "smb://";
        }

        /// <summary>Retrieves the share associated with this SMB resource.</summary>
        /// <remarks>
        /// Retrieves the share associated with this SMB resource. In
        /// the case of <code>smb://</code>, <code>smb://workgroup/</code>,
        /// and <code>smb://server/</code> URLs which do not specify a share,
        /// <code>null</code> will be returned.
        /// </remarks>
        /// <returns>The share component or <code>null</code> if there is no share</returns>
        public virtual string GetShare()
        {
            return _share;
        }

        internal virtual string GetServerWithDfs()
        {
            if (_dfsReferral != null)
            {
                return _dfsReferral.Server;
            }
            return GetServer();
        }

        /// <summary>Retrieve the hostname of the server for this SMB resource.</summary>
        /// <remarks>
        /// Retrieve the hostname of the server for this SMB resource. If this
        /// <code>SmbFile</code> references a workgroup, the name of the workgroup
        /// is returned. If this <code>SmbFile</code> refers to the root of this
        /// SMB network hierarchy, <code>null</code> is returned.
        /// </remarks>
        /// <returns>
        /// The server or workgroup name or <code>null</code> if this
        /// <code>SmbFile</code> refers to the root <code>smb://</code> resource.
        /// </returns>
        public virtual string GetServer()
        {
            string str = Url.GetHost();
            if (str.Length == 0)
            {
                return null;
            }
            return str;
        }

        /// <summary>Returns type of of object this <tt>SmbFile</tt> represents.</summary>
        /// <remarks>Returns type of of object this <tt>SmbFile</tt> represents.</remarks>
        /// <returns>
        /// <tt>TYPE_FILESYSTEM, TYPE_WORKGROUP, TYPE_SERVER, TYPE_SHARE,
        /// TYPE_PRINTER, TYPE_NAMED_PIPE</tt>, or <tt>TYPE_COMM</tt>.
        /// </returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public new virtual int GetType()
        {
            if (Type == 0)
            {
                if (GetUncPath0().Length > 1)
                {
                    Type = TypeFilesystem;
                }
                else
                {
                    if (_share != null)
                    {
                        // treeConnect good enough to test service type
                        Connect0();
                        if (_share.Equals("IPC$"))
                        {
                            Type = TypeNamedPipe;
                        }
                        else
                        {
                            if (Tree.Service.Equals("LPT1:"))
                            {
                                Type = TypePrinter;
                            }
                            else
                            {
                                if (Tree.Service.Equals("COMM"))
                                {
                                    Type = TypeComm;
                                }
                                else
                                {
                                    Type = TypeShare;
                                }
                            }
                        }
                    }
                    else
                    {
                        if (string.IsNullOrEmpty(Url.Authority))
                        {
                            Type = TypeWorkgroup;
                        }
                        else
                        {
                            UniAddress addr;
                            try
                            {
                                addr = GetAddress();
                            }
                            catch (UnknownHostException uhe)
                            {
                                throw new SmbException(Url.ToString(), uhe);
                            }
                            if (addr.GetAddress() is NbtAddress)
                            {
                                int code = ((NbtAddress)addr.GetAddress()).GetNameType();
                                if (code == 0x1d || code == 0x1b)
                                {
                                    Type = TypeWorkgroup;
                                    return Type;
                                }
                            }
                            Type = TypeServer;
                        }
                    }
                }
            }
            return Type;
        }

        /// <exception cref="UnknownHostException"></exception>
        internal virtual bool IsWorkgroup0()
        {
            if (Type == TypeWorkgroup || Url.GetHost().Length == 0)
            {
                Type = TypeWorkgroup;
                return true;
            }
            GetUncPath0();
            if (_share == null)
            {
                UniAddress addr = GetAddress();
                if (addr.GetAddress() is NbtAddress)
                {
                    int code = ((NbtAddress)addr.GetAddress()).GetNameType();
                    if (code == 0x1d || code == 0x1b)
                    {
                        Type = TypeWorkgroup;
                        return true;
                    }
                }
                Type = TypeServer;
            }
            return false;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual IInfo QueryPath(string path, int infoLevel)
        {
            Connect0();
            if (Log.Level >= 3)
            {
                Log.WriteLine("queryPath: " + path);
            }
            if (Tree.Session.transport.HasCapability(SmbConstants.CapNtSmbs))
            {
                Trans2QueryPathInformationResponse response = new Trans2QueryPathInformationResponse
                    (infoLevel);
                Send(new Trans2QueryPathInformation(path, infoLevel), response);
                return response.Info;
            }
            else
            {
                SmbComQueryInformationResponse response = new SmbComQueryInformationResponse(Tree
                    .Session.transport.Server.ServerTimeZone * 1000 * 60L);
                Send(new SmbComQueryInformation(path), response);
                return response;
            }
        }

        /// <summary>Tests to see if the SMB resource exists.</summary>
        /// <remarks>
        /// Tests to see if the SMB resource exists. If the resource refers
        /// only to a server, this method determines if the server exists on the
        /// network and is advertising SMB services. If this resource refers to
        /// a workgroup, this method determines if the workgroup name is valid on
        /// the local SMB network. If this <code>SmbFile</code> refers to the root
        /// <code>smb://</code> resource <code>true</code> is always returned. If
        /// this <code>SmbFile</code> is a traditional file or directory, it will
        /// be queried for on the specified server as expected.
        /// </remarks>
        /// <returns>
        /// <code>true</code> if the resource exists or is alive or
        /// <code>false</code> otherwise
        /// </returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual bool Exists()
        {
            if (_attrExpiration > Runtime.CurrentTimeMillis())
            {
                return _isExists;
            }
            _attributes = AttrReadonly | AttrDirectory;
            _createTime = 0L;
            _lastModified = 0L;
            _isExists = false;
            try
            {
                if (Url.GetHost().Length == 0)
                {
                }
                else
                {
                    if (_share == null)
                    {
                        if (GetType() == TypeWorkgroup)
                        {
                            UniAddress.GetByName(Url.GetHost(), true);
                        }
                        else
                        {
                            UniAddress.GetByName(Url.GetHost()).GetHostName();
                        }
                    }
                    else
                    {
                        if (GetUncPath0().Length == 1 || Runtime.EqualsIgnoreCase(_share, "IPC$"))
                        {
                            Connect0();
                        }
                        else
                        {
                            // treeConnect is good enough
                            IInfo info = QueryPath(GetUncPath0(), Trans2QueryPathInformationResponse.SMB_QUERY_FILE_BASIC_INFO
                                );
                            _attributes = info.GetAttributes();
                            _createTime = info.GetCreateTime();
                            _lastModified = info.GetLastWriteTime();
                        }
                    }
                }
                _isExists = true;
            }
            catch (UnknownHostException)
            {
            }
            catch (SmbException se)
            {
                switch (se.GetNtStatus())
                {
                    case NtStatus.NtStatusNoSuchFile:
                    case NtStatus.NtStatusObjectNameInvalid:
                    case NtStatus.NtStatusObjectNameNotFound:
                    case NtStatus.NtStatusObjectPathNotFound:
                        {
                            break;
                        }

                    default:
                        {
                            throw;
                        }
                }
            }
            _attrExpiration = Runtime.CurrentTimeMillis() + AttrExpirationPeriod;
            return _isExists;
        }

        /// <summary>
        /// Tests to see if the file this <code>SmbFile</code> represents can be
        /// read.
        /// </summary>
        /// <remarks>
        /// Tests to see if the file this <code>SmbFile</code> represents can be
        /// read. Because any file, directory, or other resource can be read if it
        /// exists, this method simply calls the <code>exists</code> method.
        /// </remarks>
        /// <returns><code>true</code> if the file is read-only</returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual bool CanRead()
        {
            if (GetType() == TypeNamedPipe)
            {
                // try opening the pipe for reading?
                return true;
            }
            return Exists();
        }

        // try opening and catch sharing violation?
        /// <summary>
        /// Tests to see if the file this <code>SmbFile</code> represents
        /// exists and is not marked read-only.
        /// </summary>
        /// <remarks>
        /// Tests to see if the file this <code>SmbFile</code> represents
        /// exists and is not marked read-only. By default, resources are
        /// considered to be read-only and therefore for <code>smb://</code>,
        /// <code>smb://workgroup/</code>, and <code>smb://server/</code> resources
        /// will be read-only.
        /// </remarks>
        /// <returns>
        /// <code>true</code> if the resource exists is not marked
        /// read-only
        /// </returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual bool CanWrite()
        {
            if (GetType() == TypeNamedPipe)
            {
                // try opening the pipe for writing?
                return true;
            }
            return Exists() && (_attributes & AttrReadonly) == 0;
        }

        /// <summary>Tests to see if the file this <code>SmbFile</code> represents is a directory.
        /// 	</summary>
        /// <remarks>Tests to see if the file this <code>SmbFile</code> represents is a directory.
        /// 	</remarks>
        /// <returns><code>true</code> if this <code>SmbFile</code> is a directory</returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual bool IsDirectory()
        {
            if (GetUncPath0().Length == 1)
            {
                return true;
            }
            if (!Exists())
            {
                return false;
            }
            return (_attributes & AttrDirectory) == AttrDirectory;
        }

        /// <summary>Tests to see if the file this <code>SmbFile</code> represents is not a directory.
        /// 	</summary>
        /// <remarks>Tests to see if the file this <code>SmbFile</code> represents is not a directory.
        /// 	</remarks>
        /// <returns><code>true</code> if this <code>SmbFile</code> is not a directory</returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual bool IsFile()
        {
            if (GetUncPath0().Length == 1)
            {
                return false;
            }
            Exists();
            return (_attributes & AttrDirectory) == 0;
        }

        /// <summary>
        /// Tests to see if the file this SmbFile represents is marked as
        /// hidden.
        /// </summary>
        /// <remarks>
        /// Tests to see if the file this SmbFile represents is marked as
        /// hidden. This method will also return true for shares with names that
        /// end with '$' such as <code>IPC$</code> or <code>C$</code>.
        /// </remarks>
        /// <returns><code>true</code> if the <code>SmbFile</code> is marked as being hidden</returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual bool IsHidden()
        {
            if (_share == null)
            {
                return false;
            }
            if (GetUncPath0().Length == 1)
            {
                if (_share.EndsWith("$"))
                {
                    return true;
                }
                return false;
            }
            Exists();
            return (_attributes & AttrHidden) == AttrHidden;
        }

        /// <summary>
        /// If the path of this <code>SmbFile</code> falls within a DFS volume,
        /// this method will return the referral path to which it maps.
        /// </summary>
        /// <remarks>
        /// If the path of this <code>SmbFile</code> falls within a DFS volume,
        /// this method will return the referral path to which it maps. Otherwise
        /// <code>null</code> is returned.
        /// </remarks>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual string GetDfsPath()
        {
            ResolveDfs(null);
            if (_dfsReferral == null)
            {
                return null;
            }
            string path = "smb:/" + _dfsReferral.Server + "/" + _dfsReferral.Share + Unc;
            path = path.Replace('\\', '/');
            if (IsDirectory())
            {
                path += '/';
            }
            return path;
        }

        /// <summary>Retrieve the time this <code>SmbFile</code> was created.</summary>
        /// <remarks>
        /// Retrieve the time this <code>SmbFile</code> was created. The value
        /// returned is suitable for constructing a
        /// <see cref="System.DateTime">System.DateTime</see>
        /// object
        /// (i.e. seconds since Epoch 1970). Times should be the same as those
        /// reported using the properties dialog of the Windows Explorer program.
        /// For Win95/98/Me this is actually the last write time. It is currently
        /// not possible to retrieve the create time from files on these systems.
        /// </remarks>
        /// <returns>
        /// The number of milliseconds since the 00:00:00 GMT, January 1,
        /// 1970 as a <code>long</code> value
        /// </returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual long CreateTime()
        {
            if (GetUncPath0().Length > 1)
            {
                Exists();
                return _createTime;
            }
            return 0L;
        }

        /// <summary>
        /// Retrieve the last time the file represented by this
        /// <code>SmbFile</code> was modified.
        /// </summary>
        /// <remarks>
        /// Retrieve the last time the file represented by this
        /// <code>SmbFile</code> was modified. The value returned is suitable for
        /// constructing a
        /// <see cref="System.DateTime">System.DateTime</see>
        /// object (i.e. seconds since Epoch
        /// 1970). Times should be the same as those reported using the properties
        /// dialog of the Windows Explorer program.
        /// </remarks>
        /// <returns>
        /// The number of milliseconds since the 00:00:00 GMT, January 1,
        /// 1970 as a <code>long</code> value
        /// </returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual long LastModified()
        {
            if (GetUncPath0().Length > 1)
            {
                Exists();
                return _lastModified;
            }
            return 0L;
        }

        /// <summary>List the contents of this SMB resource.</summary>
        /// <remarks>
        /// List the contents of this SMB resource. The list returned by this
        /// method will be;
        /// <ul>
        /// <li> files and directories contained within this resource if the
        /// resource is a normal disk file directory,
        /// <li> all available NetBIOS workgroups or domains if this resource is
        /// the top level URL <code>smb://</code>,
        /// <li> all servers registered as members of a NetBIOS workgroup if this
        /// resource refers to a workgroup in a <code>smb://workgroup/</code> URL,
        /// <li> all browseable shares of a server including printers, IPC
        /// services, or disk volumes if this resource is a server URL in the form
        /// <code>smb://server/</code>,
        /// <li> or <code>null</code> if the resource cannot be resolved.
        /// </ul>
        /// </remarks>
        /// <returns>
        /// A <code>String[]</code> array of files and directories,
        /// workgroups, servers, or shares depending on the context of the
        /// resource URL
        /// </returns>
        /// <exception cref="SmbException"></exception>
        public virtual string[] List()
        {
            return List("*", AttrDirectory | AttrHidden | AttrSystem, null, null);
        }

        /// <summary>List the contents of this SMB resource.</summary>
        /// <remarks>
        /// List the contents of this SMB resource. The list returned will be
        /// identical to the list returned by the parameterless <code>list()</code>
        /// method minus filenames filtered by the specified filter.
        /// </remarks>
        /// <param name="filter">a filename filter to exclude filenames from the results</param>
        /// <exception cref="SmbException"># @return An array of filenames</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual string[] List(ISmbFilenameFilter filter)
        {
            return List("*", AttrDirectory | AttrHidden | AttrSystem, filter, null);
        }

        /// <summary>
        /// List the contents of this SMB resource as an array of
        /// <code>SmbFile</code> objects.
        /// </summary>
        /// <remarks>
        /// List the contents of this SMB resource as an array of
        /// <code>SmbFile</code> objects. This method is much more efficient than
        /// the regular <code>list</code> method when querying attributes of each
        /// file in the result set.
        /// <p>
        /// The list of <code>SmbFile</code>s returned by this method will be;
        /// <ul>
        /// <li> files and directories contained within this resource if the
        /// resource is a normal disk file directory,
        /// <li> all available NetBIOS workgroups or domains if this resource is
        /// the top level URL <code>smb://</code>,
        /// <li> all servers registered as members of a NetBIOS workgroup if this
        /// resource refers to a workgroup in a <code>smb://workgroup/</code> URL,
        /// <li> all browseable shares of a server including printers, IPC
        /// services, or disk volumes if this resource is a server URL in the form
        /// <code>smb://server/</code>,
        /// <li> or <code>null</code> if the resource cannot be resolved.
        /// </ul>
        /// </remarks>
        /// <returns>
        /// An array of <code>SmbFile</code> objects representing file
        /// and directories, workgroups, servers, or shares depending on the context
        /// of the resource URL
        /// </returns>
        /// <exception cref="SmbException"></exception>
        public virtual SmbFile[] ListFiles()
        {
            return ListFiles("*", AttrDirectory | AttrHidden | AttrSystem, null, null);
        }

        /// <summary>
        /// The CIFS protocol provides for DOS "wildcards" to be used as
        /// a performance enhancement.
        /// </summary>
        /// <remarks>
        /// The CIFS protocol provides for DOS "wildcards" to be used as
        /// a performance enhancement. The client does not have to filter
        /// the names and the server does not have to return all directory
        /// entries.
        /// <p>
        /// The wildcard expression may consist of two special meta
        /// characters in addition to the normal filename characters. The '*'
        /// character matches any number of characters in part of a name. If
        /// the expression begins with one or more '?'s then exactly that
        /// many characters will be matched whereas if it ends with '?'s
        /// it will match that many characters <i>or less</i>.
        /// <p>
        /// Wildcard expressions will not filter workgroup names or server names.
        /// <blockquote><pre>
        /// winnt&gt; ls c?o
        /// clock.avi                  -rw--      82944 Mon Oct 14 1996 1:38 AM
        /// Cookies                    drw--          0 Fri Nov 13 1998 9:42 PM
        /// 2 items in 5ms
        /// </pre></blockquote>
        /// </remarks>
        /// <param name="wildcard">a wildcard expression</param>
        /// <exception cref="SmbException">SmbException</exception>
        /// <returns>
        /// An array of <code>SmbFile</code> objects representing file
        /// and directories, workgroups, servers, or shares depending on the context
        /// of the resource URL
        /// </returns>
        /// <exception cref="SmbException"></exception>
        public virtual SmbFile[] ListFiles(string wildcard)
        {
            return ListFiles(wildcard, AttrDirectory | AttrHidden | AttrSystem, null, null
                );
        }

        /// <summary>List the contents of this SMB resource.</summary>
        /// <remarks>
        /// List the contents of this SMB resource. The list returned will be
        /// identical to the list returned by the parameterless <code>listFiles()</code>
        /// method minus files filtered by the specified filename filter.
        /// </remarks>
        /// <param name="filter">a filter to exclude files from the results</param>
        /// <returns>An array of <tt>SmbFile</tt> objects</returns>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual SmbFile[] ListFiles(ISmbFilenameFilter filter)
        {
            return ListFiles("*", AttrDirectory | AttrHidden | AttrSystem, filter, null);
        }

        /// <summary>List the contents of this SMB resource.</summary>
        /// <remarks>
        /// List the contents of this SMB resource. The list returned will be
        /// identical to the list returned by the parameterless <code>listFiles()</code>
        /// method minus filenames filtered by the specified filter.
        /// </remarks>
        /// <param name="filter">a file filter to exclude files from the results</param>
        /// <returns>An array of <tt>SmbFile</tt> objects</returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual SmbFile[] ListFiles(ISmbFileFilter filter)
        {
            return ListFiles("*", AttrDirectory | AttrHidden | AttrSystem, null, filter);
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual string[] List(string wildcard, int searchAttributes, ISmbFilenameFilter
             fnf, ISmbFileFilter ff)
        {
            List<object> list = new List<object>();
            DoEnum(list, false, wildcard, searchAttributes, fnf, ff);

            return Collections.ToArray<string>(list); //Collections.ToArray<string>(list);
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual SmbFile[] ListFiles(string wildcard, int searchAttributes
            , ISmbFilenameFilter fnf, ISmbFileFilter ff)
        {
            List<object> list = new List<object>();
            DoEnum(list, true, wildcard, searchAttributes, fnf, ff);

            return Collections.ToArray<SmbFile>(list); //Collections.ToArray<SmbFile>(list);
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void DoEnum(List<object> list, bool files, string wildcard, int searchAttributes
            , ISmbFilenameFilter fnf, ISmbFileFilter ff)
        {
            if (ff != null && ff is DosFileFilter)
            {
                DosFileFilter dff = (DosFileFilter)ff;
                if (dff.Wildcard != null)
                {
                    wildcard = dff.Wildcard;
                }
                searchAttributes = dff.Attributes;
            }
            try
            {
                int hostlen = Url.GetHost() != null ? Url.GetHost().Length : 0;
                if (hostlen == 0 || GetType() == TypeWorkgroup)
                {
                    DoNetServerEnum(list, files, wildcard, searchAttributes, fnf, ff);
                }
                else
                {
                    if (_share == null)
                    {
                        DoShareEnum(list, files, wildcard, searchAttributes, fnf, ff);
                    }
                    else
                    {
                        DoFindFirstNext(list, files, wildcard, searchAttributes, fnf, ff);
                    }
                }
            }
            catch (UnknownHostException uhe)
            {
                throw new SmbException(Url.ToString(), uhe);
            }
            catch (UriFormatException mue)
            {
                throw new SmbException(Url.ToString(), mue);
            }
        }

        private void RemoveCurrentAddress()
        {
            if (AddressIndex >= 1)
            {
                UniAddress[] aux = new UniAddress[Addresses.Length - 1];

                Array.Copy(Addresses, 1, aux, 0, Addresses.Length - 1);

                Addresses = aux;
                AddressIndex--;
            }
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        /// <exception cref="UnknownHostException"></exception>
        /// <exception cref="System.UriFormatException"></exception>
        internal virtual void DoShareEnum(List<object> list, bool files, string wildcard, int
             searchAttributes, ISmbFilenameFilter fnf, ISmbFileFilter ff)
        {
            string p = Url.AbsolutePath;
            IOException last = null;
            IFileEntry[] entries;
            UniAddress addr;
            IFileEntry e;
            Hashtable map;
            if (p.LastIndexOf('/') != (p.Length - 1))
            {
                throw new SmbException(Url + " directory must end with '/'");
            }
            if (GetType() != TypeServer)
            {
                throw new SmbException("The requested list operations is invalid: " + Url);
            }
            map = new Hashtable();
            if (_enableDfs && Dfs.IsTrustedDomain(GetServer(), Auth))
            {
                try
                {
                    entries = DoDfsRootEnum();
                    for (int ei = 0; ei < entries.Length; ei++)
                    {
                        e = entries[ei];
                        if (map.ContainsKey(e) == false)
                        {
                            map.Put(e, e);
                        }
                    }
                }
                catch (IOException ioe)
                {
                    if (Log.Level >= 4)
                    {
                        Runtime.PrintStackTrace(ioe, Log);
                    }
                }
            }
            addr = GetFirstAddress();
            while (addr != null)
            {
                try
                {
                    last = null;

                    DoConnect();
                    try
                    {
                        entries = DoMsrpcShareEnum();
                    }
                    catch (IOException ioe)
                    {
                        if (Log.Level >= 3)
                        {
                            Runtime.PrintStackTrace(ioe, Log);
                        }
                        entries = DoNetShareEnum();
                    }
                    for (int ei = 0; ei < entries.Length; ei++)
                    {
                        e = entries[ei];
                        if (map.ContainsKey(e) == false)
                        {
                            map.Put(e, e);
                        }
                    }
                    break;
                }
                catch (IOException ioe)
                {
                    if (Log.Level >= 3)
                    {
                        Runtime.PrintStackTrace(ioe, Log);
                    }
                    last = ioe;

                    if (!(ioe is SmbAuthException))
                    {
                        RemoveCurrentAddress();

                        addr = GetNextAddress();
                    }
                    else
                    {
                        break;
                    }
                }

            }
            if (last != null && map.Count == 0)
            {
                if (last is SmbException == false)
                {
                    throw new SmbException(Url.ToString(), last);
                }
                throw (SmbException)last;
            }
            //Iterator iter = map.Keys.Iterator();
            //while (iter.HasNext())
            foreach (var item in map.Keys)
            {
                e = (IFileEntry)item;
                string name = e.GetName();
                if (fnf != null && fnf.Accept(this, name) == false)
                {
                    continue;
                }
                if (name.Length > 0)
                {
                    // if !files we don't need to create SmbFiles here
                    SmbFile f = new SmbFile(this, name, e.GetType(), AttrReadonly
                         | AttrDirectory, 0L, 0L, 0L);
                    if (ff != null && ff.Accept(f) == false)
                    {
                        continue;
                    }
                    if (files)
                    {
                        list.Add(f);
                    }
                    else
                    {
                        list.Add(name);
                    }
                }
            }
        }

        /// <exception cref="System.IO.IOException"></exception>
        internal virtual IFileEntry[] DoDfsRootEnum()
        {
            MsrpcDfsRootEnum rpc;
            DcerpcHandle handle = null;
            IFileEntry[] entries;
            handle = DcerpcHandle.GetHandle("ncacn_np:" + GetAddress().GetHostAddress() + "[\\PIPE\\netdfs]"
                , Auth);
            try
            {
                rpc = new MsrpcDfsRootEnum(GetServer());
                handle.Sendrecv(rpc);
                if (rpc.Retval != 0)
                {
                    throw new SmbException(rpc.Retval, true);
                }
                return rpc.GetEntries();
            }
            finally
            {
                try
                {
                    handle.Close();
                }
                catch (IOException ioe)
                {
                    if (Log.Level >= 4)
                    {
                        Runtime.PrintStackTrace(ioe, Log);
                    }
                }
            }
        }

        /// <exception cref="System.IO.IOException"></exception>
        internal virtual IFileEntry[] DoMsrpcShareEnum()
        {
            MsrpcShareEnum rpc;
            DcerpcHandle handle;
            rpc = new MsrpcShareEnum(Url.GetHost());
            handle = DcerpcHandle.GetHandle("ncacn_np:" + GetAddress().GetHostAddress() + "[\\PIPE\\srvsvc]"
                , Auth);
            try
            {
                handle.Sendrecv(rpc);
                if (rpc.Retval != 0)
                {
                    throw new SmbException(rpc.Retval, true);
                }
                return rpc.GetEntries();
            }
            finally
            {
                try
                {
                    handle.Close();
                }
                catch (IOException ioe)
                {
                    if (Log.Level >= 4)
                    {
                        Runtime.PrintStackTrace(ioe, Log);
                    }
                }
            }
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual IFileEntry[] DoNetShareEnum()
        {
            SmbComTransaction req = new NetShareEnum();
            SmbComTransactionResponse resp = new NetShareEnumResponse();
            Send(req, resp);
            if (resp.Status != WinError.ErrorSuccess)
            {
                throw new SmbException(resp.Status, true);
            }
            return resp.Results;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        /// <exception cref="UnknownHostException"></exception>
        /// <exception cref="System.UriFormatException"></exception>
        internal virtual void DoNetServerEnum(List<object> list, bool files, string wildcard
            , int searchAttributes, ISmbFilenameFilter fnf, ISmbFileFilter ff)
        {
            int listType = Url.GetHost().Length == 0 ? 0 : GetType();
            SmbComTransaction req;
            SmbComTransactionResponse resp;
            if (listType == 0)
            {
                Connect0();
                req = new NetServerEnum2(Tree.Session.transport.Server.OemDomainName, NetServerEnum2
                    .SvTypeDomainEnum);
                resp = new NetServerEnum2Response();
            }
            else
            {
                if (listType == TypeWorkgroup)
                {
                    req = new NetServerEnum2(Url.GetHost(), NetServerEnum2.SvTypeAll);
                    resp = new NetServerEnum2Response();
                }
                else
                {
                    throw new SmbException("The requested list operations is invalid: " + Url);
                }
            }
            bool more;
            do
            {
                int n;
                Send(req, resp);
                if (resp.Status != WinError.ErrorSuccess && resp.Status != WinError.ErrorMoreData)
                {
                    throw new SmbException(resp.Status, true);
                }
                more = resp.Status == WinError.ErrorMoreData;
                n = more ? resp.NumEntries - 1 : resp.NumEntries;
                for (int i = 0; i < n; i++)
                {
                    IFileEntry e = resp.Results[i];
                    string name = e.GetName();
                    if (fnf != null && fnf.Accept(this, name) == false)
                    {
                        continue;
                    }
                    if (name.Length > 0)
                    {
                        // if !files we don't need to create SmbFiles here
                        SmbFile f = new SmbFile(this, name, e.GetType(), AttrReadonly
                             | AttrDirectory, 0L, 0L, 0L);
                        if (ff != null && ff.Accept(f) == false)
                        {
                            continue;
                        }
                        if (files)
                        {
                            list.Add(f);
                        }
                        else
                        {
                            list.Add(name);
                        }
                    }
                }
                if (GetType() != TypeWorkgroup)
                {
                    break;
                }
                req.SubCommand = unchecked(SmbComTransaction.NetServerEnum3);
                req.Reset(0, ((NetServerEnum2Response)resp).LastName);
                resp.Reset();
            }
            while (more);
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        /// <exception cref="UnknownHostException"></exception>
        /// <exception cref="System.UriFormatException"></exception>
        internal virtual void DoFindFirstNext(List<object> list, bool files, string wildcard
            , int searchAttributes, ISmbFilenameFilter fnf, ISmbFileFilter ff)
        {
            SmbComTransaction req;
            Trans2FindFirst2Response resp;
            int sid;
            string path = GetUncPath0();
            string p = Url.AbsolutePath;
            if (p.LastIndexOf('/') != (p.Length - 1))
            {
                throw new SmbException(Url + " directory must end with '/'");
            }
            req = new Trans2FindFirst2(path, wildcard, searchAttributes);
            resp = new Trans2FindFirst2Response();
            if (Log.Level >= 3)
            {
                Log.WriteLine("doFindFirstNext: " + req.Path);
            }
            Send(req, resp);
            sid = resp.Sid;
            req = new Trans2FindNext2(sid, resp.ResumeKey, resp.LastName);
            resp.SubCommand = SmbComTransaction.Trans2FindNext2;
            for (; ; )
            {
                for (int i = 0; i < resp.NumEntries; i++)
                {
                    IFileEntry e = resp.Results[i];
                    string name = e.GetName();
                    if (name.Length < 3)
                    {
                        int h = name.GetHashCode();
                        if (h == HashDot || h == HashDotDot)
                        {
                            if (name.Equals(".") || name.Equals(".."))
                            {
                                continue;
                            }
                        }
                    }
                    if (fnf != null && fnf.Accept(this, name) == false)
                    {
                        continue;
                    }
                    if (name.Length > 0)
                    {
                        SmbFile f = new SmbFile(this, name, TypeFilesystem, e.GetAttributes
                            (), e.CreateTime(), e.LastModified(), e.Length());
                        if (ff != null && ff.Accept(f) == false)
                        {
                            continue;
                        }
                        if (files)
                        {
                            list.Add(f);
                        }
                        else
                        {
                            list.Add(name);
                        }
                    }
                }
                if (resp.IsEndOfSearch || resp.NumEntries == 0)
                {
                    break;
                }
                req.Reset(resp.ResumeKey, resp.LastName);
                resp.Reset();
                Send(req, resp);
            }
            try
            {
                Send(new SmbComFindClose2(sid), Blank_resp());
            }
            catch (SmbException se)
            {
                if (Log.Level >= 4)
                {
                    Runtime.PrintStackTrace(se, Log);
                }
            }
        }

        /// <summary>
        /// Changes the name of the file this <code>SmbFile</code> represents to the name
        /// designated by the <code>SmbFile</code> argument.
        /// </summary>
        /// <remarks>
        /// Changes the name of the file this <code>SmbFile</code> represents to the name
        /// designated by the <code>SmbFile</code> argument.
        /// <p/>
        /// <i>Remember: <code>SmbFile</code>s are immutible and therefore
        /// the path associated with this <code>SmbFile</code> object will not
        /// change). To access the renamed file it is necessary to construct a
        /// new <tt>SmbFile</tt></i>.
        /// </remarks>
        /// <param name="dest">An <code>SmbFile</code> that represents the new pathname</param>
        /// <exception cref="System.ArgumentNullException">If the <code>dest</code> argument is <code>null</code>
        /// 	</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void RenameTo(SmbFile dest)
        {
            if (GetUncPath0().Length == 1 || dest.GetUncPath0().Length == 1)
            {
                throw new SmbException("Invalid operation for workgroups, servers, or shares");
            }
            ResolveDfs(null);
            dest.ResolveDfs(null);
            if (!Tree.Equals(dest.Tree))
            {
                throw new SmbException("Invalid operation for workgroups, servers, or shares");
            }
            if (Log.Level >= 3)
            {
                Log.WriteLine("renameTo: " + Unc + " -> " + dest.Unc);
            }
            _attrExpiration = _sizeExpiration = 0;
            dest._attrExpiration = 0;
            Send(new SmbComRename(Unc, dest.Unc), Blank_resp());
        }

        internal class WriterThread : Thread
        {
            internal byte[] B;

            internal int N;

            internal long Off;

            internal bool Ready;

            internal SmbFile Dest;

            internal SmbException E;

            internal bool UseNtSmbs;

            internal SmbComWriteAndX Reqx;

            internal SmbComWrite Req;

            internal ServerMessageBlock Resp;

            /// <exception cref="SharpCifs.Smb.SmbException"></exception>
            public WriterThread(SmbFile enclosing)
                : base("JCIFS-WriterThread")
            {
                this._enclosing = enclosing;
                UseNtSmbs = this._enclosing.Tree.Session.transport.HasCapability(SmbConstants.CapNtSmbs);
                if (UseNtSmbs)
                {
                    Reqx = new SmbComWriteAndX();
                    Resp = new SmbComWriteAndXResponse();
                }
                else
                {
                    Req = new SmbComWrite();
                    Resp = new SmbComWriteResponse();
                }
                Ready = false;
            }

            internal virtual void Write(byte[] b, int n, SmbFile dest, long off)
            {
                lock (this)
                {
                    this.B = b;
                    this.N = n;
                    this.Dest = dest;
                    this.Off = off;
                    Ready = false;
                    Runtime.Notify(this);
                }
            }

            public override void Run()
            {
                lock (this)
                {
                    try
                    {
                        for (; ; )
                        {
                            Runtime.Notify(this);
                            Ready = true;
                            while (Ready)
                            {
                                Runtime.Wait(this);
                            }
                            if (N == -1)
                            {
                                return;
                            }
                            if (UseNtSmbs)
                            {
                                Reqx.SetParam(Dest.Fid, Off, N, B, 0, N);
                                Dest.Send(Reqx, Resp);
                            }
                            else
                            {
                                Req.SetParam(Dest.Fid, Off, N, B, 0, N);
                                Dest.Send(Req, Resp);
                            }
                        }
                    }
                    catch (SmbException e)
                    {
                        this.E = e;
                    }
                    catch (Exception x)
                    {
                        E = new SmbException("WriterThread", x);
                    }
                    Runtime.Notify(this);
                }
            }

            private readonly SmbFile _enclosing;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void CopyTo0(SmbFile dest, byte[][] b, int bsize, WriterThread
             w, SmbComReadAndX req, SmbComReadAndXResponse resp)
        {
            int i;
            if (_attrExpiration < Runtime.CurrentTimeMillis())
            {
                _attributes = AttrReadonly | AttrDirectory;
                _createTime = 0L;
                _lastModified = 0L;
                _isExists = false;
                IInfo info = QueryPath(GetUncPath0(), Trans2QueryPathInformationResponse.SMB_QUERY_FILE_BASIC_INFO
                    );
                _attributes = info.GetAttributes();
                _createTime = info.GetCreateTime();
                _lastModified = info.GetLastWriteTime();
                _isExists = true;
                _attrExpiration = Runtime.CurrentTimeMillis() + AttrExpirationPeriod;
            }
            if (IsDirectory())
            {
                SmbFile[] files;
                SmbFile ndest;
                string path = dest.GetUncPath0();
                if (path.Length > 1)
                {
                    try
                    {
                        dest.Mkdir();
                        dest.SetPathInformation(_attributes, _createTime, _lastModified);
                    }
                    catch (SmbException se)
                    {
                        if (se.GetNtStatus() != NtStatus.NtStatusAccessDenied && se.GetNtStatus() != NtStatus
                            .NtStatusObjectNameCollision)
                        {
                            throw;
                        }
                    }
                }
                files = ListFiles("*", AttrDirectory | AttrHidden | AttrSystem, null, null);
                try
                {
                    for (i = 0; i < files.Length; i++)
                    {
                        ndest = new SmbFile(dest, files[i].GetName(), files[i].Type, files[i]._attributes,
                            files[i]._createTime, files[i]._lastModified, files[i]._size);
                        files[i].CopyTo0(ndest, b, bsize, w, req, resp);
                    }
                }
                catch (UnknownHostException uhe)
                {
                    throw new SmbException(Url.ToString(), uhe);
                }
                catch (UriFormatException mue)
                {
                    throw new SmbException(Url.ToString(), mue);
                }
            }
            else
            {
                long off;
                try
                {
                    Open(ORdonly, 0, AttrNormal, 0);
                    try
                    {
                        dest.Open(OCreat | OWronly | OTrunc, SmbConstants.FileWriteData |
                             SmbConstants.FileWriteAttributes, _attributes, 0);
                    }
                    catch (SmbAuthException sae)
                    {
                        if ((dest._attributes & AttrReadonly) != 0)
                        {
                            dest.SetPathInformation(dest._attributes & ~AttrReadonly, 0L, 0L);
                            dest.Open(OCreat | OWronly | OTrunc, SmbConstants.FileWriteData |
                                 SmbConstants.FileWriteAttributes, _attributes, 0);
                        }
                        else
                        {
                            throw;
                        }
                    }
                    i = 0;
                    off = 0L;
                    for (; ; )
                    {
                        req.SetParam(Fid, off, bsize);
                        resp.SetParam(b[i], 0);
                        Send(req, resp);
                        lock (w)
                        {
                            if (w.E != null)
                            {
                                throw w.E;
                            }
                            while (!w.Ready)
                            {
                                try
                                {
                                    Runtime.Wait(w);
                                }
                                catch (Exception ie)
                                {
                                    throw new SmbException(dest.Url.ToString(), ie);
                                }
                            }
                            if (w.E != null)
                            {
                                throw w.E;
                            }
                            if (resp.DataLength <= 0)
                            {
                                break;
                            }
                            w.Write(b[i], resp.DataLength, dest, off);
                        }
                        i = i == 1 ? 0 : 1;
                        off += resp.DataLength;
                    }
                    dest.Send(new Trans2SetFileInformation(dest.Fid, _attributes, _createTime, _lastModified
                        ), new Trans2SetFileInformationResponse());
                    dest.Close(0L);
                }
                catch (SmbException se)
                {
                    if (IgnoreCopyToException == false)
                    {
                        throw new SmbException("Failed to copy file from [" + ToString() + "] to ["
                            + dest + "]", se);
                    }
                    if (Log.Level > 1)
                    {
                        Runtime.PrintStackTrace(se, Log);
                    }
                }
                finally
                {
                    Close();
                }
            }
        }

        /// <summary>
        /// This method will copy the file or directory represented by this
        /// <tt>SmbFile</tt> and it's sub-contents to the location specified by the
        /// <tt>dest</tt> parameter.
        /// </summary>
        /// <remarks>
        /// This method will copy the file or directory represented by this
        /// <tt>SmbFile</tt> and it's sub-contents to the location specified by the
        /// <tt>dest</tt> parameter. This file and the destination file do not
        /// need to be on the same host. This operation does not copy extended
        /// file attibutes such as ACLs but it does copy regular attributes as
        /// well as create and last write times. This method is almost twice as
        /// efficient as manually copying as it employs an additional write
        /// thread to read and write data concurrently.
        /// <p/>
        /// It is not possible (nor meaningful) to copy entire workgroups or
        /// servers.
        /// </remarks>
        /// <param name="dest">the destination file or directory</param>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void CopyTo(SmbFile dest)
        {
            SmbComReadAndX req;
            SmbComReadAndXResponse resp;
            WriterThread w;
            int bsize;
            byte[][] b;
            if (_share == null || dest._share == null)
            {
                throw new SmbException("Invalid operation for workgroups or servers");
            }
            req = new SmbComReadAndX();
            resp = new SmbComReadAndXResponse();
            Connect0();
            dest.Connect0();
            ResolveDfs(null);
            try
            {
                if (GetAddress().Equals(dest.GetAddress()) && _canon.RegionMatches(true, 0, dest._canon
                    , 0, Math.Min(_canon.Length, dest._canon.Length)))
                {
                    throw new SmbException("Source and destination paths overlap.");
                }
            }
            catch (UnknownHostException)
            {
            }
            w = new WriterThread(this);
            w.SetDaemon(true);
            w.Start();
            SmbTransport t1 = Tree.Session.transport;
            SmbTransport t2 = dest.Tree.Session.transport;
            if (t1.SndBufSize < t2.SndBufSize)
            {
                t2.SndBufSize = t1.SndBufSize;
            }
            else
            {
                t1.SndBufSize = t2.SndBufSize;
            }
            bsize = Math.Min(t1.RcvBufSize - 70, t1.SndBufSize - 70);
            b = new[] { new byte[bsize], new byte[bsize] };
            try
            {
                CopyTo0(dest, b, bsize, w, req, resp);
            }
            finally
            {
                w.Write(null, -1, null, 0);
            }
        }

        /// <summary>
        /// This method will delete the file or directory specified by this
        /// <code>SmbFile</code>.
        /// </summary>
        /// <remarks>
        /// This method will delete the file or directory specified by this
        /// <code>SmbFile</code>. If the target is a directory, the contents of
        /// the directory will be deleted as well. If a file within the directory or
        /// it's sub-directories is marked read-only, the read-only status will
        /// be removed and the file will be deleted.
        /// </remarks>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void Delete()
        {
            Exists();
            GetUncPath0();
            Delete(Unc);
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void Delete(string fileName)
        {
            if (GetUncPath0().Length == 1)
            {
                throw new SmbException("Invalid operation for workgroups, servers, or shares");
            }
            if (Runtime.CurrentTimeMillis() > _attrExpiration)
            {
                _attributes = AttrReadonly | AttrDirectory;
                _createTime = 0L;
                _lastModified = 0L;
                _isExists = false;
                IInfo info = QueryPath(GetUncPath0(), Trans2QueryPathInformationResponse.SMB_QUERY_FILE_BASIC_INFO
                    );
                _attributes = info.GetAttributes();
                _createTime = info.GetCreateTime();
                _lastModified = info.GetLastWriteTime();
                _attrExpiration = Runtime.CurrentTimeMillis() + AttrExpirationPeriod;
                _isExists = true;
            }
            if ((_attributes & AttrReadonly) != 0)
            {
                SetReadWrite();
            }
            if (Log.Level >= 3)
            {
                Log.WriteLine("delete: " + fileName);
            }
            if ((_attributes & AttrDirectory) != 0)
            {
                try
                {
                    SmbFile[] l = ListFiles("*", AttrDirectory | AttrHidden | AttrSystem, null, null
                        );
                    for (int i = 0; i < l.Length; i++)
                    {
                        l[i].Delete();
                    }
                }
                catch (SmbException se)
                {
                    if (se.GetNtStatus() != NtStatus.NtStatusNoSuchFile)
                    {
                        throw;
                    }
                }
                Send(new SmbComDeleteDirectory(fileName), Blank_resp());
            }
            else
            {
                Send(new SmbComDelete(fileName), Blank_resp());
            }
            _attrExpiration = _sizeExpiration = 0;
        }

        /// <summary>Returns the length of this <tt>SmbFile</tt> in bytes.</summary>
        /// <remarks>
        /// Returns the length of this <tt>SmbFile</tt> in bytes. If this object
        /// is a <tt>TYPE_SHARE</tt> the total capacity of the disk shared in
        /// bytes is returned. If this object is a directory or a type other than
        /// <tt>TYPE_SHARE</tt>, 0L is returned.
        /// </remarks>
        /// <returns>
        /// The length of the file in bytes or 0 if this
        /// <code>SmbFile</code> is not a file.
        /// </returns>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual long Length()
        {
            if (_sizeExpiration > Runtime.CurrentTimeMillis())
            {
                return _size;
            }
            if (GetType() == TypeShare)
            {
                Trans2QueryFsInformationResponse response;
                int level = Trans2QueryFsInformationResponse.SMB_INFO_ALLOCATION;
                response = new Trans2QueryFsInformationResponse(level);
                Send(new Trans2QueryFsInformation(level), response);
                _size = response.Info.GetCapacity();
            }
            else
            {
                if (GetUncPath0().Length > 1 && Type != TypeNamedPipe)
                {
                    IInfo info = QueryPath(GetUncPath0(), Trans2QueryPathInformationResponse.SMB_QUERY_FILE_STANDARD_INFO
                        );
                    _size = info.GetSize();
                }
                else
                {
                    _size = 0L;
                }
            }
            _sizeExpiration = Runtime.CurrentTimeMillis() + AttrExpirationPeriod;
            return _size;
        }

        /// <summary>
        /// This method returns the free disk space in bytes of the drive this share
        /// represents or the drive on which the directory or file resides.
        /// </summary>
        /// <remarks>
        /// This method returns the free disk space in bytes of the drive this share
        /// represents or the drive on which the directory or file resides. Objects
        /// other than <tt>TYPE_SHARE</tt> or <tt>TYPE_FILESYSTEM</tt> will result
        /// in 0L being returned.
        /// </remarks>
        /// <returns>
        /// the free disk space in bytes of the drive on which this file or
        /// directory resides
        /// </returns>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual long GetDiskFreeSpace()
        {
            if (GetType() == TypeShare || Type == TypeFilesystem)
            {
                int level = Trans2QueryFsInformationResponse.SmbFsFullSizeInformation;
                try
                {
                    return QueryFsInformation(level);
                }
                catch (SmbException ex)
                {
                    switch (ex.GetNtStatus())
                    {
                        case NtStatus.NtStatusInvalidInfoClass:
                        case NtStatus.NtStatusUnsuccessful:
                            {
                                // NetApp Filer
                                // SMB_FS_FULL_SIZE_INFORMATION not supported by the server.
                                level = Trans2QueryFsInformationResponse.SMB_INFO_ALLOCATION;
                                return QueryFsInformation(level);
                            }
                    }
                    throw;
                }
            }
            return 0L;
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        private long QueryFsInformation(int level)
        {
            Trans2QueryFsInformationResponse response;
            response = new Trans2QueryFsInformationResponse(level);
            Send(new Trans2QueryFsInformation(level), response);
            if (Type == TypeShare)
            {
                _size = response.Info.GetCapacity();
                _sizeExpiration = Runtime.CurrentTimeMillis() + AttrExpirationPeriod;
            }
            return response.Info.GetFree();
        }

        /// <summary>
        /// Creates a directory with the path specified by this
        /// <code>SmbFile</code>.
        /// </summary>
        /// <remarks>
        /// Creates a directory with the path specified by this
        /// <code>SmbFile</code>. For this method to be successful, the target
        /// must not already exist. This method will fail when
        /// used with <code>smb://</code>, <code>smb://workgroup/</code>,
        /// <code>smb://server/</code>, or <code>smb://server/share/</code> URLs
        /// because workgroups, servers, and shares cannot be dynamically created
        /// (although in the future it may be possible to create shares).
        /// </remarks>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void Mkdir()
        {
            string path = GetUncPath0();
            if (path.Length == 1)
            {
                throw new SmbException("Invalid operation for workgroups, servers, or shares");
            }
            if (Log.Level >= 3)
            {
                Log.WriteLine("mkdir: " + path);
            }
            Send(new SmbComCreateDirectory(path), Blank_resp());
            _attrExpiration = _sizeExpiration = 0;
        }

        /// <summary>
        /// Creates a directory with the path specified by this <tt>SmbFile</tt>
        /// and any parent directories that do not exist.
        /// </summary>
        /// <remarks>
        /// Creates a directory with the path specified by this <tt>SmbFile</tt>
        /// and any parent directories that do not exist. This method will fail
        /// when used with <code>smb://</code>, <code>smb://workgroup/</code>,
        /// <code>smb://server/</code>, or <code>smb://server/share/</code> URLs
        /// because workgroups, servers, and shares cannot be dynamically created
        /// (although in the future it may be possible to create shares).
        /// </remarks>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void Mkdirs()
        {
            SmbFile parent;
            try
            {
                parent = new SmbFile(GetParent(), Auth);
            }
            catch (IOException)
            {
                return;
            }
            if (parent.Exists() == false)
            {
                parent.Mkdirs();
            }
            Mkdir();
        }

        /// <summary>Create a new file but fail if it already exists.</summary>
        /// <remarks>
        /// Create a new file but fail if it already exists. The check for
        /// existance of the file and it's creation are an atomic operation with
        /// respect to other filesystem activities.
        /// </remarks>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void CreateNewFile()
        {
            if (GetUncPath0().Length == 1)
            {
                throw new SmbException("Invalid operation for workgroups, servers, or shares");
            }
            Close(Open0(ORdwr | OCreat | OExcl, 0, AttrNormal, 0), 0L);
        }

        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        internal virtual void SetPathInformation(int attrs, long ctime, long mtime)
        {
            int f;
            int dir;
            Exists();
            dir = _attributes & AttrDirectory;
            f = Open0(ORdonly, SmbConstants.FileWriteAttributes, dir, dir != 0 ? 0x0001
                 : 0x0040);
            Send(new Trans2SetFileInformation(f, attrs | dir, ctime, mtime), new Trans2SetFileInformationResponse
                ());
            Close(f, 0L);
            _attrExpiration = 0;
        }

        /// <summary>Set the create time of the file.</summary>
        /// <remarks>
        /// Set the create time of the file. The time is specified as milliseconds
        /// from Jan 1, 1970 which is the same as that which is returned by the
        /// <tt>createTime()</tt> method.
        /// <p/>
        /// This method does not apply to workgroups, servers, or shares.
        /// </remarks>
        /// <param name="time">the create time as milliseconds since Jan 1, 1970</param>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void SetCreateTime(long time)
        {
            if (GetUncPath0().Length == 1)
            {
                throw new SmbException("Invalid operation for workgroups, servers, or shares");
            }
            SetPathInformation(0, time, 0L);
        }

        /// <summary>Set the last modified time of the file.</summary>
        /// <remarks>
        /// Set the last modified time of the file. The time is specified as milliseconds
        /// from Jan 1, 1970 which is the same as that which is returned by the
        /// <tt>lastModified()</tt>, <tt>getLastModified()</tt>, and <tt>getDate()</tt> methods.
        /// <p/>
        /// This method does not apply to workgroups, servers, or shares.
        /// </remarks>
        /// <param name="time">the last modified time as milliseconds since Jan 1, 1970</param>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void SetLastModified(long time)
        {
            if (GetUncPath0().Length == 1)
            {
                throw new SmbException("Invalid operation for workgroups, servers, or shares");
            }
            SetPathInformation(0, 0L, time);
        }

        /// <summary>Return the attributes of this file.</summary>
        /// <remarks>
        /// Return the attributes of this file. Attributes are represented as a
        /// bitset that must be masked with <tt>ATTR_*</tt> constants to determine
        /// if they are set or unset. The value returned is suitable for use with
        /// the <tt>setAttributes()</tt> method.
        /// </remarks>
        /// <returns>the <tt>ATTR_*</tt> attributes associated with this file</returns>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual int GetAttributes()
        {
            if (GetUncPath0().Length == 1)
            {
                return 0;
            }
            Exists();
            return _attributes & AttrGetMask;
        }

        /// <summary>Set the attributes of this file.</summary>
        /// <remarks>
        /// Set the attributes of this file. Attributes are composed into a
        /// bitset by bitwise ORing the <tt>ATTR_*</tt> constants. Setting the
        /// value returned by <tt>getAttributes</tt> will result in both files
        /// having the same attributes.
        /// </remarks>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void SetAttributes(int attrs)
        {
            if (GetUncPath0().Length == 1)
            {
                throw new SmbException("Invalid operation for workgroups, servers, or shares");
            }
            SetPathInformation(attrs & AttrSetMask, 0L, 0L);
        }

        /// <summary>Make this file read-only.</summary>
        /// <remarks>
        /// Make this file read-only. This is shorthand for <tt>setAttributes(
        /// getAttributes() | ATTR_READ_ONLY )</tt>.
        /// </remarks>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SharpCifs.Smb.SmbException"></exception>
        public virtual void SetReadOnly()
        {
            SetAttributes(GetAttributes() | AttrReadonly);
        }

        /// <summary>Turn off the read-only attribute of this file.</summary>
        /// <remarks>
        /// Turn off the read-only attribute of this file. This is shorthand for
        /// <tt>setAttributes( getAttributes() & ~ATTR_READONLY )</tt>.
        /// </remarks>
        /// <exception cref="SmbException">SmbException</exception>
        /// <exception cref="SmbException"></exception>
        public virtual void SetReadWrite()
        {
            SetAttributes(GetAttributes() & ~AttrReadonly);
        }

        /// <summary>
        /// Returns a
        /// <see cref="System.Uri">System.Uri</see>
        /// for this <code>SmbFile</code>. The
        /// <code>URL</code> may be used as any other <code>URL</code> might to
        /// access an SMB resource. Currently only retrieving data and information
        /// is supported (i.e. no <tt>doOutput</tt>).
        /// </summary>
        /// <returns>
        /// A new <code>
        /// <see cref="System.Uri">System.Uri</see>
        /// </code> for this <code>SmbFile</code>
        /// </returns>
        /// <exception cref="System.UriFormatException">System.UriFormatException</exception>
        [Obsolete(@"Use getURL() instead")]
        public virtual Uri ToUrl()
        {
            return Url;
        }

        /// <summary>
        /// Computes a hashCode for this file based on the URL string and IP
        /// address if the server.
        /// </summary>
        /// <remarks>
        /// Computes a hashCode for this file based on the URL string and IP
        /// address if the server. The hashing function uses the hashcode of the
        /// server address, the canonical representation of the URL, and does not
        /// compare authentication information. In essance, two
        /// <code>SmbFile</code> objects that refer to
        /// the same file should generate the same hashcode provided it is possible
        /// to make such a determination.
        /// </remarks>
        /// <returns>A hashcode for this abstract file</returns>
        /// <exception cref="SmbException">SmbException</exception>
        public override int GetHashCode()
        {
            int hash;
            try
            {
                hash = GetAddress().GetHashCode();
            }
            catch (UnknownHostException)
            {
                hash = GetServer().ToUpper().GetHashCode();
            }
            GetUncPath0();
            return hash + _canon.ToUpper().GetHashCode();
        }

        protected internal virtual bool PathNamesPossiblyEqual(string path1, string path2
            )
        {
            int p1;
            int p2;
            int l1;
            int l2;
            // if unsure return this method returns true
            p1 = path1.LastIndexOf('/');
            p2 = path2.LastIndexOf('/');
            l1 = path1.Length - p1;
            l2 = path2.Length - p2;
            // anything with dots voids comparison
            if (l1 > 1 && path1[p1 + 1] == '.')
            {
                return true;
            }
            if (l2 > 1 && path2[p2 + 1] == '.')
            {
                return true;
            }
            return l1 == l2 && path1.RegionMatches(true, p1, path2, p2, l1);
        }

        /// <summary>Tests to see if two <code>SmbFile</code> objects are equal.</summary>
        /// <remarks>
        /// Tests to see if two <code>SmbFile</code> objects are equal. Two
        /// SmbFile objects are equal when they reference the same SMB
        /// resource. More specifically, two <code>SmbFile</code> objects are
        /// equals if their server IP addresses are equal and the canonicalized
        /// representation of their URLs, minus authentication parameters, are
        /// case insensitivly and lexographically equal.
        /// <p/>
        /// For example, assuming the server <code>angus</code> resolves to the
        /// <code>192.168.1.15</code> IP address, the below URLs would result in
        /// <code>SmbFile</code>s that are equal.
        /// <p><blockquote><pre>
        /// smb://192.168.1.15/share/DIR/foo.txt
        /// smb://angus/share/data/../dir/foo.txt
        /// </pre></blockquote>
        /// </remarks>
        /// <param name="obj">Another <code>SmbFile</code> object to compare for equality</param>
        /// <returns>
        /// <code>true</code> if the two objects refer to the same SMB resource
        /// and <code>false</code> otherwise
        /// </returns>
        /// <exception cref="SmbException">SmbException</exception>
        public override bool Equals(object obj)
        {
            if (obj is SmbFile)
            {
                SmbFile f = (SmbFile)obj;
                bool ret;
                if (this == f)
                {
                    return true;
                }
                if (PathNamesPossiblyEqual(Url.AbsolutePath, f.Url.AbsolutePath))
                {
                    GetUncPath0();
                    f.GetUncPath0();
                    if (Runtime.EqualsIgnoreCase(_canon, f._canon))
                    {
                        try
                        {
                            ret = GetAddress().Equals(f.GetAddress());
                        }
                        catch (UnknownHostException)
                        {
                            ret = Runtime.EqualsIgnoreCase(GetServer(), f.GetServer());
                        }
                        return ret;
                    }
                }
            }
            return false;
        }

        /// <summary>Returns the string representation of this SmbFile object.</summary>
        /// <remarks>
        /// Returns the string representation of this SmbFile object. This will
        /// be the same as the URL used to construct this <code>SmbFile</code>.
        /// This method will return the same value
        /// as <code>getPath</code>.
        /// </remarks>
        /// <returns>The original URL representation of this SMB resource</returns>
        /// <exception cref="SmbException">SmbException</exception>
        public override string ToString()
        {
            return Url.ToString();
        }

        /// <summary>This URLConnection method just returns the result of <tt>length()</tt>.</summary>
        /// <remarks>This URLConnection method just returns the result of <tt>length()</tt>.</remarks>
        /// <returns>the length of this file or 0 if it refers to a directory</returns>
        public int GetContentLength()
        {
            try
            {
                return (int)(Length() & unchecked(0xFFFFFFFFL));
            }
            catch (SmbException)
            {
            }
            return 0;
        }

        /// <summary>This URLConnection method just returns the result of <tt>lastModified</tt>.
        /// 	</summary>
        /// <remarks>This URLConnection method just returns the result of <tt>lastModified</tt>.
        /// 	</remarks>
        /// <returns>the last modified data as milliseconds since Jan 1, 1970</returns>
        public long GetDate()
        {
            try
            {
                return LastModified();
            }
            catch (SmbException)
            {
            }
            return 0L;
        }

        /// <summary>This URLConnection method just returns the result of <tt>lastModified</tt>.
        /// 	</summary>
        /// <remarks>This URLConnection method just returns the result of <tt>lastModified</tt>.
        /// 	</remarks>
        /// <returns>the last modified data as milliseconds since Jan 1, 1970</returns>
        public long GetLastModified()
        {
            try
            {
                return LastModified();
            }
            catch (SmbException)
            {
            }
            return 0L;
        }

        /// <summary>This URLConnection method just returns a new <tt>SmbFileInputStream</tt> created with this file.
        /// 	</summary>
        /// <remarks>This URLConnection method just returns a new <tt>SmbFileInputStream</tt> created with this file.
        /// 	</remarks>
        /// <exception cref="System.IO.IOException">thrown by <tt>SmbFileInputStream</tt> constructor
        /// 	</exception>
        public InputStream GetInputStream()
        {
            return new SmbFileInputStream(this);
        }

        /// <summary>This URLConnection method just returns a new <tt>SmbFileOutputStream</tt> created with this file.
        /// 	</summary>
        /// <remarks>This URLConnection method just returns a new <tt>SmbFileOutputStream</tt> created with this file.
        /// 	</remarks>
        /// <exception cref="System.IO.IOException">thrown by <tt>SmbFileOutputStream</tt> constructor
        /// 	</exception>
        public OutputStream GetOutputStream()
        {
            return new SmbFileOutputStream(this);
        }

        /// <exception cref="System.IO.IOException"></exception>
        private void ProcessAces(Ace[] aces, bool resolveSids)
        {
            string server = GetServerWithDfs();
            int ai;
            if (resolveSids)
            {
                Sid[] sids = new Sid[aces.Length];
                string[] names = null;
                for (ai = 0; ai < aces.Length; ai++)
                {
                    sids[ai] = aces[ai].Sid;
                }
                for (int off = 0; off < sids.Length; off += 64)
                {
                    int len = sids.Length - off;
                    if (len > 64)
                    {
                        len = 64;
                    }
                    Sid.ResolveSids(server, Auth, sids, off, len);
                }
            }
            else
            {
                for (ai = 0; ai < aces.Length; ai++)
                {
                    aces[ai].Sid.OriginServer = server;
                    aces[ai].Sid.OriginAuth = Auth;
                }
            }
        }

        /// <summary>
        /// Return an array of Access Control Entry (ACE) objects representing
        /// the security descriptor associated with this file or directory.
        /// </summary>
        /// <remarks>
        /// Return an array of Access Control Entry (ACE) objects representing
        /// the security descriptor associated with this file or directory.
        /// If no DACL is present, null is returned. If the DACL is empty, an array with 0 elements is returned.
        /// </remarks>
        /// <param name="resolveSids">
        /// Attempt to resolve the SIDs within each ACE form
        /// their numeric representation to their corresponding account names.
        /// </param>
        /// <exception cref="System.IO.IOException"></exception>
        public virtual Ace[] GetSecurity(bool resolveSids)
        {
            int f;
            Ace[] aces;
            f = Open0(ORdonly, SmbConstants.ReadControl, 0, IsDirectory() ? 1 : 0);
            NtTransQuerySecurityDesc request = new NtTransQuerySecurityDesc(f, 0x04);
            NtTransQuerySecurityDescResponse response = new NtTransQuerySecurityDescResponse(
                );
            try
            {
                Send(request, response);
            }
            finally
            {
                Close(f, 0L);
            }
            aces = response.SecurityDescriptor.Aces;
            if (aces != null)
            {
                ProcessAces(aces, resolveSids);
            }
            return aces;
        }

        /// <summary>
        /// Return an array of Access Control Entry (ACE) objects representing
        /// the share permissions on the share exporting this file or directory.
        /// </summary>
        /// <remarks>
        /// Return an array of Access Control Entry (ACE) objects representing
        /// the share permissions on the share exporting this file or directory.
        /// If no DACL is present, null is returned. If the DACL is empty, an array with 0 elements is returned.
        /// <p>
        /// Note that this is different from calling <tt>getSecurity</tt> on a
        /// share. There are actually two different ACLs for shares - the ACL on
        /// the share and the ACL on the folder being shared.
        /// Go to <i>Computer Management</i>
        /// &gt; <i>System Tools</i> &gt; <i>Shared Folders</i> &gt <i>Shares</i> and
        /// look at the <i>Properties</i> for a share. You will see two tabs - one
        /// for "Share Permissions" and another for "Security". These correspond to
        /// the ACLs returned by <tt>getShareSecurity</tt> and <tt>getSecurity</tt>
        /// respectively.
        /// </remarks>
        /// <param name="resolveSids">
        /// Attempt to resolve the SIDs within each ACE form
        /// their numeric representation to their corresponding account names.
        /// </param>
        /// <exception cref="System.IO.IOException"></exception>
        public virtual Ace[] GetShareSecurity(bool resolveSids)
        {
            string p = Url.AbsolutePath;
            MsrpcShareGetInfo rpc;
            DcerpcHandle handle;
            Ace[] aces;
            ResolveDfs(null);
            string server = GetServerWithDfs();
            rpc = new MsrpcShareGetInfo(server, Tree.Share);
            handle = DcerpcHandle.GetHandle("ncacn_np:" + server + "[\\PIPE\\srvsvc]", Auth);
            try
            {
                handle.Sendrecv(rpc);
                if (rpc.Retval != 0)
                {
                    throw new SmbException(rpc.Retval, true);
                }
                aces = rpc.GetSecurity();
                if (aces != null)
                {
                    ProcessAces(aces, resolveSids);
                }
            }
            finally
            {
                try
                {
                    handle.Close();
                }
                catch (IOException ioe)
                {
                    if (Log.Level >= 1)
                    {
                        Runtime.PrintStackTrace(ioe, Log);
                    }
                }
            }
            return aces;
        }

        /// <summary>
        /// Return an array of Access Control Entry (ACE) objects representing
        /// the security descriptor associated with this file or directory.
        /// </summary>
        /// <remarks>
        /// Return an array of Access Control Entry (ACE) objects representing
        /// the security descriptor associated with this file or directory.
        /// <p>
        /// Initially, the SIDs within each ACE will not be resolved however when
        /// <tt>getType()</tt>, <tt>getDomainName()</tt>, <tt>getAccountName()</tt>,
        /// or <tt>toString()</tt> is called, the names will attempt to be
        /// resolved. If the names cannot be resolved (e.g. due to temporary
        /// network failure), the said methods will return default values (usually
        /// <tt>S-X-Y-Z</tt> strings of fragments of).
        /// <p>
        /// Alternatively <tt>getSecurity(true)</tt> may be used to resolve all
        /// SIDs together and detect network failures.
        /// </remarks>
        /// <exception cref="System.IO.IOException"></exception>
        public virtual Ace[] GetSecurity()
        {
            return GetSecurity(false);
        }
    }
}