RISCOS Samba Server
===================

Welcome to version 0.06 of RISCOS Samba Server. This is a port
of Samba which allows Windows and Unix machines to share RISCOS discs
using the Microsoft File Sharing Protocol (now known as CIFS).

Please read and understand the instructions contained in the HTML
documentation in !smbserver.docs for information on how to configure
!smbserver.

This version of !smbserver has been tested running on RISCOS 4.02,
RISCOS 3.70 and RISCOS 3.10 with the following clients: Windows 98,
Linux (using smbclient, smbmount and smbumount), !Omniclient and !LanMan98
(running on a different RiscPC to the server).                         


Installation
------------

If upgrading from an old release copy your !smbserver.resources.smb/conf
and !smbserver.resources.FileTypes safely out of the way before
unpacking the Samba zip file. Copy the files back after you have unpacked
the zip file.

If running for the first time you may see the error "Please insert
'HardDisc4'". If this happens click cancel and then configure
!smbserver as described in the documentation once the application
is loaded.  


What's new in this release
--------------------------
                                       
- Passwords now supported on shares. (Both plain text and encrypted)
  Note 1: that if you are using Windows 98 or NT and wish to use plain text
  passwords you need to edit a registry entry to enable them. Intructions
  explaining how to do this are provided in the !smbserver documentation.
  Note 2: if you don't wish to use passwords set the "guest OK" option for
  each share.
- Option to detect !LanMan98 clients. When set, if !smsberver detects
  a !LanMan98 client it alters its behaviour to append filetypes as
  hex numbers rather than as extensions to filenams - plus a few other
  tricks.
- Changed character !smbserver uses to distinguish files save from
  clients with the same name but different filetypes.
- Added detect extension option.           
- Tidied up handling of serving of files in DOS partitions to clients.
- Added help text to configuration windows.                           
- Added a file to allow users to be able to edit any parameter they want.
  (You should only edit parameters not aready selected if you know what
   you are doing - there is a good chance I won't have tested whatever
   you change!)


Toolbox Lib Modules
-------------------

This verion of Samba uses the Toolbox lib modules. If you do not have 
the toolbox lib modules you can download them from www.riscos.com. 


Mimemap Module
--------------

This version of Samba uses the Mimemap module to map RISCOS filetypes to
DOS extensions and visa versa. Please read the documentation for more
information on this.

If you do not have a copy of the Mimemap module a PD version can be
obtained from www.thevillage.ndirect.co.uk/justin.


RISCOS 3.1 Users
----------------

There appears to be a problem with the Toolbox Lib Module "TextGadgets".
When it loads it calls SWI 0x66 (OS_DynamicArea) which doesn't exist in RISCOS 3.1!
I don't know what the answer to this yet. For the time being comment out the
rmensure of this module in !smbserver.!run. The side effect of this is that
the text for gadgets in the configuration windows is not displayed properly.


Incompatibilities
-----------------

- !smbserver is not compatible with !Freeze. This is currently under investigation
  but not fixed yet. !smbserver must be exited before freezing your machine.


Bugs and support
----------------

Please send bug reports to samba@merddin.demon.co.uk. Send general chitchat,
nice-to-haves, observations to david@merddin.demon.co.uk. If you find a real
bug then set Debuglevel to 10 in the Global Variables configuration window.
Reproduce the bug, quit !smbserver and send the file !smbserver.Resources.ALogFile
to me. When you restart !smbserver remember to set Debuglevel back to 0 otherwise
it will run slowly and you'll end up with a very large log file!



Have fun!
Eur Ing David R. H. Buxton (19/02/00)     

