![]() The Java CIFS Client Library |
|
LinksJCIFS NTLM HTTP AuthenticationThe FAQ Mailing List Archive (GMANE) Obtaining a Network Packet Capture Developer InformationJCIFS API DocumentationSetting Client Properties Setting Name Resolution Properties Using JCIFS to Connect to Win32 Named Pipes JCIFS Exceptions and NtlmAuthenticator Using JCIFS NTLM Authentication for HTTP Connections JCIFS is Licensed Under the LGPL Related Java Projectsj-interop - Java COM Interop (uses Jarapac)sharehound - CIFS network search engine IntegraTUM WebDisk - HTTP to CIFS gateway jcifs-ext - JCIFS Extensions Jarapac - DCE/RPC in Java The Jacob Project - Java/COM Bridge JNBridge - Java/.NET Bridge J-Integra - DCE/RPC in Java Davenport - WebDAV to CIFS gateway Alfresco JLAN Shared File Drive Interface CIFS Authoritieshttp://www.samba.org/http://www.samba-tng.org/ Other CIFS Utilities and ToolsSamba for AmigaSharity-Lite SMB Browse for MacOSX Xamba Network Integration Project MSRPCRpcdump utility for querying RPC serversOpenGroup DCE/RPC Specification OpenGroup DCE/RPC Specification - NDR What OLE Is Really About KerberosRFC1510 - Kerberos V5 SpecificationHow a Kerberos Logon Works in Win2K JGSS Example Kerberos Explained W2K PAC Specification Technical Documentation"Implementing CIFS" (complete online book)Annotated CIFS Specification: draft-leach-cifs-v1-spec-02.html SNIA CIFS Technical Reference (V1.0) The NTLM Authentication Protocol A .NET Developer's Guide to Windows Security Windows System Error Codes Windows Network Management Error Codes rfc1001 - NetBIOS Concepts and Methods rfc1002 - NetBIOS Detailed Specifications CIFS Explained (A whitepaper by John Kleven) SMB URL draft specification V07 NetBIOS, NetBEUI, NBF, SMB, CIFS networking links page Microsoft Writeup on WINS behavior Microsoft Writeup on WINS under W2K Microsoft Server Documentation on Browsing WANs using WINS Windows IT Library: NT Network Plumbing Thursby Software's CIFS pages Linux Mag: Understanding the Network Neighborhood OtherJoin the JCIFS Mailing ListBrowse the Source Batching http://www.gnu.org/ http://www.opensource.org/ Microsoft's CIFS Mailing List Archives |
Newsjcifs-1.2.22 released / InterruptedIOExceptions, Invalid parameter Exceptions, DFS and moreThe 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. If SmbSession.send() threw an exception it could trigger "Invalid parameter" exceptions on subsequent requests. 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. 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). 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. 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. jcifs-1.2.21 released / DFS Cache Bugfix posted by Mike, May 28, 2008 The DFS cache was not properly synchronized. This has been fixed. The trusted domains are now looked up with <1C> NetBIOS lookups to speed discovery. Thanks to Ronny S. for reporting these issues. jcifs-1.2.19 released / DFS Roots on non-Domain Controllers posted by Mike, Apr 6, 2008 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. The new code also eliminates the now-obsolete behavior of building a merged list of shares across hosts. A new NetrDfsEnumEx RPC has been added. Two new properties have been added: jcifs.smb.client.dfs.ttl and jcifs.smb.client.dfs.strictView. Two SmbComOpenAndX parameters were incorrectly swapped which could cause failure on Windows 98. 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. jcifs-1.2.18 released / DCERPC, Robust Recovery, URL Decoding, NPEs and Much More posted by Mike, Feb 18, 2008 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:
posted by Mike, Nov 2, 2007 Alfresco have announced the release of the JLAN Shared File Drive Interface 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. "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." Their press release has a link to the source code at the bottom of the page. jcifs-1.2.17 released / Minor Fix posted by Mike, Aug 15, 2007 A try / catch clause that was accidentally introduced in a previous release has been removed. jcifs-1.2.16 released / Domain-Based DFS Support posted by Mike, Aug 2, 2007 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. (new SmbFile("smb://example.com/")).listFiles()), JCIFS will build a merged list of all shares on all domain controllers. 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. 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. jcifs-1.2.15 released / NetApp Compatibility, SMB signing with DFS and More posted by Mike, Jul 16, 2007 This release includes some significant changes. Most of these changes are related to NetApp compatibility. The changes in this release include the following:
posted by Mike, Jun 20, 2007 A new SID.getGroupMemberSids() 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 SamrEnumerateAliasesInDomain RPC and numerous other calls necessary to negotiate the various handles. 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. jcifs-krb5-1.2.13 released / Kerberos Authentication Support Update posted by Mike, Feb 8, 2007 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. The JCIFS team has compiled the package and confirmed that it works with at least the one test case provided (examples/KerberosAuthExample.java) but otherwise the code should be used with caution. Great thanks again to Mr. Shun from Japan for contributing this work. jcifs-1.2.13 released / Share ACLs, DFS Fixes and NoRouteToHostException Fallback posted by Mike, Jan 22, 2007 A new SmbFile.getShareSecurity() method that uses a new MsrpcShareGetInfo/ShareInfo502 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 NoRouteToHostException 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. 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. jcifs-krb5-1.2.9 released / Kerberos Authentication Support posted by Mike, Sep 13, 2006 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. The examples/KerberosAuthExample.java 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 Krb5LogonModule to fully utilitize this new feature. 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. 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. Great thanks to Mr. Shun from Japan for contributing this work. Ever notice Japan always get's new stuff first? jcifs-1.2.0 released / New Transport Layer, Port 445, getDiskFreeSpace posted by Mike, May 22, 2005 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. 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:
posted by Mike, May 4, 2005 If a file is opened with SmbFileOutputStream, written to, and then the client waits for jcifs.smb.client.soTimeout 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 RandomAccessFile which does not have this problem. 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. |
Last updated Jun 25, 2008 jcifs-1.2.22 Copyright © 2008 The JCIFS Project validate this page |