| 1 | Samba Client Plugin for eCS (OS/2)
|
|---|
| 2 | Version _VERSION_
|
|---|
| 3 | Build _BUILD_
|
|---|
| 4 | __________________________________
|
|---|
| 5 |
|
|---|
| 6 | CONTENTS
|
|---|
| 7 | ________
|
|---|
| 8 |
|
|---|
| 9 | 1. Introduction
|
|---|
| 10 | 2. License
|
|---|
| 11 | 3. Installation
|
|---|
| 12 | 3.1 Netdrive
|
|---|
| 13 | 3.2 EVFS
|
|---|
| 14 | 4. NDPSMB.DLL usage
|
|---|
| 15 | 4.1 Netdrive
|
|---|
| 16 | 4.2 EVFS
|
|---|
| 17 | 5. Debugging
|
|---|
| 18 | 6. Changelog
|
|---|
| 19 |
|
|---|
| 20 |
|
|---|
| 21 | 1. Introduction
|
|---|
| 22 | _______________
|
|---|
| 23 |
|
|---|
| 24 | Samba is a SMB/CIFS protocols file and print sharing server/client suite
|
|---|
| 25 | originally made for the UNIX world to cooperate with corresponding Windows and
|
|---|
| 26 | eCS (OS/2) servers or clients. eCS (OS/2) has a native implementation of SMB/CIFS
|
|---|
| 27 | server/client set - IBM LAN Manager and IBM Peer. These products haven't been
|
|---|
| 28 | updated for a long time and have some compatibility problems with modern
|
|---|
| 29 | Windows SMB/CIFS implementations.
|
|---|
| 30 |
|
|---|
| 31 | This package is the eCS (OS/2) port of Samba client made as the plugin for
|
|---|
| 32 |
|
|---|
| 33 | - NetDrive for eCS (OS/2) - a well known virtual file system for eCS (OS/2) or
|
|---|
| 34 | - EVFS - the eComStation Virtual Filesystem for SMB.
|
|---|
| 35 |
|
|---|
| 36 | eCS (OS/2) Samba client provides seamless access to SMB/CIFS file shares over
|
|---|
| 37 | your network using TCP/IP as the underlying transport protocol.
|
|---|
| 38 |
|
|---|
| 39 | The eCS (OS/2) Samba client consists of one module:
|
|---|
| 40 | ndpsmb.dll - the NetDrive/EVFS plugin itself.
|
|---|
| 41 |
|
|---|
| 42 | Releases prior to version 1.5.0 had a second module which is now deprecated:
|
|---|
| 43 | smbcd.exe - the Samba client daemon, which actually processes the requests
|
|---|
| 44 | from ndpsmb.dll
|
|---|
| 45 |
|
|---|
| 46 | 2. License
|
|---|
| 47 | __________
|
|---|
| 48 |
|
|---|
| 49 | Samba is freely available under the GNU General Public License. You can get
|
|---|
| 50 | the full sourcecode from our SVN repository, please refer to the Samba for
|
|---|
| 51 | eCS (OS/2) Homepage for details about downloading the source.
|
|---|
| 52 |
|
|---|
| 53 | The NetDrive plugin is also available with full sourcecode.
|
|---|
| 54 |
|
|---|
| 55 | So if you are using our plugin we kindly ask you to support netlabs.org.
|
|---|
| 56 | Please refer to the Samba for eCS (OS/2) Homepage to learn how you can do
|
|---|
| 57 | that!
|
|---|
| 58 |
|
|---|
| 59 |
|
|---|
| 60 | Links:
|
|---|
| 61 |
|
|---|
| 62 | Samba for eCS (OS/2) Homepage: http://samba.netlabs.org/
|
|---|
| 63 | NetDrive Homepage: http://www.blueprintsoftwareworks.com/netdrive/
|
|---|
| 64 | Samba Homepage: http://www.samba.org/
|
|---|
| 65 |
|
|---|
| 66 |
|
|---|
| 67 | 3. Installation
|
|---|
| 68 | _______________
|
|---|
| 69 |
|
|---|
| 70 | The plugin needs the klibc runtime named libc06*.dll (the innotek gcc runtime
|
|---|
| 71 | DLL) somewhere in your LIBPATH, if it is not there already (It comes with any
|
|---|
| 72 | recent eComStation release).
|
|---|
| 73 | The plugin needs the 32 bit TCP/IP stack. This stack comes with all eComStation
|
|---|
| 74 | releases. If you have still the 16 bit stack, please search the net for the 32 bit stack.
|
|---|
| 75 |
|
|---|
| 76 | 3.1 Netdrive
|
|---|
| 77 | ____________
|
|---|
| 78 |
|
|---|
| 79 | You must have NetDrive 2.2.1 or newer installed prior to installation of this
|
|---|
| 80 | package. If you want to use 64bit file API, you should install 2.3 or newer
|
|---|
| 81 | version of NetDrive. The installation is semi-automatic and consists of the
|
|---|
| 82 | following:
|
|---|
| 83 |
|
|---|
| 84 | - ndpsmb.dll installation :
|
|---|
| 85 | Run instpl.cmd from this package. It will place all files to the netdrive
|
|---|
| 86 | plugin directory.
|
|---|
| 87 |
|
|---|
| 88 | 3.2 EVFS
|
|---|
| 89 | ________
|
|---|
| 90 |
|
|---|
| 91 | - ndpsmb.dll installation :
|
|---|
| 92 | Put ndpsmb.dll into x:\ecs\dll (where x: is your bootdrive)
|
|---|
| 93 |
|
|---|
| 94 |
|
|---|
| 95 | 4. NDPSMB.DLL
|
|---|
| 96 | _____________
|
|---|
| 97 |
|
|---|
| 98 |
|
|---|
| 99 | 4.1. Usage with Netdrive
|
|---|
| 100 | ______________________
|
|---|
| 101 |
|
|---|
| 102 | NetDrive Samba plugin is used according to general NetDrive usage rules. Read
|
|---|
| 103 | the NetDrive documentation for more information. The SMB/CIFS resources could
|
|---|
| 104 | be mounted either using command line nd.exe utility or WPS ndpm.exe utility of
|
|---|
| 105 | NetDrive.
|
|---|
| 106 |
|
|---|
| 107 | The NetDrive Samba plugin parameters are:
|
|---|
| 108 |
|
|---|
| 109 | workgroup - the name of workgroup to connect to.
|
|---|
| 110 | server - the name of server to connect to.
|
|---|
| 111 | share - the name of server resource (share) to connect to.
|
|---|
| 112 | user - the name of user to login under.
|
|---|
| 113 | password - the password of selected user.
|
|---|
| 114 | master - the name of 'master' server or workgroup, used to get the list
|
|---|
| 115 | of workgroups when the concrete workgroup and server not
|
|---|
| 116 | specified.
|
|---|
| 117 | masterttype - 0 if 'master' is the name of master server, 1 if 'master' is
|
|---|
| 118 | the name of master workgroup.
|
|---|
| 119 | easupport - 1 to support eCS (OS/2) Extended Attributes, 0 to not support it
|
|---|
| 120 | cache timeout - the time in seconds for which the cache is valid. If the time is
|
|---|
| 121 | over the client rereads the directory again. For a directory with
|
|---|
| 122 | many files it may be better to increase the timeout.
|
|---|
| 123 | (rule of thumb: per 500-800 files 10 seconds). Default: 10 seconds
|
|---|
| 124 | cache listings- the amount of directories the cache should hold. Be aware the higher
|
|---|
| 125 | the value the more memory is used. Default: 32 listings
|
|---|
| 126 |
|
|---|
| 127 | To mount the exact server's share one need to specify both 'server' and
|
|---|
| 128 | 'share' parameters, the other parameters are optional. The root path of
|
|---|
| 129 | server's share will be mounted to the mounting path.
|
|---|
| 130 |
|
|---|
| 131 | If one want to access all server shares, then only the 'server', not the 'share'
|
|---|
| 132 | parameter, should be specified,the other parameters are optional. The list of
|
|---|
| 133 | server shares will be mounted to the mounting path.
|
|---|
| 134 |
|
|---|
| 135 | If one want to access all servers within the workgroup, then only the 'workgroup',
|
|---|
| 136 | not the 'server' parameter, should be specified, the other parameters are
|
|---|
| 137 | optional. The list of servers within the specified workgroup will be mounted to
|
|---|
| 138 | the mounting path.
|
|---|
| 139 |
|
|---|
| 140 | If one want to access all available workgroups within one master browser
|
|---|
| 141 | within the network, then only the 'master', not the 'workgroup' nor the 'server' parameter,
|
|---|
| 142 | should be specified, the other parameters are optional. The list of workgroups
|
|---|
| 143 | will be mounted to the mounting path. The 'master' workgroup can be any known
|
|---|
| 144 | workgroup in the net. The 'master' server should be the master browser for
|
|---|
| 145 | workgroup[s].
|
|---|
| 146 |
|
|---|
| 147 | By default the 'guest' user with blank password is used to access selected
|
|---|
| 148 | resources. If you get access denied (5) errors, try to specify another user
|
|---|
| 149 | and password combination.
|
|---|
| 150 |
|
|---|
| 151 | 4.2 Usage with EVFS
|
|---|
| 152 | ___________________
|
|---|
| 153 |
|
|---|
| 154 | eComStation comes with a GUI program named EVFSGUI which is even more feature
|
|---|
| 155 | rich than the Netdrive GUI. Refer to the documentaion that comes with eCS.
|
|---|
| 156 |
|
|---|
| 157 | 5. Debugging
|
|---|
| 158 | ____________
|
|---|
| 159 |
|
|---|
| 160 | To produce a logfile please add an empty file called ndpsmb.dbg into the
|
|---|
| 161 | root drive.
|
|---|
| 162 |
|
|---|
| 163 | The logfile is placed to your LOGFILES env path, if available. If the
|
|---|
| 164 | LOGFILES environment variable is missing, the logfile is placed into the
|
|---|
| 165 | Netdrive directory. The logfile is called log.ndpsmb for the Netdrive part
|
|---|
| 166 | and log.smbc for the Samba part.
|
|---|
| 167 |
|
|---|
| 168 |
|
|---|
| 169 | 6. Changelog
|
|---|
| 170 | ____________
|
|---|
| 171 |
|
|---|
| 172 | v1.0 beta3:
|
|---|
| 173 | - changelog created
|
|---|
| 174 | - fixed a bug with several network interfaces on one system
|
|---|
| 175 | - fixed a bug with broken cmd.exe builtin commands
|
|---|
| 176 | - fixed a bug with wrong dates of new and modified files
|
|---|
| 177 | - fixed a bunch of other bugs which are too small to remember ;)
|
|---|
| 178 | - smbcd.exe compiled against old tcp/ip stack interface
|
|---|
| 179 |
|
|---|
| 180 | v1.0 beta4:
|
|---|
| 181 | - fixed errors on write to eCs shares
|
|---|
| 182 | - more fixes for wrong dates of files
|
|---|
| 183 |
|
|---|
| 184 | v1.0 beta5:
|
|---|
| 185 | - added file locking
|
|---|
| 186 | - added 64bit file IO (when working with NDFS 2.3+)
|
|---|
| 187 | - moved to 3.0.9 samba code
|
|---|
| 188 |
|
|---|
| 189 | v1.0 beta6:
|
|---|
| 190 | - fixed set attribute bug introduced in beta 5
|
|---|
| 191 | - implemented setnewfilesize function. It may work not on all CIFS servers.
|
|---|
| 192 | - added automatic smbcd.exe starting if not started when connecting to CIFS share
|
|---|
| 193 | - added 'logfile' and 'loglevel' options to ndpsmb
|
|---|
| 194 |
|
|---|
| 195 | v1.0 beta7:
|
|---|
| 196 | - moved to libc06b4.dll libc.
|
|---|
| 197 |
|
|---|
| 198 | v1.0 beta8:
|
|---|
| 199 | - moved back to libc custom build.
|
|---|
| 200 | - added EA support
|
|---|
| 201 | - a bunch of bugs fixed
|
|---|
| 202 |
|
|---|
| 203 | v1.0 beta9:
|
|---|
| 204 | - added EA support for DosOpen which was forgotten in beta8
|
|---|
| 205 |
|
|---|
| 206 | v1.0 beta10:
|
|---|
| 207 | - caching of EA size after file find request
|
|---|
| 208 | - moved to libc06b5.dll libc
|
|---|
| 209 |
|
|---|
| 210 | v1.0 beta11:
|
|---|
| 211 | - moved to libc06r1.dll libc
|
|---|
| 212 |
|
|---|
| 213 | v1.0 beta12:
|
|---|
| 214 | - NdpRsrcQueryFSAllocate rewritten
|
|---|
| 215 | - moved to libc06.dll from GA2 release
|
|---|
| 216 |
|
|---|
| 217 | v1.0 beta13, the lucky one:
|
|---|
| 218 | - moved to libc061.dll from CSD1 release
|
|---|
| 219 |
|
|---|
| 220 | v1.0 beta14:
|
|---|
| 221 | - moved to libc custom build
|
|---|
| 222 |
|
|---|
| 223 | v1.0 GA:
|
|---|
| 224 | - changelog was not updated
|
|---|
| 225 |
|
|---|
| 226 | v1.5.0 alpha1:
|
|---|
| 227 | - smbdc.exe was implemented within ndpsmb.dll
|
|---|
| 228 | - a lot of other changes
|
|---|
| 229 |
|
|---|
| 230 | v1.5.0 beta1:
|
|---|
| 231 | - logging feature rewritten
|
|---|
| 232 | - fixed free disk space
|
|---|
| 233 | - added more return codes in the mount part (for evfsgui)
|
|---|
| 234 |
|
|---|
| 235 | v1.5.0 beta2:
|
|---|
| 236 | - update to Samba 3.0.35 client code
|
|---|
| 237 |
|
|---|
| 238 | v1.5.0 beta3:
|
|---|
| 239 | - update to Samba 3.0.36 client code
|
|---|
| 240 | - codepage fix for system running
|
|---|
| 241 | non IBM-850 codepages (Ticket #100)
|
|---|
| 242 |
|
|---|
| 243 | v1.5.0 beta4:
|
|---|
| 244 | - update to Samba 3.0.37 client code
|
|---|
| 245 | - codepage fix for Ticket #68
|
|---|
| 246 |
|
|---|
| 247 | v1.5.0:
|
|---|
| 248 | - Fix memory leak in EA code
|
|---|
| 249 | - Ticket #111
|
|---|
| 250 | - Remove unused MEMLEN, LOGFILE and LOGLEVEL token
|
|---|
| 251 | (Compatibility warning: These tokens must also be removed from older
|
|---|
| 252 | *.ndc *.evp and volumes.cfg files in order to restore connections
|
|---|
| 253 | with the new plugin properly)
|
|---|
| 254 | - added logging feature for samba messages
|
|---|
| 255 |
|
|---|
| 256 | v1.5.1:
|
|---|
| 257 | - Fix crashes on quadcore machines
|
|---|
| 258 |
|
|---|
| 259 | v1.5.2:
|
|---|
| 260 | - Fix help files
|
|---|
| 261 |
|
|---|
| 262 | v1.5.3:
|
|---|
| 263 | - Fix timestamp problem
|
|---|
| 264 |
|
|---|
| 265 | v2.0.0 beta1:
|
|---|
| 266 | - added dir caching
|
|---|
| 267 |
|
|---|
| 268 | v2.0.0 beta2:
|
|---|
| 269 | - read problem of small files fixed
|
|---|
| 270 | - delete cache of changed files
|
|---|
| 271 | - SIGPIPE crash fixed
|
|---|
| 272 |
|
|---|
| 273 | v2.0.0 beta3:
|
|---|
| 274 | - changed instpl.cmd to work correct with nls
|
|---|
| 275 | - added the possibility to adjust cache timeout and depth via GUI
|
|---|
| 276 | - adjustments to helpfile and readme
|
|---|
| 277 |
|
|---|
| 278 | v2.0.0 beta4:
|
|---|
| 279 | - possible SIGPIPE crashes redone (thanks to Vitali)
|
|---|
| 280 | - touch did not delete the cache
|
|---|
| 281 |
|
|---|
| 282 | v2.1.0 alpha1:
|
|---|
| 283 | - moved to samba 3.3 source base
|
|---|
| 284 | - new merge of 2.0 code and 1.6 code
|
|---|
| 285 |
|
|---|
