Contributed software for Linux autofs support.

[sfrench/samba-autobuild/.git] / examples / autofs / mount-smb.doc

diff --git a/examples/autofs/mount-smb.doc b/examples/autofs/mount-smb.doc
new file mode 100644 (file)
index 0000000..7eee74f
--- /dev/null
+++ b/examples/autofs/mount-smb.doc
@@ -0,0 +1,65 @@
+Date:          Tue, 07 Apr 1998 
+Contributor:   Christoph L. Spiel <Christoph_Spiel@physik.tu-muenchen.de>
+Organization:  Munich Institute of Technology, Institute E10
+Subject:       WISHES:LINUX:smbmount
+===============================================================================
+Machine Arch: i386
+Machine OS: linux
+Kernel: 2.1.85
+Samba Version: Version 1.9.18p3
+Mount Version: 2.7i
+Autofs Version: 0.3.14
+
+
+Hi SAMBA developers!
+
+I have written a shell script that marries smbmount and mount
+on a Linux-machine with a 2.1.55+ kernel (i.e., a newer developper
+kernel.  Especially it makes smbmount compatible
+with autofs!  Now, You (when root :-) can say
+       mount -t smb /win-machine/my-share /mntpt
+Concerning the management of the user/password-pairs I have already
+made a step in the right direction, but there is still a lot of
+brain-work to do :-(
+
+The primary problem with the Win passwords
+is that they are under user-control, and not under admin-control
+as the Linux passwords are.  Therfore, I give every SAMBA user
+a
+       ~/smb-pass
+file where she can manage her usernames and passwords herself.
+The fundamental mount-tables /etc/fstab and /etc/auto.* only
+list the mount-point and the respective options.  The user´s
+password file is adressed via the uuname=<user_name>-option.
+
+An important "side-effect" is that the password file need not to
+be word-readable.  In fact my script tests for user-only rights of
+this file to close this potential security-hole.
+
+The script mount.smb has to be installed in /sbin and given mode 755.
+No suid is necessary!  I attached an automount table that is currently
+in use on my machine.  A user´s password file looks like this:
+
+$ cat ~/smb-pass
+supra:/cspiel   cspiel  secret
+helium:/c       cspiel  sesame
+^               ^       ^
+|               |       +- password
+|               +- username
++- share-name as in fundamental mount-table.
+
+It would be nice, if someone else tests my script.  Maybe, You have
+already found a better solution than mine.  If You find it useful,
+I would be glad to donate it to the SAMBA-project.
+
+BUGS:
+(1) There is no documentation yet.  (Yes, I consider this a bug!)
+(2) When used with autofs the automounter overruns mount.smb.
+    This means when accessing an automounted share for the 1st time
+    You may get an empty directory.  Retrying several times will
+    cause the mount to complete successfully.
+
+
+Best,
+       Christoph Spiel
+