SAMBA server for MagiCNet
-------------------------

This is the server part of SAMBA which enables other SMB compatible
systems to access files or printers(?) on our ATARIs!

Installation:
-------------
The 'official' location of SAMBA programs is "u:\usr\local\samba"
or "u:\usr\local\samba\bin". I suggest the creation of a x:\usr
folder on your VFAT partition which will be linked to U:\ drive.

Inside this folder create a subfolder "local" and inside "local"
"samba". The "samba" folder should contain three more folders
"lib", "private" and "var". In the "lib" folder copy the file
smb.conf, optionaly your LMHOSTS file and create yet another
folder called "codepages".

If it all looks complicated, take a look at the original SAMBA
documentation, then you'll realize what complicated means :-)

Having prepared the above directory structure your VFAT drive
should have a tree like this.
 
 x:/usr
     /local
           /samba
                 smb_clnt.ttp
                 nmbd.ttp
                 smbd.ttp
                 /lib
                     smb.conf
                     LMHOSTS    (optional, only if WINS is enabled)
                           /codepages
                 /private
                     smbpasswd  (optional)
                 /var

Please also drop a file named passwd in your u:\etc\ folder.
The format is:

username::0:0:descriptive name:path:shell_program
example:
root::0:0:Vassilis Papathanassiou:f:\home\root:sh

If you already have a /etc/passwd file from your MiNT installation
you can use this, possibly adding a line for your new SAMBA 
connection. This line should have the name you use to login to
your PC (windows network) or other system.

Samba will default to user 'nobody' if it can't find a valid
name for a user trying to login, this will most probably fail!

I'd also strongly suggest the creation of a x:\tmp folder and
in case you already have one, link it to U:\TMP

I'm using a utility from Daniel Augsburger called LINK2U.PRG which
does the job fine. Just copy it to your \GEMSYS\MAGIC\START folder
and prepare a text file called link2u.cnf in your $HOME folder 
defining the links. You can get this program from
"http://www.jumpgates.com/skydiver"

This is my own LINK2U.CNF:
---------------------------
# create links to drive u
#
sln i:\usr u:\usr
sln i:\tmp\ u:\tmp

# delete link to drive a
#
delu a
---------------------------

Usage:
------
Make sure you can ping from/to your server.

Start smbd.ttp with the parameter -D ie become a daemon (unless
someone has ported inetd for MagiCNet :-)

If you want NetBios name services, start also nmdb.ttp with the
same parameter (-D).

Note: with -d <number> one can set the debug level. Normally it
should be zero (0) but if you want to check for possible problems
(debug files in u:\usr\local\samba\var), set it to 4 or 5.

Both should be started from the 'official' samba location, ie
u:\usr\local\samba\.

In a few seconds you'll be able to see your computer in the remote
system (for windoez in Network Neighborhood). Then browsing the
exported disks/folders etc on the ATARI system should be as with
any other network.

smb.conf
--------
There are several things you need in your smb.conf file:

under [global]
   workgroup = A_VALID_WORKGROUP name, eg the same as in your
                                 window$ or Linux system.
   
   server string = ATARI Samba Server
   
since it's nice to see this in your window$ network :-)

   guest account = guest
   
For test purposes or because you're using a password to log-in to the
other system and this password is not contained in your passwd file,
you can use your login name to the other system as guest account.

  security = user
  
Security at user level, if in trouble try security = share (and read
the SAMBA docs!!)

  domain logons = yes
  
To allow the server to accept requests from windows workstations.

Then you need to export some folders. The syntax is
[name]
  comment = A comment, eg public folder.
  browsable = yes
  available = yes
  public = yes
  path = /path_to_this_folder eg /tmp
  read only = no
or
  writable = yes
  
Please note that the whole project is for unix systems, so any path
you're going to use should be relative to the U:\ drive.
I have used a path = /  to be able to browse all the disks on my TT
(not very secure option but this also works :-)

---- To be continued ----
