Smb4K – Samba (SMB) share advanced browser
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
Michele Calgaro cb4c5cd75f
Use centralized cmake version
2 days ago
admin@59a8bf7c09 Reset submodule main/applications/internet/smb4k/admin to latest HEAD 1 month ago
doc Replace Qt with TQt 4 weeks ago
plugin Use new TQ_METHOD, TQ_SIGNAL, TQ_SLOT defines 3 months ago
po CMake conversion 4 months ago
smb4k Use new TQ_METHOD, TQ_SIGNAL, TQ_SLOT defines 3 months ago
utilities CMake conversion 4 months ago
.gitmodules Remove cmake submodule since it has now been replaced by cmake-trinity dependency. 3 years ago
AUTHORS Added old KDE3 version of SMB4K 14 years ago
BUGS Added old KDE3 version of SMB4K 14 years ago
CMakeL10n.txt Use centralized cmake version 2 days ago
CMakeLists.txt Use centralized cmake version 2 days ago
COPYING Added old KDE3 version of SMB4K 14 years ago
ChangeLog Rename KWallet to TDEWallet 11 years ago
ConfigureChecks.cmake CMake conversion 4 months ago
Doxyfile Added old KDE3 version of SMB4K 14 years ago
FAQ Replace Qt with TQt 4 weeks ago
INSTALL Added old KDE3 version of SMB4K 14 years ago
Makefile.am Added old KDE3 version of SMB4K 14 years ago
README Replace Qt with TQt 4 weeks ago
TODO Replace QObject, QWidget, QImage, QPair, QRgb, QColor, QChar, QString, QIODevice with TQ* version 6 months ago
config.h.cmake CMake conversion 4 months ago
config.h.in Added old KDE3 version of SMB4K 14 years ago
configure.in.in Add automake support for --enable-gcc-hidden-visibility. 12 years ago

README

Smb4K README (version 0.9.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:
---------
- 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
- TDEWallet support
- Synchronization of a remote share with a local copy and vice versa
- Ability to define custom options for individual servers and shares

Translations:
-------------
For the list of currently supported translations please visit Smb4K's home page
at http://smb4k.berlios.de/information.html.

Supported operating systems:
----------------------------
Smb4K officially supports Linux (kernel >= 2.2.x) and since version 0.4.1 also
FreeBSD (>= 4.10-RELEASE). Smb4K might also run on other operating system (e.g.
Solaris).

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

Make sure that you also have installed all header files of the libraries TQt
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
- A sh-compatible shell (bash, dash, ash, etc.) with an existing link /bin/sh
  or the sh shell itself.
- Samba (3.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/]
- rsync - A file transfer program to keep (remote) files in sync
  [http://rsync.samba.org/]

Compilation and Installation
----------------------------
(a) Full installation:

1. Change into the root directory of the source code:
     $ cd smb4k-x.x.x
   (Replace x.x.x with the version number)
2. Configure the source code with at least the following command
     $ ./configure --prefix=`tde-config --prefix`
   Several more options can be added. Run
     $ ./configure --help
   to find out which ones are available.
3. Compile the source code:
     $ make
4. Install the application. For that, become root
     $ su
   and run
     $ make install
   in the root directory of the source code. If you want to be able to
   remove Smb4K with your package manager, install the 'checkinstall'
   package and run
     $ checkinstall
   instead.

(b) Installation without Konqueror plugin:

Those of you, who do not use KDE or who do not wish to install the Konqueror
plugin, should run this configure command
  $ ./configure --prefix=`tde-config --prefix` --without-konqplugin
instead of the one mentioned above and else proceed as described.

Additional information about compiling and installing the software is available
in the INSTALL file.

Debugging the Source Code
-------------------------
If you experience crashes or similar and want to debug the source code yourself,
compile the source code with debugging symbols. The procedure is similar to the
one described in the "Compilation and Installation" section above except that
you need to modify the configure command slightly:
  $ ./configure --prefix=`tde-config --prefix` --enable-debug=full
Now compile and install the program as stated above. If you do not want to
install but only debug the newly compiled program, you may execute Smb4K from
within the source code directory. Change into the 'smb4k' subdirectory and run:
  $ ./smb4k --nofork
If you found the cause for a bug, please let us know. A backtrace or a patch
will be much appreciated.

Help and Support
----------------
If you encounter problems when using Smb4K and need help or support, please
read the 'Trouble Shooting' section of the handbook first. You can access the
handbook from the 'Help' menu by selecting the 'Smb4K Handbook' entry or by
pressing the F1 key. An online version handbook is also available at 
http://smb4k.berlios.de/handbook/index.html. Most of the common problems that
arise when working with Smb4K are already covered there. If that's not the
case, we recommend that you contact the Smb4K-general mailing list at 
https://lists.berlios.de/mailman/listinfo/smb4k-general to get help. Some of
the developers and many users are subscribed and can help.

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 information about the version of Smb4K and the
operating system you are using (Linux or FreeBSD). It might also help if you
mention the distribution you have installed (Linux).
If you experienced a crash, we would appreciate if you sent us the backtrace,
i.e. the output provided by KDE's crash dialog. Please see the section "Debug-
ging the Source Code" for a description how to make sure useful debugging output
is returned.

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

Latest Version
--------------
The latest stable version of Smb4K is always available from the Smb4K home page
at http://smb4k.berlios.de.