Description
-----------
  This ARexx-script is a handler module for Opus Magellan which
  allows to access a windows network environment in your local
  network.
  The script uses a working samba installation for accessing
  the network.
  The basic oprations like copy, delete, rename and change-
  directory are supported.
  There is also support for password protected access to shared
  network-folders.


Requirements
------------
  o OpusMagellanII
  o a working Samba installation
    (not sure what versions work, I use the V2.1.0-prealpha)
  o access to a windows network over Ethernet


Distribution
------------
  OpusSMBHandler is PUBLIC DOMAIN. But I would be happy to get an eMail
  if you like/use it or if you have any questions about this program.

  *** Don't ask me how to correctly install Samba - it doesn't work ***
  *** correctly on my machine, too!!                                ***

  >>>> Feel free to improve this script!!

  I would be happy if there would be someone out there who has more time
  than me and could improve the script and add more features, etc...


!!! Important !!!
-----------------
  It is possible, that this script will not work on your configuration!
  If you can do "smbclient -L <yourhostname>" and it outputs a list of
  your shares and some of other network computers, it *should* work.


Installation
------------
  1. copy OpusSMBHandler.dopus5 to Dopus5:ARexx

  2. edit the script and change the lines

    "/* *************************** */

    currenthost="Amiga3000"
    sambaaccess="Samba:accesslist"
    hostslist  ="Samba:hostslist"
    smbclient  ="smbclient"

    /* *************************** */"

     according to your conffig.

     currenthost has to be the name of your Amiga
     "sambaaccess" and "hostslist" have to be a valid
     path/filename. If these files doesn't exist,
     the script will create them by it's own (they're
     used for caching the network comouters

  3. Now make a new Opus-Button "Samba", add the function
     "ARexx Dopus5:Arexx/OpusSMBHandler.dopus5 {Qp}"
     and save it.

  4. That's it.


Usage
-----
  Click the Button "Samba" and a new lister with title "OpusSMBHandler"
  appears. Now the network is searched for other computers.
  If you don't find one, try to enter it's name in the path-line
  of the lister. for example: "\\powerbook\mp3"

  If it works, you should be able to copy files between your Amiga and
  PC(s) without problems.


Bugs/Problems
-------------
  -> This script is rather buggy, so don't be angry if it doesn't
     work on your machine!!!

  - No recursive directory accesses are supported.
  - Perhaps it doesn't work with other smbhandler-versions.
  - No copy-progress-bar is possible
  - Sometimes the filenames/directories are not correctly
    parsed (-> files become directories, etc.)
  - smbclient/samba has a *lot* of bugs, this can cause a lot
    of problems!

  -> Please don't contact me about problems like "it doesn't work on
     my machine"!
     I can't help here, perhaps you can check the script for bugfixes
     yourself.
     I have not much time at the moment, so please try to solve
     problems first on your own!

  *** If someone can help me get the latest samba work on my machine,
      I would be very happy!! ***


History
-------
  V1.00: (28.05.2000)
         ** first public release **


Author
------
  Stefan Robl <stefanqdev.de>
  More infos about ArtecScan, FMdriver, PPCjpeg, the QBox and many
  other cool projects?

  Just visit my Homepage: http://www.qdev.de

Have fun!

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                 4281   18909  22.6% -lh5- 8507 May 28  2000 OpusSMBHandler.dopus5
[generic]                 1724    3731  46.2% -lh5- df7f May 28  2000 OpusSMBHandler.readme
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         2 files    6005   22640  26.5%            May 27  2000