#include Plugin client Samba per <$OS> Versione <$NDPSMB_VERSION> Build <$NDPSMB_BUILD> ________________________________________________ CONTENUTI _________ 1. Introduzione 2. Licenza 3. Installazione 3.1 <$ND> 3.2 EVFS 3.3 Disinstallazione 4. Uso di NDPSMB.DLL 4.1 <$ND> 4.2 EVFS 5. Debugging 6. Changelog 1. Introduzione _______________ Samba Š una suite client/server per la condivisione di file e stampanti basata sul protocollo SMB/CIFS, originariamente sviluppata nel mondo UNIX per avere accesso ai server e client <$OS> e Windows. <$OS> dispone di diverse implementazioni native del servizio SMB/CIFS - Peer IBM (nella versione LAN Requester IBM o in quella Condivisione file e stampanti IBM) e LAN Manager IBM. Questi prodotti non sono aggiornati da molto tempo e hanno anche problemi di compatibilit… con le implementazioni SMB/CIFS moderne di Windows. Questo pacchetto Š il port <$OS> del client Samba, implementato sotto forma di plugin per - <$ND> per <$OS> - il ben noto file system virtuale per <$OS> o - EVFS - il Virtual Filesystem per SMB di eComStation Il plugin client Samba per <$OS> garantisce accesso senza problemi alle condivisioni file SMB/CIFS nella rete, utilizzando TCP/IP come sottostante protocollo di trasporto. Il plugin client Samba per <$OS> consiste di un modulo: ndpsmb.dll - il <$ND>/EVFS plugin stesso. I rilasci precedenti la versione 1.5.0 comprendevano un secondo modulo, ora deprecato: smbcd.exe - il demone client Samba, che processa le richieste ricevute da ndpsmb.dll 2. Licenza __________ Samba Š liberamente disponibile in accordo alla GNU General Public License v3. E' possibile ottenere il codice sorgente completo dalla nostra repository SVN; fai riferimento alla homepage del progetto Samba per <$OS> per dettagli su come scaricare il sorgente. Anche il codice sorgente completo del plugin <$ND> Š disponibile. So if you are using our plugin we kindly ask you to support either bww bitwise works or netlabs.org. Please refer to the Samba for <$OS> Homepage to learn how you can do that! Collegamenti: Homepage Samba per <$OS>: http://samba.netlabs.org/ Homepage <$ND>: http://www.blueprintsoftwareworks.com/netdrive/ Homepage Samba: http://www.samba.org/ 3. Installazione ________________ Il plugin necessita del runtime klibc libc06*.dll (DLL runtime GCC InnoTek) nel LIBPATH, se non gi… presente (dovrebbe essere presente in tutte le versioni recenti di eComStation). Il plugin necessita dello stack TCP/IP 32 bit. Si tratta dello stack presente in tutte le versioni di eComStation. Se si dispone ancora di uno stack a 16 bit, cercare in rete lo stack 32 bit. 3.1 <$ND> ____________ E' necessario disporre di <$ND> ver. 2.2.1 o superiore prima di installare questo pacchetto. Se si vuole utilizzare l'API file 64bit, bisogna installare la ver. 2.3 o superiore di <$ND>. L'installazione Š semiautomatica e consiste in: - installazione ndpsmb.dll: lanciare instpl.cmd da questo pacchetto. Tutti i file verranno copiati nella cartella plugin di <$ND>. 3.2 EVFS ________ - installazione ndpsmb.dll: copiare ndpsmb.dll in x:\ecs\dll (dove x: Š la unit… di avvio) 3.3 Disinstallazione ____________________ Lanciare lo script uninstpl.cmd per disinstallare il plugin. La procedura funziona sia per EVFS che per <$ND>. 4. NDPSMB.DLL _____________ 4.1. Uso con <$ND> _____________________ Il plugin Samba <$ND> va usato in accordo con le regole generali di uso di <$ND>. Si veda la documentazione <$ND> per maggiori informazioni. Le risorse SMB/CIFS si possono montare sia usando l'utilit… linea di comando nd.exe che con l'utilit… WPS ndpm.exe di <$ND>. I parametri del plugin Samba <$ND> sono: workgroup - il nome del gruppo di lavoro cui connettersi. server - il nome del server cui connettersi. share - il nome della risorsa del server (condivisione) cui connettersi. user - il nome dell'utente con cui connettersi. password - la parola d'ordine dell'utente selezionato. master - il nome del server o gruppo di lavoro 'master' utilizzato per ottenere la lista dei gruppi di lavoro disponibili se non si Š specificato un gruppo di lavoro e server. masterttype - 0 se 'master' Š il nome del server master, 1 se 'master' Š il nome del gruppo di lavoro master. cache timeout - la durata (in secondi) della validit… della cache; una volta raggiunta la scadenza, il client rilegge la directory; nel caso di cartelle con molti file, pu• essere utile aumentare il timeout (regola empirica: 10 secondi per 500-800 file). Default: 10 secondi cache listings- il numero di directory da conservare in cache; si tenga presente che maggiore Š il valore, pi— memoria verr… utilizzata. Default: 32 directory easupport - 1 per supportare gli Attributi Estesi <$OS>, 0 per non supportarli r/w - definisce se la risorsa Š in sola lettura (r) o scrivibile (w) loglevel - determines the ammount of information writte into a logfile Per montare una risorsa specifica, Š necessario indicare sia il parametro 'server' che quello 'share'; gli altri parametri sono opzionali. La radice della condivisione del server sar… montata sul punto di aggancio. Per accedere a tutte le condivisioni presenti sul server, specificare solo il parametro 'server' (non quello 'share'); gli altri parametri sono opzionali. L'elenco delle risorse condivise dal server sar… montato sul punto di aggancio. Per accedere a tutti i server nel gruppo di lavoro o dominio, specificare solo il parametro 'workgroup' (non quello 'server'); gli altri parametri sono opzionali. L'elenco dei server nel gruppo di lavoro specificato sar… montato sul punto di aggancio. Per accedere a tutti i gruppi di lavoro elencati dal master browser nella rete, specificare solo il parametro 'master' (non 'workgroup' n‚ 'server'); gli altri parametri sono opzionali. L'elenco dei gruppi di lavoro sar… montato sul punto di aggancio. Il gruppo di lavoro 'master' pu• essere qualsiasi gruppo noto nella rete. Il server 'master' dovrebbe essere il master browser per il gruppo (o i gruppi) di lavoro. Come valore di default, per accedere alla risorsa selezionata viene usato l'utente 'guest' senza parola d'ordine. Se sul server non sono previsti utenti ospiti, si ricever… probabilmente un errore 'access denied'. Specificare la corretta combinazione nome utente / parola d'ordine. 4.2 Uso con EVFS ________________ eComStation dispone di EVFSGUI, un programma con interfaccia grafica che Š pi— ricco di opzioni rispetto all'interfaccia grafica di <$ND>. EFVSGUI pu• anche essere usato in combinazione con <$ND>. In proposito, fare riferimento alla documentazione allegata ad eCS. 5. Debugging ____________ In order to produce a log file, choose an appropriate loglevel in the login dialogue. 0 = do not log 2 = log a little 5 = log quite some stuff 10 = log everything. Il file log viene creato nella directory specificata dalla variabile ambiente LOGFILES, se disponibile. Se la variabile ambiente LOGFILES non Š stata definita, il file log viene creato nella directory <$ND>. Il nome del file Š log.ndpsmb.SHARE for the <&ND> log and log.smbd.SHARE for the Samba Client Plugin for &os. log. SHARE is the name of the connected share. 6. Storia _________ #include