"Fossies" - the Fresh Open Source Software Archive

Member "jcifs_1.3.19/docs/index.xml" (21 Dec 2017, 154012 Bytes) of package /linux/misc/jcifs-1.3.19.tgz:

As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) XML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "index.xml": 1.3.18_vs_1.3.19.

    1 <?xml version="1.0"?>
    3 <proj>
    5 <title>JCIFS</title>
    6 <short>The Java CIFS Client Library</short>
    7 <desc>
    8 JCIFS is an <a href="http://www.opensource.org/docs/definition_plain.php">Open Source</a> client library that implements the CIFS/SMB networking protocol in 100% Java. CIFS is the standard file sharing protocol on the Microsoft Windows platform (e.g. Map Network Drive ...). This client is used extensively in production on large Intranets.
    9 </desc>
   10 <news>
   12 <!-- entry>
   13 <title></title>
   14 <sub></sub>
   15 <desc>
   16 </desc>
   17 </entry-->
   19 <entry>
   20 <title>jcifs-1.3.19 released / NTLMv2 Acceptor Security Vulnerability Fixed</title>
   21 <sub>posted by Mike, December 21, 2017</sub>
   22 <desc>
   23 This release fixes a moderately serious security issue. All NTLM acceptors / servers using JCIFS should upgrade their JCIFS jar immediately. Credit goes to Moritz Bechler for identifying and reporting this flaw.
   24 </desc>
   25 </entry>
   27 <entry>
   28 <title>jcifs-1.3.18 released / Minor Fixes</title>
   29 <sub>posted by Mike, October 29, 2014</sub>
   30 <desc>
   31 This release includes minor fixes such as for a <code>ConcurrentModificationException</code> that could occur when initializing JCIFS classes.
   32 </desc>
   33 </entry>
   35 <entry old="true">
   36 <title>jcifs-krb5-1.3.17 released / Kerberos Package Update</title>
   37 <sub>posted by Mike, November 11, 2011</sub>
   38 <desc>
   39 The Kerberos package been updated to 1.3.17. Special thanks to Mr. Shun for contributing this package.
   40 </desc>
   41 </entry>
   43 <entry old="true">
   44 <title>jcifs-1.3.17 released / SO_TIMEOUT Fixed, Connect Timeout Control Added</title>
   45 <sub>posted by Mike, October 18, 2011</sub>
   46 <desc>
   47 The <code>jcifs.smb.client.soTimeout</code> property, which controls how long the client will wait to read data from a server, was broken in the previous release (1.3.16). Not only was it broken but no SO_TIMEOUT was specified at all meaning if a server became unresponsive, JCIFS could hang for an uncontrollably long time. This behavior of this property has been restored.
   48 <p/>
   49 Additionally, a new <code>jcifs.smb.client.connTimeout</code> has been added which specifies the number of milliseconds that the client will wait to connect to a server (how long it will wait for a response to the TCP SYN). This can be very useful when trying to communicate with many servers in parallel.
   50 </desc>
   51 </entry>
   53 <entry>
   54 <title>jcifs-1.3.16 released / SO_TIMEOUT, Disconnect Improvements, copyTo() Exceptions and more</title>
   55 <sub>posted by Mike, June 25, 2011</sub>
   56 <desc>
   57 This release includes the following minor fixes and improvements:
   58 <ul>
   59 <li>
   60 JCIFS now uses the InetSocketAddress class to explicitly bind and set the SO_TIMEOUT on client sockets before they are connected. This makes the SO_TIMEOUT effective when the target server socket is not listening and the client OS socket implementation takes a long time for the dropped SYN to timeout. This may significantly reduce resource consumption in applications that use multiple threads to constantly query servers that may not be listening.
   61 </li><li>
   62 When disconnecting a transport, new clauses have been added to better reset transport state whereas previously transports could get stuck in a disconnected state for unnecessarily long periods of time.
   63 </li><li>
   64 A new property jcifs.smb.client.ignoreCopyToException has been added. When set to "true" (the default), the SmbFile.copyTo() method will ignore (but log) exceptions trying to copy individual files or directories (such as because of a permissions error). To maintain backward compatibility, the default value of this property is "true" (exceptions are ignored). Setting this property to "false" will cause any exception that occurs trying to copy an individual file or directory to be thrown out of copyTo and abort the copy operation at the point of failure. 
   65 </li><li>
   66 If an authentication exception occurs trying to connect to a server that has multiple IP addresses, JCIFS will not attempt to connect to more than one IP addresses because doing so could result in an account lockout.
   67 </li><li>
   68 The SID resolver code incorrectly resolved SIDs of an ACE in blocks of at most 10 where it should have used a limit of 64. This performance issue has been fixed.
   69 </li><li>
   70 JCIFS will not throw the artifical "Access is denied" error if the special NtlmPasswordCredential.ANONYMOUS credential is used explicitly (whereas normally JCIFS will deliberately throw an SmbAuthException if a login results in a guest login or if the anonymous identity is used).
   71 </li><li>
   72 The NetrServerEnum2 RAP call used incorrect parameter descriptiors which could result in "SmbException: 2320" errors trying to list domains and servers from the local NetBIOS browse service.
   73 </li><li>
   74 The NTLMSSP AUTHENTICATE_MESSAGE (aka "Type 2 Message") encoding routine incorrectly left out the TargetName field (although this had no effect on CIFS client behavior).
   75 </li>
   76 </ul>
   77 <p/>
   78 The JCIFS Team would like to thank IOPLEX Software for contributing to this work.
   79 </desc>
   80 </entry>
   82 <entry old="true">
   83 <title>jcifs-1.3.15 released / Minor DcerpcHandle Locking Adjustments</title>
   84 <sub>posted by Mike, October 7</sub>
   85 <desc>
   86 Minor adjustments have been applied to DcerpcHandle locking routines in the SID class to fix sporadic occurances of "All pipe instances are busy" errors under high load.
   87 <p/>
   88 The JCIFS Team would like to thank Vivísimo, Inc. for supporting this work. Vivísimo provides enterprises with innovative search solutions to find, access, and manipulate all content. For consumer web searches, Vivísimo offers Clusty.com.
   89 </desc>
   90 </entry>
   92 <entry old="true">
   93 <title>jcifs-1.3.14 released / NetBIOS Node Status Disabled and Named Pipe Errors</title>
   94 <sub>posted by Mike, February 11, 2010</sub>
   95 <desc>
   96 JCIFS will no longer do a NetBIOS Node Status to determine the server hostname because it seems some servers no longer respond to it. Under high load "All pipe instances are busy" errors could occur. This has been fixed by adding a lock to ensure that the MSRPC bind and pipe open request are performed together.
   97 </desc>
   98 </entry>
  100 <entry old="true">
  101 <title>jcifs-1.3.13 released / Deadlock Fixed, OSX Snow Leopard, and EMC</title>
  102 <sub>posted by Mike, January 5, 2010</sub>
  103 <desc>
  104 Locking throughout the transport layer has been rewritten. This should fix the long standing deadlock that has been reported in the past. Note that these are significant changes to the I/O layer. The package should be tested carefully before being deployed.
  105 <p/>The size of the transient input buffer used to read the SMB_COM_NEGOTIATE response has been doubled to accommodate a security blob (as observed with OSX Snow Leopard). A signing issue reading data from an EMC server has been fixed. NTLMSSP logging has been improved.
  106 <p/>
  107 The JCIFS Team would like to thank Stoneware, Inc. for supporting this work. Stoneware, Inc. provides innovative software that enables organizations to build their own 'private' cloud for simplified access to all of their web, Windows or hosted applications and services.
  108 </desc>
  109 </entry>
  111 <entry>
  112 <title>JCIFS U.S. Export Control Classification Numbers (ECCN)</title>
  113 <sub>posted by Mike, August 27, 2009</sub>
  114 <desc>
  115 JCIFS uses cryptography including RC4 128 (for NTLMv2) and AES 256 (for Kerberos) for authentication, digital signatures and encryption.
  116 Products that use cryptography and which are exported from the U.S. to other countries are supposed to obtain an export classification.
  117 The United States Department of Commerce Bureau of Industry and Security (BIS) has issued two ECCNs for the JCIFS package:
  118 <blockquote>
  119 5D002.C.1 License Exception TSU<br/>
  120 5D992.C (for binary only distribution of "mass market" software)
  121 </blockquote>
  122 For commercial products that ship JCIFS in binary form, you will need to reference the second ECCN in your export classification requests.
  123 For further information such as CCATS numbers, please contact ioplex<i style="font-style: normal;">@</i>gmail.com.
  124 <p/>
  125 The JCIFS Team would like to thank BIS for their excellent service and patience.
  126 </desc>
  127 </entry>
  129 <entry>
  130 <title old="true">jcifs-1.3.12 released / Two NullPointerExceptions Fixed and DFS</title>
  131 <sub>posted by Mike, August 14, 2009</sub>
  132 <desc>
  133 If NtlmPasswordAuthentication.ANONYMOUS was used, CAP_EXTENDED_SECURITY could be incorrectly turned off resulting in a NullPointerException. If a DFS server did not return any referrals, a NullPointerException could occur. Both of these exceptions have been corrected. Also, JCIFS could become confused when connecting to a server that also happened to be a DFS root server. This issue has been fixed.
  134 </desc>
  135 </entry>
  137 <entry old="true">
  138 <title>jcifs-1.3.11 released / NTLMv2 Calculation Correction</title>
  139 <sub>posted by Mike, July 21, 2009</sub>
  140 <desc>
  141 The nTOWFv2 computation for NTLMv2 authentication was slightly wrong in that it upper-cased the domain. This had no effect on JCIFS but it has been corrected for technical accuracy.
  142 </desc>
  143 </entry>
  145 <entry old="true">
  146 <title>jcifs-1.3.10 released / Bugfix for SmbException: The parameter is incorrect</title>
  147 <sub>posted by Mike, June 4, 2009</sub>
  148 <desc>
  149 This release fixes a bug that could sporadically trigger a "The parameter is incorrect" error.
  150 <p/>
  151 The JCIFS Team would like to thank IOPLEX Software for contributing to this work.
  152 IOPLEX Software has many years of experience with HTTP Single Sign-On, Kerberos, NTLM, Active Directory, MSRPC and related networking protocols.
  153 </desc>
  154 </entry>
  156 <entry old="true">
  157 <title>jcifs-1.3.9 released / Robust Retry of Replicated DFS Targets, copyTo Fix, UTF-16LE, and More</title>
  158 <sub>posted by Mike, May 30, 2009</sub>
  159 <desc>
  160 This package adds the following fixes:
  161 <ul>
  162 <li>
  163 JCIFS will now iteratively try multiple replicated DFS targets if some are not enabled (whereas previously JCIFS would quit if the first root target was not accessible)
  164 </li>
  165 <li>
  166 Fixed "Invalid operation for ????? service" error when querying DFS
  167 </li>
  168 <li>
  169 SmbFile.copyTo will now copy files larger than 4GB
  170 </li>
  171 <li>
  172 All instances of UnicodeLittleUnmarked have been changed to UTF-16LE (for platforms like Android)
  173 </li>
  174 </ul>
  175 <p/>
  176 The JCIFS Team would like to thank MetaCarta, Inc. for supporting this work. MetaCarta, Inc., a provider of geographic intelligence solutions, offers users map-driven geographic search, geographic referencing, and data visualization capabilities.
  177 </desc>
  178 </entry>
  180 <entry old="true">
  181 <title>jcifs-1.3.8 released / RC4 Implemented, Java 1.4 Now Supported Again</title>
  182 <sub>posted by Mike, Mar 29, 2009</sub>
  183 <desc>
  184 RC4 has been implemented and therefore JCIFS no longer requires Java 1.5 update 7 or an implementation that provides RC4. Java 1.4 should work as well as it did prior to JCIFS 1.3.
  185 </desc>
  186 </entry>
  188 <entry old="true">
  189 <title>jcifs-1.3.7 released / Share Security Fixed</title>
  190 <sub>posted by Mike, Mar 18, 2009</sub>
  191 <desc>
  192 Share security was broken in both 1.2 and 1.3. It has been fixed. Note that share security is considered deprecated and is only supported by older software like Windows 98 and Samba 3.0.
  193 </desc>
  194 </entry>
  196 <entry old="true">
  197 <title>jcifs-1.3.5 released / Stand-alone DFS with IP Address Hostname Issue Fixed</title>
  198 <sub>posted by Mike, Mar 12, 2009</sub>
  199 <desc>
  200 Stand-alone DFS did not work properly if the hostname used in the SMB URL was an IP address and not a DNS or NetBIOS hostname. This issue has been fixed.
  201 <p/>
  202 The JCIFS Team would like to thank Vivísimo, Inc. for supporting this work. Vivísimo provides enterprises with innovative search solutions to find, access, and manipulate all content. For consumer web searches, Vivísimo offers Clusty.com.
  203 </desc>
  204 </entry>
  206 <entry old="true">
  207 <title>jcifs-1.3.4 released / Parameter Words, Status Codes and Minor Fixes</title>
  208 <sub>posted by Mike, Mar 9, 2009</sub>
  209 <desc>
  210 This release includes some minor protocol adjustments and the addition of some more common status code text.
  211 </desc>
  212 </entry>
  214 <entry old="true">
  215 <title>jcifs-1.3.3 released / NTLMv2 Requirements, "Invalid parameter" Error, and NetBIOS Broadcast Lookup Timeouts</title>
  216 <sub>posted by Mike, Jan 25, 2009</sub>
  217 <desc>
  218 NTLMv2 support requires the RC4 cipher. Note that Sun's Java did not include RC4 until Java 1.5 update 7.
  219 <p/>
  220 If the above mentioned RC4 cipher was not available, an "Invalid parameter" error would occur. Logic has been corrected so that the more informative "Cannot find any provider supporting RC4" error is reported instead.
  221 <p/>
  222 To date, JCIFS has always tried NetBIOS broadcast lookups in favor of DNS which frequently resulted in a 6 second delay if the <tt>jcifs.resolveOrder</tt> property was not adjusted. This behavior has been changed to try DNS before NetBIOS broadcast lookups which should result in much less frequent delays when using default settings. To restore the old behavior, simply set <tt>jcifs.resolveOrder=LMHOSTS,BCAST,DNS</tt>.
  223 <p/>
  224 The NTLMSSP code would not fallback to ASCII if Cp850 was not available (which is the case with stock JREs). This issue has been fixed.
  225 </desc>
  226 </entry>
  228 <entry old="true">
  229 <title>jcifs-krb5-1.3.1 released / Kerberos 5 Package Updated</title>
  230 <sub>posted by Mike, Dec 22, 2008</sub>
  231 <desc>
  232 The Kerberos package been updated to 1.3.1. The KerberosAuthExample.java example has been independently verified to work. Special thanks to Mr. Shun for contributing this package.
  233 </desc>
  234 </entry>
  236 <entry old="true">
  237 <title>jcifs-1.3.2 released / Samba DFS</title>
  238 <sub>posted by Mike, Dec 22, 2008</sub>
  239 <desc>
  240 Accessing a DFS link on Samba directly could result in an error. This issue has been fixed. Samba 3.0.x does not support raw NTLMSSP and therefore the new default JCIFS settings that use NTLMSSP break JCIFS and Samba 3.0.x compatibility. To work-around, turn off extended security and use NTLMv1 by setting <tt>jcifs.smb.client.useExtendedSecurity=false</tt> and <tt>jcifs.smb.lmCompatibility=0</tt>.
  241 </desc>
  242 </entry>
  244 <entry old="true">
  245 <title>jcifs-1.3.1 released / NTLM HTTP Filter Fixed, DFS Adjustments and More</title>
  246 <sub>posted by Mike, Nov 30, 2008</sub>
  247 <desc>
  248 The NTLM HTTP Filter was broken in 1.3.0. Setting jcifs.smb.client.useExtendedSecurity to false fixes the issue. This property has been changed in the Filter init method. Some minor DFS changes have been applied that users claim prevent issues in certain DFS scenarios. The NTLMv2 code has been refined in several ways (in particular the getNTLMv2Response method has changed). The NtlmPasswordAuthentication constructor will now split the username if it appears to be composed of a domain and username.
  249 </desc>
  250 </entry>
  252 <entry>
  253 <title>jcifs-1.3.0 released / NTLMv2 Support</title>
  254 <sub>posted by Mike, Oct 25, 2008</sub>
  255 <desc>
  256 NTLMv2 has been fully implemented and will be used by default.
  257 <p/>
  258 To emulate the old behavior you must set <tt>jcifs.lmCompatibility = 0</tt> and <tt>jcifs.smb.client.useExtendedSecurity = false</tt> (new defaults are <tt>3</tt> and <tt>true</tt> respectively).
  259 <p/>
  260 NTLMv2 and NTLMv1 over NTLMSSP has been fairly well tested with and without SMB signing negotiated and various NTLMSSP flags (e.g. <tt>NTLMSSP_NEGOTIATE_NTLM2</tt>).
  261 <p/>
  262 Note: The NTLM HTTP Filter does not and can never support NTLMv2 as it uses a main-in-the-middle technique that is broken by NTLMSSP's "target information" used in computing password hashes. However, the existing Filter should continue to work.
  263 <p/>
  264 The JCIFS Team would like to thank MetaCarta, Inc. for supporting this work. MetaCarta, Inc., a provider of geographic intelligence solutions, offers users map-driven geographic search, geographic referencing, and data visualization capabilities.
  265 </desc>
  266 </entry>
  268 <entry old="true">
  269 <title>jcifs-1.2.25 released / ArrayIndexOutOfBoundsException, copyTo and IBM iSeries Fixes</title>
  270 <sub>posted by Mike, Oct 20, 2008</sub>
  271 <desc>
  272 An ArrayIndexOutOfBoundsException could occur listing a large number of shares (DCERPC response larger than 65535 bytes). The <tt>copyTo</tt> method could deadlock if the server was disconnected during a copy. The IBM iSeries server can send the NativeFileSystem field in ASCII even though Unicode was negotiated and it requires the '?????' service string (and not 'A:'). These issues have been fixed.
  273 <p/>
  274 The JCIFS Team would like to thank MetaCarta, Inc. for supporting this work. MetaCarta, Inc., a provider of geographic intelligence solutions, offers users map-driven geographic search, geographic referencing, and data visualization capabilities.
  275 </desc>
  276 </entry>
  278 <entry old="true">
  279 <title>jcifs-1.2.24 released / Stand-Alone DFS Fixed</title>
  280 <sub>posted by Mike, Jul 23, 2008</sub>
  281 <desc>
  282 The recent domain-based DFS work broke stand-alone DFS. This has been fixed. Both stand-alone and domain-based DFS should work properly now.
  283 <p/>
  284 Note: The 1.2.23 was a dud - it did not really contain the said fix.
  285 </desc>
  286 </entry>
  288 <entry old="true">
  289 <title>jcifs-1.2.22 released / InterruptedIOExceptions, Invalid parameter Exceptions, DFS and more</title>
  290 <sub>posted by Mike, Jun 25, 2008</sub>
  291 <desc>
  292 The SmbFileInputStream methods will now throw InterruptedIOExceptions where apppropriate whereas previously they would throw SmbExceptions with a root cause of TransportException with a root cause of InterruptedException.
  293 <p/>
  294 If SmbSession.send() threw an exception it could trigger "Invalid parameter" exceptions on subsequent requests.
  295 <p/>
  296 An InterruptedException in the NameServiceClient was being caught and ignored. It will now be re-thrown as an IOException so that all threads used with/by JCIFS can be triggered to return immediately.
  297 <p/>
  298 A jcifs.smb.client.dfs.disabled property has been added to disable domain based DFS so that JCIFS can be configured not to try and fail to resolve paths as domain paths in non-domain environments (e.g. on the local machine).
  299 <p/>
  300 The getSecurity and getShareSecurity methods will now return null if no DACL is present on a file whereas previously it would return an empty array. This allows the caller to distinguish between an object that has a DACL with no elements and one that has no DACL at all.
  301 <p/>
  302 The JCIFS Team would like to thank MetaCarta, Inc. for supporting this work. MetaCarta, Inc., a provider of geographic intelligence solutions, offers users map-driven geographic search, geographic referencing, and data visualization capabilities.
  303 </desc>
  304 </entry>
  306 <entry old="true">
  307 <title>jcifs-1.2.21 released / DFS Cache Bugfix</title>
  308 <sub>posted by Mike, May 28, 2008</sub>
  309 <desc>
  310 The DFS cache was not properly synchronized. This has been fixed.
  311 The trusted domains are now looked up with &lt;1C&gt; NetBIOS lookups to speed discovery.
  312 <p/>
  313 Thanks to Ronny S. for reporting these issues.
  314 <p/>
  315 </desc>
  316 </entry>
  318 <entry old="true">
  319 <title>jcifs-1.2.19 released / DFS Roots on non-Domain Controllers</title>
  320 <sub>posted by Mike, Apr 6, 2008</sub>
  321 <desc>
  322 This release adds proper support for domain based DFS roots. Previously JCIFS could not see DFS roots that were not hosted on domain controllers. JCIFS will now properly discover and cache DFS topology information using a series of referrals.
  323 The new code also eliminates the now-obsolete behavior of building a merged list of shares across hosts.
  324 A new NetrDfsEnumEx RPC has been added.
  325 Two new properties have been added: jcifs.smb.client.dfs.ttl and jcifs.smb.client.dfs.strictView.
  326 Two SmbComOpenAndX parameters were incorrectly swapped which could cause failure on Windows 98.
  327 <p/>
  328 The JCIFS Team would like to thank MetaCarta, Inc. for supporting this work. MetaCarta, Inc., a provider of geographic intelligence solutions, offers users map-driven geographic search, geographic referencing, and data visualization capabilities.
  329 </desc>
  330 </entry>
  332 <entry old="true">
  333 <title>jcifs-1.2.18 released / DCERPC, Robust Recovery, URL Decoding, NPEs and Much More</title>
  334 <sub>posted by Mike, Feb 18, 2008</sub>
  335 <desc>
  336 This release includes a few significant fixes for DCERPC related issues. It also includes numerous minor fixes for issues that have accumulated over time. The issues that have been fixed are as follows:
  338 <ul>
  339 <li>
  340 The SID.getServerSid() method could fail with NetApp servers due to a "generic" mask values. The mask has been changed to 0x00000001 which corresponds to an LsaOpenPolicy mask of POLICY_VIEW_LOCAL_INFORMATION.
  341 </li><li>
  342 The LsaPolicyHandle class would not throw an error if the LsarOpenPolicy2 call failed. This has been fixed.
  343 </li><li>
  344 If a share was unshared while JCIFS was in the middle of reading files from it, the transport could enter an error state from which it could not immediately recover if the share was subsequently restored. A small change to SmbTransport.doRecv() fixes this problem.
  345 </li><li>
  346 The SmbFile constructor could inappropriately URL decode the authority component of SMB URLs.
  347 </li><li>
  348 The NTLM HTTP Filter documentation has been updated.
  349 </li><li>
  350 An Invalid state: 4 error has been fixed.
  351 </li><li>
  352 A NetBIOS name service issue caused by Jetdirect printers has been fixed.
  353 </li><li>
  354 An ArrayIndexOutOfBounds exception in the SmbException class has been fixed.
  355 </li><li>
  356 A NullPointerException in SmbSession.getChallengeForDomain() has been fixed.
  357 </li><li>
  358 A NullPointerException in NbtAddress related to hosts without adequate localhost address configuration has been fixed.
  359 </li><li>
  360 An ArrayIndexOutOfBounds exception could be thrown if a server requires NTLMv2. This exception has been replaced with a more informative one.
  361 </li><li>
  362 The SmbSessionSetup constructor will now compare the challenge and encryptionKey using Arrays.equals instead of == to satisfy unforseen use-cases that otherwise trigger an NT_STATUS_ACCESS_VIOLATION.
  363 </li>
  364 </ul>
  366 The JCIFS Team would like to thank Vivísimo, Inc. for supporting this work. Vivísimo provides enterprises with innovative search solutions to find, access, and manipulate all content. For consumer web searches, Vivísimo offers Clusty.com.
  367 <p/>
  368 The JCIFS Team would like to thank IOPLEX Software for contributing to this work.
  369 IOPLEX Software has many years of experience with HTTP Single Sign-On, Kerberos, NTLM, Active Directory, MSRPC and related networking protocols.
  370 IOPLEX Software's Plexcel extension for PHP provides unmatched integration with Active Directory for PHP applications.
  371 </desc>
  372 </entry>
  374 <entry old="true">
  375 <title>Alfresco releases Java CIFS server under GPL</title>
  376 <sub>posted by Mike, Nov 2, 2007</sub>
  377 <desc>
  378 <a href="http://www.alfresco.com/">Alfresco</a> have announced the release of the <i>JLAN Shared File Drive Interface</i> under the terms of the Gnu General Public License (GPL). JLAN includes a CIFS server written in Java, as well as several other Java-based network components. 
  379 <p/>
  380 "I am very excited about this Open Source contribution", said Chris Hertel, Samba Team member and co-founder the jCIFS project.  "Every Open Source CIFS implementation adds to the community's understanding, and to the utility of the protocol itself."
  381 <p/>Their <a href="http://www.alfresco.com/media/releases/2007/10/jlan1007/">press release</a> has a link to the source code at the bottom of the page.
  382 </desc>
  383 </entry>
  385 <entry old="true">
  386 <title>jcifs-1.2.17 released / Minor Fix</title>
  387 <sub>posted by Mike, Aug 15, 2007</sub>
  388 <desc>
  389 A try / catch clause that was accidentally introduced in a previous release has been removed.
  390 </desc>
  391 </entry>
  393 <entry old="true">
  394 <title>jcifs-1.2.16 released / Domain-Based DFS Support</title>
  395 <sub>posted by Mike, Aug 2, 2007</sub>
  396 <desc>
  397 With this release, JCIFS now supports domain-based DFS. With domain-based DFS, clients access DFS roots under the DNS domain name like \\example.com\dfs\foo so that users do not need to remember server names. However, for clients to work with these DFS roots they have to be prepared to connect to each domain controller as necessary to find the target share and successfully authenticate. JCIFS now includes this retry logic. JCIFS will also do something that it seems even Windows clients do not do - if you list the shares of a domain (e.g. <tt>(new SmbFile("smb://example.com/")).listFiles()</tt>), JCIFS will build a merged list of all shares on all domain controllers.
  398 <p/>
  399 Note that these changes are fairly significant. Whenever JCIFS tries to connect to a server this new logic is used. So if anyone notices anything out of the ordinary please report it to the JCIFS mailing list.
  400 <p/>
  401 The JCIFS Team would like to thank MetaCarta, Inc. for supporting this work. MetaCarta, Inc., a provider of geographic intelligence solutions, offers users map-driven geographic search, geographic referencing, and data visualization capabilities.
  402 </desc>
  403 </entry>
  405 <entry old="true">
  406 <title>jcifs-1.2.15 released / NetApp Compatibility, SMB signing with DFS and More</title>
  407 <sub>posted by Mike, Jul 16, 2007</sub>
  408 <desc>
  409 This release includes some significant changes. Most of these changes are related to NetApp compatibility. The changes in this release include the following:
  410 <ul>
  411 <li>An SMB signing failure related to DFS that could result in "Access denied" errors has been fixed.</li>
  412 <li>The DCERPC bind did not exactly mimic Windows which uses SMB_COM_{WRITE,READ}_ANDX. We were using TransactNmPipe throughout which could result in an 'Incorrect function' error when querying the LSA on a NetApp server. JCIFS now implements the bind exactly like Windows to help ensure compatibility with other servers.</li>
  413 <li>Other changes related to NetApp compatibility include falling back to SamrConnect2 if a DCERPC_FAULT_OP_RNG_ERROR error occurs, more closely mimicking the SMB_COM_NT_CREATE_ANDX "extended" response, adjusting various RPC handle operation access masks, uncommenting some padding code that was commented out for what appeared to be a NetWare problem, disabling some logic to use port 139 if the jcifs.netbios.hostname was set and finally adding code to include LsarQosInfo structures in the MSRPC bind.</li>
  414 <li>Some new error code information has been added.</li>
  415 <li>Constants for common SIDs have been added to the SID class.</li>
  416 <li>The SID.getGroupMemberSids() method will now return an empty SID array if the SID is not of type SID_TYPE_DOM_GRP or SID_TYPE_ALIAS.</li>
  417 <li>A minor performance flaw in the DCERPC code was found and fixed.</li>
  418 </ul>
  419 <p/>
  420 The JCIFS Team would like to thank Simple Groupware Solutions and the Leibniz Computing Centre Munich (LRZ) for supporting this work.
  421 <p/>
  422 The JCIFS Team would like to thank Vivísimo, Inc. for supporting this work. Vivísimo provides enterprises with innovative search solutions to find, access, and manipulate all content. For consumer web searches, Vivísimo offers Clusty.com.
  423 </desc>
  424 </entry>
  426 <entry old="true">
  427 <title>jcifs-1.2.14 released / SID.getGroupMemberSids() and the SAMR Interface</title>
  428 <sub>posted by Mike, Jun 20, 2007</sub>
  429 <desc>
  430 A new <tt>SID.getGroupMemberSids()</tt> method has been added that will return the local group membership of SID (aka it's aliases). The SAMR interface has been added to the dcerpc code with the <tt>SamrEnumerateAliasesInDomain</tt> RPC and numerous other calls necessary to negotiate the various handles.
  431 <p/>
  432 The JCIFS Team would like to thank Vivísimo, Inc. for supporting this work. Vivísimo provides enterprises with innovative search solutions to find, access, and manipulate all content. For consumer web searches, Vivísimo offers Clusty.com.
  433 </desc>
  434 </entry>
  436 <entry old="true">
  437 <title>jcifs-krb5-1.2.13 released / Kerberos Authentication Support Update</title>
  438 <sub>posted by Mike, Feb 8, 2007</sub>
  439 <desc>
  440 The stock jcifs-1.2.13 package has been patched by a third party to support Kerberos 5 / SPNEGO extended security authentication. Additionally, SMB signing and DFS issues that existed in jcifs-krb5-1.2.9 have been fixed.
  441 <p/>
  442 The JCIFS team has compiled the package and confirmed that it works with at least the one test case provided (<tt>examples/KerberosAuthExample.java</tt>) but otherwise the code should be used with caution.
  443 <p/>
  444 Great thanks again to Mr. Shun from Japan for contributing this work.
  445 </desc>
  446 </entry>
  448 <entry old="true">
  449 <title>jcifs-1.2.13 released / Share ACLs, DFS Fixes and NoRouteToHostException Fallback</title>
  450 <sub>posted by Mike, Jan 22, 2007</sub>
  451 <desc>
  452 A new <tt>SmbFile.getShareSecurity()</tt> method that uses a new <tt>MsrpcShareGetInfo/ShareInfo502</tt> RPC has been added. This will return the ACL for a share as opposed to the ACL for the directory shared. See the API documentation for details. Several DFS issues have been identified and fixed. If JCIFS receives a <tt>NoRouteToHostException</tt> on port 445 it will now try to fallback to port 139. This code has been tested fairly well already. There have been no changes since b4.
  453 <p/>
  454 The JCIFS Team would like to thank MetaCarta, Inc. for supporting this work. MetaCarta, Inc., a provider of geographic intelligence solutions, offers users map-driven geographic search, geographic referencing, and data visualization capabilities.
  455 </desc>
  456 </entry>
  458 <entry old="true">
  459 <title>jcifs-1.2.12 released / NtTransQuerySecurityDesc, DFS Bugfixs and SID Adjustments</title>
  460 <sub>posted by Mike, Dec 27, 2006</sub>
  461 <desc>
  462 The <tt>NtTransQuerySecurityDesc</tt> request could specify a data buffer that could be too small for the response. As a result the response was not decoded properly and an error would occur. The response will now be decoded properly if the buffer is too small and the buffer size has been increased from 4096 to 32768.
  463 <p/>
  464 The <tt>getSecurity()</tt> method did not work over DFS. A very small but potentially significant change has been made to the DFS code. I do not have a sophisticated DFS test environment so please pay special attention to JCIFS with DFS and report any problems to the JCIFS mailing list.
  465 <p/>
  466 The <tt>toString()</tt> method of the SID class has been changed back to the old behavior of returning only the numeric SID representation. This was done not only for backward compatibility with previous versions of JCIFS but because conceptually the textual representation of a SID is not it's resolved account name. A new <tt>toDisplayString</tt> method has been added to return the resolved Windows ACL editor text (as <tt>toString()</tt> did in the 1.2.11 release). The <tt>toSidString()</tt> method has been removed. The <tt>getDomainName()</tt> and <tt>getAccountName()</tt> methods have not changed.
  467 </desc>
  468 </entry>
  470 <entry old="true">
  471 <title>jcifs-1.2.11 released / SID Class Adjustments</title>
  472 <sub>posted by Mike, Dec 9, 2006</sub>
  473 <desc>
  474 The 1.2.11 release is now final. No serious problems have been reported with the new SID resolution code however some minor adjustments have been made with respect to values returned when a SID has not been resolved (e.g. the associated account was deleted). The SID class API documentation has been updated accordingly.
  475 <p/>
  476 The JCIFS Team would like to thank Vivísimo, Inc. for supporting this work. Vivísimo provides enterprises with innovative search solutions to find, access, and manipulate all content. For consumer web searches, Vivísimo offers Clusty.com.
  477 </desc>
  478 </entry>
  480 <entry old="true">
  481 <title>jcifs-1.2.11b released / SID Resolution</title>
  482 <sub>posted by Mike, Nov 30, 2006</sub>
  483 <desc>
  484 This release significantly expands the SID and ACE classes by using the new MSRPC infrastructure to resolve SIDs to their associated account names. A new <tt>SmbFile.getSecurity()</tt> method has been added which if called with a boolean value of <tt>true</tt> will resolve the SIDs returned within the <tt>ACE[]</tt> array such that <tt>SID.toString()/getDomainName()/getAccountName()</tt> will return text about the account associated with that SID suitable for display to users (e.g. <tt>MYDOM\alice</tt>, <tt>SYSTEM</tt>, etc). Documentation for all associated methods and classes has been added.
  485 <p/>
  486 A fix for a <tt>NullPointerException</tt> within <tt>DcerpcPipeHandle</tt> has been applied.
  487 </desc>
  488 </entry>
  490 <entry old="true">
  491 <title>midlc-0.6.1 released / JCIFS MSRPC Stub Support</title>
  492 <sub>posted by Mike, Nov 30, 2006</sub>
  493 <desc>
  494 The midlc MIDL compatible IDL compiler has been updated to emit stubs for the new JCIFS MSRPC infrastructure. For your convenience the libmba library is included and the Makefile will build a static binary (i.e. you no longer need to install libmba separately). For JCIFS MSRPC stubs use the <tt>-t jcifs</tt> option (the behavior of <tt>-t java</tt> for Jarapac remains).
  495 </desc>
  496 </entry>
  498 <entry old="true">
  499 <title>jcifs-1.2.10 released / Minor Adjustments</title>
  500 <sub>posted by Mike, Nov 24, 2006</sub>
  501 <desc>
  502 The 1.2.10 release is now final. A NetBIOS name service lookup bug has been fixed in addition to several other harmless adjustments.
  503 <p/>
  504 The JCIFS Team would like to thank MetaCarta, Inc. for supporting this work. MetaCarta, Inc., a provider of geographic intelligence solutions, offers users map-driven geographic search, geographic referencing, and data visualization capabilities.
  505 </desc>
  506 </entry>
  508 <entry old="true">
  509 <title>jcifs-1.2.10b released / MSRPC Support, Long Unicode Share Name Enumeration and Critical Bugfixes</title>
  510 <sub>posted by Mike, Nov 13, 2006</sub>
  511 <desc>
  512 This release contains the following new functionality and fixes:
  513 <ul>
  514 <li>Long Unicode Share Enumeration - The SmbFile.list* methods will now try to use MSRPC to enumerate shares if the target is a server. If the operation should fail for any reason, the client will fall back to trying the older RAP method. This should permit enumerating shares with names that use charsets other than the negotiated OEM "ASCII" encoding, share names that are longer than 12 characters, and arbirarily large lists of shares.</li>
  515 <li>MSRPC Support - MSRPC support has been integrated into JCIFS directly. It should now be possible to add new RPCs (AT jobs, SID/group name resolution, service management, regedit, etc) relatively easily with little knowledge of MSRPC protocols. Look at the jcifs/dcerpc/msrpc/MsrpcShareEnum.java class for an example and ask the mailing list for further instructions.</li>
  516 <li>Apr 24 bugfix - A NullPointerException caused by an error in logic has been fixed.</li>
  517 <li>May 10 bugfix - The client will now detect if the JRE supports Cp850 and set the default jcifs.encoding to US-ASCII if it does not. This will eliminate some NullPointerExceptions that were occuring as a result.</li>
  518 <li>A small update about keep-alives has been added to the NTLM HTTP Authentication document.</li>
  519 <li>Jun 21 bugfix - CLOSE-WAIT sockets left over by read errors have been fixed.</li>
  520 <li>Jul 19 bugfix - Errors caused by using UnicodeLittle as opposed to UnicodeLittleUnmarked have been fixed by ensuring UnicodeLittleUnmarked is used throughout the codebase.</li>
  521 <li>Oct 3 bugfix - Invalid state errors from Transport classes have been fixed. It should be safe to interrupt() JCIFS operations now.</li>
  522 <li>Oct 20 bugfix - Uncontrolled looping due to invalid Transport logic has been fixed.</li>
  523 <li>Oct 25 bugfix - Logic has been added to make domain controller lookups more robust.</li>
  524 <li>Oct 27 bugfix - Failure when using SmbFile.renameTo() with jcifs.smb.client.ssnLimit=1 has been fixed.</li>
  525 <li>Oct 31 bugfix - Endless looping when all WINS servers in a list are unavailable has been fixed.</li>
  526 </ul>
  527 </desc>
  528 </entry>
  530 <entry old="true">
  531 <title>jcifs-krb5-1.2.9 released / Kerberos Authentication Support</title>
  532 <sub>posted by Mike, Sep 13, 2006</sub>
  533 <desc>
  534 This package is stock jcifs-1.2.9 modified to support Kerberos 5 / SPNEGO extended security authentication. Please note that this has no impact on the HTTP Filter which still only supports NTLM.
  535 <p/>
  536 The <tt>examples/KerberosAuthExample.java</tt> is included to demonstrate using this package however note that this example initializes a logon context from a username and password. In the steady-state it is more likely that the user will already have a credential (e.g. via kinit) in which case your application code would be different. You will need to familiarize yourself with JGSS and it's <tt>Krb5LogonModule</tt> to fully utilitize this new feature.
  537 <p/>
  538 WARNING: This package has been reported to work by several users however the code has not been examined carefully by jCIFS maintainers and therefore should be considered highly experimental.
  539 <p/>
  540 Note: This package has been compiled with Java 1.5. It may work with eariler versions of Java but you will need to recompile and experiment to determine what the precise requirements are.
  541 <p/>
  542 Great thanks to Mr. Shun from Japan for contributing this work. Ever notice Japan always get's new stuff first?
  543 </desc>
  544 </entry>
  546 <entry old="true">
  547 <title>jcifs-1.2.9 released / Java 1.5 Issue, jcifs.encoding Documentation</title>
  548 <sub>posted by Mike, Apr 4, 2006</sub>
  549 <desc>
  550 The 1.2.8 release was compiled with Java 1.5.0_06 which under certain conditions could cause the following error: <tt>java.lang.LinkageError: ... Unsupported major.minor version 49.0</tt>. I have rebuilt the entire package using the compiler I used previously (1.4.2_08). Also, the documentation regarding the <tt>jcifs.encoding</tt> property has been updated to clarify the implications of using a non-Internationalized version of the Java runtime.
  551 </desc>
  552 </entry>
  554 <entry old="true">
  555 <title>jcifs-1.2.8 released / Deadlock Fix, ACLs, DFS, NTLM HTTP Filter, and More</title>
  556 <sub>posted by Mike, Mar 24, 2006</sub>
  557 <desc>
  558 There are several significant changes in this release. These include:
  559 <ul>
  560 <li>A deadlock could occur if the client tried to logoff and logon at the same instant. This has been fixed.</li>
  561 <li>It was discovered that in at least some cases "preauthentication" did not work properly. A very simple logical error would cause the wrong signing digest to be installed. This has been fixed.</li>
  562 <li>The ACL patch has been integrated. The <tt>SmbFile.getSecurity()</tt> method is now available.</li>
  563 <li>The <tt>jcifs.smb.client.responseTimeout</tt> and <tt>jcifs.smb.client.soTimeout</tt> values have been increased from 10000ms and 15000ms to 30000ms and 35000ms respectively. Users with crawler type applications will almost certainly want to reduce these values.</li>
  564 <li>Several logical errors in DFS referral handling have been fixed (still no fix for the mystery preemtive behavior observed by Windows clients).</li>
  565 <li>Documentation has been updated significantly.</li>
  566 </ul>
  567 </desc>
  568 </entry>
  570 <entry old="true">
  571 <title>jcifs-1.2.7 released / Transport Error, Filter Changes, Integer Overflow, User Contributed Patches, and More</title>
  572 <sub>posted by Mike, Nov 18, 2005</sub>
  573 <desc>
  574 This release consists of the following changes. Happy Thanksgiving.
  575 <ul>
  576 <li>Some debugging printlns left over from the last release have been removed.</li>
  577 <li>Added setContentLength(0) to two other places for the NTLM HTTP Filter. This is required for HTTP 1.0 clients (e.g. Google appliance servers).</li>
  578 <li>The name service code will now properly resolve DNS names that begin with digits.</li>
  579 <li>Several instances of possible integer overflow have been fixed.</li>
  580 <li>A patch for large read and write support has been added to the patches directory. A patch for reading security descriptors has been added to the patches directory.</li>
  581 <li>If a transport was in error due to a connection timeout it could remain in the error state indefinitely. This issue has been fixed.</li>
  582 </ul>
  583 </desc>
  584 </entry>
  586 <entry old="true">
  587 <title>jcifs-1.2.6 released / Session Management and Filter Fix</title>
  588 <sub>posted by Mike, Oct 7, 2005</sub>
  589 <desc>
  590 It was discovered that redundant sessions could be created. This problem has been fixed but the fix is to simply <i>not</i> remove sessions from the list of sessions for a transport which is a waste of memory after time (although most users should not case as the number of sessions is proportional to the number of distinct credentials used). This will probably need to be revisited in the future. It has been advised that the Filter should call <tt>setStatus()</tt> <i>before</i> <tt>setContentLength(0)</tt>. This change has been implemented. 
  591 </desc>
  592 </entry>
  594 <entry old="true">
  595 <title>jcifs-1.2.5 released / Filter Exceptions, Stressing the Transport Layer, and DFS Deadlock Fixed</title>
  596 <sub>posted by Mike, Oct 1, 2005</sub>
  597 <desc>
  598 This release of the JCIFS client consists of the following changes.
  599 <ul>
  600 <li>It was discovered that a flaw in session expiration could cause sessions to expire prematurely. This has been repaired.</li>
  601 <li>If the <tt>jcifs.netbios.hostname</tt> property is set, the client will communicate using only NetBIOS over port 139. This is required for environments that implement a policy restricting users to logging in from certain computers.</li>
  602 <li>Under stress the client could incorrectly attempt to use the invalid "NULL" transport. This has been fixed.</li>
  603 <li>Filter users could experience exceptions due to using the port 0 rather than the default CIFS port.</li>
  604 <li>The client should now handle partial reads and socket exceptions more gracefully.</li>
  605 <li>Under stress, the DFS referral query could cause the client to deadlock. This has been fixed.</li>
  606 </ul>
  607 </desc>
  608 </entry>
  610 <entry old="true">
  611 <title>jcifs-1.2.4 released / Timedout Waiting for Response Exception, Bogus Signature Error, and More</title>
  612 <sub>posted by Mike, Sep 21, 2005</sub>
  613 <desc>
  614 A NetBIOS keep-alive message (received after ~10 minutes) would break message processesing with a <i>timedout waiting for response</i> Exception. This has been fixed.
  615 <p/>
  616 JCIFS would fail to validate responses with a status that is not zero. Assuming we are calculating the verfication signature correctly I can only assume the affected servers choose not to generate the correct signature for error responses (perhaps for DOS reasons). Because JCIFS checked the signature before the message status, an error response would fail with "signature verification failure". This behavior has been changed so that signatures are not verified if the status is non zero.
  617 <p/>
  618 It was discovered that the new transport (as of 1.2.x) could not cleanly recover from temporary server failure (e.g. a restart). This has been fixed. Methods will still throw Exceptions but the moment the server comes back online the client should gracefully recover.
  619 </desc>
  620 </entry>
  622 <entry old="true">
  623 <title>
  624 jcifs-1.2.3 released / Port 445 Fixed</title>
  625 <sub>posted by Mike, Aug 24, 2005</sub>
  626 <desc>
  627 A mistake in the 1.2.2 release broke port 445 communication entirely. It has been fixed. The exact error (with a sufficiently high loglevel) was "Invalid payload size: 1".
  628 </desc>
  629 </entry>
  631 <entry old="true">
  632 <title>jcifs-1.2.2 released / Exception "cannot assign requested address" Fixed, Clusters, NetApp Filer, and More</title>
  633 <sub>posted by Mike, Aug 19, 2005</sub>
  634 <desc>
  635 There have been a number of small fixes. These are:
  636 <ul>
  637 <li>The "cannot assign requested address" exception caused by trying to bind the local address has been fixed.</li>
  638 <li>In a cluster environment the NTLM HTTP Filter could fail with "account currently disabled" or "Access denied" errors due to a deserialization issue of "preauthentication" credentials stored in the <tt>HttpSession</tt>. The initialization of default credentials has been changed however it is not clear that the change will have any effect as I do not have a clustered environment in which to test.</li>
  639 <li>The combination of plain text passwords and Unicode (largely specific to Samba 3) has been fixed.</li>
  640 <li>A bogus debugging statement has been discovered and removed. Who left that in there?!</li>
  641 <li>A <tt>Socket.shutdownOutput()</tt> call has been added to <tt>doDisconnect</tt> as it is believed to reduce spurrious RST frames observed when abruptly shutting down transports. These are believed to be harmless but they have been associated with unsightly messages in Samba log files.</li>
  642 <li>The <tt>copyTo()</tt> method will now check to see if the source path is a child, parent or equal to the destination path and if so throw a <i>Source and destination paths overlap</i> exception.</li>
  643 <li>An additional debugging statement has been added to the NTLM HTTP Filter domain controller interrogation code.</li>
  644 <li>The <tt>getDiskFreeSpace</tt> call could fail with NetApp Filer. It has been repaired.</li>
  645 </ul>
  646 </desc>
  647 </entry>
  649 <entry old="true">
  650 <title>jcifs-1.2.1 released / Signing, setAttributes, getType, and More</title>
  651 <sub>posted by Mike, Jul 4, 2005</sub>
  652 <desc>
  653 The SMB signing code was totally broken in the last release makeing 1.2.0 useless in many environments. It has been reparied.
  654 The setAttributes method did not work on directories. This has been fixed and the masks used to filter attributes been optimized to allow getting and setting all possible attributes based on observed XP behavior.
  655 The getType() method would always return TYPE_SHARE if the SmbFiles were obtained through the listFiles() method. This issue has been fixed - getType() may now also return TYPE_PRINTER and TYPE_NAMEDPIPE (this has been broken for a long time BTW). There have been a variety of other subtle fixes. 
  656 </desc>
  657 </entry>
  659 <entry old="true">
  660 <title>jcifs-1.2.0 released / New Transport Layer, Port 445, getDiskFreeSpace</title>
  661 <sub>posted by Mike, May 22, 2005</sub>
  662 <desc>
  663 The transport layer (the code that multiplexes requests from muliple threads over sockets) has occasionally caused trouble over the years. In general it was too complex. To remedy this problem the transport was rewritten and a forked 1.1.19 was released as the "trans" branch. This branch appears to be at stable enough that it is being released as 1.2.
  664 <p/>
  665 The biggest change in this release should not be visible to users (hopefully) although some new features have managed to sneak in as a result of this merger. These new features are:
  666 <ul>
  667 <li>The client will now attempt to connect to port 445 as opposed to port 139. If this connection fails the client will fall-back to port 139.</li>
  668 <li>If a share was disabled while jCIFS was connected an error would occur even if the share was reenabled before the client tried to access it. This has been fixed so that the client will reconnect and complete the current operation transparently.</li>
  669 <li>The getDiskFreeSpace() method could report the wrong value for very large volumes. This has been fixed by adding a new info-level.</li>
  670 <li>Named pipes were broken by changes for DCE/RPC transactions. They have been repaired.</li>
  671 <li>The NetBIOS name resolution code will now use the <i>last</i> resource record in a name query response rather than the first. This appears to be more correct (at least with WMWare adapters on my XP workstation).</li>
  672 <li>The client is generally faster because the transport is simpler. The amount of code for the transport is less than half of what it used to be.</li>
  673 </ul> 
  674 Developers writing Java network clients may want to look at the <tt>jcifs.util.transport.*</tt> classes.
  675 </desc>
  676 </entry>
  678 <entry old="true">
  679 <title>jcifs-1.1.11 released / File Corruption Bugfix</title>
  680 <sub>posted by Mike, May 4, 2005</sub>
  681 <desc>
  682 If a file is opened with <tt>SmbFileOutputStream</tt>, written to, and then the client waits for <tt>jcifs.smb.client.soTimeout</tt> without any communication to the target, a subsequent write could zero the contents of the file before the current file index resulting in file corruption. This problem has been fixed. And alternative to upgrading is to use <tt>RandomAccessFile</tt> which does not have this problem.
  683 <p/>
  684 Also in the download area is the "trans" release. This version has a completely rewritten transport layer, proper port 445+139 support as well as the beginnings of new features destined for 2.0. Use with caution - it's green.
  685 </desc>
  686 </entry>
  688 <entry old="true">
  689 <title>jcifs-1.1.10 released / DC Lookup Rewrite</title>
  690 <sub>posted by Mike, Apr 17, 2005</sub>
  691 <desc>
  692 The code used by the NTLM HTTP Filter to lookup and rotate through domain controllers has been considerably simplified. The <code>NtlmChallenge</code> class is now <code>Serializeable</code>, the timeout for rebuilding the filters DC list has been increased from 20 minutes to 10 hours, and the <code>jcifs.netbios.lookupRespLimit</code> default has been reduced to 3.
  693 </desc>
  694 </entry>
  696 <entry old="true">
  697 <title>jcifs-1.1.9 released / Read Error</title>
  698 <sub>posted by Mike, Feb 28, 2005</sub>
  699 <desc>
  700 When multiplexing I/O, if socket buffers fill up such that packets can be read in fragments (i.e. high load), it was possible for the 4 byte NetBIOS header to be read incorrectly resulting in a bogus <code>unexpected EOF reading netbios session header</code> exception. This problem has been fixed. Also, some small javadoc updates have been applied.
  701 </desc>
  702 </entry>
  704 <entry old="true">
  705 <title>jcifs-1.1.8 released / Blocked Threads Again, DC Lookups, Name Service, and More </title>
  706 <sub>posted by Mike, Feb 11, 2005</sub>
  707 <desc>
  708 The blocked thread bug wasn't quite fixed in the last release. A lookup exception (e.g. caused by an unresponsive domain controller) could leave a thread blocked if many requests are being processed simultaneously. Similarly the fix for the DC lookup code wasn't complete enough to handle the unusual scenario where all DCs are unresponsive. Also, a malfomed NetBIOS name query response could cause the name service thread to exit incorrectly. These issues have been fixed. Finally, the URL handling of <tt>smb://@/</tt> (meaning "null" credentials) has been fixed.
  709 </desc>
  710 </entry>
  712 <entry old="true">
  713 <title>jcifs-1.1.7 released / Blocked Threads, DC Lookups, Signatures, and Other Fixes </title>
  714 <sub>posted by Mike, Jan 16, 2005</sub>
  715 <desc>
  716 A bug introduced in a recent release that could cause threads to wait indefinately has been fixed. After time many threads could be blocked resulting in wasted resources. The DC lookup code has been modified to gracefully handle WINS returning an empty list (e.g. due to temporary network failure). A simple fix has been applied that premits SMB signatures to work without specifying preauthentication credentials. The <tt>getAttributes()</tt> method will now return 31 bits of attributes whereas previously it would mask the lower 6 bits that JCIFS actually uses. A bug has been fixed that under certain conditions prevented <tt>copyTo()</tt> from copying entire shares. A try/catch block has been added to <tt>copyTo()</tt> to permit the copy to continue if an error occurs. 
  717 </desc>
  718 </entry>
  720 <entry old="true">
  721 <title>jcifs-1.1.6 released / Minor Adjustments</title>
  722 <sub>posted by Mike, Dec 27, 2004</sub>
  723 <desc>
  724 If a variable length 8 bit encoding such as Big5 was used the NTCreateAndX command could fail. This bug has been fixed. If an <tt>SmbFile{Input,Output}Stream</tt> was closed, a subsequent operation could cause the file to be reopened. This behavior is now blocked such that operations performed on a stream after it has been closed will generate an IOException (to conform to java.io streams behavior). Some transport layer synchronization has been adjusted. A <tt>getPrincipal</tt> method has been added to <tt>SmbFile</tt> that will return the <tt>NtlmPasswordAuthentication</tt> object used as credentials for the file or pipe. An adjustment has been made to the <tt>NbtAddress.firstCalledName</tt> method that streamlines communication with domain controllers. The documentation has been updated regarding transparent NTLM authentication in Mozilla and the <tt>available()</tt> method of <tt>SmbFileInputStream</tt>.
  725 </desc>
  726 </entry>
  728 <entry old="true">
  729 <title>jcifs-1.1.5 released / ArrayIndexOutOfBoundsException</title>
  730 <sub>posted by Santa, Dec 17, 2004</sub>
  731 <desc>
  732 It was discovered that an <tt>ArrayIndexOutOfBoundsException</tt> could occur if the list of domain controllers returned by <tt>NbtAddress.getAllByName</tt> was shorter than the list returned in the previous call (possibly because the WINS query timed out and switched to an alternate WINS server). All NTLM HTTP Authentication Filter users should upgrade to prevent this error. Also, the value of <tt>jcifs.netbios.cachePolicy</tt> set by the NTLM HTTP Filter if it is not specified has been doubled to 20 minutes. Finally, some log levels have been increased such that running with <tt>jcifs.util.loglevel = 3</tt> temporarily is actually reasonable in a production environment (must use loglevel > 3 to see individual SMB messages and loglevel > 5 to get hexdumps). 
  733 </desc>
  734 </entry>
  736 <entry old="true">
  737 <title>jcifs-1.1.4 released / LMv2 Fix</title>
  738 <sub>posted by Mike, Dec 7, 2004</sub>
  739 <desc>
  740 Two bugs regarding the upcasing of domain and username fields with LMv2 authentication (used with lmCompatibility = 3) have been fixed. Additionally the firstCalledName/nextCalledName methods changed in 1.1.0 have been changed back to the old behavior. The change was not warranted as it did not emulate Windows behavior. 
  741 </desc>
  742 </entry>
  744 <entry old="true">
  745 <title>jcifs-1.1.3 released / Concurrency Error Fixed</title>
  746 <sub>posted by Mike, Nov 30, 2004</sub>
  747 <desc>
  748 A concurrency error that was introduced with the <tt>getChallengeForDomain()</tt> code used by the NTLM HTTP Filter has been repaired.
  749 </desc>
  750 </entry>
  752 <entry old="true">
  753 <title>jcifs-1.1.2 released / Bogus Debugging Statement</title>
  754 <sub>posted by Mike, Nov 2, 2004</sub>
  755 <desc>
  756 Opps! A harmless println statement that found it's way into the last release has been removed.
  757 </desc>
  758 </entry>
  760 <entry old="true">
  761 <title>jcifs-1.1.1 released / logonShare and DCE Pipe Fixes</title>
  762 <sub>posted by Casper, Oct 31, 2004</sub>
  763 <desc>
  764 The <tt>jcifs.smb.client.logonShare</tt> (and thus the JCIFSACL NTLM HTTP Filter example) did not work. It would not restrict users to those found in the ACL and would instead permit all authenticated users. This has been fixed. A bug was discovered and fixed in the named pipe code. If a specific sequence of reads were performed the pipe could become corrupted. This fix is necessary for multi-pdu DCE requests to work. A small bug in the new <tt>NbtAddress.getAllByName()</tt> method has been repaired. It will now broadcast for a name if a WINS address was not provided. 
  765 </desc>
  766 </entry>
  768 <entry old="true">
  769 <title>jcifs-1.1.0 released / NTLM HTTP Authentication Improvements</title>
  770 <sub>posted by Mike, Oct 1, 2004</sub>
  771 <desc>
  772 There have been significant changes that should improve the reliability and overall behavior of JCIFS particularly for users of the <tt>NtlmHttpFilter</tt>.
  773 <ul>
  774 <li>NbtAddress.get<b>All</b>ByName - The <tt>NbtAddress.getAllByName()</tt> method has been implemented that will return all RDATA records for a NetBIOS name. Thus, you can now retrieve the full list of domain controllers with <tt>NbtAddress.getByName( "MYDOM", 0x1C, null, null )</tt>. The old behavior of returning a random entry from the <tt>getByName</tt> method has been eliminated.</li>
  775 <li>SYN Timeout - The socket code has been modified to employ the transport thread when opening a new connection. This eliminates the annoying 1min+ hang that occurs trying to connect to a non-existant but routable addresss (i.e. the single threaded <tt>SmbCrawler</tt> example is relatively fast now).</li>
  776 <li>SmbSession.getChallengeForDomain - A new method has been added to retrieve an object that encapsulates both the server session key (a.k.a. challenge) and the <tt>UniAddress</tt> from which it came. This method is used solely by the NTLM HTTP Authentication Filter to eliminate the possibility for a different domain controller to be queried in the middle of client nogotiation. Prior to this release this could result in temporary authentication failures. This code uses the new <tt>getAllByName</tt> method to build a list of domain controllers suitable for authenticating web clients. The clent will rotate evenly through the list and remove entries that are unresponsive. This makes the filter very resilent to domain controller failures.</li>
  777 <li>Session Expiration - because of the above changes the client will now proactively close idle sessions. This is particularly pertainent to the NTLM HTTP Filter which really only touches the session when it is first created as the resulting credentials are cached in the user's HTTP session.</li>
  778 <li>Read Bug - A read bug in JCIFS that affected EMC Celera servers has been fixed.</li>
  779 <li>NetBIOS CalledName - The <tt>firstCalledName/nextCalledName</tt> methods have been modified to try <tt>SMBSERVER*</tt> first and fall back to other names. This should eliminate a round trip during session establishment in newer environments.</li>
  780 </ul>
  781 Finally, I have updated the sample <a href="view-source:http://jcifs.samba.org/src/examples/web.xml">web.xml</a>. It should be used as a stationary in all production environments.
  782 </desc>
  783 </entry>
  785 <entry old="true">
  786 <title>jcifs-1.0.1 released / Guest Account Broken</title>
  787 <sub>posted by Mike, Sep 6, 2004</sub>
  788 <desc>
  789 The guest account fix released 6 hours ago broke guest access entirely. The original fix has been re-applied but with the bad test condition corrected.
  790 </desc>
  791 </entry>
  793 <entry old="true">
  794 <title>jcifs-1.0.0 released / 5 Years and Beyond</title>
  795 <sub>posted by Mike, Sep 6, 2004</sub>
  796 <desc>
  797 According to the <a href="http://freshmeat.net/projects/jcifs/">freshmeat page</a>, JCIFS is 5 years old today (vote for us!). The project has come a long way in those years. Its features now include:
  798 <ul>
  799 <li>
  800 The <a href="src/docs/ntlmhttpauth.html">NTLM HTTP Authentication Filter</a>, which adds easy Single Sign On (SSO) functionality to Java Servlet containers, is clearly the most popular feature of JCIFS. Eric did a great job of deciphering the details of <a href="http://davenport.sourceforge.net/ntlm.html">that protocol</a>. The filter is mind-numbingly easy to install as all it requires is the JCIFS jar and a filter section in your <a href="view-source:http://jcifs.samba.org/src/examples/web.xml">web.xml</a> with two or three init parameters [1].
  801 </li><li>
  802 The performance of JCIFS is one of its more surprising achievements. Consider the client can enumerate 5GB of files and directories in less than 10 seconds [2]. To reduce memory usage and increase concurrency JCIFS automatically reuses existing transports and sessions. One nice artifact of this design is that the NTLM HTTP Authentication Filter scales to thousands of active clients. And because the negotiated credentials are cached in the user's HTTP session the number of concurrent user's supported can be many times greater than that.
  803 </li><li>
  804 The <a href="src/docs/api/jcifs/smb/SmbFile.html#copyTo(jcifs.smb.SmbFile)">SmbFile.copyTo()</a> method is a venerable feature in itself. All file and directory attributes and timestamps are mirrored perfectly [3]. It employs an extra thread to write data while the next read operation is in progress. This optimization makes JCIFS the fastest client available for copying large trees of files and directories across hosts (neither of which needs to be the local machine).
  805 </li><li>
  806 Accessing DFS volumes (sub-trees of files and directories that actually reside on another host) is fully transparent to the user. The client may be redirected multiple times in the middle of any operation. After a redirection has occurred the mapping is cached but the cache is only queried for transports that indicate they host DFS volumes.
  807 </li><li>
  808 SMB signing is robust and negotiated automatically with servers that require it.
  809 </li><li>
  810 The <a href="src/docs/api/jcifs/smb/SmbRandomAccessFile.html">SmbRandomAccessFile</a> implementation is a complete drop in replacement for the standard java.io.RandomAccessFile. When opened with SmbFile.FILE_NO_SHARE share access this class is a legitimate database API.
  811 </li><li>
  812 Named Pipes of all types are fully supported. TransactNamedPipe, CallNamedPipe, and standard file I/O style pipes are all supported using a <a href="http://jcifs.samba.org/src/docs/pipes.html">single generic API</a> that conforms to the InputStream/OutputStream model.
  813 </li><li>
  814 JCIFS' <a href="src/docs/resolver.html">name resolution capability</a> is very sophisticated. WINS, DNS, NetBIOS broadcast queries, and remote lmhosts files are supported well. Which services and the order in which each service is queried is fully configurable. The name service cache policy is also adjustable.
  815 </li><li>
  816 JCIFS implements the <a href="http://www.ietf.org/internet-drafts/draft-crhertel-smb-url-07.txt">SMB URL Draft Specification V07</a> and processes all SMB URLs through an SMB URL proticol handler. This same handler is used to build standard java.net.URL objects which means once the protocol handler is registered SMB URLs can be used with any application that uses URLs (e.g. -Djava.rmi.server.codebase=smb://mymachine/c/download/myapp.jar).
  817 </li>
  818 </ul>
  819 Other features include NTLM and LMv2 Authentication [4], optimal request batching, <a href="ntstatus.txt">NT STATUS codes</a>, full transactions, large file support, Unicode support from the ground up [5], NTLM HTTP <a href="src/docs/httpclient.html">authentication wrappers for HTTP and HTTPS clients</a>, a simple logging facility, and extensive documentation. If that's not enough, there's always <a href="http://sourceforge.net/projects/jcifs-ext/">jcifs-ext</a> where bleeding edge JCIFS extensions live.
  820 <p/>
  821 But the best feature of JCIFS is the simplicity of <a href="src/docs/api/">the API</a> itself. We have diligently resisted "feature creep". The SMB URL allows addressing resources with wonderful ease. The SmbFile class is a drop in replacement for java.io.File so if you know how to use that, you know how to use JCIFS.
  822 <p/>
  823 JCIFS is now one of the most sophisticated and powerful CIFS clients available free or otherwise. It is used in production environments by many large commercial organizations and the Open Source model has worked well for us as these users have contibuted valuable feekback that has made JCIFS rock solid.
  824 <p/>
  825 To commemorate these achievements we are proud to release JCIFS 1.0. Aside from fixing broken links and a few packaging tweaks it is not different from 0.9.8 and we hope it stays that way. Moving forward, the 1.0 branch will only receive critical fixes.
  826 <p/>
  827 In recent weeks a MIDL compatible IDL compiler was developed. Coupled with the <a href="http://sourceforge.net/projects/jarapac/">Jarapac DCE/RPC framework</a> for Java it is now practical to make <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/rpc/rpc/overviews.asp">MSRPC</a> calls. This means that the Microsoft network management API functions are very close to being incorporated into JCIFS. IDL files need to be written and APIs need to be devised but we will soon be able to create users, edit groups, control NT services, reboot machines, edit the registry, execute programs on a remote host, and much much more. This will open up an entirely new level of integration between Java and Microsoft environments.
  828 <p/>
  829 Finally, thanks goes out to Eric and Chris and everyone else that has contributed their time. JCIFS is truely a great product because we have taken full advantage of the Open Source model. We would not have made nearly as much progress without the code, bug fixes, problem reports, and solutions provided by our users.
  830 <p/>
  831 <small>
  832 [1] although running through web servers that <i>also</i> try to negotiate NTLM HTTP or do not properly support keep-alives is problematic<br/>
  833 [2] Client Host: 500MHz Debian Linux "testing" Java 1.4 JCIFS 1.0.0; Target Workstation: 2.7GHz 5.77GB Windows NT 4 sp6; Nework: 100 Mbps full-duplex switched; Test Program: examples/T2Crawler.java with println statements commented out, default properties, ran 3 times to load up target workstation cache; Results: $ time java -Djcifs.properties=../miallen.prp T2Crawler smb://myworksta/c$/ 3 1000, real 0m<b>9.929s</b> user 0m5.580s sys 0m0.600s<br/>
  834 [3] although currently extended attributes are not copied<br/>
  835 [4] NTLMv2 is not fully supported but LMv2 permits the client to operate in NTLMv2 environments<br/>
  836 [5] Unicode share names are not supported but will be soon now that RPCs are underway<br/>
  837 </small>
  838 </desc>
  839 </entry>
  841 <entry old="true">
  842 <title>jcifs-0.9.8 released / Guest Account Again and Minor Adjustments</title>
  843 <sub>posted by Mike, Sep 3, 2004</sub>
  844 <desc>
  845 If the "guest" account on a server was not disabled as it normally is it would be possible for a user to use an invalid username to access an SMB resource or website protected with the NtlmHttpFilter. JCIFS will no longer successfully authenticate the "guest" account at all (even if the guest account is enabled and the user enters "guest"). A log message will now be generated for all SmbAuthExceptions in the NtlmHttpFilter if the <tt>jcifs.util.loglevel</tt> property is set to 2 or greater. Behavior regarding accessing System properties has been curbed to accomodate more restrictive environments. Finally a benign exception that could occur if the client was misconfigured has been fixed.
  846 </desc>
  847 </entry>
  849 <entry old="true">
  850 <title>jarapac-0.3.4 and idlc-0.3.6 released / DCE RPC Working</title>
  851 <sub>posted by Mike, Aug 28, 2004</sub>
  852 <desc>
  853 After several weeks of hard work on our MIDL compatible IDL compiler, MS-RPC calls are now working with the Jarapac DCE framework. Currently only the ncacn_np transport in Jarapac works but other transports (e.g. TCP port 135) should work without too much trouble. The process is very easy now -- write IDL, compile with idlc, write Jarapac driver program, and go. The Jarapac examples directory has the beginnings of lsarpc, samr, and srvsvc interfaces. This should unlock a whole new set of functionality for integrating Java into Windows networks. Eat your heart out Microsoft!
  854 </desc>
  855 </entry>
  857 <entry old="true">
  858 <title>jcifs-0.9.7 released / Minor Adjustments</title>
  859 <sub>posted by Mike, Aug 11, 2004</sub>
  860 <desc>
  861 The NTLM HTTP Filter will no longer set Connection: close, a new SmbFile constructor has been added and a rogue debugging statement has been removed. 
  862 </desc>
  863 </entry>
  865 <entry old="true">
  866 <title>jcifs-0.9.6 released / copyTo Bug and Many Other Fixes</title>
  867 <sub>posted by Mike, Jul 23, 2004</sub>
  868 <desc>
  869 A bug in <tt>copyTo()</tt> has been found and fixed that could result in the operation failing and timing out. The default <tt>jcifs.smb.client.snd_buf_size</tt> has been changed from 5000 to 16644. When copying data between larger servers with <tt>copyTo()</tt> (servers that negotiate larger buffer sizes) the result is a noticable preformance increase. Adjustments have been made regarding a null pointer exception triggered by an internal method during certain error scenarios. The client will now failover to a <tt>jcifs.smb.client.domain</tt> controller for browser information if the LMB query fails. Methods have been added to <tt>SmbSession</tt> that support the specification of alternative port. Some incorrect debugging output has been fixed. A clause has been added to <tt>SmbFile.delete()</tt> to subvert an exception caused exclusively by the Oracle FilesOnline CIFS implementation. The NTLM HTTP Authentication documentation has been slightly updated.
  870 </desc>
  871 </entry>
  873 <entry old="true">
  874 <title>SMB URL IETF Draft Version 7</title>
  875 <sub>posted by Chris, Jul 8, 2004</sub>
  876 <desc>
  877 The latest <a href="http://www.ietf.org/internet-drafts/draft-crhertel-smb-url-07.txt">SMB URL Draft</a> has been posted. JCIFS tries to conform to this SMB URL specification as closely as possible.
  878 </desc>
  879 </entry>
  881 <entry old="true">
  882 <title>jcifs-0.9.5 released / Workgroup Server Enum Fix and updated NtlmHttpURLConnection</title>
  883 <sub>posted by Mike, Jul 2, 2004</sub>
  884 <desc>
  885 A bug introduced in 0.9.3 could result in an infinite loop that exhausts all memory in the VM when enumerating workgroups and servers. This issue has been fixed. Also included is an updated to the NtlmHttpURLConnection (now works with org.apache.xmlrpc.XmlRpcClient).
  886 </desc>
  887 </entry>
  889 <entry old="true">
  890 <title>JCIFS Extensions for SPNEGO Filter and RAP Functions</title>
  891 <sub>posted by Eric, Jul 1, 2004</sub>
  892 <desc>
  893 A project for jCIFS extensions called <a href="http://sourceforge.net/projects/jcifs-ext/">jcifs-ext</a> has been established on Sourceforge. Currently this project hosts the latest versions of the SPNEGO HTTP Filter and the RAP function library.
  894 </desc>
  895 </entry>
  897 <entry old="true">
  898 <title>jcifs-0.9.4 released / Credential Propagation and NTLM for HTTP Clients</title>
  899 <sub>posted by Mike, Jun 30, 2004</sub>
  900 <desc>
  901 Credentials were not being propogated to files returned by <tt>listFiles()</tt> or to parent files used in <tt>mkdirs()</tt>. This could result in inappropriate authentication exceptions. Also NTLM HTTP support for HTTP <i>clients</i> (<tt>NtlmHttpURLConnection</tt>) has been updated to support NTLM negotiation using the POST method.
  902 </desc>
  903 </entry>
  905 <entry old="true">
  906 <title>jcifs-0.9.3 released / The SMB URL Port Field and Full Enumeration of Workgroups and Servers</title>
  907 <sub>posted by Mike, Jun 29, 2004</sub>
  908 <desc>
  909 A bug has been fixed that will now permit jCIFS to enumerate all workgroups and servers. Also included is a fix for the SMB URL port field that was previously being ignored.
  910 </desc>
  911 </entry>
  913 <entry old="true">
  914 <title>Davenport 0.9.9 released</title>
  915 <sub>posted by Eric, Jun 29, 2004</sub>
  916 <desc>
  917 This release includes some session serialization fixes as well as other minor items noted during testing.
  918 </desc>
  919 </entry>
  921 <entry old="true">
  922 <title>Davenport 0.9.9b released</title>
  923 <sub>posted by Eric, Jun 18, 2004</sub>
  924 <desc>
  925 The latest version of <a href="http://davenport.sourceforge.net/">Davenport</a> adds support for URL rewriting based on a context base, per-server authentication caching, disabling closing of HTTP connections upon request for authentication, support for pluggable error handlers and logging, the ability to specify anonymous credentials, and a file filter framework. The jCIFS library bundled with Davenport has also been updated to 0.9.2.
  926 </desc>
  927 </entry>
  929 <entry old="true">
  930 <title>jcifs-0.9.2 released / Deadlock in copyTo</title>
  931 <sub>posted by Mike, Jun 8, 2004</sub>
  932 <desc>
  933 An initialization race in the <tt>SmbFile.copyTo()</tt> method has been discovered and fixed. Also the documentation work continues.
  934 </desc>
  935 </entry>
  937 <entry old="true">
  938 <title>jcifs-0.9.1 released / Security Update</title>
  939 <sub>posted by Mike, Jun 1, 2004</sub>
  940 <desc>
  941 If the "guest" account is enabled on a CIFS server it is possible for jCIFS to successfully authenticate even with an invalid username. Windows networks virtually always disable this account but apparently it is not difficult to enable this condition when using Samba. NTLM HTTP Filter users that are not certain the "guest" account is disabled should upgrade. This release eliminates the possability of authenticating anyone without a valid username. Specifically, a small clause has been added that throws an <tt>SmbAuthException</tt> if the server responds with the "is logged in as guest" bit on.
  942 </desc>
  943 </entry>
  945 <entry old="true">
  946 <title>jcifs-0.9.0 released / Documentation</title>
  947 <sub>posted by Mike, May 28, 2004</sub>
  948 <desc>
  949 There have been no reports of problems so the aside from a very minor adjustment to the code all changes in this release are to the documentation. In particular the NTLM HTTP Authentication documentation has been significantly improved. The API documentation still needs work but it is believed to be accurate.
  950 </desc>
  951 </entry>
  953 <entry old="true">
  954 <title>jcifs-0.9.0b released / General Cleanup and Minor Enhancements</title>
  955 <sub>posted by Mike, May 14, 2004</sub>
  956 <desc>
  957 And thus begins the 0.9 series. This should solidify fairly quickly although there have been some pervasive changes. The details are as follows:
  958 <ul>
  959 <li>PropertiesTree has been removed. Thus properties must now be specified using the full name only.</li>
  960 <li>Multiple WINS servers may now be specified using a comma separated list of IPs (i.e. <tt>jcifs.netbios.wins=,,</tt>).</li>
  961 <li>The <tt>NtlmHttpFilter</tt> has been modified to support "preauthentication" such that if the <tt>jcifs.smb.client.{domain,username,password}</tt> properties are supplied as init parameters, all transports will be initialized with these credentials. This is the ideal setup for domain controllers that require SMB signatures (although it has been observed that NT 4.0 at least does not check the signatures of authentication requests).</li>
  962 <li>NT status codes are now used in favor or DOS error codes even if DOS error codes are negotiated (mapped to NT status codes immediately after being decoded). You can <a href="ntstatus.txt">lookup NT status codes here</a>. The package used to generate this file and the jCIFS code tables is in the download area.</li>
  963 <li>The <tt>NetServerEnum3</tt> operation has been added (thanks Gary) such that large lists of workgroups and servers may now be enumerated (doesn't help with large numbers of shares).</li>
  964 <li>Fixed some incorrect path handling in the DFS referral code.</li>
  965 <li>It is now NOT possible for a session setup to be transmitted if the <tt>NtlmPasswordAuthentication</tt> object's hashes were created with a server challenge that does not match the current <tt>encryptionKey</tt> of the transport. If this condition occurs and <tt>SmbAuthException</tt> with an NT status of <tt>NT_STATUS_ACCESS_VIOLATION</tt> will be thrown. The NTLM HTTP Filter and NetworkExplorer servlet have both been modified to catch this exception and issue an HTTP redirect to the original URL to reinitiate the NTLM negotiation.</li>
  966 <li>The <tt>jcifs.smb.client.ssnLimit</tt> property will now open redundant transports if the limit is reached. The old behavior of closing 10% of the oldest sessions has been eliminated.</li>
  967 <li>Several SMB signing fixes. The SMB signature code has been mostly moved into the <tt>SigningDigest</tt> class.</li>
  968 <li>Additional checks in the initial connection code have been added to reduce/eliminate lingering <tt>CLOSE_WAIT</tt> sockets.</li>
  969 <li>If <tt>PIPE_TYPE_TRANSACT</tt> and <tt>PIPE_TYPE_CALL</tt> are <i>not</i> specified a <tt>TRANS_WAIT_NAMED_PIPE</tt> will be issued before the open call to emulate <tt>WaitNamedPipe</tt> followed by <tt>CreateFile</tt> behavior.</li>
  970 <li>All access specifiers have been reviewed and changed to private, static, final, etc wherever appropriate.</li>
  971 <li>The queue used to manage MIDs has been removed in favor of something considerably simplier. Performance should be improved.</li>
  972 <li>The NetBIOS socket OutputStream has been simplified to remove a potential copy of data. Performance should be improved.</li>
  973 <li>The NBT header length is now checked after decoding an SMB to detect and skip incorrect byte counts. This should bypass the OS/400 bug reported.</li>
  974 <li>Property defaults for <tt>jcifs.smb.client.listCount</tt> and <tt>jcifs.smb.client.listSize</tt> have changed from 15 to 200 and from 1200 to 65535 repspectively. High latency networks should set these values back to the old values.</li>
  975 </ul>
  976 Bare in mind the documentation has not been updated. That's next.
  977 </desc>
  978 </entry>
  980 <entry old="true">
  981 <title>jcifs-0.8.3 released / Write Corruption with HotSpot VM on Linux</title>
  982 <sub>posted by Mike, Apr 20, 2004</sub>
  983 <desc>
  984 A bug in Sun's HotSpot VM can cause jCIFS to incorrectly encode file offsets in write requests resulting in massive file corruption. Once the error occurs it cannot be stopped without restarting the VM. If you are using the java <tt>-server</tt> option on Linux with a long lived multithreaded application that uses jCIFS to write files it is strongly recommended that you upgrade to 0.8.3. This release eliminates some redundent code that was ultimately triggering the bug in the HotSpot VM.
  985 <p/>
  986 Big thanks to Richard Heap for diagnosing and fixing this very elusive problem.
  987 </desc>
  988 </entry>
  990 <entry old="true">
  991 <title>jcifs-0.8.2 released / DST and getParent Fixes</title>
  992 <sub>posted by Mike, Mar 15, 2004</sub>
  993 <desc>
  994 The daylight savings time adjustement does not appear to work correctly. Commenting out the adjustment appears to exibit the desired behavior but the issue may need further tuning. The problem regarding <tt>SmbFile.getParent()</tt> returning unexpected results has been fixed.
  995 </desc>
  996 </entry>
  998 <entry old="true">
  999 <title>jcifs-0.8.1 released / Listing Adjustments</title>
 1000 <sub>posted by Mike, Feb 26, 2004</sub>
 1001 <desc>
 1002 All list methods will now return <tt>ATTR_HIDDEN</tt> files unless specifically filtered. It was decided that hiding hidden files is the job of a UI and not the API. Several bugs have also been fixed regarding attribute caching, the <tt>createNewFile</tt> method and <tt>setLastModified</tt> invalidating the create time.
 1003 </desc>
 1004 </entry>
 1006 <entry old="true">
 1007 <title>Davenport 0.9.8 relesed</title>
 1008 <sub>posted by Eric, Feb 13, 2004</sub>
 1009 <desc>
 1010 A bug introduced in 0.9.7 (observed against Windows 2000 and Gnome Nautilus clients) has been fixed.
 1011 </desc>
 1012 </entry>
 1014 <entry old="true">
 1015 <title>Davenport 0.9.7 relesed</title>
 1016 <sub>posted by Eric, Feb 12, 2004</sub>
 1017 <desc>
 1018 A bug involving redirects for directories not ending in "/" as well as various bugs involving incorrect WebDAV properties have been fixed. Additional localization support has been added.
 1019 </desc>
 1020 </entry>
 1022 <entry old="true">
 1023 <title>jcifs-0.8.0 released</title>
 1024 <sub>posted by Mike, Feb 11, 2004</sub>
 1025 <desc>
 1026 The 0.8 beta cycle is now over. There is no technical difference between this release and 0.8.0b1.
 1027 </desc>
 1028 </entry>
 1030 <entry old="true">
 1031 <title>Davenport 0.9.6 released</title>
 1032 <sub>posted by Eric, Feb 9, 2004</sub>
 1033 <desc>
 1034 This release provides minor bugfixes and enhancements; most notably, configuration options have been established to allow interoperability with Windows 2003 servers in the presence of SMB signing. See the <a href="http://davenport.sourceforge.net/">Davenport project page</a> for details.
 1035 </desc>
 1036 </entry>
 1038 <entry old="true">
 1039 <title>jcifs-rap-0.8.0b1 released / Remote Administration Protocol (RAP) Branch</title>
 1040 <sub>posted by Mike, Feb 6, 2004</sub>
 1041 <desc>
 1042 Eric has created a modified version of jCIFS that supports the following RAP functions:
 1043 <ul>
 1044 <li>NetGroupAdd -- Creates a global (domain) group on a DC</li>
 1045 <li>NetGroupDel -- Deletes a global group on a DC</li>
 1046 <li>NetGroupAddUser -- Adds a user to a global group on a DC</li>
 1047 <li>NetGroupDelUser -- Removes a user from a global group on a DC</li>
 1048 <li>NetGroupEnum -- Enumerates the global groups on a DC</li>
 1049 <li>NetGroupGetUsers -- Enumerates the members of a global group on a DC</li>
 1050 </ul>
 1051 <ul>
 1052 <li>NetServerEnum -- Enumerates servers in a domain/workgroup (reimplementation)</li>
 1053 <li>NetServerGetInfo -- Gets server information</li>
 1054 </ul>
 1055 <ul>
 1056 <li>NetShareAdd -- Adds a share to a server</li>
 1057 <li>NetShareDel -- Removes a share from a server</li>
 1058 <li>NetShareEnum -- Enumerates the shares on a server (reimplementation)</li>
 1059 </ul>
 1060 <ul>
 1061 <li>NetUserAdd -- Creates a domain or machine-local user</li>
 1062 <li>NetUserDel -- Deletes a domain or machine-local user</li>
 1063 <li>NetUserEnum -- Enumerates the users on a domain or machine</li>
 1064 <li>NetUserGetGroups -- Enumerates the global groups to which a user belongs</li>
 1065 <li>SamOemChangePassword -- Changes a user's password</li>
 1066 </ul>
 1067 He claims:
 1068 <p/>
 1069 "There are also GroupUtilities, ServerUtilities, ShareUtilities, and 
 1070 UserUtilities classes which provide simplified versions of the primary 
 1071 functionality.
 1072 <p/>
 1073 Most of the group-related stuff needs to be run against a DC, as it only 
 1074 works with global domain groups rather than machine local; that requires 
 1075 RPC, from what I gather.  None of this has been tested extensively, so 
 1076 results may vary.  But I figured you might like to play with it; it's 
 1077 fairly interesting stuff."
 1078 </desc>
 1079 </entry>
 1081 <entry old="true">
 1082 <title>jcifs-0.8.0b1 released / DFS with NetworkExplorer</title>
 1083 <sub>posted by Mike, Feb 3, 2004</sub>
 1084 <desc>
 1085 Some work has gone into getting DFS to work with NetworkExplorer
 1086 and all fixes from the 0.7 series since 0.7.15 have been incorporated.
 1087 Otherwise, the 0.8.0 series seems quite stable so far.
 1088 </desc>
 1089 </entry>
 1091 <entry old="true">
 1092 <title>jcifs-0.7.19 released / SMB Signing Fixes</title>
 1093 <sub>posted by Mike, Jan 19, 2004</sub>
 1094 <desc>
 1095 SMB signature varification was not working properly. There have been several fixes but <a href="https://lists.samba.org/archive/jcifs/2004-January/002905.html">one problem remains</a>. If there is a quick succession of reads and writes with the same host (i.e. copying a file) signing can fail. The source of the problem has not yet been identified.
 1096 </desc>
 1097 </entry>
 1099 <entry old="true">
 1100 <title>jcifs-0.7.18 released / NTLM HTTP Filter Fixes</title>
 1101 <sub>posted by Mike, Jan 7, 2004</sub>
 1102 <desc>
 1103 The NTLM HTTP Authentication Filter should now work with domain controllers
 1104 that  negotiate signing without generating the benign "exception
 1105 reading  from socket input" error. Also, the <tt>NtlmPasswordAuthentication</tt>
 1106 class  is  now  Serializable to increase compatability with certain Servlet 
 1107 containers. 
 1108 </desc>
 1109 </entry>
 1111 <entry old="true">
 1112 <title>jcifs-0.7.17 released / "exception reading from socket input" Exception No More</title>
 1113 <sub>posted by Mike, Dec 23, 2003</sub>
 1114 <desc>
 1115 JCIFS  will  now suppress the harmess "exception reading from socket input"
 1116 message  being  written  to  the log.
 1117 </desc>
 1118 </entry>
 1120 <entry old="true">
 1121 <title>jcifs-0.7.16 released / NetWare 6 Fix</title>
 1122 <sub>posted by Mike, Dec 9, 2003</sub>
 1123 <desc>
 1124 An issue regarding writing to NetWare 6 servers has been resolved.
 1125 </desc>
 1126 </entry>
 1128 <entry old="true">
 1129 <title>jcifs-0.8.0b released / Lots of New Features</title>
 1130 <sub>posted by Mike, Nov 24, 2003</sub>
 1131 <desc>
 1132 This  is  the  first  beta  release  of  the  0.8  series.  There have been
 1133 significant  additions  to  this  package. The most noteable is Distributed
 1134 FileSystem  (DFS)  support. This client fully supports DFS with deep paths,
 1135 multiple  redirects,  you  name  it.  This functionality required pervasive
 1136 changes so DFS users should proceed with caution and report any problems to
 1137 the  mailing list. Support for setting file attributes has been added as is
 1138 the long awaited RandomAccessFile. 
 1139 <p/>
 1140 Here is a more specific breakdown:
 1141 <ul>
 1142 <li> DFS  -  DFS  support  is  thorough.  All  DFS  operations  are completely
 1143 transparent.  It  Just  Works.  The  client can be redirected an infinate
 1144 number  of  times.  It  will reuse mappings established by other callers.
 1145 Components of a path that do not fall within the DFS space and deep paths
 1146 are  handled  properly. Also, note the new <tt>getDfsPath</tt> method can
 1147 be  used  to  determine  if a file or directory falls within a DFS space.
 1148 This  support  required pervasive changes so proceed with caution and run
 1149 your  unit  tests  with  files  that  span DFS volumes. Please report any
 1150 problems to the jCIFS mailing list.
 1151 </li>
 1152 <li> Random  Access  Files  -  The <a href="src/docs/api/jcifs/smb/SmbRandomAccessFile.html"><tt>SmbRandomAccessFile</tt></a> class has been
 1153 added.  All  features  of the analygous <tt>java.io.RandomAccessFile</tt>
 1154 class  are supported and should function as a drop in replacement. Notice
 1155 it   is   now   possible   to   set   the   size   of  a  file  with  the
 1156 <tt>SmbRandomAccessFile.setLength()</tt>    method.    Also   check   out
 1157 <tt>SmbTableFile.java</tt>   in   the  examples  directory  for  a  nifty
 1158 persistant  storage  class. When used with <tt>SmbFile.FILE_NO_SHARE</tt>
 1159 this might serve as a reasonable poor man's database. 
 1160 </li>
 1161 <li> File    Filters    -    Support    for   <tt>SmbFilenameFilter</tt>   and
 1162 <tt>SmbFileFilter</tt>  is  complete.  Because  CIFS  servers  can accept
 1163 attributes  and a wildcard expression for filtering entries on the server
 1164 side,  a  <a href="src/docs/api/jcifs/smb/DosFileFilter.html"><tt>DosFileFilter</tt></a>  is  provided  that  will  accept  these
 1165 parameters  and  pass  them to the server. The <tt>DosFileFilter</tt> can
 1166 also  be  extended  to  create  highly  sophisticated  and efficient file
 1167 filters.  Because of this work the <tt>list()</tt> and <tt>listFiles</tt>
 1168 methods have been refactored and actually reduced in size.
 1169 </li>
 1170 <li> Complete copyTo - The <tt>SmbFile.copyTo</tt> operation will now copy all
 1171 file  attributes  as  well  as  create  and last write times. Directories
 1172 copied  using  this  method should be indistinquishable from the original
 1173 minus  ACLs.  This  method  can now copy entire shares whereas previously
 1174 only sud-directories could be specified.
 1175 </li>
 1176 <li> Setting Attributes and Times - It is now possible to set file attribites,
 1177 the  create  time,  and  last  write  time  in a variety of ways. The new
 1178 methods     are     <tt>setCreateTime</tt>,     <tt>setLastModified</tt>,
 1179 <tt>getAttributes</tt>, <tt>setAttributes</tt>, <tt>setReadOnly</tt>, and
 1180 <tt>setReadWrite</tt>.
 1181 </li>
 1182 <li> Complete   Delete   -   The  <tt>SmbFile.delete()</tt>  method  will  now
 1183 completely  delete  directories  regardless  of wheather or not there are
 1184 read-only files in them.
 1185 </li>
 1186 <li> The createNewFile Method - An <tt>SmbFile.createFile</tt> method has been
 1187 added. 
 1188 </li>
 1189 </ul>
 1190 </desc>
 1191 </entry>
 1193 <entry old="true">
 1194 <title>jcifs-0.7.15 released / Load Balancing Across Domain Controllers</title>
 1195 <sub>posted by Mike, Oct 23, 2003</sub>
 1196 <desc>
 1197 The name service code has been modified to return a different response with
 1198 each  0x1C  domain controller query. The range of servers is limited to the
 1199 top  <tt>jcifs.netbios.lookupRespLimit</tt>  entries  in  the  NetBIOS response. The
 1200 effect  that this will have is that the <tt>NtlmHttpFilter</tt> and <tt>NtlmServlet</tt> will
 1201 rotate  through  domain  controllers when authenticating WWW clients. Also,
 1202 because  different  transports are used, fewer sessions will be multiplexed
 1203 over  each  resulting  in  an  increase  in scalability proportional to the
 1204 number  of  domain  controllers  used.  This  behavior can be turned off by
 1205 setting the <tt>jcifs.http.loadBalance</tt> property to false (the default is true).
 1206 <p/>
 1207 The  <tt>jcifs.smb.client.ssnLimit</tt>  property  default value has been changed to
 1208 250 from 100. 
 1209 </desc>
 1210 </entry>
 1213 <entry old="true">
 1214 <title>jcifs-0.7.14 released / Fixes</title>
 1215 <sub>posted by Mike, Oct 6, 2003</sub>
 1216 <desc>
 1217 An from Eric that improves (corrects) LMv2 support has been merged. There is some uncertainty surrounding
 1218 the signing of SMBs if guest credentials are negotiated.
 1219 A minor syncronization issue has been recified.
 1220 Finally there has been
 1221 a  straight  forward  but potentially dangerous change in <tt>SmbFile</tt>. All list
 1222 operations  now  build  a  list  of names or files using an <tt>ArrayList</tt>. This
 1223 assisted  in  fixing  another  problem  where <tt>NetServerEnum2</tt> responses were
 1224 observed    to   return   server   names   of   0   length which caused
 1225 <tt>ArrayIndexOutOfBounds</tt> exceptions. These entries are now ignored. 
 1226 </desc>
 1227 </entry>
 1230 <entry old="true">
 1231 <title>jcifs-0.7.13 released / SMB Signing Support</title>
 1232 <sub>posted by Mike, Sep 17, 2003</sub>
 1233 <desc>
 1234 JCIFS  now  supports SMB signing. If a server requires SMB signing (Windows
 1235 2003  requires  it  by  default)  or if the server supports signing and the
 1236 <tt>jcifs.smb.client.signingPreferred</tt> property   is   true  signing  will  be
 1237 negotiated  and  used.  Signing does not work with NTLM HTTP authentication
 1238 because  the  original  password  hashes  are  required to generate the MAC
 1239 signing  key.  There  have  also been some adjustments to <tt>SmbFile.hashCode()</tt>.
 1240 Previously  jCIFS  did  not precisely exhibit the behavior described in the
 1241 comments for <tt>hashCode()</tt> and <tt>equals()</tt>. 
 1242 </desc>
 1243 </entry>
 1246 <entry old="true">
 1247 <title>jcifs-0.7.12 released / ERRSVR/90 Fix</title>
 1248 <sub>posted by Mike, Sep 1, 2003</sub>
 1249 <desc>
 1250 CIFS  permits  multiple  users  to  be  logged  in  over the same transport
 1251 (socket).  JCIFS  takes  advantage  of  this and reuses existing transports
 1252 wherever  possible.  It  was  reported  that  a user using the NTLM Servlet
 1253 Filter  was  getting  <tt>ERRSRV/90</tt>  which  means "Too many Uids active on this
 1254 session". So it looks like the limit is ~150 sessions per transport. I have
 1255 added    code    to    logoff    1/10th    of    the    sessions   if   the
 1256 jcifs.smb.client.ssnLimit propery is exceeded (default 100). <i>update: this value was later reported to be low and has been increased to 250.</i> 
 1257 </desc>
 1258 </entry>
 1260 <entry old="true">
 1261 <title>jcifs-0.7.11 released / LMv2 Authentication Support</title>
 1262 <sub>posted by Mike, Jul 10, 2003</sub>
 1263 <desc>
 1264 Support  for  LMv2  authentication has been added. See the Overview page in
 1265 the  API  documentation  regarding  the <tt>jcifs.smb.lmCompatibility</tt> property.
 1266 Some  additonal  "cleanup"  has  also  been performed. One side-effect that
 1267 might be noticed is that the default domain/username/password can no longer
 1268 be  set  at runtime. Once the client is initialized the default credentials
 1269 are  fixed.  Setting  default  credentials are runtime was always an unsafe
 1270 operation. Create an <tt>NtlmPasswordAuthentication</tt> object instead. 
 1271 </desc>
 1272 </entry>
 1274 <entry old="true">
 1275 <title>jcifs-0.7.10 released / NTLM Protocol Documentation</title>
 1276 <sub>posted by Mike, Jul 3, 2003</sub>
 1277 <desc>
 1278 There  have  been  two small bug fixes in the SMB layer; the count field in
 1279 the  <tt>SMB_COM_WRITE_ANDX</tt>  response  was  being ignored. Apparently the count
 1280 specified  in the request is always honored or we would have seen plenty of
 1281 file corruption by now. Second, the <tt>list()</tt> and <tt>listFiles()</tt> did not properly
 1282 handle  Transaction  buffering  with  certain  values  for the <tt>listSize</tt> and
 1283 <tt>listCount</tt>  properties  (if  multipart transaction responses are send). Also
 1284 removed  a  few  obnoxious warnings getting logged during file transfers if
 1285 <tt>Log.WARNINGS</tt> is set. 
 1286 <p/>
 1287 Regarding  NTLM  HTTP Authentication; there have been additions and updates
 1288 to  the  documentation  on the NTLM flags, a fix to <tt>NtlmSsp</tt> to only provide
 1289 the  target when requested by the client via the NTLM "request target" flag
 1290 (this   is   the   correct  behavior),  and  a  bugfix  to  <tt>NtlmSsp</tt> regarding
 1291 <tt>Base64.encodeBytes</tt>
 1292 Eric has prepared excellent
 1293 documentation detailing his analysis of the NTLM protocol: 
 1294 <p/>
 1295 <a href="http://davenport.sourceforge.net/ntlm.html">http://davenport.sourceforge.net/ntlm.html</a>
 1296 </desc>
 1297 </entry>
 1299 <entry old="true">
 1300 <title>jcifs-0.7.9 released / Important Fix</title>
 1301 <sub>posted by Mike, Jun 12, 2003</sub>
 1302 <desc>
 1303 It  was  discovered  that if a server responds to the NBT session setup but
 1304 not  to  the  <tt>SMB_COM_NEGOTIATE</tt>  request the client will hang indefinately.
 1305 This  is not a likely thing to occur because servers usually respond or not
 1306 at  all.  Regardless  it  has  been  fixed.  The  client will timeout after
 1307 <tt>jcifs.netbios.soTimeout</tt> in this situation. 
 1308 <p/>
 1309 Some tweeking of the NTLM http code has been performed.
 1310 </desc>
 1311 </entry>
 1313 <entry old="true">
 1314 <title>jcifs-0.7.8 released</title>
 1315 <sub>posted by Mike, May 28, 2003</sub>
 1316 <desc>
 1317 A bug in the new ntlm http client code was identified and fixed.
 1318 </desc>
 1319 </entry>
 1321 <entry old="true">
 1322 <title>jcifs-0.7.7 released</title>
 1323 <sub>posted by Mike, May 27, 2003</sub>
 1324 <desc>
 1325 A  deadlock  was  identified  in <tt>SmbTransport.java</tt> very similar to the last one found
 1326 about a year ago.  A simple but significant  change  has  been made that greatly simplifies
 1327 synchronization in the transport layer. It eliminates this issue as well as 
 1328 the  extra synchronization introduced to fix the previous problem. It is an
 1329 elemental change however so proceed with caution (<i>Update Jun 1: Reports are good; no problems</i>).
 1330 <p/>
 1331 Two  new  packages  have  been  introduced.  The  <tt>jcifs.ntlmssp</tt> package now
 1332 contains some NTLMSSP base classes. This code is used by the <tt>NtlmHttpFilter</tt> as
 1333 well  as  the  new  <tt>NtlmHttpURLConnection</tt> class for transparently enabling
 1334 your  HTTP and HTTPS client to negotiate NTLM authentication with IIS, the jCIFS Filter, Sqiud proxy, etc.
 1335 The other new
 1336 package  is  <tt>jcifs.https</tt>  which  just  contains  the HTTPS protocol handler 
 1337 necesary for proper protocol handler registration.
 1338 Please read the document entitled <a href="src/docs/httpclient.html">Using JCIFS NTLM Authentication for HTTP Connections</a> for important information about this new functionality.
 1339 <p/>
 1340 Some open flags internal to <tt>SmbFileOutputStream</tt> have been changed to permit <a href="http://lists.samba.org/pipermail/jcifs/2003-May/002168.html">unusual named pipe modes</a> to be used that previously were not considered.
 1341 <p/>
 1342 Previously it was possible for jCIFS to report incorrect (old)
 1343 file size and modification time values after writing to the file. The attribute expiration period is now reset in <tt>SmbFileOutputStream.write()</tt> to prevent this problem. It is also possible to work around the problem by setting <tt>jcifs.smb.client.attrExpirationPeriod = 0</tt> although doing so may impact performace.
 1344 <p/>
 1345 Previously using the <tt>SmbFileInputStream.skip()</tt> method meant data would be read and then discarded.
 1346 This implementation of this  method  has  been changed so that data is not read; there will be no IO to the server.
 1347 This might be useful to applications that wish to resume a large download from a certain offset within a file in the event of a network failure.
 1348 </desc>
 1349 </entry>
 1351 <entry old="true">
 1352 <title>jcifs-0.7.6 released</title>
 1353 <sub>posted by Mike, Apr 16, 2003</sub>
 1354 <desc>
 1355 The  <tt>SmbFile.isDirectory()</tt> method has been changed to return <tt>false</tt> if the target does
 1356 not  exist.  Previously  this  would return <tt>true</tt> which is inconsistent with
 1357 <tt>java.io.File</tt>. 
 1358 </desc>
 1359 </entry>
 1362 <entry old="true">
 1363 <title>jcifs-0.7.5 released</title>
 1364 <sub>posted by Mike, Apr 2, 2003</sub>
 1365 <desc>
 1366 More  refinement  to  the  NTLM  HTTP authentication code has been applied.
 1367 There  is  also  a fix for listing hosts from Windows ME/98/95 local master
 1368 browsers.
 1369 </desc>
 1370 </entry>
 1372 <entry old="true">
 1373 <title>jcifs-0.7.4 released</title>
 1374 <sub>posted by Mike, Mar 26, 2003</sub>
 1375 <desc>
 1376 Some <tt>NtlmHttpFilter</tt> issues were reported by several users with Windows 98 clients.
 1377 Eric  has  provided  a  new  <tt>NtlmSsp.java</tt>  that permits the Filter to work correctly with these
 1378 clients.
 1379 </desc>
 1380 </entry>
 1382 <entry old="true">
 1383 <title>jcifs-0.7.3 released</title>
 1384 <sub>posted by Mike, Feb 12, 2003</sub>
 1385 <desc>
 1386 Under certain conditions the <tt>SmbSession.logon()</tt> method could
 1387 accept an incorrect password because of how <tt>SmbSession</tt>
 1388 objects are shared internally. This mehtod will now <i>always</i>
 1389 throw a <tt>SmbAuthException</tt> if incorrect credentials are
 1390 supplied. A minor change has also been made to the behavior of the
 1391 <tt>NtlmHttpFilter</tt> and <tt>NetworkExplorer</tt> servlet that
 1392 provokes the Network Password dialog to be redisplayed repeatedly
 1393 until correct credentials are entered by the user.
 1394 </desc>
 1395 </entry>
 1397 <entry old="true">
 1398 <title>jcifs-0.7.2 released</title>
 1399 <sub>posted by Mike, Feb 5, 2003</sub>
 1400 <desc>
 1401 A serious bug was found that causes an
 1402 <tt>ArrayIndexOutOfBoundsException</tt> to be thrown if the <tt>len</tt>
 1403 parameter of <tt>SmbFileOutputStream.write()</tt> is 1501, 1502, or
 1404 1503. Also, the <tt>FILE_SHARE_READ</tt>, <tt>FILE_SHARE_WRITE</tt>,
 1405 <tt>FILE_SHARE_DELETE</tt>, and <tt>FILE_NO_SHARE</tt> constants have
 1406 been exposed in <tt>SmbFile</tt> to specify a <tt>shareAccess</tt>
 1407 parameter to <tt>SmbFileOutputStream</tt> and <tt>SmbFile</tt> to
 1408 restrict other processes from accessing files opened by jCIFS. The
 1409 <tt>SmbFileOutputStream</tt> now supports offsets greater than 4GB.
 1410 </desc>
 1411 </entry>
 1413 <entry old="true">
 1414 <title>jcifs-0.7.1 released</title>
 1415 <sub>posted by Mike, Jan 16, 2003</sub>
 1416 <desc>
 1417 Three bugs have been fixed, regarding filenames with '#' signs in them, the <tt>getInputStream()</tt>, <tt>getLastModified()</tt>, <tt>getDate()</tt>, and <tt>getContentLength()</tt> methods of the <tt>URLConnection</tt> implementation, and <tt>isExists()</tt> incorrectly returning false.
 1418 </desc>
 1419 </entry>
 1421 <entry old="true">
 1422 <title>Updated SMB URL Internet Draft</title>
 1423 <sub>posted by Chris, Jan 15, 2003</sub>
 1424 <desc>
 1425 Revision 04 of the <A
 1426 HREF="http://www.ietf.org/internet-drafts/draft-crhertel-smb-url-04.txt">SMB
 1427 URL draft specification</A> is now available.
 1428 </desc>
 1429 </entry>
 1431 <entry old="true">
 1432 <title>jcifs-0.7.0 released</title>
 1433 <sub>posted by Mike, Jan 8, 2003</sub>
 1434 <desc>
 1435 <A HREF="http://freshmeat.net/screenshots/4774"><IMG SRC="http://images.freshmeat.net/screenshots/4774_thumb.png" BORDER="0" ALT="" ALIGN="RIGHT"/></A>
 1437 This release of the jCIFS client includes new functionality specifically targeting Web applications
 1438 as well as some critical SMB URL fixes and feature improvements. They are outlined in greater detail below. Enjoy!
 1440 <UL>
 1441 <LI> The new <tt>jcifs.http</tt> package is very handy when building
 1442 Web applications that need to integrate with MS corporate intranets. Adding
 1443 a hyperlink to a document on a network drive is easy with Network
 1444 Explorer (pictured right) and will transparently negotiate credentials
 1445 with MSIE to browse SMB resources (really, no password dialog necessary). This package also boasts an <A
 1446 HREF="src/docs/ntlmhttpauth.html">NTLM HTTP Authentication</A> servlet Filter
 1447 for authenticating MSIE clients. These are useful features because many of
 1448 the tasks surrounding user management now fall back to computer support
 1449 and HR. It is not necessary to add and remove users as they join and
 1450 leave the company. Perhaps most important from the user's perspective;
 1451 they do not need to enter a username or password if their workstation
 1452 is a member of an NT domain. The password hashes generated when they
 1453 logged on to their workstation will be negotiated during the initial
 1454 request for a session, passed through jCIFS, and validated against a
 1455 PDC or BDC. This also makes the user's domain, username, and password
 1456 available for managing session information, profiles, preferences, etc.
 1457 </LI>
 1458 <LI> The functionality used to authenticate and manage
 1459 arbitrary credentials has been exposed in the <a href="src/docs/api/jcifs/smb/SmbSession.html">SmbSession</a> and <a
 1460 href="src/docs/api/jcifs/smb/NtlmPasswordAuthentication.html">NtlmPasswordAuthentication</a>
 1461 classes. This permits NTLM password authentication to be integrated
 1462 into applications without requiring Microsoft components or JNI.
 1463 </LI>
 1464 <LI> With the introduction of the <A HREF="src/docs/api/overview-summary.html#scp"><tt>jcifs.encoding</tt></A> property the client is now truly internationalized. It has been used successfully on OS/390 with native
 1465 EBCDIC character encoding. See the Sun JRE documentation for a list of <A
 1466 HREF="http://java.sun.com/j2se/1.3/docs/guide/intl/encoding.doc.html">supported
 1467 encodings</A>.
 1468 </LI>
 1469 <LI> The URL issues remaining in the 0.6 series have been
 1470 fixed in 0.7 by converting all SMB URL handling internally to use the
 1471 <tt>java.net.URL</tt> class (<i>Note: directories must now have a
 1472 trailing slash and Java 1.3 is required</i>). Also a deadlock in the
 1473 name service code was identified and fixed (repaired in 0.6.8 as well).
 1474 </LI>
 1475 <LI> A <tt>copyTo()</tt> method has
 1476 been added to <tt>SmbFile</tt> that is <A
 1477 HREF="http://lists.samba.org/pipermail/jcifs/2002-August/002357.html"><i>very
 1478 fast</i></A> at copying large directories across hosts.
 1479 </LI>
 1480 </UL>
 1481 There have been numerous other changes including the <tt>mkdirs()</tt>
 1482 and <tt>getType()</tt> methods, plain text password support (disabled
 1483 by default), the <tt>available()</tt> method and <tt>close()</tt>
 1484 fix for Named Pipes, reading files larger than 4 GB, the
 1485 <tt>NtlmAuthenticator</tt> class, and more.
 1487 <p/> All documentation has been completely reviewed. See the links under Developer Information at the top of the list to the left.
 1488 </desc>
 1489 </entry>
 1491 <entry old="true">
 1492 <title>jcifs-0.6.8 released</title>
 1493 <sub>posted by Mike, Thu Dec 19, 2002</sub>
 1494 <desc>
 1495 This release fixes a name service deadlock.  It was thought to have
 1496 been fixed in the previous release but an update was accidentally
 1497 lost.  This is the same name service deadlock described in both the
 1498 stable and beta series for the past two releases.  It should really be
 1499 gone now.
 1500 </desc>
 1501 </entry>
 1503 <entry old="true">
 1504 <title>Java 1.3 Now Required</title>
 1505 <sub>posted by Mike, Wed Nov 12, 2002</sub>
 1506 <desc>
 1507 Java 1.3 is now required with jcifs-0.7.0b4 or later. This is because
 1508 we are now using the Java 1.3 variant of <tt>java.net.URL.set()</tt> for
 1509 all URL handling internally and the 1.2 implementation does not support
 1510 our requirements. Attempting to use Java 1.2 or below will result in an
 1511 error message printed to <tt>System.err</tt> and <tt>unknown protocol:
 1512 smb</tt> exceptions. If you must use Java 1.2 or 1.1 jcifs-0.6.8
 1513 will work great as usual minus The URL Bug.
 1514 </desc>
 1515 </entry>
 1517 <entry old="true">
 1518 <title>jcifs-0.7.0b5 released</title>
 1519 <sub>posted by Mike, Tue Oct 22, 2002</sub>
 1520 <desc>
 1521 To resolve URL issues, jcifs now uses <tt>java.net.URL</tt> internally
 1522 throughout. This has changed the behavior of the client in very
 1523 significant ways and it will undoubtedly break older code. These
 1524 issues are:
 1525 <ul>
 1526 <li><b>URLs that represent workgroups, servers, shares, or directories
 1527 must have a trailing slash '/'.</b></li>
 1528 <li>Canonicalization does not exceed the host component of the
 1529 URL. So <tt>smb://host/share/path/</tt> + <tt>../../../../foo/</tt> is
 1530 canonicalized to <tt>smb://host/foo/</tt> whereas previously the client
 1531 would have reduced this to <tt>smb://foo/</tt>.</li>
 1532 <li>For constructors that accept a second parameter, that parameter can
 1533 no longer be <tt>null</tt>.</li>
 1534 <li>Composing a URL with a workgroup and a second parameter like
 1535 <tt>smb://workgroup/</tt> + <tt>server/share/path/</tt> used to
 1536 be intelligent enough to eliminate <tt>workgroup</tt>. This
 1537 will now blindly compose the two arguments to give
 1538 <tt>smb://workgroup/server/share/path/</tt> which is an illegal SMB URL.</li>
 1539 </ul>
 1540 See <a href="src/CHANGES.txt">CHANGES.txt</a> for a more detailed explanation.
 1541 <p/>
 1542 The <tt>NtlmHttpFilter</tt> and <tt>NetworkExplorer</tt> should
 1543 now work whereas before some users (largely Tomcat users) were
 1544 experiencing problems. The NTLM HTTP Authentication code is now
 1545 stateless and has been verified to work with both Resin and Tomcat
 1546 at least. An <tt>NtlmServlet</tt> has been contributed that can
 1547 negotiated NTLM SSP using older pre-2.3 servlet containers. Previously,
 1548 negotiated credentials could not be used to access SMB resources
 1549 with <tt>NetworkExplorer</tt>. This works now, and it is remarkably
 1550 fast, however you cannot filter <tt>NetworkExplorer</tt> with the
 1551 <tt>NtlmHttpFilter</tt>. The <a href="src/docs/ntlmhttpauth.html">NTLM
 1552 HTTP Authentication document</a> has been updated.
 1553 </desc>
 1554 </entry>
 1556 <entry old="true">
 1557 <title>jcifs-0.6.6 released</title>
 1558 <sub>posted by Mike, Thu Sep 26, 2002</sub>
 1559 <desc>
 1560 There's a nasty bug in Win2K that causes jCIFS to hang. The
 1561 <tt>PrimaryDomain</tt> field in the <tt>SMB_COM_SESSION_SETUP_ANDX</tt>
 1562 response is not properly terminated with <i>two</i> zeros like it
 1563 should be when Unicode is negotiated. I have patched jCIFS to only
 1564 look for one zero which should eliminate this problem.
 1565 <P/>
 1566 Unfortunately there are three other bugs that have not been attended
 1567 to as they all relate to the rather complicated issue of the SMB URL:
 1568 <ul>
 1569 <li>The URL protocol handler is not reentrant. It will produce
 1570 inconsistent results if <tt>java.net.URL</tt>s are created concurrently.</li>
 1571 <li>Full SMB URLs with an '@' in the path will misinterpret the
 1572 string following the '@' as the server component. This problem will
 1573 not occur if an <tt>SmbFile</tt> is composed with the two parameter
 1574 constructor or if user credentials are supplied.</li>
 1575 <li>There have been reports of a '/' being left out of SMB URLs being
 1576 created with the <tt>java.net.URL</tt> class. I have not been able to
 1577 reproduce this issue.</li>
 1578 </ul>
 1579 These issues will be resolved all together with a new simpler State
 1580 Machine parser and properly integrated with the <tt>java.net.URL</tt>
 1581 class. I am not aware of any other bugs in 0.6.6 so please let us know
 1582 if you see otherwise.
 1583 </desc>
 1584 </entry>
 1586 <entry old="true">
 1587 <title>jcifs-0.7.0b12 released</title>
 1588 <sub>posted by Mike, Tue Dec 31, 2002</sub>
 1589 <desc>
 1590 Changes have been made that should eliminate the "<tt>unknown
 1591 protocol: smb</tt>" exceptions experienced when trying to install
 1592 jCIFS in environments using custom class loaders and restrictive
 1593 security policies (application servers). URL decoding of the
 1594 <tt>domain;user:password</tt> component of SMB URLs is in place. There
 1595 were a few other minor adjustments.
 1596 </desc>
 1597 </entry>
 1599 <entry old="true">
 1600 <title>jcifs-0.7.0b11 released</title>
 1601 <sub>posted by Mike, Fri Dec 20, 2002</sub>
 1602 <desc>
 1603 A debugging statement at <tt>jcifs/UniAddress.java:173</tt> was printing
 1604 useless information to <tt>System.out</tt> when listing <tt>smb://</tt>
 1605 and <tt>smb://workgroup/</tt> URLs. This has been fixed.
 1606 <p/>
 1607 Although it remains to be seen how exactly jCIFS should be installed
 1608 for those using the <tt>jcifs.http</tt> package there do not appear to
 1609 be any issues remaining in the core. This will likely be the last beta.
 1610 <p/>
 1611 Happy Holidays!
 1612 </desc>
 1613 </entry>
 1615 <entry old="true">
 1616 <title>jcifs-0.6.8 released</title>
 1617 <sub>posted by Mike, Thu Dec 19, 2002</sub>
 1618 <desc>
 1619 This release fixes a name service deadlock.  It was thought to have
 1620 been fixed in the previous release but an update was accidentally
 1621 lost.  This is the same name service deadlock described in both the
 1622 stable and beta series for the past two releases.  It should really be
 1623 gone now.
 1624 </desc>
 1625 </entry>
 1627 <entry old="true">
 1628 <title>jcifs-0.7.0b10 released</title>
 1629 <sub>posted by Mike, Fri Dec 13, 2002</sub>
 1630 <desc>
 1631 Please read the <a href="src/docs/faq.html">FAQ</a>. It now covers issues surrounding
 1632 the following Exception:
 1633 <pre>
 1634 Exception MalformedURLException: unknown protocol: smb
 1635 at java.net.URL.&lt;init&gt;(URL.java:480)
 1636 at java.net.URL.&lt;init&gt;(URL.java:376)
 1637 at java.net.URL.&lt;init&gt;(URL.java:330)
 1638 at jcifs.smb.SmbFile.&lt;init&gt;(SmbFile.java:355)
 1639 ...
 1640 </pre>
 1641 Two deadlocks have been fixed (one serious one thought to have been
 1642 fixed in 0.7.0b7), minor adjustments to <tt>jcifs.Config</tt> have been
 1643 made to assist with the above exception, and the <tt>jcifs.encoding</tt>
 1644 property will now be read properly whereas previously it was not.
 1645 <P/>
 1646 Also, notice there's an <a href="old.html">Old News ...</a> link at
 1647 the bottom of the news section now. It's hard to believe it's been
 1648 less than three years since jcifs-0.1.
 1649 </desc>
 1650 </entry>
 1652 <entry old="true">
 1653 <title>jcifs-0.7.0b9 released</title>
 1654 <sub>posted by Mike, Fri Nov 22, 2002</sub>
 1655 <desc>
 1656 An issue with <tt>getType()</tt> returning incorrect values and an issue
 1657 with the <tt>close()</tt> method of Named Pipe input and output streams
 1658 have been fixed. The NtlmAuthenticator has been reimplemented allowing
 1659 the SmbShell example to be restored to working order.
 1660 <pre>
 1661 $ java -Djcifs.properties=../miallen.prp SmbShell smb://storage15/
 1662 storage15/&gt; cd admin$/
 1663 Access denied for smb://storage15/admin$/
 1664 username: nyrsch\Administrator
 1665 password: fretos
 1666 admin$/&gt;
 1667 </pre>
 1668 </desc>
 1669 </entry>
 1671 <entry old="true">
 1672 <title>jcifs-0.7.0b8 released</title>
 1673 <sub>posted by Mike, Wed Nov 13, 2002</sub>
 1674 <desc>
 1675 Several bugs have been fixed regarding the <tt>getUncPath()</tt>
 1676 method not including the share name, failure connecting to Windows
 1677 98 via the Node Status call, and a <tt>NullPointerException</tt> in
 1678 <tt>UniAddress</tt>. The <tt>Authenticator</tt> functionality has not
 1679 be reimplemented but will in a later release.
 1680 </desc>
 1681 </entry>
 1683 <entry old="true">
 1684 <title>Java 1.3 Now Required</title>
 1685 <sub>posted by Mike, Wed Nov 12, 2002</sub>
 1686 <desc>
 1687 Java 1.3 is now required with jcifs-0.7.0b4 or later. This is because
 1688 we are now using the Java 1.3 variant of <tt>java.net.URL.set()</tt> for
 1689 all URL handling internally and the 1.2 implementation does not support
 1690 our requirements. Attempting to use Java 1.2 or below will result in an
 1691 error message printed to <tt>System.err</tt> and <tt>unknown protocol:
 1692 smb</tt> exceptions. If you must use Java 1.2 or 1.1 jcifs-0.6.8
 1693 will work great as usual minus The URL Bug.
 1694 </desc>
 1695 </entry>
 1697 <entry old="true">
 1698 <title>jcifs-0.6.7 released</title>
 1699 <sub>posted by Mike, Wed Nov 6, 2002</sub>
 1700 <desc>
 1701 It's not clear that the name service deadlock can be provoked on the
 1702 0.6 series but I have applied the fix just to be safe. That's the
 1703 only change.
 1704 </desc>
 1705 </entry>
 1707 <entry old="true">
 1708 <title>jcifs-0.7.0b7 released</title>
 1709 <sub>posted by Mike, Mon Nov 4, 2002</sub>
 1710 <desc>
 1711 A  deadlock  in  the  name  service  code  was  found  and  eliminated. The
 1712 <tt>SmbFiles</tt>   created  with  <tt>listFiles()</tt>  on  a  workgroup
 1713 resource    like    <tt>smb://workgroup/</tt>    were    invalid    (e.g.
 1714 <tt>smb://workrgoup/server/</tt>).  The  old  correct  behavior  has been
 1715 restored.  An  issue  regarding  <tt>InetAddress</tt>  mistaking  certain
 1716 pathological  names as IP addresses like the name '1' yielding IP
 1717 has been fixed.
 1718 </desc>
 1719 </entry>
 1722 <entry old="true">
 1723 <title>jcifs-0.7.0b6 released</title>
 1724 <sub>posted by Mike, Mon Oct 28, 2002</sub>
 1725 <desc>
 1726 All encoding and decoding of 8 bit strings being read from or written to
 1727 a server will use an arbitrary encoding specified with the new
 1728 <tt>jcifs.encoding</tt> property. These changes will permit the client
 1729 to operate in any environment regardless of locale settings such as
 1730 OS/390 with a native EBCDIC <tt>file.encoding</tt>.
 1731 <P/>
 1732 With the 0.7 series a bug was introduced that prevented workgroups,
 1733 servers of a workgroup, and shares of a server from being enumerated
 1734 using anonymous credentials.  A concurrency issue with <tt>copyTo</tt>
 1735 was also identified. Both issues have been fixed.
 1736 </desc>
 1737 </entry>
 1739 <entry old="true">
 1740 <title>jcifs-0.6.6 released</title>
 1741 <sub>posted by Mike, Thu Sep 26, 2002</sub>
 1742 <desc>
 1743 There's a nasty bug in Win2K that causes jCIFS to hang. The
 1744 <tt>PrimaryDomain</tt> field in the <tt>SMB_COM_SESSION_SETUP_ANDX</tt>
 1745 response is not properly terminated with <i>two</i> zeros like it
 1746 should be when Unicode is negotiated. I have patched jCIFS to only
 1747 look for one zero which should eliminate this problem.
 1748 <P/>
 1749 Unfortunately there are three other bugs that have not been attended
 1750 to as they all relate to the rather complicated issue of the SMB URL:
 1751 <ul>
 1752 <li>The URL protocol handler is not reentrant. It will produce
 1753 inconsistent results if <tt>java.net.URL</tt>s are created concurrently.</li>
 1754 <li>Full SMB URLs with an '@' in the path will misinterpret the
 1755 string following the '@' as the server component. This problem will
 1756 not occur if an <tt>SmbFile</tt> is composed with the two parameter
 1757 constructor or if user credentials are supplied.</li>
 1758 <li>There have been reports of a '/' being left out of SMB URLs being
 1759 created with the <tt>java.net.URL</tt> class. I have not been able to
 1760 reproduce this issue.</li>
 1761 </ul>
 1762 These issues will be resolved all together with a new simpler State
 1763 Machine parser and properly integrated with the <tt>java.net.URL</tt>
 1764 class. I am not aware of any other bugs in 0.6.6 so please let us know
 1765 if you see otherwise.
 1766 </desc>
 1767 </entry>
 1769 <entry old="true">
 1770 <title>SNIA CIFS Technical Reference Back Online</title>
 1771 <sub>posted by Chris, Mon Sep 9, 2002</sub>
 1772 <desc>
 1773 Following the restructuring of the <B>S</B>torage <B>N</B>etworking
 1774 <B>I</B>ndustry <B>A</B>ssociation (SNIA) website, the <A
 1775 HREF="http://www.snia.org/tech_activities/CIFS/">CIFS Technical
 1776 Reference</A> disappeared for a while.  A new home has been found and
 1777 the document is now back online.  In the next few months, work will
 1778 begin on a <A HREF="http://twiki.org/">TWiki</A><small><SUP>[TM]</SUP></small>-based comment forum so that interested
 1779 folk can annotate the SNIA CIFS doc.
 1780 </desc>
 1781 </entry>
 1784 <entry old="true">
 1785 <title>jcifs-0.7.0b3 released</title>
 1786 <sub>posted by Mike, Sun Aug 25, 2002</sub>
 1787 <desc>
 1788 As usual Chris found a couple of bugs testing in the interop
 1789 lab at the CIFS conferance. I fixed the graceful-reconnect
 1790 issue. Countless bugs have been fixed in Network Explorer. The NTLM HTTP
 1791 Authentication/Network Explorer docucumentation has been overhauled
 1792 again. Implemented <tt>mkdirs()</tt>, <tt>available()</tt> for Named
 1793 Pipes, and <tt>copyTo()</tt> will now attempt to maintain the last
 1794 modified time (although NT clearly doesn't support it). Quite a few
 1795 other issues fixed including one quite serious bug.
 1796 </desc>
 1797 </entry>
 1799 <entry old="true">
 1800 <title>NTLM HTTP Authentication and the New <tt>jcifs.http</tt> Package</title>
 1801 <sub>posted by Mike, Wed Aug 8, 2002</sub>
 1802 <desc>
 1803 With the release of the 0.7.0 series, we are introducing a new
 1804 package; <tt>jcifs.http</tt>. The jCIFS client is proving to be quite
 1805 useful for adding functionality to websites on corporate intranets.
 1806 Adding a link to a document on your LAN for example is a trivial
 1807 exercise with jCIFS. In the <tt>jcifs.http</tt> package we will be
 1808 providing Servlets and CGIs that do this and more.
 1809 <P/>
 1810 To inaugurate this package, we have implemented NTLM HTTP
 1811 Authentication which allow MSIE clients to authenticate against a domain
 1812 controller. This is a useful feature because many of the tasks
 1813 surrounding user management now fall back to computer support and HR. It
 1814 is not necessary to add and remove users as they join and leave the
 1815 company. Perhaps most important from a user's perspective; they do not
 1816 need to enter a username or password if their workstation is a member of
 1817 the domain. The password hashes generated when they logged on to their
 1818 workstation will be negotiated during the initial request for a session,
 1819 passed through jCIFS, and validated against a PDC or BDC. This also
 1820 makes the users domain, username, and password available for managing
 1821 session information, profiles, preferences, etc.
 1822 <P/>
 1823 For complete details, please read <a href="src/docs/ntlmhttpauth.html">Authenticating MSIE Clients using NTLM HTTP Authentication and jCIFS</a>.
 1824 <P/>
 1825 We would be delighted to see popular application servers use the now
 1826 public <a href="src/docs/api/jcifs/smb/SmbSession.html">SmbSession</a>
 1827 class's <tt>getChallenge()</tt> and <tt>logon()</tt> methods to
 1828 integrate this functionality into their products in a way that is
 1829 consistent with other authentication schemes such as <tt>BASIC_AUTH</tt>
 1830 so that <tt>getRemoteUser()</tt> works expectedly or provide for NTLM
 1831 HTTP Authentication protected &#34;Relms&#34; in Tomcat.
 1832 </desc>
 1833 </entry>
 1835 <entry old="true">
 1836 <title>jcifs-0.7.0b released</title>
 1837 <sub>posted by Mike, Wed Aug 8, 20002</sub>
 1838 <desc>
 1839 New features:
 1840 <ul>
 1841 <li>NTLM HTTP Authentication.  Thanks to Jason Pugsley for his code and
 1842 bringing us up to speed on this. I know this will be a popular feature.
 1843 See above message for details.</li>
 1844 <li>A <tt>jcifs.smb.client.codepage</tt> property has been added to
 1845 specify an 8 bit character encoding to use for &#34;ASCII&#34; strings.
 1846 If your workgroup, server, and share names are not rendered properly you
 1847 may wish to explore this.  See <a href="src/CHANGES.txt">CHANGES.txt</a>
 1848 for details.  This should resolve the issue reported by Dmitry Khlonin
 1849 about using <tt>codepage=Cp866</tt> on his Russian LAN.  See the <a
 1850 href="http://java.sun.com/j2se/1.3/docs/guide/intl/encoding.doc.html">Supported
 1851 Encodings</a> page in the Sun JRE documentation for a list of valid
 1852 identifiers.</li>
 1853 <li>Added an <tt>SmbFile.getType()</tt> which will return one of the
 1854 following type identifiers:
 1855 <pre>
 1857 SmbFile.TYPE_SERVER
 1858 SmbFile.TYPE_SHARE
 1860 SmbFile.TYPE_PRINTER
 1862 </pre>
 1863 <TT>isWorkgroup()</TT> is now deprecated.</li>
 1864 <li>Added a "lookup" table to <tt>jcifs.netbios.NbtAddress</tt> like the
 1865 one in <tt>java.net.InetAddress</tt> to prevent redundant queries from
 1866 reaching the wire.</li>
 1868 <li>Plain text passwords have been implemented but must be enabled with
 1869 <tt>jcifs.smb.client.disablePlainTextPasswords=false</tt>.  This is
 1870 <tt>true</tt> by default and will generate a "Plain text passwords are
 1871 disabled" <tt>RuntimeException</tt> exception if you try to use it.</li>
 1873 <li>The <tt>SmbFile.length()</tt> method now returns the capacity of the
 1874 disk for a share. So <tt>getType()</tt> must be
 1875 <tt>SmbFile.TYPE_SHARE</tt>.</li>
 1877 <li>Added an <tt>SmbFile.freeDiskSpace()</tt> method that reports the
 1878 amount of free disk space in bytes on a disk exported by a share.</li>
 1880 <li>Added an <tt>SmbFile.copyTo()</tt> method. This method can copy
 1881 directories across hosts <i>very quickly</i> however at the moment it
 1882 does not mirror file attributes. See the end of <a
 1883 href="http://lists.samba.org/pipermail/jcifs/2002-August/002357.html">this
 1884 message</a> for details.</li>
 1886 <li>Replaced the <tt>AuthHandler</tt> interface and <tt>AuthInfo</tt>
 1887 with the abstract <tt>NtlmAuthenticator</tt> and
 1888 <tt>NtlmPasswordAuthentication</tt> classes to be consistent with the
 1889 <tt>Authenticator</tt> and <tt>PasswordAuthentication</tt> classes from
 1890 the <tt>java.net</tt> package.  The underlying behavior remains the same
 1891 however it has not been tested thoroughly.</li>
 1892 </ul>
 1893 </desc>
 1894 </entry>
 1897 <entry old="true">
 1898 <title>jcifs-0.6.5 released</title>
 1899 <sub>posted by Chris, Sun Jun 2, 2002</sub>
 1900 <desc>
 1901 A file corruption bug, which occurred only when writing to Novell's CIFS
 1902 implementation for NetWare, was found and fixed.  (Novell has been
 1903 notified about this problem; good work Mike and Tony!)  Also fixed was a
 1904 file truncation bug introduced in 0.6.2 (with the return -1 fix).
 1905 </desc>
 1906 </entry>
 1908 <entry old="true">
 1909 <title>jcifs-0.6.3 released</title>
 1910 <sub>posted by Mike, Fri May 3, 2002</sub>
 1911 <desc>
 1912 The SMB URL issues with reserved characters and Unicode (e.g. Japanese)
 1913 have been resolved. It is no longer necessary to URL encode or decode
 1914 pathnames. Instead, these characters must be encoded for the authority
 1915 component (actually just '&#064;' with '&#037;40'). A problem with
 1916 passwords longer than 14 characters has also been fixed.
 1917 </desc>
 1918 </entry>
 1921 <entry old="true">
 1922 <title>SNIA CIFS Technical Reference 1.0 Released</title>
 1923 <sub>posted by Chris, Wed Apr 3, 2002</sub>
 1924 <desc>
 1925 According to <A HREF="http://lists.samba.org/pipermail/samba-technical/2002-April/035876.html">a
 1926 message on the Samba Technical mailing list</A>, the <A HREF="http://www.snia.org/">Storage Network Industry Association</A>
 1927 will soon release version 1.0 of their SMB/CIFS Technical Reference.
 1928 Version 0.9 has been available for quite some time.  The new release
 1929 contains several corrections and updates.
 1930 </desc>
 1931 </entry>
 1933 <entry old="true">
 1934 <title>jcifs-0.6.2 released</title>
 1935 <sub>posted by Mike, Thu Mar 21, 2002</sub>
 1936 <desc>
 1937 Two minor bugs have been fixed. Please see <a href="src/CHANGES.txt">CHANGES.txt</a> for details.
 1938 </desc>
 1939 </entry>
 1941 <entry old="true">
 1942 <title>New version of jCIFS-based SMB-Browse for MacOS X</title>
 1943 <sub>posted by Chris, Tue Mar 5, 2002</sub>
 1944 <desc>
 1945 Version 0.8:
 1946 <UL>
 1947 <LI>Mounting of shares with spaces in the share name now works,</LI>
 1948 <LI>German and French version are now included,</LI>
 1949 <LI>Domain and Workgroup logins are now working correctly.</LI>
 1950 </UL>
 1952 See: <A HREF="http://www.shukwit.com/main.php">http://www.shukwit.com/main.php</A>
 1953 </desc>
 1954 </entry>
 1956 <entry old="true">
 1957 <title>Serious Bug Fixed: jcifs-0.6.1 released</title>
 1958 <sub>posted by Mike, Thu Feb 21, 2002</sub>
 1959 <desc>
 1960 A bug has been found that affects all previous versions of jCIFS. Users
 1961 are advised to upgrade to 0.6.1 immediately. If a file is retrieved
 1962 using the <code>SmbFileInputStream</code> class, the file's size is
 1963 precisely a multiple of 4096 and the <code>byte[] b</code> and <code>int
 1964 len</code> parameters used in a <code>read()</code> operation are both
 1965 larger than 4096, the <code>read( byte[] b )</code> and <code>read(
 1966 byte[] b, int off, int len )</code> methods will return <code>-1</code>.
 1967 </desc>
 1968 </entry>
 1970 <entry old="true">
 1971 <title>jcifs-0.6.0 released</title>
 1972 <sub>posted by Mike, Wed Feb 20, 2002</sub>
 1973 <desc>
 1974 The jcifs-0.6.0 package is ready. The most significant improvement since 0.5 is performance.
 1975 <p/>
 1976 <b>Performance:</b>
 1977 <p/>
 1978 The performance improvements leading up to the 0.6 release have proven
 1979 to be significant. Raw transfer rates have not changed but listing
 1980 large directories, crawling over several hosts with multiple threads,
 1981 querying attributes on lists of files, and otherwise IO and multiplexing
 1982 intense operations have improved 800%+ in some cases. This release illustrates how a
 1983 carefully considered design can greatly improve the performance of an application. These
 1984 speed improvements are the result of reorganizing how buffers are used
 1985 (now only two per VM rather than per connection), elimination of
 1986 unnecessary network messages with smarter driver logic,
 1987 attribute caching, and analyzing spots where objects were being created
 1988 and destroyed frequently. This new client can crawl over every file
 1989 on my NT workstation in a hair over 10 seconds.
 1990 <p/>
 1991 Even though the focus for 0.6.0 was cleanup, refactoring, and
 1992 performance, there are a few new features worth mentioning. Here's
 1993 a breakdown.
 1994 <p/>
 1995 <b>New Features:</b>
 1997 <ul>
 1998 <li>The <code>listFiles</code> methods have been added which offer
 1999 a significant speed boost for operations that intensively query the
 2000 attributes of each file in the list.</li>
 2001 <li>Many of the <a href="src/docs/api/jcifs/smb/SmbFile.html"><code>SmbFile</code></a>
 2002 methods throw the now public
 2003 <a href="src/docs/api/jcifs/smb/SmbException.html"><code>SmbException</code></a>.</li>
 2004 <li>An <a href="src/docs/api/jcifs/util/AuthHandler.html"><code>AuthHandler</code></a>
 2005 interface and
 2006 <a href="src/docs/api/jcifs/smb/SmbAuthException.html"><code>SmbAuthException</code></a>
 2007 have been introduced for handling authentication related error
 2008 conditions.</li>
 2009 <li>The name service code has been generalized to handle
 2010 both DNS and NetBIOS name services much more smoothly
 2011 (0.5 handles this incorrectly actually) using the new
 2012 <a href="src/docs/api/jcifs/UniAddress.html"><code>UniAddress</code></a>.</li>
 2013 <li>The client can now list the hosts of a workgroup/ntdomain on remote
 2014 networks; you can enumerate an entire WAN.</li>
 2015 <li>The client is a lot smarter about how to ultimately service requests.</li>
 2016 <li>Graceful reconnect.</li>
 2017 <li>Support for Novell NetWare.</li>
 2018 </ul>
 2019 </desc>
 2020 </entry>
 2023 <entry old="true">
 2024 <title>Related Projects of Note</title>
 2025 <sub>posted by Chris, Tue Feb 12, 2002</sub>
 2026 <desc>
 2027 These are project related, in various ways, to the work we are doing
 2028 with jCIFS:
 2029 <UL>
 2030 <LI>The <A HREF="http://xamba.sourceforge.net/index.shtml">Xamba Network
 2031 Integration Project</A> focuses on integration between Macintoshes
 2032 and SMB/CIFS networks.</LI>
 2033 </UL>
 2034 <P/>
 2035 <UL>
 2036 <LI><A HREF="http://shukwit.com/main.php">SMB Browse</A> allows browsing
 2037 of the Network Neighborhood from a Mac OSX system.  The software is
 2038 written in Cocoa-Java, and uses jCIFS to provide access to the SMB
 2039 browse list.</LI>
 2040 </UL>
 2042 Version 0.6 of <A HREF="http://shukwit.com/main.php">SMB Browse</A>
 2043 has been released, with 0.7 planned soon.
 2044 </desc>
 2045 </entry>
 2047 <entry old="true">
 2048 <title>jcifs-0.6b9 released</title>
 2049 <sub>posted by Mike, Wed Feb 6, 2002</sub>
 2050 <desc>
 2051 There have been two bug fixes, some unnecessary code has been removed,
 2052 logic preventing certain invlid operations (e.g. <code>list()</code>
 2053 on <code>IPC$</code>) has been added, and the documentation has been
 2054 updated. The API documentation still needs a little more work, but
 2055 we think that should be it for this long string of betas. Thanks to
 2056 everyone who provided feedback.
 2057 </desc>
 2058 </entry>
 2060 <entry old="true">
 2061 <title>New Mirror</title>
 2062 <sub>posted by Chris, Sun Jan 20, 2002</sub>
 2063 <desc>
 2064 We have started <A HREF="src/">mirroring the source archive</A> here on
 2065 the root server.  This should reduce the problems we've had in the past
 2066 when one or the other server is down or unreachable.  The mirror is
 2067 updated once daily.
 2068 </desc>
 2069 </entry>
 2071 <entry old="true">
 2072 <title>jcifs-0.6b8 realeased</title>
 2073 <sub>posted by Mike, Sat Jan 12, 2002</sub>
 2074 <desc>
 2075 I forgot to convert the delete operation to use <TT>listFiles</TT>.
 2076 <P/>
 2077 Beta8 handles this properly on NT as well as Win98 and probably most
 2078 other servers including NetWare.  Deleting directories should also be
 2079 faster.  I also fixed an issue where testing <TT>exists()</TT> on a
 2080 newly created directory would incorrectly return false. I just needed to
 2081 manually expire the <TT>attrExpiration</TT> after the <TT>mkdir</TT>
 2082 call to cause the client to check the server again.
 2083 </desc>
 2084 </entry>
 2086 <entry old="true">
 2087 <title>Updated SMB URL Internet Draft</title>
 2088 <sub>posted by Chris, Sat Jan 12, 2002</sub>
 2089 <desc>
 2090 The <A HREF="http://search.ietf.org/internet-drafts/draft-crhertel-smb-url-02.txt">SMB
 2091 URL Internet Draft</A> has been updated.  The new draft includes support
 2092 for the <TT>:port</TT> field, and the use of query strings to specify
 2093 NBT context (WINS server, Called Name, etc.)  The document provides a
 2094 fixed set of keywords that may be used within the query section of the
 2095 URL string.  It would be nice to have a third-party authority placed in
 2096 charge of accepting updates to the keyword list.  Unfortunately, the
 2097 keywords <I>must</I> be interpreted by the client rather than the
 2098 server, so adding new keywords without some sort of public comment
 2099 process would cause some clients to break.
 2100 <P/>
 2101 The new draft does <I>not</I> include any support for SMB over native
 2102 TCP (port 445 semantics).  This is still an area for discussion.  While
 2103 it is clear that adding support for non-NBT file services would be easy,
 2104 no one yet (including myself) has provided a mechanism for efficiently
 2105 browsing services within a W2K Domain via the SMB URL.  This may turn
 2106 out to be trivial, but it won't go into the specification until it is
 2107 shown that it <I>can</I> be done.
 2108 </desc>
 2109 </entry>
 2111 <entry old="true">
 2112 <title>jcifs-0.6b7 released</title>
 2113 <sub>posted by Mike, Fri Jan 11, 2002</sub>
 2114 <desc>
 2115 The introduction of <code>listFiles</code> in a previous beta created
 2116 an issue with caching file attributes and enumerating workgroups
 2117 and hosts of a workgroup. There was a compilation problem with
 2118 <code>URLDecoder</code> and a possible <code>NullPointerException</code>
 2119 in the graceful reconnect code. Generally the last beta was a flop. We
 2120 strongly advise that you erase it and use this release. We have high
 2121 hopes for it. The good news is <code>listFiles</code> has turned out
 2122 to be quite a screamer on regular directories. I can list every file
 2123 on my NT machine with <code>T2Crawler</code> in 10.095 seconds (yes,
 2124 over the network).
 2125 </desc>
 2126 </entry>
 2129 <entry old="true">
 2130 <title>jcifs-0.6b6 released</title>
 2131 <sub>posted by Mike, Mon Jan 7, 2002</sub>
 2132 <desc>
 2133 There have been quite a few bug fixes. The <code>listFiles()</code>
 2134 methods no longer throw <code>MalformedURLException</code> or
 2135 <code>UnknownHostException</code>. The client can now recover from
 2136 a server being restarted or unavailable between calls (and might
 2137 solve your invalid UID problem TN). A URL decoding issue, some
 2138 unnecessary <code>AuthException</code>s, and Win98's preference for
 2139 capitalized share names have also been fixed. Lot's of detail in the
 2140 <a href="http://auditorymodels.org:81/jcifs/src/README.txt">README.txt</a>
 2141 if you're interested.
 2142 </desc>
 2143 </entry>
 2146 <entry old="true">
 2147 <title>jcifs-0.6b5 released</title>
 2148 <sub>posted by Mike, Wed Dec 19, 2001</sub>
 2149 <desc>
 2150 Dispite being in the middle of a beta cycle we have implemented a new
 2151 freqently requested feature. The <code>SmbFile</code> class now has two
 2152 <code>listFiles</code> methods. The normal <code>java.io.File</code>
 2153 like <code>listFiles</code> method will return an array of
 2154 <code>SmbFile</code>s. The other will take a DOS "wildcard" expression
 2155 with '?' and '*' meta characters. The <code>SmbShell</code> example
 2156 now sports pretty formatted output to complement this feature:
 2157 <blockquote><pre>
 2158 winnt> ls c?o*
 2159 clock.avi                  -rw--      82944 Mon Oct 14 1996 1:38 AM
 2160 Cookies                    drw--          0 Fri Nov 13 1998 9:42 PM
 2161 2 items in 5ms
 2162 </pre></blockquote>
 2163 I have written a document on <a
 2164 href="http://auditorymodels.org/jcifs/src/docs/authhandler.html">Exceptions
 2165 and the AuthHandler Interface </a>. The auditorymodels.org site appears
 2166 to have stablized. It has a new static IP so we should be able to use
 2167 that as our download area once again.
 2168 </desc>
 2169 </entry>
 2171 <entry old="true">
 2172 <title>jcifs-0.6b4 released</title>
 2173 <sub>posted by Mike, Sat Dec 15, 2001</sub>
 2174 <desc>
 2175 This beta 4 fixes a serious bug that caused <code>exists()</code> and
 2176 the several methods that called it to return erroneous results. There
 2177 have also been quite a few other smaller bug fixes. This release should
 2178 be fairly stable. The example and test programs have been updated
 2179 and retested without incedent.
 2180 <P/>
 2181 It has recently been decided that the next beta will introduce
 2182 the <code>listFiles</code> methods. This will prolong the beta
 2183 cycle however the issue has been raised enough that it is now
 2184 considered a bug. A wildcard <code>FilenameFilter</code> and possibly
 2185 <code>FileFilter</code> will also be implemented.
 2186 </desc>
 2187 </entry>
 2190 <entry old="true">
 2191 <title>jcifs-0.6b3 and auditorymodels.org</title>
 2192 <sub>posted by Mike, Wed Nov 28, 2001</sub>
 2193 <desc>
 2194 The beta 2 release has a deadlock in it so you might want to
 2195 try jcifs-0.6b3. This code should prove to be even faster
 2196 than the first beta.  I have changed from using two buffers for
 2197 each transport to two buffers for all transports with a main
 2198 <code>synchronized(buf)</code> around it. This serializes reads
 2199 and writes for all sockets but, surprisingly, it appears to be
 2200 even faster. I've been tweaking the crawler example to use as a
 2201 benchmark. There's a new example <code>T2Crawler</code> that can
 2202 enumerate every share on a segment in a matter of seconds.
 2203 <P/>
 2204 You may have noticed that the auditorymodels.org site is not available.
 2205 AT&amp;T switched IP's on that cable modem. Looks like it might take
 2206 a while. I've mirrored everything over to my ISP's account for
 2207 now. Please let me know if you find any bad links.
 2208 </desc>
 2209 </entry>
 2211 <entry old="true">
 2212 <title>jcifs-0.6b2 released</title>
 2213 <sub>posted by Mike, Wed Nov 21, 2001</sub>
 2214 <desc>
 2215 Previously, jCIFS could not enumerate hosts of a
 2216 workgroup/domain if that workgroup/domain was on a different
 2217 network segment. This problem has fixed. This beta of the
 2218 jCIFS client can enumerate the complete hierarchy of an entire WAN <a
 2219 href="http://www.microsoft.com/windows2000/en/server/help/sag_WINS_und_BrowsingWithWins.htm">provided
 2220 your network supports it</a>. Two trivial bugs have also been fixed.
 2221 </desc>
 2222 </entry>
 2225 <entry old="true">
 2226 <title>jcifs-0.6b released</title>
 2227 <sub>posted by Mike, Fri Nov 16, 2001</sub>
 2228 <desc>
 2229 There have been significant changes under the hood and to
 2230 the API. The name service bug has been fixed, most of the
 2231 top level code has been re-written to be <i>much</i> smarter, and most
 2232 of <code>SmbFile</code>'s methods throw the now public <a
 2233 href="http://auditorymodels.org/jcifs/src/docs/api/jcifs/smb/SmbException.html"><code>SmbException</code></a>.
 2234 This refactoring has resulted in marked performace
 2235 improvements (100%+ in some cases). See the <a
 2236 href="http://auditorymodels.org/jcifs/src/README.txt">README.txt</a>
 2237 for important details about how to modify your code. Keep in mind the
 2238 sooner you find the bugs the sooner they get fixed so we can move on.
 2239 </desc>
 2240 </entry>
 2243 <entry old="true">
 2244 <title>Bug in Mixed Mode DNS/NetBIOS Name Resolution Code</title>
 2245 <sub>posted by Mike, Thu Oct 18, 2001</sub>
 2246 <desc>
 2247 If a DNS name longer than 15 characters is used with a
 2248 <code>resolveOrder</code> that has <code>DNS</code> <i>after</i>
 2249 <code>WINS</code> or <code>BCAST</code> (the default of
 2250 <code>resolveOrder=LMHOSTS,WINS,BCAST,DNS</code> qualifies) the
 2251 name will incorrectly get truncated to 15 characters. In short,
 2252 the name query will fail and jCIFS will not be able to connect to
 2253 the host. The only solution at the moment is to use <code>DNS</code>
 2254 before <code>WINS</code> and <code>BCAST</code> or do not use both
 2255 types of resolution simultaniously.
 2256 <P/>
 2257 This has prompted a bit of refactoring, reducing, rewriting, general
 2258 cleanup, comments ... etc (everywhere, not just in the above mentioned
 2259 resolver code). The result will be 0.6. This means no new features
 2260 but it will mean a more robust, leaner, and faster jCIFS. This release
 2261 will also break bytecode compatabilty.
 2262 <P/>
 2263 If you think of anything you consider to be &#34;broken&#34; in
 2264 jCIFS, even if it is not technically a bug, now is the time to
 2265 <a href="mailto:jcifs@samba.org">send a message</a> to the <a
 2266 href="https://lists.samba.org/mailman/listinfo/jcifs">jCIFS mailing list</a>
 2267 with an explaination of the issue.
 2268 </desc>
 2269 </entry>
 2272 <entry old="true">
 2273 <title>jcifs-0.5.1 released</title>
 2274 <sub>posted by Mike, Mon Aug 27, 2001</sub>
 2275 <desc>
 2276 Chris found three minor bugs while testing in the CIFS Conference
 2277 Interoperabilty Lab. A detailed description of these issues and their
 2278 resolutions is posted <a href="http://lists.samba.org/pipermail/jcifs/2001-August/001428.html">here</a>.
 2279 These packages will also now work with both Java 1.1 as well as Java2.
 2280 </desc>
 2281 </entry>
 2283 <entry old="true">
 2284 <title>Success at the CIFS Conference</title>
 2285 <sub>posted by Chris, Sun Aug 25, 2001</sub>
 2286 <desc>
 2287 <A HREF="http://www.cifs2001.org/"><IMG SRC="images/CIFS_Banner.gif" BORDER="0" ALT="" ALIGN="RIGHT"/></A>
 2288 I <A HREF="presentations/cifs2001/index.html">presented jCIFS</A> at
 2289 the <A HREF="http://www.cifs2001.org/">2001 CIFS Conference and
 2290 PlugFest</A>, which was held August 20 - 24 in <A
 2291 HREF="http://maps.yahoo.com/py/pmap.py?Pyt=Tmap&amp;addr=&amp;csz=Bellevue,+WA&amp;city=Bellevue&amp;state=WA&amp;slt=47.610600&amp;sln=-122.199501&amp;mlt=47.634700&amp;mln=-122.169000&amp;zip=&amp;country=us&amp;BFCat=&amp;BFClient=&amp;mag=7&amp;cs=7&amp;name=&amp;desc=">Bellevue,
 2292 Washington</A> (a suburb of Redmond).
 2293 <P/>
 2294 I met up with the Australian contingent of the Samba Team on Sunday,
 2295 the day before the PlugFest started.  We all went out to the hotel pool
 2296 on what proved to be the only warm and sunny day of the week.  The plan
 2297 was to relax and spend some time swimming, but Tridge got the idea of
 2298 setting up a Wireless Access Point so we could all sit by the pool with
 2299 our laptops.  I think we spent five hours trying to get the modem in the
 2300 Apple Airport to dial out and authenticate properly.  We never did get
 2301 it working (and I never got into that pool).  Eventually, we used
 2302 Tridge's Linux Laptop to dial in, hard-wired that to the Airport, and
 2303 used the Airport's DHCP service to hand out unrouted IPs.  It was a bit
 2304 of a hack but it worked.
 2305 <P/>
 2306 The PlugFest started Monday.  Many CIFS vendors were present,
 2307 including some new faces, and I was able to test jCIFS against a large
 2308 variety of servers.  Some jCIFS bugs were discovered (and squashed) and
 2309 I was also able to demonstrate the utility of jCIFS as a test client.
 2310 The ease with which new torture tests can be written makes jCIFS an
 2311 excellent tool for server verification.
 2312 <P/>
 2313 A number of issues were discussed at the Conference, including the
 2314 current status of the <A HREF="http://www.snia.org/English/Work_Groups/NAS/CIFS/WG_CIFS_Docs.html">SNIA
 2315 CIFS document</A> which has been downgraded from a Specification to a
 2316 Technical Reference.  The <A HREF="http://www.snia.org">SNIA</A> is also
 2317 looking for CIFS compatibility testing tools to help CIFS implementors
 2318 verify their products, so (as time permits...and it typically doesn't) I
 2319 will be looking at writing and documenting some more formal jCIFS test
 2320 suites.
 2321 </desc>
 2322 </entry>
 2324 <entry old="true">
 2325 <title>Java 2 No Longer Required</title>
 2326 <sub>posted by Mike, Thu Aug 9, 2001</sub>
 2327 <desc>
 2328 Actually, it never was. I just never bothered to try. I had to comment
 2329 out one (1) line.  Oops.
 2330 <P/>
 2331 It has been built with the <A HREF="http://www.blackdown.org/">Blackdown</A> jdk_1.1.6-v2, however any
 2332 1.1 version should work fine.  For your convenience, I have uploaded a
 2333 <A HREF="http://auditorymodels.org/jcifs/src/jcifs-0.5jdk116.jar">jar</A>.
 2334 </desc>
 2335 </entry>
 2337 <entry old="true">
 2338 <title>jcifs-0.5b2 released</title>
 2339 <sub>posted by Mike, Fri Jul 13, 2001</sub>
 2340 <desc>
 2341 Some flags specified when opening files were not optimal. Trying
 2342 to open the same file twice would fail even though the file
 2343 was opened only for reading. This has been fixed. Also, a
 2344 new <code>Log.CRITICAL_EXCEPTIONS</code> mask has been added
 2345 to turn off common non-critical exceptions from
 2346 being printed to the console. See the second to last line of <code><a
 2347 href="http://auditorymodels.org/jcifs/src/examples/ThreadedSmbCrawler.java">examples/ThreadedSmbCrawler.java</a></code>
 2348 for an example of how to set this mask.
 2349 </desc>
 2350 </entry>
 2353 <entry old="true">
 2354 <title>jCIFS 0.5 is Now Final</title>
 2355 <sub>posted by Mike, Sun Jul 29, 2001</sub>
 2356 <desc>
 2357 The 0.5 series is complete. This is the most stable and
 2358 full featured CIFS client library that that we have to
 2359 offer. There are no known bugs and it has been tested very
 2360 thoroughly. A minor bug in <code>SmbFile.renameTo()</code>
 2361 has been fixed (did not return false when it should have)
 2362 and <a href="http://auditorymodels.org/jcifs/src/docs/api/">API
 2363 Documentation</a> improvements have been added. Thanks deserved to
 2364 everyone who helped.
 2365 </desc>
 2366 </entry>
 2368 <entry old="true">
 2369 <title>jcifs-0.5b2 released</title>
 2370 <sub>posted by Mike, Fri Jul 13, 2001</sub>
 2371 <desc>
 2372 Some flags specified when opening files were not optimal. Trying
 2373 to open the same file twice would fail even though the file
 2374 was opened only for reading. This has been fixed. Also, a
 2375 new <code>Log.CRITICAL_EXCEPTIONS</code> mask has been added
 2376 to turn off common non-critical exceptions from
 2377 being printed to the console. See the second to last line of <code><a
 2378 href="http://auditorymodels.org/jcifs/src/examples/ThreadedSmbCrawler.java">examples/ThreadedSmbCrawler.java</a></code>
 2379 for an example of how to set this mask.
 2380 </desc>
 2381 </entry>
 2383 <entry old="true">
 2384 <title>jcifs-0.5b released</title>
 2385 <sub>posted by Mike, Fri Jun 29, 2001</sub>
 2386 <desc>
 2387 The 0.5 series is now beta. New features include the proper fix for the <code>SmbFile.list()</code> bug, share, server, and workgroup enumeration, <a href="http://auditorymodels.org/jcifs/src/docs/pipes.html">Named Pipes</a>, a complete implementation of the <a href="http://www.ietf.org/internet-drafts/draft-crhertel-smb-url-00.txt">SMB Filesharing URL Scheme</a> IETF draft, and more. See the <a href="http://auditorymodels.org/jcifs/src/README.txt">README</a> for details. This release is already been through a stable iteration and there are no known bugs.
 2388 </desc>
 2389 </entry>
 2391 <entry old="true">
 2392 <title>CIFS Conference!</title>
 2393 <sub>posted by Chris, Fri Jun 22, 2001</sub>
 2394 <desc>
 2395 <A HREF="http://www.cifs2001.org/"><IMG SRC="images/CIFS_Banner.gif" BORDER="0" ALT="" ALIGN="RIGHT"/></A>
 2396 The 2001 <A HREF="http://www.cifs2001.org/">CIFS Conference and Plugfest</A>
 2397 will be held August 20 - 24 in <A
 2398 HREF="http://maps.yahoo.com/py/pmap.py?Pyt=Tmap&amp;addr=&amp;csz=Bellevue,+WA&amp;city=Bellevue&amp;state=WA&amp;slt=47.610600&amp;sln=-122.199501&amp;mlt=47.634700&amp;mln=-122.169000&amp;zip=&amp;country=us&amp;BFCat=&amp;BFClient=&amp;mag=7&amp;cs=7&amp;name=&amp;desc=">Bellevue,
 2399 Washington</A> (a suburb of Redmond).  There will be a <A
 2400 HREF="http://www.cifs2001.org/English/Conference/Companies.html">bigbunch</A>
 2401 of CIFS developer's present.  This is <I>the</I> main event for the CIFS
 2402 community.
 2403 </desc>
 2404 </entry>
 2407 <entry old="true">
 2408 <title>jcifs-0.5dev3 released</title>
 2409 <sub>posted by Mike, Thu Jun 21, 2001</sub>
 2410 <desc>
 2411 No new features. Just many sorely needed bug fixes. The jcifs-0.5dev2
 2412 release has some pretty serious problems. This release should be
 2413 <i>much better</i>. It passes all my torture tests anyway. There
 2414 is some documentation on using jCIFS with Win32 Named Pipes <a
 2415 href="http://auditorymodels.org/jcifs/src/docs/pipes.html">here</a>. I
 2416 have also writtin a crude <a
 2417 href="http://auditorymodels.org/jcifs/src/examples/ThreadedSmbCrawler.java">SmbCrawler</a>
 2418 program that might help admins map out their network. Use
 2420 <blockquote><pre>
 2421 java -Djcifs.properties=my.prp ThreadedSmbCrawler smb://myworkgroup 2 10
 2422 </pre></blockquote>
 2424 to enumerate over all servers and their shares (depth 2) with 10 threads.
 2425 </desc>
 2426 </entry>
 2428 <entry old="true">
 2429 <title>jcifs-0.5dev2 released</title>
 2430 <sub>posted by Mike, Mon May 21, 2001</sub>
 2431 <desc>
 2432 Lots of new stuff including <a
 2433 href="http://auditorymodels.org/jcifs/src/docs/resolver.html">enhanced
 2434 server name resolution</a> with DNS, lmhosts files, specifying a
 2435 "resolve order", Named Pipes (Paul) and Transact Named Pipes,
 2436 a daylight savings time bugfix and time encoding bugfix (Urban),
 2437 documentation improvements, Unicode alignment proper (fixes the
 2438 <code>smb://</code>, <code>smb://name</code> enumeration problem with
 2439 Samba), <code>SmbFile</code> method behavior finalization, quick exit
 2440 of programs (used to hang for 15sec), and more. Of course this is all
 2441 totally untested so try it out and let us know how it goes.
 2442 </desc>
 2443 </entry>
 2446 <entry old="true">
 2447 <title>Bug in jcifs-0.4 SmbFile.list() Method</title>
 2448 <sub>posted by Mike, Fri May 11, 2001</sub>
 2449 <desc>
 2450 There is a serious bug in NT and NT Server that can
 2451 cause the <code>SmbFile.list()</code> method to get
 2452 caught in an endless loop consuming major cpu cycles
 2453 and bandwidth. The problem is described in more detail <a
 2454 href="http://lists.samba.org/pipermail/jcifs/2001-March/001095.html">here</a>.
 2455 <P/>
 2456 There is no fix except to not call <code>SmbFile.list()</code>. Do not
 2457 use jcifs-0.4 in a production environment if your application uses this
 2458 method. The bug has been properly fixed in jcifs-0.5dev1, however this
 2459 version is highly experimental and has known bugs of it's own.  We are
 2460 sorry for any inconvenience this may have caused.
 2461 </desc>
 2462 </entry>
 2465 <entry old="true">
 2466 <title>jcifs-0.5dev1 released</title>
 2467 <sub>posted by Mike, Sun Apr 8, 2001</sub>
 2468 <desc>
 2469 We now embark on the first experimental series of
 2470 what will become jcifs-0.5. New features include the
 2471 Transactions API, batching, and workgroup, server,
 2472 share enumeration. Tunable batching, which is described <a
 2473 href="http://auditorymodels.org/jcifs/src/docs/batching.html">here</a>,
 2474 should only be of interest to CIFS developers. What should
 2475 intrest most people is that jCIFS now has the ability to enumerate
 2476 workgroups of a network, servers of a workgroup, and shares of a
 2477 server with <code>smb://</code>, <code>smb://workgroup</code>,
 2478 and <code>smb://server</code> URLs respectively. For example
 2479 the url <code>smb://storage15</code> will list the shares
 2480 available on the server <code>storage15</code>. This makes <a
 2481 href="http://auditorymodels.org/jcifs/src/examples/SmbShell.java">SmbShell</a>
 2482 start to look pretty slick because you can <code>cd</code> all around
 2483 your network.
 2484 </desc>
 2485 </entry>
 2488 <entry old="true">
 2489 <title>New CIFS Draft Specification Posted</title>
 2490 <sub>posted by Chris, Wed, Apr 4, 2001</sub>
 2491 <desc>
 2492 The Storage Network Industry Association (<A
 2493 HREF="http://www.snia.org">SNIA</A>) has posted a <A
 2494 HREF="http://www.snia.org/English/Work_Groups/NAS/CIFS/WG_CIFS_Docs_FS.html">draft
 2495 specification for the SMB/CIFS protocol</A>.  This draft is based on
 2496 earlier work by Paul Leach and Dilip Naik of Microsoft, but has been
 2497 updated.  The draft is currently in 30-day review.
 2498 </desc>
 2499 </entry>
 2502 <entry old="true">
 2503 <title>jCIFS Demonstrated at Connectathon 2001</title>
 2504 <sub>posted by Chris, Sat Mar 31, 2001</sub>
 2505 <desc>
 2506 <A HREF="http://www.connectathon.org/"><IMG SRC="images/cthonlogo.gif" BORDER="0" ALT="" ALIGN="RIGHT"/></A>
 2507 jCIFS 0.4-final was demonstrated and tested at <A
 2508 HREF="http://www.connectathon.org/">Connectathon 2001</A> with
 2509 overall good results.  Some problems were discovered, of course, and
 2510 solutions are planned for 0.5.
 2511 <P/>
 2512 The jCIFS Team is interested in continued testing against commercial
 2513 SMB/CIFS implementations, particularly derivatives of Advanced Server
 2514 for Unix.  Please let us know if you can generate sniffer output for
 2515 us to look at.  (TCPdump and/or Microsoft NetMon formats for input into
 2516 <A HREF="http://www.ethereal.com/">Ethereal</A> are preferred.)
 2517 </desc>
 2518 </entry>
 2520 <entry old="true">
 2521 <title>jCIFS 0.4 is Now Final</title>
 2522 <sub>posted by Mike, Fri Feb 16, 2001</sub>
 2523 <desc>
 2524 The jCIFS 0.4 series is now final. All of the idiosyncrasies of the
 2525 various platforms have been worked out and overall performace is
 2526 good. There are no known bugs but a couple of minor ones have
 2527 been fixed.
 2528 </desc>
 2529 </entry>
 2532 <entry old="true">
 2533 <title>jcifs-0.4b3 released</title>
 2534 <sub>posted by Mike, Sat Feb 10, 2001</sub>
 2535 <desc>
 2536 Heavily threaded torture test programs have revealed elusive
 2537 reentrance problems and prompted total retooling of lower io
 2538 layers. The name service code was particularly troubled. Special
 2539 thanks to Paul for his help with this. There are also several
 2540 other minor bug fixes and general spit and polish. See the <a
 2541 href="http://auditorymodels.org/jcifs/src/README.txt">README</a>
 2542 for details.
 2543 </desc>
 2544 </entry>
 2547 <entry old="true">
 2548 <title>More Bugs Fixed: jcifs-0.4b2 released</title>
 2549 <sub>posted by Mike, Sat Jan 20, 2001</sub>
 2550 <desc>
 2551 More bug's have been revieled and squashed. Thanks to all who have helped
 2552 with beta testing this. It should be pretty stable at this point. See
 2553 the README for details but you should upgrade regardless.
 2554 </desc>
 2555 </entry>
 2557 <entry old="true">
 2558 <title>Bug Fixed: jcifs-0.4b1 released</title>
 2559 <sub>posted by Mike, Wed Jan 4, 2001</sub>
 2560 <desc>
 2561 A serious bug was discovered and fixed. The new packages are
 2562 in the download directory. If two different host names where
 2563 queried quickly back to back the returned names could get mixed
 2564 up because the transaction id used to coordinate concurrent name
 2565 service queries was not being incremented. Thank's to the <a
 2566 href="http://jakarta.apache.org/ant/index.html">Ant build tool</a>
 2567 new packages where built and up in no time flat.
 2568 </desc>
 2569 </entry>
 2571 <entry old="true">
 2572 <title>jcifs-0.4b released</title>
 2573 <sub>posted by Mike, Wed Jan 3, 2001</sub>
 2574 <desc>
 2575 The jcifs client is now stable and ready for use. This is not
 2576 "infrastructure" anymore. It _should_ work flawlessly. I got
 2577 rid of quiet a bit of fat such as that "Demultiplexer" thing I
 2578 preached for two months :~) I took Chris' advice and created our
 2579 own normalized abstraction based on the java.io.File class for
 2580 the API. There's no XFile accessor but the URL protocol handler
 2581 is in place. This is NOT alpha code and it will only be beta
 2582 until I get some confirmation that it works for everybody. If you
 2583 have any problems get on the mailing list. Eveything's in the <a
 2584 href="http://auditorymodels.org/jcifs/src/">src directory</a>. Happy
 2585 New Year!
 2586 </desc>
 2587 </entry>
 2589 <entry old="true">
 2590 <title>Licensing Model</title>
 2591 <sub>posted by Chris, Mon Jul 24, 2000</sub>
 2592 <desc>
 2593 After much debate, we have decided to use the GNU <A
 2594 HREF="http://www.gnu.org/copyleft/lesser.html">LGPL</A> to license the
 2595 jCIFS class library.  There are <A
 2596 HREF="http://www.gjt.org/info/policy/license/policy.shtml">issues</A> to
 2597 consider when using the regular <A
 2598 HREF="http://www.gnu.org/copyleft/gpl.html">GPL</A> to license Java code.
 2599 See also <A HREF="http://www.gnu.org/software/java/">GNU's Java pages</A>.
 2600 </desc>
 2601 </entry>
 2603 <entry old="true">
 2604 <title>jcifs-0.3a released</title>
 2605 <sub>posted by Mike, Thu Jul 20, 2000</sub>
 2606 <desc>
 2607 Lotta plumbing, finalized the server message block infrastructure,
 2608 implemented some of XFileAccessor as well as URLStreamHandler,
 2609 batching works great, replaced NbtSession with NbtSocket class that
 2610 extends java.net.Socket(this is the way it should have been done), and
 2611 more. Feel free to <a href='http://auditorymodels.org/jcifs/src/'>browse
 2612 the source</a> as usual. Still alpha code.
 2613 </desc>
 2614 </entry>
 2616 <entry old="true">
 2617 <title>jcifs-0.2a released</title>
 2618 <sub>posted by Mike, Sun Jun 18, 2000</sub>
 2619 <desc>
 2620 Quite a range of new things but still just preliminary code(ie
 2621 can't transfer a file). Mainly the new packet construction/deconstruction
 2622 code has been implemented throughout(a joy to work with now). There's also
 2623 some smb foundation code, server componentry and much more.
 2624 </desc>
 2625 </entry>
 2627 <entry old="true">
 2628 <title>jcifs-0.1 released</title>
 2629 <sub>posted by Mike, Wed Mar 15, 2000</sub>
 2630 <desc>
 2631 The NetBIOS client implementation is complete.
 2632 </desc>
 2633 </entry>
 2635 </news>
 2636 <links>
 2638 <a href="src/">Download</a>
 2639 <a href="src/docs/ntlmhttpauth.html">JCIFS NTLM HTTP Authentication</a>
 2640 <a href="src/docs/faq.html">The FAQ</a>
 2641 <a href="src/docs/capture.html">Obtaining a Network Packet Capture</a>
 2643 <group>
 2644 <title>Developer Information</title>
 2646 <a href="src/docs/api/">JCIFS API Documentation</a>
 2647 <a href="src/docs/api/overview-summary.html#scp">Setting Client Properties</a>
 2648 <a href="src/docs/resolver.html">Setting Name Resolution Properties</a>
 2649 <a href="src/docs/pipes.html">Using JCIFS to Connect to Win32 Named Pipes</a>
 2650 <a href="src/docs/authhandler.html">JCIFS Exceptions and NtlmAuthenticator</a>
 2651 <a href="src/docs/httpclient.html">Using JCIFS NTLM Authentication for HTTP Connections</a>
 2652 <a href="http://www.gnu.org/licenses/lgpl-2.1.txt">JCIFS is Licensed Under the LGPL</a>
 2653 </group>
 2655 <group>
 2656 <title>Related Java Projects</title>
 2657 <!--
 2658 <desc>Listings here are not necessarily an endorsement by The JCIFS Project</desc>
 2659 <a href="http://www.ioplex.com/jespa.html">Jespa library - NTLMv2 Servlet Filter and more</a>
 2660 -->
 2662 <a href="https://github.com/hierynomus/smbj">smbj - Server Message Block (SMB2, SMB3) implementation in Java</a>
 2663 <a href="http://sourceforge.net/projects/j-interop/">j-interop - Java COM Interop (uses Jarapac)</a>
 2664 <a href="http://sharehound.sourceforge.net/">sharehound - CIFS network search engine</a>
 2665 <a href="http://sourceforge.net/projects/webdisk/">IntegraTUM WebDisk - HTTP to CIFS gateway</a>
 2666 <a href="http://sourceforge.net/projects/jarapac/">Jarapac - DCE/RPC in Java</a>
 2667 <a href="http://danadler.com/jacob/">The Jacob Project - Java/COM Bridge</a>
 2668 <a href="http://www.jnbridge.com/">JNBridge - Java/.NET Bridge</a>
 2669 <a href="http://j-integra.intrinsyc.com/j-integra/info/">J-Integra - DCE/RPC in Java</a>
 2670 <a href="http://sourceforge.net/projects/davenport/">Davenport - WebDAV to CIFS gateway</a>
 2671 <a href="http://sourceforge.net/project/showfiles.php?group_id=143373&amp;package_id=248550">Alfresco JLAN Shared File Drive Interface</a>
 2672 </group>
 2674 <group>
 2675 <title>CIFS Authorities</title>
 2677 <a href="http://www.samba.org/">http://www.samba.org/</a>
 2678 </group>
 2680 <group>
 2681 <title>Other CIFS Utilities and Tools</title>
 2683 <a href="http://www.amigasamba.org/">Samba for Amiga</a>
 2684 <a href="http://www.obdev.at/products/sharity-light/">Sharity-Lite</a>
 2685 <a href="http://shukwit.com/main.php">SMB Browse for MacOSX</a>
 2686 <a href="http://xamba.sourceforge.net/index.shtml">Xamba Network Integration Project</a>
 2687 </group>
 2689 <group>
 2690 <title>MSRPC</title>
 2691 <a href="http://www.bindview.com/Support/RAZOR/Utilities/Windows/rpctools1.0-readme.cfm">Rpcdump utility for querying RPC servers</a>
 2692 <a href="http://www.opengroup.org/onlinepubs/9629399/">OpenGroup DCE/RPC Specification</a>
 2693 <a href="http://www.opengroup.org/onlinepubs/9629399/chap14.htm">OpenGroup DCE/RPC Specification - NDR</a>
 2694 <a href="http://msdn.microsoft.com/library/default.asp?url=/archive/en-us/dnarolegen/html/msdn_aboutole.asp">What OLE Is Really About</a>
 2695 </group>
 2697 <group>
 2698 <title>Kerberos</title>
 2699 <a href="http://www.ietf.org/rfc/rfc1510.txt">RFC1510 - Kerberos V5 Specification</a>
 2700 <a href="http://www.serverwatch.com/tutorials/article.php/2176201">How a Kerberos Logon Works in Win2K</a>
 2701 <a href="http://www-106.ibm.com/developerworks/java/library/j-gss-sso/">JGSS Example</a>
 2702 <a href="http://www.microsoft.com/technet/prodtechnol/windows2000serv/maintain/security/kerberos.mspx">Kerberos Explained</a>
 2703 <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnkerb/html/msdn_pac.asp">W2K PAC Specification</a>
 2704 </group>
 2706 <group>
 2707 <title>Technical Documentation</title>
 2709 <a href="http://ubiqx.org/cifs/">&#34;Implementing CIFS&#34; (complete online book)</a>
 2710 <a href="http://ubiqx.org/cifs/rfc-draft/draft-leach-cifs-v1-spec-02.html"><i>Annotated</i> CIFS Specification: draft-leach-cifs-v1-spec-02.html</a>
 2711 <a href="http://www.snia.org/tech_activities/CIFS/">SNIA CIFS Technical Reference (V1.0)</a>
 2712 <a href="http://davenport.sourceforge.net/ntlm.html">The NTLM Authentication Protocol</a>
 2713 <a href="http://www.pluralsight.com/keith/book/">A .NET Developer's Guide to Windows Security</a>
 2714 <a href="http://msdn.microsoft.com/library/en-us/debug/base/system_error_codes__0-499_.asp">Windows System Error Codes</a>
 2715 <a href="http://msdn.microsoft.com/library/en-us/netmgmt/netmgmt/network_management_error_codes.asp">Windows Network Management Error Codes</a>
 2716 <a href="http://ubiqx.org/cifs/rfc-draft/rfc1001.html">rfc1001 - NetBIOS Concepts and Methods</a>
 2717 <a href="http://ubiqx.org/cifs/rfc-draft/rfc1002.html">rfc1002 - NetBIOS Detailed Specifications</a>
 2718 <a href="http://www.codefx.com/whitepapers.htm">CIFS Explained <small>(A whitepaper by John Kleven)</small></a>
 2719 <a href="http://www.ietf.org/internet-drafts/draft-crhertel-smb-url-07.txt">SMB URL draft specification V07</a>
 2720 <a href="http://ourworld.compuserve.com/homepages/timothydevans/nbf.htm">NetBIOS, NetBEUI, NBF, SMB, CIFS networking links page</a>
 2721 <a href="http://msdn.microsoft.com/library/backgrnd/html/msdn_winswp.htm">Microsoft Writeup on WINS behavior</a>
 2722 <a href="http://msdn.microsoft.com/library/backgrnd/html/msdn_winsoverview.htm">Microsoft Writeup on WINS under W2K</a>
 2723 <a href="http://www.microsoft.com/windows2000/en/server/help/sag_WINS_und_BrowsingWithWins.htm">Microsoft Server Documentation on Browsing WANs using WINS</a>
 2724 <a href="http://www.windowsitlibrary.com/Documents/Book.cfm?DocumentID=386">Windows IT Library: NT Network Plumbing</a>
 2725 <a href="http://www.thursby.com/CIFS/">Thursby Software's CIFS pages</a>
 2726 <a href="http://www.linux-mag.com/cgi-bin/printer.pl?issue=2001-05&amp;article=smb">Linux Mag: Understanding the Network Neighborhood</a>
 2727 </group>
 2729 <group>
 2730 <title>Other</title>
 2732 <a href="https://lists.samba.org/mailman/listinfo/jcifs">Join the JCIFS Mailing List</a>
 2733 <a href="src/src/jcifs/">Browse the Source</a>
 2734 <a href="src/docs/batching.html">Batching</a>
 2735 <a href="http://www.gnu.org/">http://www.gnu.org/</a>
 2736 <a href="http://www.opensource.org/">http://www.opensource.org/</a>
 2737 </group>
 2739 </links>
 2740 </proj>