| 1 | #include "version.h"
|
|---|
| 2 |
|
|---|
| 3 | :userdoc.
|
|---|
| 4 |
|
|---|
| 5 | .nameit symbol=os text='eCS (OS/2)'
|
|---|
| 6 | .nameit symbol=nd text='NetDrive for &os.'
|
|---|
| 7 | .nameit symbol=ndcp text='NetDrive for &os. Control Panel'
|
|---|
| 8 | .nameit symbol=mp text='mount point'
|
|---|
| 9 | .nameit symbol=ressmb text='Samba Resource Properties'
|
|---|
| 10 | .nameit symbol=usage text='Usage'
|
|---|
| 11 | .nameit symbol=build text='Samba Client Plugin for &os. version <$NDPSMB_VERSION> build <$NDPSMB_BUILD>'
|
|---|
| 12 |
|
|---|
| 13 | :title.NetDrive for &os. Control Panel Help
|
|---|
| 14 |
|
|---|
| 15 | :docprof toc=123456.
|
|---|
| 16 | .******************************************************
|
|---|
| 17 | :h1.Introduction
|
|---|
| 18 | :p.
|
|---|
| 19 | Samba is a SMB/CIFS protocols file and print sharing server/client suite originaly
|
|---|
| 20 | made for the UNIX world to cooperate with corresponding Windows and &os. servers or
|
|---|
| 21 | clients. &os. has a native implementation of SMB/CIFS server/client set - IBM LAN
|
|---|
| 22 | Manager and IBM Peer. These products haven&csq.t been updated for a long time and
|
|---|
| 23 | have some compatibility problems with modern Windows SMB/CIFS implementations.
|
|---|
| 24 | :p.
|
|---|
| 25 | This package is the &os. port of Samba client made as the plugin for&colon.
|
|---|
| 26 | :ul.
|
|---|
| 27 | :li.&nd. - a well known virtual file system for &os.
|
|---|
| 28 | :li.EVFS - the eComStation Virtual Filesystem for SMB
|
|---|
| 29 | :eul.:p.
|
|---|
| 30 | &os. Samba client provides seamless access to SMB/CIFS file shares over your network using TCP/IP as the
|
|---|
| 31 | underlying transport protocol.
|
|---|
| 32 | :p.
|
|---|
| 33 | The &os. Samba client consists of one module&colon.
|
|---|
| 34 | :ul.
|
|---|
| 35 | :li.ndpsmb.dll - the NetDrive plugin itself
|
|---|
| 36 | :eul.:p.
|
|---|
| 37 | Releases prior to version 1.5.0 had a second module which is now deprecated&colon.
|
|---|
| 38 | :ul.
|
|---|
| 39 | :li.smbcd.exe - the Samba client daemon, which actually processes the requests from ndpsmb.dll
|
|---|
| 40 | :eul.
|
|---|
| 41 | .******************************************************
|
|---|
| 42 | :h1.License
|
|---|
| 43 | :p.
|
|---|
| 44 | Samba is freely available under the GNU General Public License. You can get
|
|---|
| 45 | the full sourcecode from our SVN repository, please refer to the Samba for &os. Homepage for details about downloading the source.
|
|---|
| 46 | :p.
|
|---|
| 47 | The NetDrive plugin for &os. is also available with full sourcecode.
|
|---|
| 48 | :p.
|
|---|
| 49 | So if you are using our plugin we kindly ask you to support netlabs.org.
|
|---|
| 50 | Please refer to the Samba for &os. Homepage to learn how you can do
|
|---|
| 51 | that!
|
|---|
| 52 | :h2 res=003.Links
|
|---|
| 53 | :p.
|
|---|
| 54 | :ul.
|
|---|
| 55 | :li.Samba for &os. Homepage (http&colon.&slr.&slr.samba.netlabs.org)
|
|---|
| 56 | :li.NetDrive Homepage (http&colon.&slr.&slr.www.blueprintsoftwareworks.com&slr.netdrive)
|
|---|
| 57 | :li.Samba Homepage (http&colon.&slr.&slr.www.samba.org)
|
|---|
| 58 | :eul.
|
|---|
| 59 | .*******************************************************
|
|---|
| 60 | :h1 res=1000 group=2 x=left y=top width=100% height=100% scroll=both.&ressmb.
|
|---|
| 61 | :i1 id=ressmb.&ressmb.
|
|---|
| 62 | :ul.
|
|---|
| 63 | :li.:link reftype=hd res=100.&ressmb.:elink.
|
|---|
| 64 | :li.:link reftype=hd res=101.&usage.:elink.
|
|---|
| 65 | :eul.
|
|---|
| 66 | :h2 res=100.&ressmb.
|
|---|
| 67 | :p.
|
|---|
| 68 | The parameters of a SMB/CIFS FS resource are&colon.
|
|---|
| 69 | :parml.
|
|---|
| 70 | :pt.Workgroup
|
|---|
| 71 | :pd.The name of workgroup to connect to.
|
|---|
| 72 |
|
|---|
| 73 | :pt.Server
|
|---|
| 74 | :pd.The name or IP address of server to connect to.
|
|---|
| 75 |
|
|---|
| 76 | :pt.Share
|
|---|
| 77 | :pd.The name of server resource (share) to connect to.
|
|---|
| 78 |
|
|---|
| 79 | :pt.User
|
|---|
| 80 | :pd.The name of user to login under.
|
|---|
| 81 |
|
|---|
| 82 | :pt.Password
|
|---|
| 83 | :pd.The password of selected user.
|
|---|
| 84 |
|
|---|
| 85 | :pt.Master
|
|---|
| 86 | :pd.the name of 'master' server or workgroup, used to get the list of workgroups when the concrete workgroup and server not specified.
|
|---|
| 87 |
|
|---|
| 88 | :pt.Mastertype
|
|---|
| 89 | :pd.0 if 'master' is the name of master server, 1 if 'master' is the name of master workgroup.
|
|---|
| 90 |
|
|---|
| 91 | :pt.EA Support
|
|---|
| 92 | :pd.1 to support eCS (OS/2) Extended Attributes, 0 to not support it.
|
|---|
| 93 |
|
|---|
| 94 | :pt.Cache timeout
|
|---|
| 95 | :pd.The time in seconds for which the cache is valid. If the time is over the client rereads the directory again. For a directory with many
|
|---|
| 96 | files it may be better to increase the timeout (rule of thumb: per 500-800 files 10 seconds). Default: 10 seconds
|
|---|
| 97 |
|
|---|
| 98 | :pt.Cache listings
|
|---|
| 99 | :pd.The amount of directories the cache should hold. Be aware the higher the value the more memory is used. Default: 32 listings
|
|---|
| 100 | :eparml.
|
|---|
| 101 | .******************************************************
|
|---|
| 102 | :h2 res=101.&usage.
|
|---|
| 103 | :p.
|
|---|
| 104 | To mount the exact server&csq.s share one need to specify both &csq.server&csq. and
|
|---|
| 105 | &csq.share&csq. parameters, the other parameters are optional. The root path of
|
|---|
| 106 | server&csq.s share will be mounted to the mounting path.
|
|---|
| 107 | :p.
|
|---|
| 108 | If one want to access all server shares, then only the &csq.server&csq., not the &csq.share&csq.
|
|---|
| 109 | parameter, should be specified,the other parameters are optional. The list of
|
|---|
| 110 | server shares will be mounted to the mounting path.
|
|---|
| 111 | :p.
|
|---|
| 112 | If one want to access all servers within the workgroup, then only the &csq.workgroup&csq.,
|
|---|
| 113 | not the &csq.server&csq. parameter, should be specified, the other parameters are
|
|---|
| 114 | optional. The list of servers within the specified workgroup will be mounted to
|
|---|
| 115 | the mounting path.
|
|---|
| 116 | :p.
|
|---|
| 117 | If one want to access all available workgroups within one master browser
|
|---|
| 118 | within the network, then only the &csq.master&csq., not the &csq.workgroup&csq. nor the &csq.server&csq. parameter,
|
|---|
| 119 | should be specified, the other parameters are optional. The list of workgroups
|
|---|
| 120 | will be mounted to the mounting path. The &csq.master&csq. workgroup can be any known
|
|---|
| 121 | workgroup in the net. The &csq.master&csq. server should be the master browser for
|
|---|
| 122 | workgroup[s].
|
|---|
| 123 | :p.
|
|---|
| 124 | By default the &csq.guest&csq. user with blank password is used to access selected
|
|---|
| 125 | resources. If you get access denied errors, try to specify another user and
|
|---|
| 126 | password combination.
|
|---|
| 127 |
|
|---|
| 128 | .******************************************************
|
|---|
| 129 | :h1.Version
|
|---|
| 130 | :p.
|
|---|
| 131 | &build.
|
|---|
| 132 | :h1.Debugging
|
|---|
| 133 | :p.
|
|---|
| 134 | To produce a logfile please add an empty file called ndpsmb.dbg into the root drive.
|
|---|
| 135 | :p.
|
|---|
| 136 | The logfile is placed to your LOGFILES env path, if available. If the LOGFILES env is missing
|
|---|
| 137 | the logfile is placed into the &nd. directory. The logfile is called log.ndpsmb for the &nd. part and
|
|---|
| 138 | log.smbd for the Samba part.
|
|---|
| 139 |
|
|---|
| 140 | .******************************************************
|
|---|
| 141 | :h1.History
|
|---|
| 142 | :p.History of the Samba client for &nd.
|
|---|
| 143 | :ul.
|
|---|
| 144 | :li.:link reftype=hd res=011.Version 1.0:elink.
|
|---|
| 145 | :li.:link reftype=hd res=012.Version 1.5.0:elink.
|
|---|
| 146 | :li.:link reftype=hd res=013.Version 2.0.0:elink.
|
|---|
| 147 | :eul.
|
|---|
| 148 | :h2 res=011.Version 1.0
|
|---|
| 149 | :p.
|
|---|
| 150 | :ul.
|
|---|
| 151 | :li.beta3
|
|---|
| 152 | :ul.
|
|---|
| 153 | :li.changelog created
|
|---|
| 154 | :li.fixed a bug with several network interfaces on one system
|
|---|
| 155 | :li.fixed a bug with broken cmd.exe builtin commands
|
|---|
| 156 | :li.fixed a bug with wrong dates of new and modified files
|
|---|
| 157 | :li.fixed a bunch of other bugs which are too small to remember ;)
|
|---|
| 158 | :li.smbcd.exe compiled against old tcp/ip stack interface
|
|---|
| 159 | :eul.
|
|---|
| 160 | :li.beta4
|
|---|
| 161 | :ul.
|
|---|
| 162 | :li.fixed errors on write to eCs shares
|
|---|
| 163 | :li.more fixes for wrong dates of files
|
|---|
| 164 | :eul.
|
|---|
| 165 | :li.beta5
|
|---|
| 166 | :ul.
|
|---|
| 167 | :li.added file locking
|
|---|
| 168 | :li.added 64bit file IO (when working with NDFS 2.3+)
|
|---|
| 169 | :li.moved to 3.0.9 samba code.
|
|---|
| 170 | :eul.
|
|---|
| 171 | :li.beta6
|
|---|
| 172 | :ul.
|
|---|
| 173 | :li.fixed set attribute bug introduced in beta 5
|
|---|
| 174 | :li.implemented setnewfilesize function. It may work not on all CIFS servers.
|
|---|
| 175 | :li.added automatic smbcd.exe starting if not started when connecting to CIFS share
|
|---|
| 176 | :li.added 'logfile' and 'loglevel' options to ndpsmb
|
|---|
| 177 | :eul.
|
|---|
| 178 | :li.beta7
|
|---|
| 179 | :ul.
|
|---|
| 180 | :li.moved to libc06b4.dll libc.
|
|---|
| 181 | :eul.
|
|---|
| 182 | :li.beta8
|
|---|
| 183 | :ul.
|
|---|
| 184 | :li.moved back to libc custom build.
|
|---|
| 185 | :li.added EA support
|
|---|
| 186 | :li.a bunch of bugs fixed
|
|---|
| 187 | :eul.
|
|---|
| 188 | :li.beta9
|
|---|
| 189 | :ul.
|
|---|
| 190 | :li.added EA support for DosOpen which was forgotten in beta8
|
|---|
| 191 | :eul.
|
|---|
| 192 | :li.beta10
|
|---|
| 193 | :ul.
|
|---|
| 194 | :li.caching of EA size after file find request
|
|---|
| 195 | :li.moved to libc06b5.dll libc
|
|---|
| 196 | :eul.
|
|---|
| 197 | :li.beta11
|
|---|
| 198 | :ul.
|
|---|
| 199 | :li.moved to libc06r1.dll libc
|
|---|
| 200 | :eul.
|
|---|
| 201 | :li.beta12
|
|---|
| 202 | :ul.
|
|---|
| 203 | :li.NdpRsrcQueryFSAllocate rewritten
|
|---|
| 204 | :li.moved to libc06.dll from GA2 release
|
|---|
| 205 | :eul.
|
|---|
| 206 | :li.beta13 (the lucky one)
|
|---|
| 207 | :ul.
|
|---|
| 208 | :li.moved to libc061.dll from CSD1 release
|
|---|
| 209 | :eul.
|
|---|
| 210 | :li.beta14
|
|---|
| 211 | :ul.
|
|---|
| 212 | :li.moved to libc custom build
|
|---|
| 213 | :eul.
|
|---|
| 214 | :li.GA
|
|---|
| 215 | :ul.
|
|---|
| 216 | :li.changelog was not updated
|
|---|
| 217 | :eul.
|
|---|
| 218 | :eul.
|
|---|
| 219 | :h2 res=012.Version 1.5.0
|
|---|
| 220 | :ul.
|
|---|
| 221 | :li.alpha1
|
|---|
| 222 | :ul.
|
|---|
| 223 | :li.smbdc.exe was implemented within ndpsmb.dll
|
|---|
| 224 | :li.a lot of other changes
|
|---|
| 225 | :eul.
|
|---|
| 226 | :li.beta1
|
|---|
| 227 | :ul.
|
|---|
| 228 | :li.logging feature rewritten
|
|---|
| 229 | :li.fixed free disk space
|
|---|
| 230 | :li.added more return codes in the mount part (for evfsgui)
|
|---|
| 231 | :eul.
|
|---|
| 232 | :li.beta2
|
|---|
| 233 | :ul.
|
|---|
| 234 | :li.update to Samba 3.0.35 client code
|
|---|
| 235 | :eul.
|
|---|
| 236 | :li.beta3
|
|---|
| 237 | :ul.
|
|---|
| 238 | :li.update to Samba 3.0.36 client code
|
|---|
| 239 | :li.codepage fix for system running non IBM-850 codepages (Ticket #100)
|
|---|
| 240 | :eul.
|
|---|
| 241 | :li.beta4
|
|---|
| 242 | :ul.
|
|---|
| 243 | :li.update to Samba 3.0.37 client code
|
|---|
| 244 | :li.codepage fix for Ticket #68
|
|---|
| 245 | :eul.
|
|---|
| 246 | :li.GA
|
|---|
| 247 | :ul.
|
|---|
| 248 | :li.Fix memory leak in EA code
|
|---|
| 249 | :li.Ticket #111
|
|---|
| 250 | :li.Remove unused MEMLEN, LOGFILE and LOGLEVEL token:p.
|
|---|
| 251 | (Compatibility warning: These tokens must also be removed from older *.ndc *.evp and volumes.cfg files in order to restore connections with the new plugin properly)
|
|---|
| 252 | :li.added logging feature for samba messages
|
|---|
| 253 | :eul.
|
|---|
| 254 | :li.1.5.1
|
|---|
| 255 | :ul.
|
|---|
| 256 | :li.Fix crash on quadcore machines
|
|---|
| 257 | :eul.
|
|---|
| 258 | :li.1.5.2
|
|---|
| 259 | :ul.
|
|---|
| 260 | :li.Fix help files
|
|---|
| 261 | :eul.
|
|---|
| 262 | :li.1.5.3
|
|---|
| 263 | :ul.
|
|---|
| 264 | :li.Fix timestamp problem
|
|---|
| 265 | :eul.
|
|---|
| 266 | :eul.
|
|---|
| 267 | :h2 res=013.Version 2.0.0
|
|---|
| 268 | :ul.
|
|---|
| 269 | :li.beta1
|
|---|
| 270 | :ul.
|
|---|
| 271 | :li.added dir caching
|
|---|
| 272 | :eul.
|
|---|
| 273 | :li.beta2
|
|---|
| 274 | :ul.
|
|---|
| 275 | :li.read problem of small files fixed
|
|---|
| 276 | :li.delete cache of changed files
|
|---|
| 277 | :li.SIGPIPE crash fixed
|
|---|
| 278 | :eul.
|
|---|
| 279 | :li.beta3
|
|---|
| 280 | :ul.
|
|---|
| 281 | :li.changed instpl.cmd to work correct with nls
|
|---|
| 282 | :li.added the possibility to adjust cache timeout and depth via GUI
|
|---|
| 283 | :li.adjustments to helpfile and readme
|
|---|
| 284 | :eul.
|
|---|
| 285 | :li.beta4
|
|---|
| 286 | :ul.
|
|---|
| 287 | :li.possible SIGPIPE crashes redone (thanks to Vitali)
|
|---|
| 288 | :li.touch did not delete the cache
|
|---|
| 289 | :eul.
|
|---|
| 290 | :eul.
|
|---|
| 291 | .******************************************************
|
|---|
| 292 | :h1.Credit
|
|---|
| 293 | :ul.
|
|---|
| 294 | :li.Paul Smedley (aka Smedles)
|
|---|
| 295 | :li.Yuri Dario (aka Paperino)
|
|---|
| 296 | :li.Herwig Bauernfeind (aka HerwigB)
|
|---|
| 297 | :li.Silvan Scherrer (aka diver)
|
|---|
| 298 | :li.Alex Taylor (aka AlexT)
|
|---|
| 299 | :li.Nikolay Kolosov (aka nickk)
|
|---|
| 300 | :li.Vitali Pelenyov (aka sunlover)
|
|---|
| 301 | :li.and all we missed
|
|---|
| 302 | :eul.
|
|---|
| 303 | .******************************************************
|
|---|
| 304 |
|
|---|
| 305 | :euserdoc.
|
|---|
