Changeset 276

Timestamp:

06/17/09 18:12:09 (9 months ago)

Author:

herwigb

Message:

Latest Readme (by diver)

Files:

• branches/client-1.5/src/readme.txt (modified) (10 diffs)

branches/client-1.5/src/readme.txt

@@ -1 @@
-                           OS/2 SAMBA client 
+                           eCS (OS/2) Samba client 
                            Version _VERSION_
                            Build _BUILD_
-                           _________________
+                           _______________________
 
 CONTENTS
@@ -10 +10 @@
  2. License
  3. Installation
- 4. SMBCD.EXE usage
- 5. NDPSMB.DLL usage
+ 4. NDPSMB.DLL usage
+ 5. Debugging
  6. Changelog
 
@@ -18 +18 @@
 _______________
 
-SAMBA is a SMB/CIFS protocols file and print sharing server/client set originaly
-made for UNIX world to cooperate with corresponding Windows and OS/2 servers or
-clients. OS/2 has native implementation of SMB/CIFS server/client set - IBM LAN
+Samba is a SMB/CIFS protocols file and print sharing server/client set originaly
+made for UNIX world to cooperate with corresponding Windows and eCS (OS/2) servers or
+clients. eCS (OS/2) has native implementation of SMB/CIFS server/client set - IBM LAN
 Manager and IBM Peer. These products haven't been updated for a long time and
 have some compatibility problems with modern Windows SMB/CIFS implementations.
 
-This package is the OS/2 port of SAMBA 3.0.9 client made as the plugin to
-NetDrive - a well known virtual file system for OS/2. OS/2 SAMBA client provides
+This package is the eCS (OS/2) port of Samba client made as the plugin to
+NetDrive - a well known virtual file system for eCS (OS/2). eCS (OS/2) Samba client provides
 seamles access to SMB/CIFS file shares over your network using TCP/IP as the
 underlying transport protocol.
 
-The OS/2 SAMBA client consists of two modules:
+The eCS (OS/2) Samba client consists of two modules:
    ndpsmb.dll - the NetDrive plugin itself.
-   smbcd.exe  - the SAMBA client daemon, which actually processes the requests
-                from ndpsmb.dll.
+   smbcd.exe  - the Samba client daemon, which actually processes the requests
+                from ndpsmb.dll. (not used anymore since v 1.5.0)
 
 
@@ -38 +38 @@
 __________
 
-SAMBA is freely available under the GNU General Public License. You can get
-the full sourcecode from our CVS repository, please refer to the SAMBA for OS/2
-and eCS Homepage for details about downloading the source.
+Samba is freely available under the GNU General Public License. You can get
+the full sourcecode from our SVN repository, please refer to the Samba for eCS (OS/2) 
+Homepage for details about downloading the source.
 
 The NetDrive plugin is also available with full sourcecode.
-However, netlabs.org hired nickk to port SAMBA to OS/2 and to create the
-NetDrive plugin. Future work on this plugin highly depends on the support of
-the OS/2 and eCS community. We also think about providing a SAMBA server
-implementation for OS/2 and eCS but that will cost money too.
 
 So if you are using our plugin we kindly ask you to support netlabs.org.
-Please refer to the SAMBA for OS/2 and eCS Homepage to learn how you can do
+Please refer to the Samba for eCS (OS/2) Homepage to learn how you can do
 that!
 
-NOTE: The current beta release needs NetDrive for OS/2. NetDrive is shareware
-but we are in contact with the developer of it, probably there will be a free
-stripped down SAMBA-only version of NetDrive when we release the final version.
-(Don't take that for granted yet, we will announce that in the future)
 
 Links:
 
-SAMBA for OS/2 and eCS Homepage: http://samba.netlabs.org/
+Samba for eCS (OS/2) Homepage: http://samba.netlabs.org/
 NetDrive Homepage: http://www.blueprintsoftwareworks.com/netdrive/
-SAMBA Homepage: http://www.samba.org/
+Samba Homepage: http://www.samba.org/
 
 
@@ -76 +68 @@
       somewhere in your LIBPATH, if it is not here already.
 
-  - ndpsmb.dll and smbcd.exe installation :
-      Run instpl.cmd from this package. The installer will place smbcd.exe in 
-      the Netdrive home directory. When you will connect to CIFS share using the
-      ndpsmb plugin, it will start the smbcd.exe  automatically from this 
-      directory. However, you can start it manually, if you want.
+  - ndpsmb.dll installation :
+      Run instpl.cmd from this package will place all files to the netdrive plugin directory.
 
-4. SMBCD.EXE Usage
-__________________
 
-SMBCD.EXE has the following parameters:
-  -d <debuglevel> (or --debug <debuglevel>) - debug level of output from 0 to 9.
-The more debug level provides more debugging output from SMBCD.EXE which may 
-be used to solve the problems.
-  -l <logfile> (or --logfile <logfile>) - the filename to write the debug info
-from smbcd.exe. Default is to print all debug info to STDOUT stream.
-  -q (or --quite) - tells smbcd.exe to be absolutely quiet.
-
-5. NDPSMB.DLL Usage
+4. NDPSMB.DLL Usage
 ___________________
 
-NetDrive SAMBA plugin is used according to general NetDrive usage rules. Read
+NetDrive Samba plugin is used according to general NetDrive usage rules. Read
 the NetDrive documentation for more information. The SMB/CIFS resources could
 be mounted either using command line nd.exe utility or WPS ndpm.exe utility of
 NetDrive.
 
-The NetDrive SAMBA plugin parameters are:
+The NetDrive Samba plugin parameters are:
 
    workgroup   - the name of workgroup to connect to.
@@ -116 +95 @@
                  to SBM/CIFS resources in size of 64k blocks. The higher values
                  could provide better access speed, but consume more memory.
-   logfile     - file to log records from smbcd.exe. Used only in smbcd.exe 
-                 is run by ndpsmb.dll plugin, not manually
-   loglevel    - level of logging (0-9) for smbcd.exe. Used only in smbcd.exe 
-                 is run by ndpsmb.dll plugin, not manually
-   easupport   - 1 to support OS/2 Extended Attributes, 0 to not support it
+   easupport   - 1 to support eCS (OS/2) Extended Attributes, 0 to not support it
 
-To mount the a exact server's share one need to specify both 'server' and
+To mount the exact server's share one need to specify both 'server' and
 'share' parametres, the other parametres are optional. The root path of
 server's share will be mounted to the mounting path.
 
-If one want to access all servers shares, the only the 'server', not the 'share'
+If one want to access all server shares, then only the 'server', not the 'share'
 parameter, should be specified,the other parametres are optional. The list of
-server's shares will be mounted to the mounting path.
+server shares will be mounted to the mounting path.
 
-If one want to access all servers within the workgroup, the only the 'workgroup',
+If one want to access all servers within the workgroup, then only the 'workgroup',
 not the 'server' parameter, should be specified, the other parametres are
 optional. The list of servers within the specified workgroup will be mounted to
@@ -136 +111 @@
 
 If one want to access all available workgroups within one master browser
-in network, the only the 'master', not the 'workgroup' or 'server' parameter,
-should be specified, the other parametres are optional. The list of workgroups
+within the network, then only the 'master', not the 'workgroup' nor the 'server' parameter,
+should be specified, the other parameters are optional. The list of workgroups
 will be mounted to the mounting path. The 'master' workgroup can be any known
 workgroup in the net. The 'master' server should be the master browser for
@@ -146 +121 @@
 password combination.
 
+5. Debugging
+____________
+
+To produce a logfile please add an empty file called ndpsmb.dbg into the root drive.
+
+The logfile is placed to your LOGFILES env path, if available. If the LOGFILES env is missing
+the logfile is placed into the netdrive directory. The logfile is called ndpsmb.log.
+
+
 6. Changelog
 ____________
 
- beta3:
+ v1.0 beta3:
    - changelog created
    - fixed a bug with several network interfaces on one system
@@ -157 +141 @@
    - smbcd.exe compiled against old tcp/ip stack interface
 
- beta4:
+ v1.0 beta4:
    - fixed errors on write to eCs shares
    - more fixes for wrong dates of files
 
- beta5:
+ v1.0 beta5:
    - added file locking
    - added 64bit file IO (when working with NDFS 2.3+)
    - moved to 3.0.9 samba code
 
- beta6:
+ v1.0 beta6:
    - fixed set attribute bug introduced in beta 5
    - implemented setnewfilesize function. It may work not on all CIFS servers.
@@ -172 +156 @@
    - added 'logfile' and 'loglevel' options to ndpsmb
 
- beta7:
+ v1.0 beta7:
    - moved to libc06b4.dll libc.
 
- beta8:
+ v1.0 beta8:
    - moved back to libc custom build. 
    - added EA support
    - a bunch of bugs fixed
 
- beta9:
+ v1.0 beta9:
    - added EA support for DosOpen which was forgotten in beta8
 
- beta10:
+ v1.0 beta10:
    - caching of EA size after file find request
    - moved to libc06b5.dll libc
 
- beta11:
+ v1.0 beta11:
    - moved to libc06r1.dll libc
 
- beta12:
+ v1.0 beta12:
    - NdpRsrcQueryFSAllocate rewritten
    - moved to libc06.dll from GA2 release
 
- beta13, the lucky one:
+ v1.0 beta13, the lucky one:
    - moved to libc061.dll from CSD1 release
 
- beta14:
+ v1.0 beta14:
    - moved to libc custom build
+
+ v1.0 GA:
+   - changelog was not updated
+
+ v1.5.0 alpha1:
+   - smbdc.exe was implemented within ndpsmb.dll
+   - a lot of other changes
+
+ v1.5.0 beta1:
+   - logging feature rewritten
+   - fixed free disk space
+   - added more return codes in the mount part (for evfsgui)