Smb4K README (version 0.6.x)
============================

Smb4K is an SMB/CIFS share browser for KDE. It uses the Samba software suite to 
access the SMB/CIFS shares of the local network neighborhood. Its purpose is to 
provide a program that's easy to use and has as many features as possible.

Features so far:
----------------
- Scanning for (active) workgroups, hosts, and shares
- Mounting and unmounting of SMB/CIFS shares, including unmounting all shares 
  at once
- Access to the files of a mounted SMB/CIFS share using Konqueror
- Auto-detection of external mounts/unmounts
- Mounting of recently used shares on start-up
- Miscellaneous infos about the SMB/CIFS shares
- Network search
- WINS server support
- Preview of SMB/CIFS shares
- Selectable look-up and search methods
- Default login
- Ability to execute mount and umount SUID root
- Special handling of homes shares
- Ability to bookmark favorite shares
- System tray icon
- Support of advanced Samba options
- Support of printer shares
- Konqueror plugin
- KWallet support

Translations:
-------------
Brazilian Portuguese, Bulgarian, (Catalan), Czech, Chinese Simplified, 
Chinese Traditional, Danish, Dutch, French, German, Hungarian, Icelandic, 
Italian, Japanese, Norwegian Bookmal, (Norwegian Nynorsk), Polish, 
(Russian), Slovak, Spanish, Swedish, Turkish, Ukrainian
  
Supported operating systems:
----------------------------
Smb4K supports Linux (kernel >= 2.2.x) and since version 0.4.1 also 
FreeBSD (>= 4.10-RELEASE). Other operating systems haven't been tested.

Requirements:
-------------
This version of Smb4K depends on the development files of the following 
libraries:
- KDE Libs & Base (>= 3.2.0): The powerful Open Source graphical desktop 
  environment for Unix workstations [http://www.kde.org]
- Qt (>= 3.2.0): A multiplatform C++ application development framework.
  [http://www.trolltech.no]
- XFree86 or X.org - Freely redistributable implementations of the X Window 
  System [http://www.xfree86.org or http://www.x.org]
- An implementation of the C library

Make sure that you also have installed all header files of the libraries Qt 
and KDE are depending on. Recent versions of automake and autoconf are also 
needed.

For a proper operation, you implicitly need:
- Support of the /proc filesystem compiled into your kernel if you are using 
  Linux
- Samba (>= 2.2.x) - Tools to access to a server's filespace and printers via 
  SMB [http://www.samba.org]
- grep - GNU grep [http://www.gnu.org/directory/grep.html]
- GNU awk (GAWK) or similar - A pattern scanning and processing language.
  [http://www.gnu.org/directory/gawk.html]
- sed - The GNU stream editor  [http://www.gnu.org/directory/sed.html]
- findutils (xargs) - The GNU Find Utilities are the basic directory searching 
  utilities of the GNU operating system 
  [http://www.gnu.org/directory/findutils.html]
- util-linux (mount, umount) - Miscellaneous system utilities
  [ftp://ftp.kernel.org/pub/linux/utils/util-linux]

To enable full functionality, you may also want to install these packages:
- super or sudo - Programs to allow general users to do superuser things
  [ftp://ftp.ucolick.org/pub/users/will/ or http://www.sudo.ws/sudo/]
- teTeX or similar (dvips) - A TeX distribution for Unix
  [http://tug.org/teTeX/]
- GNU enscript - A tool to convert ASCII files to PostScript
  [http://people.ssh.fi/mtr/genscript/]

Help and Support
----------------
If you need help or support, please read the FAQ file first. Maybe your problem 
is already covered there. If that's not the case, there is the Smb4K-general 
mailing list [https://lists.berlios.de/mailman/listinfo/smb4k-general] you should
contact to get help. Some of the developers and many users are subscribed and can 
help. There is also the Help forum where you can post your request
[http://developer.berlios.de/forum/forum.php?forum_id=2311].

Bugs
----
You are strongly encouraged to send a bug report to 
http://developer.berlios.de/bugs/?group_id=769, if you find a problem. Please 
do not forget to include the version of Smb4K, the operating system you are 
using (Linux or FreeBSD) and your distribution (Linux).

Copyright
---------
Smb4K is released under the terms of the GNU General Public License (GPL).
A copy of the license is available in the file COPYING.

Latest Version
--------------
You can always obtain the latest stable version of Smb4K from
http://smb4k.berlios.de.

From time to time the Smb4K team releases unstable code for testing purposes.
You can find it under ftp://ftp.berlios.de/pub/smb4k/testing.

You might want to check out the latest development code using anonymous CVS: 
 cvs -d:pserver:anonymous@cvs.smb4k.berlios.de:/cvsroot/smb4k login
 cvs -z3 -d:pserver:anonymous@cvs.smb4k.berlios.de:/cvsroot/smb4k co -P smb4k
When prompted for a password, simply press the Enter key. 
