Update from the original library

ClientExamples.md

@@ -1,6 +1,6 @@
 Login and list shares:
 ======================
-```
+```cs
 SMB1Client client = new SMB1Client(); // SMB2Client can be used as well
 bool isConnected = client.Connect(IPAddress.Parse("192.168.1.11"), SMBTransportType.DirectTCPTransport);
 if (isConnected)
@@ -17,7 +17,7 @@ if (isConnected)
 
 Connect to share and list files and directories - SMB1:
 =======================================================
-```
+```cs
 ISMBFileStore fileStore = client.TreeConnect("Shared", out status);
 if (status == NTStatus.STATUS_SUCCESS)
 {
@@ -36,7 +36,7 @@ status = fileStore.Disconnect();
 
 Connect to share and list files and directories - SMB2:
 =======================================================
-```
+```cs
 ISMBFileStore fileStore = client.TreeConnect("Shared", out status);
 if (status == NTStatus.STATUS_SUCCESS)
 {
@@ -55,7 +55,7 @@ status = fileStore.Disconnect();
 
 Read large file to its end:
 ===========================
-```
+```cs
 ISMBFileStore fileStore = client.TreeConnect("Shared", out status);
 object fileHandle;
 FileStatus fileStatus;
@@ -93,7 +93,7 @@ status = fileStore.Disconnect();
 
 Create a file and write to it:
 ==============================
-```
+```cs
 ISMBFileStore fileStore = client.TreeConnect("Shared", out status);
 string filePath = "NewFile.txt";
 if (fileStore is SMB1FileStore)
@@ -119,7 +119,7 @@ status = fileStore.Disconnect();
 
 Write a large file:
 ===================
-```
+```cs
 ISMBFileStore fileStore = client.TreeConnect("Shared", out status);
 if (status != NTStatus.STATUS_SUCCESS)
 {
@@ -137,7 +137,7 @@ FileStatus fileStatus;
 status = fileStore.CreateFile(out fileHandle, out fileStatus, remoteFilePath, AccessMask.GENERIC_WRITE | AccessMask.SYNCHRONIZE, FileAttributes.Normal, ShareAccess.None, CreateDisposition.FILE_CREATE, CreateOptions.FILE_NON_DIRECTORY_FILE | CreateOptions.FILE_SYNCHRONOUS_IO_ALERT, null);
 if (status == NTStatus.STATUS_SUCCESS)
 {
-    int writeOffset = 0;
+    long writeOffset = 0;
     while (localFileStream.Position < localFileStream.Length)
     {
         byte[] buffer = new byte[(int)client.MaxWriteSize];
@@ -161,7 +161,7 @@ status = fileStore.Disconnect();
 
 Delete file:
 ============
-```
+```cs
 ISMBFileStore fileStore = client.TreeConnect("Shared", out status);
 string filePath = "DeleteMe.txt";
 if (fileStore is SMB1FileStore)
@@ -181,4 +181,43 @@ if (status == NTStatus.STATUS_SUCCESS)
     status = fileStore.CloseFile(fileHandle);
 }
 status = fileStore.Disconnect();
+```
+
+Cross-platform Kerberos authentication:
+=======================================
+You can have cross-platform Kerberos login support by creating a class that implements IAuthenticationClient.  
+[Kerberos.NET](https://github.com/dotnet/Kerberos.NET) can easily be used to implement IAuthenticationClient.  
+Note that in order for Kerberos.NET to work on non-Windows platforms, you must provide a cross-platform implementation of IKerberosDnsQuery (and register it using DnsQuery.RegisterImplementation)  
+[DnsClient.NET](https://github.com/MichaCo/DnsClient.NET) can easily be used to implement IKerberosDnsQuery.  
+
+```cs
+public class KerberosNetAuthenticationClient : IAuthenticationClient
+{
+    private readonly KerberosClient m_kerberosClient;
+    private string m_spn;
+    private byte[] m_sessionKey;
+
+    public KerberosNetAuthenticationClient(string user, string password, string domain, string host)
+    {
+        m_kerberosClient = new KerberosClient();
+        m_kerberosClient.Authenticate(new KerberosPasswordCredential(user, password, domain)).Wait();
+        m_spn = $"cifs/{host}";
+    }
+
+    public byte[] InitializeSecurityContext(byte[] inputToken)
+    {
+        KrbApReq ticket = m_kerberosClient.GetServiceTicket(m_spn).GetAwaiter().GetResult();
+        KerberosClientCacheEntry cachedItem = (KerberosClientCacheEntry)m_kerberosClient.Cache.GetCacheItem(m_spn);
+        m_sessionKey = cachedItem.SessionKey.KeyValue.ToArray();
+        return ticket.EncodeGssApi().ToArray();
+    }
+
+    public byte[] GetSessionKey() => m_sessionKey;
+
+    public void ResetSecurityContext(string spn)
+    {
+        m_spn = spn;
+        m_sessionKey = null;
+    }
+}
 ```