                      Samba-Client-Plugin fr eCS (OS/2)
                      Version _VERSION_
                      Build _BUILD_
                      __________________________________

INHALT
______

 1. Einfhrung
 2. Lizenz
 3. Installation
 3.1 Netdrive
 3.2 EVFS
 4. NDPSMB.DLL Verwendung
 4.1 Netdrive
 4.2 EVFS
 5. Fehlersuche
 6. Entwicklung


1. Einfhrung
_____________

Samba ist ein freie Implementierung des CIFS/SMB-Protokolls, mit der leistungs-
fhige Datei- und Druckserver realisiert werden knnen. Ursprnglich stammt 
Samba aus der UNIX-Welt, um mit entsprechenden Windows-System kooperieren zu
knnen. eCS (OS/2) hat eine eigene Implementierung des CIFS/SMB-Protokolls,
nmlich den IBM LAN Requester als Client bzw. IBM Peer/IBM LANServer/WarpServer
fr eBusiness auf der Serverseite. Diese Produkte wurden nicht seit langer Zeit
nicht mehr aktualisiert und haben einige Kompatibilittsprobleme mit modernen
Windows CIFS/SMB-Implementierungen.

Dieses Paket ist die eCS (OS/2) Portierung des Samba-Clients als Plugin fr

- NetDrive fr eCS (OS/2) - ein bekanntes virtuelles Dateisystem fr eCS (OS/2)
oder
- EVFS - das eComStation Virtual Filesystem fr SMB.

Der eCS (OS/2) Samba-Client bietet nahtlosen Zugriff auf CIFS/SMB-Dateifreigaben 
ber Ihr Netzwerk mit TCP/IP als das zugrunde liegende Transport-Protokoll.

Die eCS (OS/2) Samba-Client besteht aus einem Modul:
   ndpsmb.dll - das NetDrive / EVFS Plugin.
   
Versionen vor Version 1.5.0 hatte ein zweites Modul, das jetzt veraltet ist:
   smbcd.exe - der Samba-Client-Daemon-Prozesse. Dieser ist seit Version
               1.5.0 in den Plugin integriert

2. Lizenz
__________

Samba ist frei verfgbar unter der GNU General Public License. Sie knnen den 
vollstndigen Sourcecode auf unserem SVN-Repository bekommen. Sie finden auf 
der Samba fr eCS (OS/2) Homepage weitere Informationen ber das Herunterladen 
des Quellcodes.

Der NetDrive Plugin ist auch mit vollstndigem Quellcode verfgbar.

Also, wenn Sie unser Plugin verwenden, bitten wir Sie um Ihre Untersttzung fr
netlabs.org. Bitte beachten Sie die Samba fr eCS (OS/2) Homepage um mehr 
darber zu erfahren, wie Sie das Projekt untersttzen knnen!


Links:

Samba fr eCS (OS/2) Homepage: http://samba.netlabs.org/
NetDrive Homepage: http://www.blueprintsoftwareworks.com/netdrive/
Samba-Homepage: http://www.samba.org/


3. Installation
_______________

Das Plugin bentigt die klibc Laufzeitbibliothek namens libc06*. dll (die 
Innotek GCC Runtime DLL) irgendwo in Ihrem LIBPATH, wenn sie nicht schon dort
ist (Sie kommt mit allen bisherigen eComStation Versionen).
Desweiteren bentigt das Plugin den 32 bit TCP/IP Stack. Auch dieser kommt mit allen
eComstation Versionen mit. Falls noch der 16 bit stack installiert ist, suchen Sie
bitte im Internet nach dem 32 bit stack.

3.1 Netdrive
____________

Sie mssen NetDrive 2.2.1 oder hher installiert haben, vor der Installation dieses
Paket. Wenn Sie 64-Bit-API-Datei verwenden mchten, installieren Sie NetDrive 
Version 2.3 oder neuer.Die Installation ist halbautomatisch und besteht aus folgendem:

  - Ndpsmb.dll Installation:
      Instpl.cmd aus diesem Paket aufrufen. Es werden alle Dateien in das
      Plugin-Verzeichnis kopiert.
      
3,2 EVFS
________

  - Ndpsmb.dll Installation:
      Kopieren Sie ndpsmb.dll in x:\ecs\dll (wobei x: Ihr Bootlaufwerk ist)


4. NDPSMB.DLL
_____________


4.1. Verwendung mit Netdrive
____________________________

Das NetDrive Samba-Plugin ist nach den allgemeinen Regeln fr die Benutzung 
von NetDrive zu verwenden. Lesen Sie bitte die Dokumentation zu Netdrive fr 
weitere Informationen. Die CIFS/SMB-Ressourcen knnen entweder von der 
Befehlszeile mit nd.exe oder ber die WPS mit ndpm.exe gemountet werden.

Die NetDrive Samba Plugin Parameter sind:

   Arbeitsgruppe  - den Namen der Arbeitsgruppe mit der eine Verbindung 
                    aufgebaut werden soll.
   Server         - Der Name des Servers mit dem eine Verbindung aufgebaut
                    werden soll.
   Freigabe       - Den Namen der Server-Resource (Freigabe) mit der eine 
                    Verbindung aufgebaut werden soll.
   Benutzer       - Den Name des Benutzers, der angemeldet werden soll.
   Passwort       - Das Passwort des ausgewhlten Benutzers.
   Master         - Den Namen "Masterbrowsers" oder "WORKGROUP", je nachdem
                    was verwendet werden soll, um die Liste aller Server einer 
                    Arbeitgruppe zu erhalten.
   Masterttype    - 0, wenn "Master" der Name des "Masterbrowsers" ist,
                    1, wenn "Master" der Name der "Master-Arbeitsgruppe" ist.
   Easupport      - 1, wenn der gewnschte Server erweiterte Attribute 
                    untersttzt, 0, wenn er es nicht tut.
   Cache timeout  - Die Zeit in Sekunden fr die der Cache gltig ist. Wenn die Zeit
                    verstrichen ist, wird das Verzeichniss neu eingelesen. Fr ein sehr
                    grosses Verzeichniss kann es von Vorteil sein, wenn die Zeit erhht wird.
                    (Als Regel: pro 500-800 Dateien 10 Sekunden) Standardwert: 10 Sekunden
   Cache listings - Die Anzahl Verzeichnisse die der Cache behalten soll. Vorsicht, je hher
                    dieser Wert desto mehr Memory wird gebraucht. Standardwert: 32 Verzeichnisse


Wenn man genau eine Freigaben mounten mchte, mu man sowohl den "Server" und 
die "Freigabe" angeben, die anderen Parameter sind optional. Die Root-Pfad 
Diese Serverfreigabe wird dann mit dem gewnschten Mountpoint verbunden.

Wenn man auf alle Freigaben eines Servers zugreifen mchte, mu man nur den 
"Server", nicht jedoch die "Freigabe" Parameter festlegen, die anderen Parameter 
sind optional. Die Liste der Server-Freigaben werden dann mit dem gewnschten 
Mountpoint verbunden.   

Mchte man auf alle Server innerhalb einer Arbeitsgruppe zugreifen, dann mu 
man nur die "Arbeitsgruppe" nicht jedoch "Server" oder "Freigabe" festlegen, 
die anderen Parameter sind wiederum optional. Die Liste der Server innerhalb 
des angegebenen Arbeitsgruppe wird mit dem gewnschten Mountpoint verbunden.   

Wenn man Zugriff auf alle verfgbaren Arbeitsgruppen innerhalb eines Master- 
Browser-Zugriff innerhalb des Netzwerks haben mchte, dann nur den "Master", 
und weder die "Arbeitsgruppe" noch den "Server" festlegen, die anderen Parameter 
sind optional. Die Liste der Arbeitsgruppen wird mit dem Mountpoint verbunden 
werden. Der "Master"-Arbeitsgruppe sollte allen bekannt sein im Netz. Der 
"Master"-Server sollte der Master-Browser fr Arbeitsgruppe sein.   

Standardmig wird der "guest" Benutzer ohne Passwort verwendet, um Zugang zu 
den gewhlten Resourcen zu bekommen. Falls Sie Zugriff verweigert (5) Fehler 
bekommen, versuchen Sie es mit einen anderen Benutzernamen und entsprechendem 
Passwort.

4.2 Verwendung mit EVFS
_______________________

eComStation kommt mit einem GUI-Programm mit dem Namen EVFSGUI, welches noch 
mehr Feature und Komfort bietet als das Netdrive GUI. In der Dokumentation
zu eComStation finden Sie mehr ber die Verwendung.

5. Fehlersuche
______________

Um eine Log-Datei fhren zu lassen, erzeugen Sie bitte eine leere Datei namens 
ndpsmb.dbg in das Root-Verzeichnis des Bootlaufwerks.

Falls eine LOGFILES Umgebungsvariable existiert, wird die Log-Datei dort 
erzeugt, falls nicht im Netdrive Verzeichnis. Die Logdatei heisst log.ndpsmb fr
den Netdrive Teil und log.smbc fr den Samba Teil.


6. Entwicklungsgeschichte
_________________________

 v1.0 beta3:
   - Changelog erstellt
   - Ein Fehler wurde behoben mit mehreren Netzwerk-Schnittstellen auf einem System
   - Ein Fehler wurde behoben mit gebrochenen cmd.exe eingebaute Kommandos
   - Ein Fehler wurde behoben mit falschen Daten der neuen und genderten Dateien
   - Es wurde ein Bndel anderer Bugs, die zu klein sind, sich daran zu erinnern;)
   - Gegen alte tcp zusammengestellt smbcd.exe / IP-Stack-Schnittstelle

 v1.0 beta4:
   - Fehler behoben auf zu schreiben, ECS Freigaben
   - Mehr Updates fr falsches Datum der Dateien

 v1.0 beta5:
   - Hat das Sperren von Dateien
   - Hat 64-Bit-IO-Datei (bei der Arbeit mit NDF 2,3 +)
   - Umzug nach 3.0.9 Samba

 v1.0 beta6:
   - Fixed bug-Attribut eingefhrt, beta 5
   - Umgesetzt setnewfilesize Funktion. Es kann nicht auf allen CIFS-Servern arbeiten.
   - Hat die automatische smbcd.exe ab, wenn nicht gestartet, wenn eine Verbindung zu CIFS-Freigabe
   - Added 'logfile' und 'loglevel "Optionen ndpsmb

 v1.0 beta7:
   - Umzug nach libc06b4.dll libc.

 v1.0 beta8:
   - Zog zurck nach libc benutzerdefinierte bauen.
   - EA hat die Untersttzung
   - Ein paar Bugs behoben

 v1.0 beta9:
   - EA hat Untersttzung fr DosOpen die in beta8 vergessen wurde

 v1.0 beta10:
   - Caching von EA-Gre nach Datei zu finden Anfrage
   - Umzug nach libc06b5.dll libc

 v1.0 beta11:
   - Umzug nach libc06r1.dll libc

 v1.0 beta12:
   - NdpRsrcQueryFSAllocate umgeschrieben
   - Bewegt von GA2 Release libc06.dll

 v1.0 beta13, der Glckliche:
   - Bewegt von CSD1 Release libc061.dll

 v1.0 beta14:
   - Verschoben aufbauen, um benutzerdefinierte libc

 v1.0 GA:
   - Changelog wurde nicht aktualisiert

 v1.5.0 alpha1:
   - smbcd.exe wurde innerhalb ndpsmb.dll umgesetzt
   - Eine Menge anderer Vernderungen

 v1.5.0 beta1:
   - Logging-Funktion neu geschrieben
   - Feste freier Festplattenspeicher
   - Hat mehr Return-Codes in die Halterung ein Teil (zum evfsgui)
   
 v1.5.0 beta2:
   - Update auf Samba 3.0.35 Client-Code
   
 v1.5.0 beta3:
   - Update auf Samba 3.0.36 Client-Code
   - Codepage Update fr System luft
     Nicht IBM-850 Codepages (Ticket #100)

 v1.5.0 beta4:
   - Update auf Samba 3.0.37 Client-Code
   - Codepage Update fr Ticket # 68
   
 v1.5.0 GA:
   - Behebung eines Speicherloches im EA-Code
   - Ticket # 111 
   - Die nicht mehr bentzten Token MEMLEN, LOGFILE und LOGLEVEL wurden 
     entfernt.
     (ACHTUNG! Kompatibilittswarnung: Die Token mssen auch aus alten
     *.evp, *.ndc und volumes.cfg Dateien entfernt werden, anonsten
     scheitert die Wiederherstellung von Verbindungsprofilen.
   - Logging-Funktion fr Samba Meldungen hinzugefgt

 v1.5.1:
   - Behebung der Abstrze auf Quadcore Maschinen
   
 v1.5.2:
   - Korrekturen an den Hilfedateien

 v1.5.3:
   - Zeitzonenproblem behoben

 v2.0.0 beta1:
   - Caching von Verzeichnissen

 v2.0.0 beta2:
   - Leseproblem mit kleinen Dateien
   - Cache von genderten Dateien sofort lschen
   - SIGPIPE absturz behoben

 v2.0.0 beta3:
   - instpl.cmd gendert, damit Sprachen richtig installiert werden
   - Mglichkeit zum verndern des Cache timeout und Tiefe via GUI
   - Anassungen an Hilfedateine und readme

 v2.0.0 beta4:
   - mgliche SIGPIPE Abstrze komplett neu gelst (Dank geht an Vitali)
   - Touch lschte den Cache nicht 

 v2.1.0 alpha1:
   - Update auf Samba 3.3 Client-Code
   - neuer Merge von 1.6 code und 2.0 code
