JCIFS

JCIFS Overview

Version 1.1 (1999.9.10)

[What is JCIFS?][Functionality][License agreement][Installation][Changes][Known Problems]

[JCIFS Tutorial][JCIFS Shell][JCIFS API]

What is JCIFS?

JCIFS is a CIFS client (Common Internet File System) in Java ("100% pure java"). The document "Just what is SMB?" by Richard Sharpe is a good introduction to CIFS.

Functionalitity

JCIFS supports the disk service, the remote administration service (RAP) and the printer service. JCIFS implements only the protocol NT LM 0.12 (supported by Windows95/98, WindowsNT and Samba).

JCIFS is a programming interface. There is a shell program for test purposes.

License agreement

The source code is released under the GNU General Public License:

Copyright (C) 1999 Norbert Hranitzky

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

The full copyright text: http://www.gnu.org/copyleft/gpl.html

This product includes software developed by the Cryptix Development Team

(http://www.cryptix.org/)

Installation

Download and unzip the archive: jcifs1_1.zip
You need JDK 1.1 or JDK 1.2

The archive contains the following files:

bin/jcifs.jar - jar file (non-debug mode)
bin/jcifs_g.jar - jar file (debug mode)
bin/jcifssh.exe - exe-file for starting the shell program
bin/jcifsbat.bat - bat-file for starting the shell program
bin/jcifssh - shell-script for starting the shell program
doc - This directory contains the documentation (tutorial and API)
src - Sources
src/org/gnu/jcifs - API
src/org/gnu/jcifs/util - Help classes(Debug, Crypt)
src/org/gnu/jcifs/i18n - Internationalisation
src/org/gnu/jcifs/shell - Shell program (only for testing)

Notes for the compilation

If you want to compile the sources in the debug mode, you have to set the flag debugOn in the class org.gnu.jcifs.Debug .

Changes

- Version 1.1: - cifs protocol handler
- bug in the password encryption
- other small changes

Known problems

The method setFileAttribute does not work for directories (why?)
The method listFileInfo does not return the directories if the server is Windows NT
UNICODE in file names is not supported

The software was tested with CIFS servers on Windows95/NT and Samba on UNIX/RM400 . Unfortunately, a test packet isn't available (it would be very useful).

Bug reporting

For help, support questions, suggestions please send an email,

Used resources

JCIFS was implemented after the CIFS specification from Microsoft.

At uncertainties I consulted the Samba sources and debug output. The MD4 implementation is taken from the Cryptix-Crypto library. The algorithm for the password change was implemented after the Samba code.