| 1 | #include <nversion.h>
|
|---|
| 2 | Samba Client Plugin for <$OS>
|
|---|
| 3 | Version <$NDPSMB_VERSION> Build <$NDPSMB_BUILD>
|
|---|
| 4 | _______________________________________________
|
|---|
| 5 |
|
|---|
| 6 | CONTENTS
|
|---|
| 7 | ________
|
|---|
| 8 |
|
|---|
| 9 | 1. Introduction
|
|---|
| 10 | 2. License
|
|---|
| 11 | 3. Installation
|
|---|
| 12 | 3.1 <$ND>
|
|---|
| 13 | 3.2 EVFS
|
|---|
| 14 | 3.3 Uninstallation
|
|---|
| 15 | 4. NDPSMB.DLL usage
|
|---|
| 16 | 4.1 <$ND>
|
|---|
| 17 | 4.2 EVFS
|
|---|
| 18 | 5. Debugging
|
|---|
| 19 | 6. Changelog
|
|---|
| 20 |
|
|---|
| 21 |
|
|---|
| 22 | 1. Introduction
|
|---|
| 23 | _______________
|
|---|
| 24 |
|
|---|
| 25 | Samba is a SMB/CIFS protocols file and print sharing server/client suite
|
|---|
| 26 | originally made for the UNIX world to cooperate with corresponding Windows and
|
|---|
| 27 | <$OS> servers or clients. <$OS> has a native implementation of SMB/CIFS
|
|---|
| 28 | server/client set - IBM LAN Manager and IBM Peer. These products haven't been
|
|---|
| 29 | updated for a long time and have some compatibility problems with modern
|
|---|
| 30 | Windows SMB/CIFS implementations.
|
|---|
| 31 |
|
|---|
| 32 | This package is the <$OS> port of Samba client made as the plugin for
|
|---|
| 33 |
|
|---|
| 34 | - <$ND> for <$OS> - a well known virtual file system for <$OS> or
|
|---|
| 35 | - EVFS - the eComStation Virtual Filesystem for SMB.
|
|---|
| 36 |
|
|---|
| 37 | <$OS> Samba client provides seamless access to SMB/CIFS file shares over
|
|---|
| 38 | your network using TCP/IP as the underlying transport protocol.
|
|---|
| 39 |
|
|---|
| 40 | The <$OS> Samba client consists of one module:
|
|---|
| 41 | ndpsmb.dll - the <$ND>/EVFS plugin itself.
|
|---|
| 42 |
|
|---|
| 43 | Releases prior to version 1.5.0 had a second module which is now deprecated:
|
|---|
| 44 | smbcd.exe - the Samba client daemon, which actually processes the requests
|
|---|
| 45 | from ndpsmb.dll
|
|---|
| 46 |
|
|---|
| 47 | 2. License
|
|---|
| 48 | __________
|
|---|
| 49 |
|
|---|
| 50 | Samba is freely available under the GNU General Public License. You can get
|
|---|
| 51 | the full sourcecode from our SVN repository, please refer to the Samba for
|
|---|
| 52 | <$OS> Homepage for details about downloading the source.
|
|---|
| 53 |
|
|---|
| 54 | The <$ND> plugin is also available with full sourcecode.
|
|---|
| 55 |
|
|---|
| 56 | So if you are using our plugin we kindly ask you to support either
|
|---|
| 57 | bww bitwise works or netlabs.org.
|
|---|
| 58 | Please refer to the Samba for <$OS> Homepage to learn how you can do that!
|
|---|
| 59 |
|
|---|
| 60 |
|
|---|
| 61 | Links:
|
|---|
| 62 |
|
|---|
| 63 | Samba for <$OS> Homepage: http://samba.netlabs.org/
|
|---|
| 64 | <$ND> Homepage: http://www.blueprintsoftwareworks.com/netdrive/
|
|---|
| 65 | Samba Homepage: http://www.samba.org/
|
|---|
| 66 |
|
|---|
| 67 |
|
|---|
| 68 | 3. Installation
|
|---|
| 69 | _______________
|
|---|
| 70 |
|
|---|
| 71 | The plugin needs the klibc runtime named libc06*.dll (the InnoTek GCC runtime
|
|---|
| 72 | DLL) in your LIBPATH, it might be there already, as it comes with any
|
|---|
| 73 | eComStation release.
|
|---|
| 74 | The plugin requires the 32 bit TCP/IP stack. This stack comes with all
|
|---|
| 75 | eComStation releases. If you have still the 16 bit stack, please search the
|
|---|
| 76 | net for the 32 bit stack.
|
|---|
| 77 |
|
|---|
| 78 | 3.1 <$ND>
|
|---|
| 79 | ____________
|
|---|
| 80 |
|
|---|
| 81 | You must have <$ND> 2.2.1 or newer installed prior to installation of this
|
|---|
| 82 | package. If you want to use 64bit file API, you should install 2.3 or newer
|
|---|
| 83 | version of <$ND>. The installation is semi-automatic and consists of the
|
|---|
| 84 | following:
|
|---|
| 85 |
|
|---|
| 86 | - ndpsmb.dll installation :
|
|---|
| 87 | Run instpl.cmd from this package. It will place all files to the <$ND>
|
|---|
| 88 | plugin directory.
|
|---|
| 89 |
|
|---|
| 90 | 3.2 EVFS
|
|---|
| 91 | ________
|
|---|
| 92 |
|
|---|
| 93 | - ndpsmb.dll installation :
|
|---|
| 94 | Put ndpsmb.dll into x:\ecs\dll (where x: is your bootdrive)
|
|---|
| 95 |
|
|---|
| 96 | 3.3 Uninstallation
|
|---|
| 97 | __________________
|
|---|
| 98 |
|
|---|
| 99 | Run the uninstpl.cmd script in order to deinstall the plugin again.
|
|---|
| 100 | This will work for both EVFS and <$ND>.
|
|---|
| 101 |
|
|---|
| 102 |
|
|---|
| 103 | 4. NDPSMB.DLL
|
|---|
| 104 | _____________
|
|---|
| 105 |
|
|---|
| 106 | 4.1. Usage with <$ND>
|
|---|
| 107 | ______________________
|
|---|
| 108 |
|
|---|
| 109 | <$ND> Samba plugin is used according to general <$ND> usage rules. Read
|
|---|
| 110 | the <$ND> documentation for more information. The SMB/CIFS resources could
|
|---|
| 111 | be mounted either using command line nd.exe utility or WPS ndpm.exe utility
|
|---|
| 112 | of <$ND>.
|
|---|
| 113 |
|
|---|
| 114 | The <$ND> Samba plugin parameters are:
|
|---|
| 115 |
|
|---|
| 116 | workgroup - the name of workgroup to connect to.
|
|---|
| 117 | server - the name of server to connect to.
|
|---|
| 118 | share - the name of server resource (share) to connect to.
|
|---|
| 119 | user - the name of user to login under.
|
|---|
| 120 | password - the password of selected user.
|
|---|
| 121 | master - the name of 'master' server or workgroup, used to get the
|
|---|
| 122 | list of workgroups when the concrete workgroup and server
|
|---|
| 123 | not specified.
|
|---|
| 124 | masterttype - 0 if 'master' is the name of master server, 1 if 'master'
|
|---|
| 125 | is the name of master workgroup.
|
|---|
| 126 | cache timeout - the time in seconds for which the cache is valid. If the
|
|---|
| 127 | time is over the client rereads the directory again. For a
|
|---|
| 128 | directory with many files it may be better to increase the
|
|---|
| 129 | timeout. (rule of thumb: per 500-800 files 10 seconds).
|
|---|
| 130 | Default: 10 seconds
|
|---|
| 131 | cache listings- the amount of directories the cache should hold. Be aware:
|
|---|
| 132 | the higher the value the more memory is used.
|
|---|
| 133 | Default: 32 listings
|
|---|
| 134 | easupport - 1 to support <$OS> Extended Attributes, 0 to not support it
|
|---|
| 135 | r/w - define whether the resource should be read-only (r) or
|
|---|
| 136 | writeable (w)
|
|---|
| 137 | loglevel - determines the ammount of information writte into a logfile
|
|---|
| 138 |
|
|---|
| 139 | To mount the exact server's share one need to specify both 'server' and
|
|---|
| 140 | 'share' parameters, the other parameters are optional. The root path of
|
|---|
| 141 | server's share will be mounted to the mounting path.
|
|---|
| 142 |
|
|---|
| 143 | If one want to access all server shares, then only the 'server', not the
|
|---|
| 144 | 'share' parameter, should be specified,the other parameters are optional.
|
|---|
| 145 | The list of server shares will be mounted to the mounting path.
|
|---|
| 146 |
|
|---|
| 147 | If one want to access all servers within the workgroup, then only the
|
|---|
| 148 | 'workgroup', not the 'server' parameter, should be specified, the other
|
|---|
| 149 | parameters are optional. The list of servers within the specified workgroup
|
|---|
| 150 | will be mounted to the mounting path.
|
|---|
| 151 |
|
|---|
| 152 | If one want to access all available workgroups within one master browser
|
|---|
| 153 | within the network, then only the 'master', not the 'workgroup' nor the
|
|---|
| 154 | 'server' parameter, should be specified, the other parameters are optional.
|
|---|
| 155 | The list of workgroups will be mounted to the mounting path. The 'master'
|
|---|
| 156 | workgroup can be any known workgroup in the net. The 'master' server should
|
|---|
| 157 | be the master browser for workgroup[s].
|
|---|
| 158 |
|
|---|
| 159 | By default the 'guest' user with blank password is used to access selected
|
|---|
| 160 | resources. If you get access denied errors, try to specify another user
|
|---|
| 161 | and password combination.
|
|---|
| 162 |
|
|---|
| 163 | 4.2 Usage with EVFS
|
|---|
| 164 | ___________________
|
|---|
| 165 |
|
|---|
| 166 | eComStation comes with a GUI program named EVFSGUI which is even more feature
|
|---|
| 167 | rich than the <$ND> GUI. EFVSGUI can also be used together with <$ND>.
|
|---|
| 168 | Refer to the documentaion that comes with eCS.
|
|---|
| 169 |
|
|---|
| 170 | 5. Debugging
|
|---|
| 171 | ____________
|
|---|
| 172 |
|
|---|
| 173 | In order to produce a logfile, choose the appropriate loglevel in the login
|
|---|
| 174 | dialogue.
|
|---|
| 175 |
|
|---|
| 176 | 0 = do not log 2 = log a little 5 = log quite some stuff 10 = log everything.
|
|---|
| 177 |
|
|---|
| 178 | The logfile is placed into your LOGFILES env path, if available. If the
|
|---|
| 179 | LOGFILES environment variable is missing, the logfile is placed into the
|
|---|
| 180 | <$ND> directory. The logfile is called log.ndpsmb.SHARE for the <$ND> part
|
|---|
| 181 | and log.smbc.SHARE for the Samba part. SHARE is the name of the connected share.
|
|---|
| 182 |
|
|---|
| 183 |
|
|---|
| 184 | 6. Changelog
|
|---|
| 185 | ____________
|
|---|
| 186 |
|
|---|
| 187 | #include <changelog.txt>
|
|---|
