  xsmb for Linux, version 0.2.0

  Copyright (C) Jorma Korpisalo 1998

  See COPYING for precise terms and conditions for copying, distribution
  and modification of this program.

  email : jkorpisa@ratol.fi

  Latest version of this program available at :
  http://www.ratol.fi/~jkorpisa/xsmb.html


WHAT IS xsmb ?
-----------------------------

  xsmb is an X -based browser for CIFS(SMB), Common Internet File System,
  known also as windows network. 

  for CIFS and SMB overview, see http://samba.anu.edu.au/cifs/

  xsmb is written in expectk (expect with Tk support)

  xsmb uses following programs found in samba suite :
  - smbclient
  - nmblookup
  - smbmount
  - smbumount

  xsmb is basically just an X frontend for these programs. With xsmb,
  you can browse local and remote networks, copy files from/to network
  hosts and mount/umount network shares.



INSTALLATION :
------------------------------

  What you need :
  - X. xsmb is X-based program.
  - Tcl/Tk. xsmb has been tested on following versions :
    Tcl: 7.6p2, 8.0.2
    Tk: 4.2p2, 8.0.2
  - expect. xsmb has been tested on folloving versions of expect :
    5.22, 5.24
  - the samba suite. xsmb uses samba programs 'smbclient', 'nmblookup',
    'smbmount' and 'smbumount'. Samba (smbd & nmbd), however, doesn't have
    to be configured nor running. xsmb has been tested on samba versions
    1.9.18p7 and 1.9.18p8
  - in kernel the following should be configured :
    CONFIG_SMB_FS (SMB filesystem support)
    CONFIG_SMB_WIN95 (SMB Win95 bug work-around)
 
  To install :
  - Check that programs smbclient, nmblookup, smbmount and smbumount
    are in your $PATH
  - If you have smbd and/or nmbd running, check that file /etc/smb.conf
    does NOT include line "debug level = 0". This prevents nmblookup
    working as xsmb would expect it to work.
  - If you want to mount & umount network shares, smbmount and smbumount
    must be suid root. This is done by typing (as root) :
    chmod u+s smbmount
    chmod u+s smbumount
    in directory where these programs are. If you don't have root
    permissions, ask your system administrator to do that.
  - unpack xsmb-0.2.0.tar.gz :
    gzip -d -c xsmb-0.2.0.tar.gz | tar xvf -
    cd xsmb-0.2.0
    .. and copy file "xsmb" to some binary directory on your $PATH, for
    example /usr/local/bin/


HOW TO USE :
------------------------------

  xsmb has only one command line option, default workgroup. This can
  be the workgroup that your own computer is in, or just some workgroup
  in your local network.

    xsmb -dwg MYGROUP
    xsmb --default-workgroup MYGROUP

  where "MYGROUP" is the name of your workgroup.

  xsmb does NOT have to be started with this option, plain "xmsb" is
  enough. The default workgroup can be set in program configuration
  window.

  - Start xsmb. The window shoud pop up, along another window
    displaying the GNU General Public License.
  - If you typed one workgroup as command line option, there should
    be a list of local workgroups available. If not, you must add it
    in configure window (from 'File' menu) and then press "R"
    (refresh)
  - You can access workgroups and following hosts/shares/directories
    by double clicking them with left mouse button.
  - More help on xsmb window structure and buttons are available from
    'help' menu.


ADDITIONAL NOTES :
------------------------------

  Master browser :

  In a stable network where master browser doesn't change, xsmb should
  work quite nicely. However, this might not always be the case, master
  browser can change. Though xsmb always tries to find the master browser
  first, it might happen that master is not available at the moment.
  If this occurs, you can try adding other (than default) workgroups in
  'add local workgroup' from 'tools' menu, if there are more than one
  workgroups in local network. OR if only one workgroup, just try
  pressing the refresh button ...

  Network timeouts :

  In a slow or otherwise loaded network, timeouts may occur. xsmb should
  handle these and reports them. You can modify the timeout xsmb uses,
  in configuration window.

  Remote workgroups/hosts :

  xsmb includes option with you can browse workgroups/hosts in other
  networks (in 'tools' menu). With remote workgroups, you need to know the
  netbios name and IP address of that workgroup's master browser. Remote
  host needs host's netbios name and/or IP address.

  If there are master browser in local and remote network, who both
  use samba, it's possible to configure them in a way that they
  synchronise their browse lists. xsmb should then automatically be
  able to list and browse these remote networks (NOT TESTED!).
  See options 'remote announce' and 'remote browse sync' in smb.conf(5)

  2.1.x kernels :

  smbmount & smbumount must be recompiled when using the mount option.
