                          Client Samba pour eCS (OS/2)
                          Version _VERSION_
                          Construction _BUILD_
                          ____________________________

CONTENU
_______

 1. Introduction
 2. Licence
 3. Installation
 3.1 Netdrive
 3.2 EVFS
 4. Utilisation de NDPSMB.DLL
 4.1 Netdrive
 4.2 EVFS
 5. Debugage
 6. Historique


1. Introduction
_______________

Samba est un ensemble client/serveur de partage de fichiers et
d'imprimantes bas sur les protocoles SMB/CIFS. Ces derniers
taient  l'origine conus pour que le monde UNIX puisse cooprer
avec les clients ou serveurs Windows et eCS (OS/2). eCS (OS/2) a
une implmentation native de l'ensemble client/serveur SMB/CIFS -
IBM LAN Manager et IBM Peer. Ces produits n'ont pas t mis 
jour depuis bien longtemps et prsentent des problmes de
compatibilit avec les implmentations SMB/CIFS Windows
modernes. 

Cette distribution est un portage pour eCS (OS/2) du client Samba
sous forme de composant enfichable pour les deux produits
suivants :
 - NetDrive pour eCS (OS/2) - un systme de fichiers virtuel pour
   eCS (OS/2) bien connu, et
 - EVFS - le systme de fichiers Virtuel pour SMB de eComStation
   (eComStation Virtual Filesystem for SMB). 
Le client Samba pour eCS (OS/2) fournit un accs transparent aux
partages de fichiers SMB/CIFS sur votre rseau en utilisant TCP/IP
comme protocole de transport. 

Le client Samba pour eCS (OS/2) consiste en un seul module :
 - ndpsmb.dll - le composant enfichable pour NetDrive/EVFS lui-mme. 

Les versions antrieures  la version 1.5.0 prsentaient un second
module : "smbcd.exe". Il s'agissait du "dmon" du client Samba qui
traitait effectivement toutes les requtes de ndpsmb.dll. Il n'est
 prsent plus du tout utilis. 


2. Licence
__________

Samba est disponible gratuitement sous licence GNU General Public.
Vous pouvez obtenir le code source complet depuis notre dpt SVN.
Veuillez vous rfrer  la page web de Samba pour eCS (OS/2) pour
les dtails sur le tlchargement des sources.

Le composant enfichable pour NetDrive est aussi disponible avec son
code source complet.

Si vous utilisez notre composant enfichable, nous vous demandons
juste de donner votre contribution  netlabs.org.
Veuillez vous rfrer  la page web de Samba pour eCS (OS/2) pour
savoir ce que vous pouvez faire ! 


Liens vers les pages web : 

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


3. Installation
_______________

Le composant enfichable ncessite la prsence dans l'un des
rpertoires de la variable d'environnement LIBPATH de votre
systme, du "runtime" klibc nomm libc06*.dll, la bibliothque GCC
d'Innotek. 
Le fichier y est peut tre dj, cette bibliothque tant en effet
fournie avec les versions rcentes d'eComStation. 

Le composant enfichable ncessite en outre une pile TCP/IP 32
bits. Celle-ci est fournie en standard avec toutes les versions
d'eComStation. 
Si vous avez toujours une pile TCP/IP 16 bits installe, vous
pourrez trouver une distribution 32 bits de celle-ci en effectuant
une recherche sur Internet. 


3.1 Netdrive
____________

Vous devez avoir NetDrive version 2.2.1 ou ultrieure installe sur
votre systme avant d'installer cette distribution. Si vous voulez
utiliser l'API fichiers 64 bits, vous devrez installer la version 2.3
ou ultrieure de NetDrive. 

Pour installer ndpsmb.dll, excutez le script instpl.cmd de cette
distribution qui placera tous les fichiers ncessaires dans le
rpertoire plugin de NetDrive. 


3.2 EVFS
________

Pour installer de ndpsmb.dll, placez  ndpsmb.dll dans x:\ecs\dll
(o x: correspond  la lettre de votre unit d'amorage). 


4. Utilisation de NDPSMB.DLL
____________________________

4.1. Utilisation avec Netdrive
______________________________

Le composant enfichable Samba pour NetDrive est utilisable selon les
rgles d'utilisation gnrale de NetDrive. Veuillez consulter la
documentation de NetDrive pour plus d'information  ce sujet. Les
ressources SMB/CIFS pourront tre montes soit en utilisant
l'utilitaire en ligne de commandes ND.EXE, ou en utilisant
l'utilitaire WPS NDPM.EXE de NetDrive. 

Les paramtres du composant enfichable pour NetDrive sont : 

   Groupe de travail - nom du groupe de travail auquel il faut se
                       joindre. 
   Serveur           - nom (ou adresse IP) du serveur sur lequel
                       il faut se connecter. 
   Partage           - nom de la ressource sur le serveur  laquelle
                       on dsire accder. 
   Utilisateur       - nom de l'utilisateur sous lequel if faut
                       ouvrir une session. 
   Mot de passe      - mot de passe de l'utilisateur. 
   Matre            - nom du serveur ou groupe de travail "matre",
                       utilis pour obtenir la liste des groupes de
                       travail lorsqu'un serveur ou un groupe de
                       travail concret n'a pas t indiqu. 
   Type de matre    - 0 si "matre" est le nom du serveur "matre",
                       1 s'il s'agit du nom du groupe de travail
                       "matre".
   Support des A    - 1 pour que les Attributs tendus (Extended
                       Attributes) d'eCS (OS/2) soient pris en
                       charge, 0 sinon. 
   Dlai du cache    - dure de validit du cache en secondes. Si
                       la dure est dpasse, le client effectue une
                       nouvelle lecture du rpertoire. 
                       Pour un rpertoire avec beaucoup de fichiers,
                       il peut tre intressant d'augmenter le dlai
                       (en rgle gnrale de 10 secondes par
                       tranches de 500  800 fichiers). 
                       10 secondes par dfaut. 
   Listes en cache   - le nombre de rpertoires que le cache devrait
                       tenir. Gardez  l'esprit que plus cette
                       valeur est grande, plus il y aura de mmoire
                       utilise. 
                       32 listes par dfaut. 

Pour monter le partage exact d'un serveur, il faut renseigner  la
fois les champs  Serveur  et  Partage . Les autres paramtres
sont optionnels. La racine du chemin vers le partage du serveur sera
monte sur le point de montage. 

Pour accder  tous les partages d'un serveur, seul le champ
 Serveur  devra tre renseign, pas le paramtre  partage . Les
autres paramtres sont optionnels. La liste des partages du serveur
sera monte sur le point de montage. 

Pour accder  tous les serveurs d'un groupe de travail, seul le
champ  Groupe de travail  doit tre renseign, pas le paramtre
 Serveur . Les autres paramtres sont optionnels. La liste des
serveurs du groupe de travail donn sera monte sur le le point de
montage. 

Pour accder  tous les groupes de travail d'un matre explorateur
d'un rseau, alors seul le paramtre  Matre  doit tre renseign,
pas les champs  Groupe de travail  ni  serveur . Les
autres paramtres sont optionnels. La liste des groupes de travail
sera monte sur le point de montage. Le groupe de travail
 Matre  peut tre l'un des groupes de travail connu sur le
rseau. Le serveur  matre  doit tre le matre explorateur du
(des) groupe(s) de travail. 

Par dfaut, l'utilisateur  guest  sans mot de passe sera utilis
pour accder aux ressources slectionnes. Si vous avez des erreurs
d'accs refus, essayez d'utiliser un autre couple (utilisateur, mot
de passe). 


4.2 Utilisation avec EVFS
_________________________

eComStation propose une interface utilisateur qui comprend plus de
fonctionnalits que l'interface de Netdrive. Veuillez vous rfrer 
la documentation fournie avec eCS.


5. Debugage
___________

Pour produire un fichier de consignation, veuillez crer un fichier
vide nomm ndpsmb.dbg  la racine du disque d'amorage.

Le fichier de consignation sera plac dans le chemin de la variable
d'environnement LOGFILES, si disponible. Si cette variable
d'environnement est absente, le fichier de rapport sera plac dans le
rpertoire de NetDrive. Le fichier de consignation est appel
log.ndpsmb pour la partie Netdrive pour OS/2 et log.smbc pour ce qui
concerne Samba. 

6. Historique
_____________

 v1.0 beta3 : 
   - Cration de l'historique. 
   - Correction du problme avec plusieurs interfaces rseau sur un
     systme.
   - Correction du problme avec les commandes internes casses de
     cmd.exe.
   - Correction du problme de mauvaises dates pour les nouveaux
     fichiers et les fichiers modifis.
   - Correction d'un tas d'autres problmes trop insignifiants pour
     qu'on s'en souvienne ;)
   - smbcd.exe compil pour l'ancienne interface de pile TCP/IP.

 v1.0 beta4 : 
   - Correction d'erreurs  l'criture sur les partages eCS. 
   - Nouvelles corrections pour les dates de fichiers errones.

 v1.0 beta5 : 
   - Ajout du verrouillage de fichiers.
   - Ajout des E/S fichiers sir 64 bits (pour une utilisation avec
     NDFS v2.3+).
   - Passage au code Samba v3.0.9. 

 v1.0 beta6 : 
   - Correction du problme d'application des attributs introduit
     dans la beta 5.
   - Implmentation de la fonction setnewfilesize. Cela peut cependant
     ne pas fonctionner avec tous les serveurs CIFS.
   - Ajout du dmarrage automatique de smbcd.exe s'il n'est pas lanc
      la connexion au partage CIFS.
   - Ajout des options 'logfile' et 'loglevel'  ndpsmb. 

 v1.0 beta7 : 
   - Passage  la bibliothque libc libc06b4.dll. 

 v1.0 beta8 : 
   - Retour  une construction "maison" de libc. 
   - Ajout de la prise en charge des A. 
   - Correction d'un tas d'autres problmes. 

 v1.0 beta9 : 
   - Ajout de la prise en charge des A pour DosOpen, oublie dans la
     beta8. 

 v1.0 beta10 : 
   - Mise en antmmoire de la taille des A aprs une requte de
     recherche de fichier.
   - Passage  la bibliothque libc libc06b5.dll. 

 v1.0 beta11 : 
   - Passage  la bibliothque libc libc06r1.dll. 

 v1.0 beta12 : 
   - Rcriture de NdpRsrcQueryFSAllocate. 
   - Passage  la bibliothque libc libc06.dll version GA2. 

 v1.0 beta13, la chanceuse :
   - Passage  la bibliothque libc libc061.dll version CSD1. 

 v1.0 beta14 : 
   - Passage  une construction "maison" de libc. 

 v1.0 GA : 
   - Historique non renseign. 

 v1.5.0 alpha1 : 
   - smbdc.exe a t implment au sein de ndpsmb.dll. 
   - Beaucoup d'autres modifications. 

 v1.5.0 beta1 : 
   - Rcriture de la fonction de consignation. 
   - Correction de l'espace disque libre. 
   - Ajout de codes de retour supplmentaires pour la partie montage
     (pour evfsgui). 

 v1.5.0 beta2 :
   - Passage au code du client Samba v3.0.35. 

 v1.5.0 beta3 :
   - Passage au code du client Samba v3.0.36. 
   - Correctif sur les pages de codes pour les systmes n'utilisant
     pas la page de condes IBM-850 (ticket n100)

 v1.5.0 beta4 :
   - Passage au code du client Samba v3.0.37. 
   - Correctif sur les pages de codes (ticket n68). 

 v1.5.0 GA :
   - Correction d'une fuite de mmoire dans le code A. 
   - Ticket n111. 
   - Retrait des variables MEMLEN, LOGFILE et LOGLEVEL non utilises. 
     (Avertissement de compatibilit : ces variables doivent aussi
     tre retires des fichiers *.ndc, *.evp et volumes.cfg plus
     anciens afin de rtablir correctement les connexions avec le
     nouveau composant enfichable).
   - Ajout de la fonction de journalisation pour les messages lis 
     Samba. 
   
 v1.5.1 :
   - Correction du plantage sur les machines Quadcore. 
   
 v1.5.2 :
   - Correction des fichiers d'aide. 

 v1.5.3 :
   - Correction du problme de tampon dateur des fichiers. 

 v2.0.0 beta1 :
   - Ajout de la mise en cache des rpertoires. 

 v2.0.0 beta2 :
   - Correction du problme de lecture des petits fichiers. 
   - Suppression du cache sur les fichiers modifis. 
   - Correction du plantage SIGPIPE. 

 v2.0.0 beta3 :
   - Ajout de la possibilit de rgler la temporisation et la
     profondeur du cache via l'interface utilisateur. 
   - Correction du script insp.pl. 
   - Correction des fichiers d'aide.

 v2.0.0 beta4 :
   - Revue des possibles plantages SIGPIPE (merci  Vitali).
   - "touch" ne supprimait pas le cache. 

 v2.1.0 alpha1 :
   - Passage au code du client Samba 3.3
   - new merge of 2.0 code and 1.6 code

Traduction franaise : Guillaume Gay <guillaume.gay@bigfoot.com>
Version : 2010-01-11
