1This is a prelodable shared library that provides SMB client services 2for existing executables. Using this you can simulate a smb 3filesystem. 4 5*** This is code under development. Some things don't work yet *** 6 7Currently this code has been tested on: 8 9- Linux 2.0 with glibc2 (RH5.1) 10- Linux 2.1 with glibc2 11- Solaris 2.5.1 with gcc 12- Solaris 2.6 with gcc 13- SunOS 4.1.3 with gcc 14- IRIX 6.4 with cc 15- OSF1 with gcc 16 17 18It probably won't run on other systems without some porting. If you 19have a different system then see the file PORTING. 20 21To use it you need to do this: 22 231) build smbwrapper.so using the command "make smbwrapper" 243) run smbsh 25 26You will be asked for a username and password. After that you will be 27returned to a shell prompt. It is actually a subshell running with 28smbwrapper enabled. 29 30Now try to access /smb/SERVER for some SMB server name and see what 31happens. If you use the -W option to set your workgroup or have 32workgroup set in your smb.conf then listing /smb/ should list all SMB 33servers in your workgroup. 34 35 36OPTIONS 37------- 38 39-U username 40 specify the username and optional password (as user%password) 41 42-d debug level 43 This is an integer that controls the internal debug level of smbw. It 44 defaults to 0, which means no debug info. 45 46-l logfile 47 The place where smbw debug logs are put. If this is not set then 48 stderr is used. 49 50-P prefix 51 The root of the SMB filesystem. This defaults to /smb/ but you can 52 set it to any name you like. 53 54-W workgroup 55 This is the workgroup used for browsing (ie. listing machines in the 56 /smb/ directory). It defaults to the one set in smb.conf. 57 58-R resolve order 59 This allows you to override the setting of the name resolve order 60 from smb.conf 61 62 63ATTRIBUTE MAPPING 64----------------- 65 66smbwrapper does an inverse attribute maping to what Samba does. This 67means that the archive bit appears as the user execute bit, the system 68bit appears as the group execute bit and the hidden bit appears as the 69other execute bit. You can control these with chmod. The mapping can 70be enabled an disabled using the normal smb.conf controls (ie. "map 71archive", "map system" and "map hidden"). 72 73Read-only files appear as non-writeable by everyone. Writeable files 74appear as writeable by the current user. 75 76 77WHAT WORKS 78---------- 79 80Things that I have tried and do seem to work include: 81 82 emacs, tar, ls, cmp, cp, rsync, du, cat, rm, mv, less, more, wc, head, 83 tail, bash, tcsh, mkdir, rmdir, vim, xedit, diff 84 85things that I know don't work: 86 87 anything executing from the share 88 anything that uses mmap 89 redirection within shells to smbsh files 90 91If you want to help with the development of this code then join the 92samba-technical mailing list. 93 94 95