From 1c62aa14cc5e43d47c9932d5c965ba834729e2f9 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Wed, 21 Aug 1996 12:36:31 +0000 Subject: update the docs ready for a new release --- docs/INSTALL.txt | 18 ++++++++----- docs/announce | 2 +- docs/manpages/nmbd.8 | 2 +- docs/manpages/samba.7 | 4 +-- docs/manpages/smb.conf.5 | 6 ++--- docs/manpages/smbclient.1 | 2 +- docs/manpages/smbd.8 | 2 +- docs/manpages/smbrun.1 | 2 +- docs/manpages/smbtar.1 | 2 +- docs/manpages/testparm.1 | 2 +- docs/manpages/testprns.1 | 2 +- docs/samba.lsm | 4 +-- docs/textdocs/BROWSING.txt | 65 ++++++--------------------------------------- docs/textdocs/BUGS.txt | 2 +- docs/textdocs/DIAGNOSIS.txt | 38 ++++++++++---------------- docs/textdocs/DOMAIN.txt | 5 ++-- docs/textdocs/PROJECTS | 2 +- docs/textdocs/Speed.txt | 2 +- 18 files changed, 54 insertions(+), 108 deletions(-) diff --git a/docs/INSTALL.txt b/docs/INSTALL.txt index 6f752b63971..1322047fd1e 100644 --- a/docs/INSTALL.txt +++ b/docs/INSTALL.txt @@ -49,10 +49,11 @@ options. The simplest useful configuration file would be something like this: -[homes] - workgroup = MYGROUP - guest ok = no - read only = no + workgroup = MYGROUP + + [homes] + guest ok = no + read only = no which would allow connections by anyone with an account on the server, using either their login name or "homes" as the service name. (Note @@ -230,8 +231,9 @@ CHOOSING THE PROTOCOL LEVEL The SMB protocol has many dialects. Currently Samba supports 5, called CORE, COREPLUS, LANMAN1, LANMAN2 and NT1. -You can choose what protocols to support in the smb.conf file. The -default is NT1 and that is the best for the vast majority of sites. +You can choose what maximum protocol to support in the smb.conf +file. The default is NT1 and that is the best for the vast majority of +sites. In older versions of Samba you may have found it necessary to use COREPLUS. The limitations that led to this have mostly been fixed. It @@ -310,7 +312,9 @@ compatability modes called DENY_FCB and DENY_DOS. You can disable share modes using "share modes = no". This may be useful on a heavily loaded server as the share modes code is very -slow. +slow. See also the FAST_SHARE_MODES option in the Makefile for a way +to do full share modes very fast using shared memory (if your OS +supports it). MAPPING USERNAMES diff --git a/docs/announce b/docs/announce index 5740f37dc61..177286ff8e5 100644 --- a/docs/announce +++ b/docs/announce @@ -129,5 +129,5 @@ newsgroup comp.protocols.smb. A WWW site with lots of Samba info can be found at http://samba.canberra.edu.au/pub/samba/ -The Samba Team (Contact: samba-bugs@anu.edu.au) +The Samba Team (Contact: samba-bugs@samba.anu.edu.au) June 1996 diff --git a/docs/manpages/nmbd.8 b/docs/manpages/nmbd.8 index d87ae75e732..942fb8920cb 100644 --- a/docs/manpages/nmbd.8 +++ b/docs/manpages/nmbd.8 @@ -210,7 +210,7 @@ these to the address below for rectification. .BR testprns (1) .SH CREDITS The original Samba software and related utilities were created by -Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper +Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper of the Source for this project. This man page was originally written by Karl Auer (Karl.Auer@anu.edu.au). diff --git a/docs/manpages/samba.7 b/docs/manpages/samba.7 index 1621f2e68c8..3dd6253ebee 100644 --- a/docs/manpages/samba.7 +++ b/docs/manpages/samba.7 @@ -69,7 +69,7 @@ of the Samba mailing list, at http://samba.canberra.edu.au/pub/samba/ .SH AUTHOR The main author of the Samba suite is Andrew Tridgell. He may be -contacted via e-mail at samba-bugs@anu.edu.au. +contacted via e-mail at samba-bugs@samba.anu.edu.au. There have also been an enormous number of contributors to Samba from all over the world. A partial list of these contributors is included @@ -184,7 +184,7 @@ Contributors to the project are (in alphabetical order by email address): S{rkel{, Vesa (vesku@rankki.kcl.fi) Tridgell, Andrew - (samba-bugs@anu.edu.au) + (samba-bugs@samba.anu.edu.au) Troyer, Dean (troyer@saifr00.ateng.az.honeywell.com) Wakelin, Ross diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5 index 21038599036..6761445b894 100644 --- a/docs/manpages/smb.conf.5 +++ b/docs/manpages/smb.conf.5 @@ -2362,7 +2362,7 @@ You may find that on some systems Samba will say "Unknown socket option" when you supply an option. This means you either mis-typed it or you need to add an include file to includes.h for your OS. If the latter is the case please send the patch to me -(samba-bugs@anu.edu.au). +(samba-bugs@samba.anu.edu.au). Any of the supported socket options may be combined in any way you like, as long as your OS allows it. @@ -2864,7 +2864,7 @@ None known. Please send bug reports, comments and so on to: .RS 3 -.B samba-bugs@anu.edu.au (Andrew Tridgell) +.B samba-bugs@samba.anu.edu.au (Andrew Tridgell) .RS 3 or to the mailing list: @@ -2887,6 +2887,6 @@ Errors or suggestions for improvements to the Samba man pages should be mailed to: .RS 3 -.B samba-bugs@anu.edu.au (Andrew Tridgell) +.B samba-bugs@samba.anu.edu.au (Andrew Tridgell) .RE diff --git a/docs/manpages/smbclient.1 b/docs/manpages/smbclient.1 index 7482c7ca765..368c8040321 100644 --- a/docs/manpages/smbclient.1 +++ b/docs/manpages/smbclient.1 @@ -1196,7 +1196,7 @@ diagnostics you are seeing. None known. .SH CREDITS The original Samba software and related utilities were created by -Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper +Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper of the Source for this project. This man page was written by Karl Auer (Karl.Auer@anu.edu.au). diff --git a/docs/manpages/smbd.8 b/docs/manpages/smbd.8 index 7c513cc41e7..116b24693d7 100644 --- a/docs/manpages/smbd.8 +++ b/docs/manpages/smbd.8 @@ -409,7 +409,7 @@ diagnostics you are seeing. None known. .SH CREDITS The original Samba software and related utilities were created by -Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper +Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper of the Source for this project. This man page was written by Karl Auer (Karl.Auer@anu.edu.au). diff --git a/docs/manpages/smbrun.1 b/docs/manpages/smbrun.1 index 05056e9720d..3f04e3cd8bd 100644 --- a/docs/manpages/smbrun.1 +++ b/docs/manpages/smbrun.1 @@ -63,7 +63,7 @@ commands to issue suitable diagnostics to aid trouble-shooting. None known. .SH CREDITS The original Samba software and related utilities were created by -Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper +Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper of the Source for this project. This man page was written by Karl Auer (Karl.Auer@anu.edu.au). diff --git a/docs/manpages/smbtar.1 b/docs/manpages/smbtar.1 index f6716940ab3..70a16afe6f3 100644 --- a/docs/manpages/smbtar.1 +++ b/docs/manpages/smbtar.1 @@ -161,7 +161,7 @@ See diagnostics for command. .SH CREDITS The original Samba software and related utilities were created by -Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper +Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper of the Source for this project. Ricky Poulten (poultenr@logica.co.uk) wrote the tar extension and this diff --git a/docs/manpages/testparm.1 b/docs/manpages/testparm.1 index 8deb1c38c21..a40de286113 100644 --- a/docs/manpages/testparm.1 +++ b/docs/manpages/testparm.1 @@ -95,7 +95,7 @@ Other messages are self-explanatory. None known. .SH CREDITS The original Samba software and related utilities were created by -Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper +Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper of the Source for this project. The diff --git a/docs/manpages/testprns.1 b/docs/manpages/testprns.1 index 22e77567a73..623163ce585 100644 --- a/docs/manpages/testprns.1 +++ b/docs/manpages/testprns.1 @@ -98,7 +98,7 @@ Other messages are self-explanatory. None known. .SH CREDITS The original Samba software and related utilities were created by -Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper +Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper of the Source for this project. The diff --git a/docs/samba.lsm b/docs/samba.lsm index eacfda5ba0a..36abbba769a 100644 --- a/docs/samba.lsm +++ b/docs/samba.lsm @@ -7,9 +7,9 @@ Desc3 = SMB compatible clients such as WinNT, WfWg, OS/2 Desc4 = and Pathworks. It also includes a ftp-style unix client Desc5 = and a netbios nameserver. Author = Andrew Tridgell -AuthorEmail = samba-bugs@anu.edu.au +AuthorEmail = samba-bugs@samba.anu.edu.au Maintainer = Andrew Tridgell -MaintEmail = samba-bugs@anu.edu.au +MaintEmail = samba-bugs@samba.anu.edu.au Site1 = samba.anu.edu.au Path1 = pub/samba/ File1 = samba-latest.tar.gz diff --git a/docs/textdocs/BROWSING.txt b/docs/textdocs/BROWSING.txt index 05d2f96544a..9d1e85f5310 100644 --- a/docs/textdocs/BROWSING.txt +++ b/docs/textdocs/BROWSING.txt @@ -5,53 +5,17 @@ Samba now fully supports browsing. The browsing is supported by nmbd and is also controlled by options in the smb.conf file (see smb.conf(5)). -Samba can act as a browse master for a workgroup and the ability for -samba to support domain logons and scripts is now available with features -still being added. See DOMAIN.txt for more information . +Samba can act as a browse master for a workgroup and the ability for +samba to support domain logons and scripts is now available. See +DOMAIN.txt for more information on domain logons. To get browsing to work you need to run nmbd as usual, but will need to use the "workgroup" option in smb.conf to control what workgroup Samba becomes a part of. -The -G option is most useful for simple setups where Samba is browsable -in only one workgroup. In more complex cases the lmhosts file is -better. - -Be very careful setting up your lmhosts file. An incorrectly setup -lmhosts file can have disasterous results for your net! - -A simple lmhosts file might be: - -# This is a simple lmhosts file -# -# This is a host alias. Anyone querying this name -# will get the specified IP -192.0.2.17 SMBDATA -# -# first put ourselves in workgroup MYGROUP using -# our own net address -0.0.0.0 MYGROUP 255.255.255.0 G - -Note in the above that I overrode what workgroup Samba is in using the -G flag. Also note that the 0.0.0.0 address is used, which will be -automatically replaced with the broadcast address for groups, and with -the local IP address for other entries. - Samba also has a useful option for a Samba server to offer itself for -browsing on another subnet. - -This works by the lmhosts file specifying a broadcast address on the -other network to use to find a browse master for the workgroup. - -For example if you wanted yourself to appear in the workgroup STAFF on -the network which has a broadcast of 192.0.3.255 then this entry would -do the trick: - -# put ourselves in the STAFF workgroup on the other subnet -192.0.3.255 STAFF 255.255.255.0 G - -Notice the G at the end! It is very important you include this as this -entry without the G could cause a broadcast storm! +browsing on another subnet. See "remote announce" in the smb.conf man +page. If something doesn't work then hopefully the log.nmb file will help you track down the problem. Try a debug level of 2 or 3 for @@ -74,8 +38,8 @@ are now far more likely to correctly find your broadcast and network addess, so in most cases these aren't needed. The other big problem people have is that their broadcast address, -netmask or IP address is wrong (specified with the -B, -N and -I -options to nmbd). +netmask or IP address is wrong (specified with the "interfaces" option +in smb.conf) FORCING SAMBA TO BE THE MASTER ============================== @@ -87,7 +51,7 @@ election. By default Samba uses a very low precedence and thus loses elections to just about anyone else. If you want Samba to win elections then just set the "os level" global -option in smb.conf to a higher number. It defaults to 0. Using 33 +option in smb.conf to a higher number. It defaults to 0. Using 34 would make it win all elections over every other system (except other samba systems!) @@ -132,22 +96,9 @@ ends in a 0) then you will strike problems. Windows for Workgroups does not seem to support a 0's broadcast and you will probably find that browsing and name lookups won't work. -You have a few options: - -1) change to a 1's broadcast on your unix server. These often end in -.255 (check with your local network guru for details) - -2) set the nmbd broadcast to a 1's based address on the command line using -the -B option. This only works if your network setup listens on both -0s and 1s based broadcasts. The -B option can only control what -address it sends to, not what it listens on. - MULTIPLE INTERFACES =================== Samba now supports machines with multiple network interfaces. If you have multiple interfaces then you will need to use the "interfaces" option in smb.conf to configure them. See smb.conf(5) for details. - - - diff --git a/docs/textdocs/BUGS.txt b/docs/textdocs/BUGS.txt index 8cccfcf449e..099791c1562 100644 --- a/docs/textdocs/BUGS.txt +++ b/docs/textdocs/BUGS.txt @@ -1,6 +1,6 @@ This file describes how to report Samba bugs. ->> The email address for bug reports is samba-bugs@anu.edu.au << +>> The email address for bug reports is samba-bugs@samba.anu.edu.au << Please take the time to read this file before you submit a bug report. Also, please see if it has changed between releases, as I diff --git a/docs/textdocs/DIAGNOSIS.txt b/docs/textdocs/DIAGNOSIS.txt index 34099e6a164..740f417ed3b 100644 --- a/docs/textdocs/DIAGNOSIS.txt +++ b/docs/textdocs/DIAGNOSIS.txt @@ -11,7 +11,7 @@ carefully choose them so later tests only use capabilities verified in the earlier tests. I would welcome additions to this set of tests. Please mail them to -samba-bugs@anu.edu.au +samba-bugs@samba.anu.edu.au If you send me an email saying "it doesn't work" and you have not followed this test procedure then you should not be surprised if I @@ -36,7 +36,7 @@ smb.conf. I will assume this share is called "tmp". You can add a read only = yes -THESE TESTS ASSUME VERSION 1.9.15 OR LATER OF THE SAMBA SUITE. SOME +THESE TESTS ASSUME VERSION 1.9.16 OR LATER OF THE SAMBA SUITE. SOME COMMANDS SHOWN DID NOT EXIST IN EARLIER VERSIONS @@ -66,7 +66,7 @@ you do have correct entries for the remainder of these tests. TEST 3: ------- -run the command "smbclient -L BIGSERVER -U%" on the unix box. You +run the command "smbclient -L BIGSERVER" on the unix box. You should get a list of available shares back. If you get a error message containing the string "Bad password" then @@ -86,7 +86,8 @@ If you get a "session request failed" then the server refused the connection. If it says "your server software is being unfriendly" then its probably because you have invalid command line parameters to smbd, or a similar fatal problem with the initial startup of smbd. Also -check your config file for syntax errors with "testparm". +check your config file for syntax errors with "testparm" and that the +various directories where samba keeps its log and lock files exist. Another common cause of these two errors is having something already running on port 139, such as Samba (ie smbd is running from inetd already) or something @@ -101,7 +102,7 @@ run the command "nmblookup -B BIGSERVER __SAMBA__". You should get the IP address of your Samba server back. If you don't then nmbd is incorrectly installed. Check your inetd.conf -if yu run it from there, or that the daemon is running and listening +if you run it from there, or that the daemon is running and listening to udp port 137. One common problem is that many inetd implementations can't take many @@ -116,9 +117,7 @@ run the command "nmblookup -B ACLIENT '*'" You should get the PCs IP address back. If you don't then the client software on the PC isn't installed correctly, or isn't started, or you -got the name of the PC wrong. Note that you probably won't get a "node -status response" from the PC due to a bug in the microsoft netbios -nameserver implementation (it responds to the wrong port number). +got the name of the PC wrong. TEST 6: ------- @@ -134,20 +133,9 @@ hosts. If this doesn't give a similar result to the previous test then nmblookup isn't correctly getting your broadcast address through its -automatic mechanism. In this case you should experiment with the -B -option which allows you to manually specify the broadcast address, -overriding the automatic detection. You should try different broadcast -addresses until your find the one that works. It will most likely be -something like a.b.c.255 as microsoft tcpip stacks only listen on 1's -based broadcast addresses. If you get stuck then ask your local -networking guru for help (and show them this paragraph). - -If you find you do need the -B option (ie. the automatic detection -doesn't work) then you should add the -B option with the right -broadcast address for your network to the command line of nmbd in -inetd.conf or in the script you use to start nmbd as a daemon. Once -you do this go back to the "nmblookup __SAMBA__ -B BIGSERVER" test to -make sure you have it running properly. +automatic mechanism. In this case you should experiment use the +"interfaces" option in smb.conf to manually configure your IP +address, broadcast and netmask. If your PC and server aren't on the same subnet then you will need to use the -B option to set the broadcast address to the that of the PCs @@ -174,6 +162,8 @@ compile in support for them in smbd - you have a mixed case password and you haven't enabled the "password level" option at a high enough level - the "path =" line in smb.conf is incorrect. Check it with testparm +- you enabled password encryption but didn't create the SMB encrypted +password file Once connected you should be able to use the commands "dir" "get" "put" etc. Type "help " for instructions. You should @@ -227,8 +217,8 @@ TEST 10: From file manager try to browse the server. Your samba server should appear in the browse list of your local workgroup (or the one you -specified in the Makefile). You should be able to double click on the -name of the server and get a list of shares. If you get a "invalid +specified in smb.conf). You should be able to double click on the name +of the server and get a list of shares. If you get a "invalid password" error when you do then you are probably running WinNT and it is refusing to browse a server that has no encrypted password capability and is in user level security mode. diff --git a/docs/textdocs/DOMAIN.txt b/docs/textdocs/DOMAIN.txt index 31e19675fae..ee086b0e236 100644 --- a/docs/textdocs/DOMAIN.txt +++ b/docs/textdocs/DOMAIN.txt @@ -7,7 +7,8 @@ administration. Support for these kind of things should be added sometime in the future. The domain support only works for WfWg and Win95 clients. Support for -NT and OS/2 clients is still being worked on. +NT and OS/2 clients is still being worked on and currently does not +work. Using these features you can make your clients verify their logon via the Samba server and make clients run a batch file when they logon to @@ -39,7 +40,7 @@ For example I have used: the choice of batch file is, of course, up to you. The above would give each user a separate batch file as the %U will be changed to their username automatically. The other standard % macros may also be -used. You can make the btch files come from a subdirectory by using +used. You can make the batch files come from a subdirectory by using soemthing like: logon script = scripts\%U.bat diff --git a/docs/textdocs/PROJECTS b/docs/textdocs/PROJECTS index cf903f2c6dd..d3b2b741e4d 100644 --- a/docs/textdocs/PROJECTS +++ b/docs/textdocs/PROJECTS @@ -14,7 +14,7 @@ then please let me know! Also, if you are listed below and you have any corrections or updates then please let me know. Email contact: -samba-bugs@anu.edu.au +samba-bugs@samba.anu.edu.au ======================================================================== Documentation and FAQ diff --git a/docs/textdocs/Speed.txt b/docs/textdocs/Speed.txt index 583076a6e33..28bceb658f5 100644 --- a/docs/textdocs/Speed.txt +++ b/docs/textdocs/Speed.txt @@ -273,4 +273,4 @@ COMMENTS If you've read this far then please give me some feedback! Which of the above suggestions worked for you? -Mail the samba mailing list or samba-bugs@anu.edu.au +Mail the samba mailing list or samba-bugs@samba.anu.edu.au -- cgit