// 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 <a
/// href="../../../resolver.html">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/ <-- 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 <-- 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/ <-- 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> 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>
/// > <i>System Tools</i> > <i>Shared Folders</i> > <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);
}
}
}