Using SambaBy Robert Eckstein, David Collier-Brown & Peter Kelly
1st Edition October 1999 (est.)
1-56592-449-5, Order Number: 4495
424 pages (est.), $34.95 (est.)
Copyright (c) 1999 by O'Reilly & Associates. This book, Using Samba, first edition, was written by Robert Eckstein, David Collier-Brown, and Peter Kelly, and published by O'Reilly & Associates. This material may be distributed only subject to the terms and conditions set forth in the license, which is presently available at http://www.oreilly.com/catalog/samba/licenseinfo.html.
This is a modified version of the O'Reilly first edition of Using Samba.
The original was downloaded on 25 November 1999, using the command
$ wget -r -L -nc -t 3 --no-parent http://www.oreilly.com/catalog/samba/chapter/book/index.htmlMy motivation for creating this version was that I wanted the book to be downloadable as a single file rather than require people to read it online. Also, I found that the version I downloaded from the O'Reilly website contained many typographical errors, apparently resulting from an imperfect machine translation from SGML to HTML. So I spent a few days carefully reading through the book to find and then fix them. And along with that, I added slightly more intelligent linking to make it easier to navigate within the book using a web browser. Here is a brief list of the changes I made:
Release 1.1, on 12 January 2000:
The most significant development for version 1.1 is that with Using Samba as a guide, I have implemented a Samba network here at the Metran Technology corporate offices, and in the process found several more errors in Using Samba to fix.
Fortunately for everyone but me, the networking setup here prevented the use of any pre-existing smb.conf configuration file, so I was reduced to creating one from scratch. Also, due to a very nonstandard host naming system in place here, I had to pick through the Fault Tree and follow all the instructions listed there. Due to these two conditions, you can be sure that I've now read most of the book very carefully!
The network here now supports Windows 98 and Windows 95 clients, as well as a Windows 98 client that is running on the same Linux system as the Samba server, under the VMware virtual machine. I also have printer sharing working from the clients, using the Linux server's printer.
Later, I hope to add a Windows NT 4.0 client, and configure Samba as a primary domain controller. Be warned that for now, the sections of the book relating to these subjects have not been checked as carefully as the rest.
As usual, I welcome reports of typos, technical errors, or any other comments you may have. What follows is an approximate list of changes made in this version.
- more whitespace bugs fixed:
- Spaces before periods, commas, colons, right parenthesis and right brackets, as well as spaces after left parenthesis and left brackets, have been removed.
- Spaces in file names (directory paths) were removed.
- Excessive vertical spaces preceeding tables were removed.
- Spelling error in Chapter 9.1: "directoryies" changed to "directory".
- Spelling error in Chapter 1.2: "back slash" changed to "backslash".
- Spelling error in Chapter 6.3.4: "domainlevel" changed to "domain-level".
- Chapter 9.2: "hostnamedomainname" changed to "hostname.domainname".
- In a number of places in the book, [global] was misprinted as [globals]. Oddly, Samba doesn't seem to notice if it is spelled wrong in smb.conf! All were changed to [global], which is the correct spelling.
- Table 4.7: Erroneous ".bak" file extension changed to ".old".
- Chapter 9.2: "TCP/IP Network Administration protocol stack" changed to "TCP/IP protocol stack". Apparently, the words "Network Administration" were inserted in error by someone who mistook that incidence of "TCP/IP" with the reference to the book TCP/IP Network Administration that appears nearby.
There are many places in the book where a literal example of a command to be typed in is given. Unfortunately, there was not a conformal method used to present the commands. For example, Chapter 9.2 shows commands using a C Shell prompt of "server%", where Bash prompts are used elsewhere. There were other oddities, so I decided to implement a standard method everywhere:
$ command [arguments]
The bash "$" prompt is used when the command can be executed without superuser permissions. When you need to su to superuser, the command is shown with a "#" prompt. And not to leave out DOS/Windows - for those, the prompt is similar to "C:\>".
The prompt itself is printed in normal text, and the literal characters to be typed in on the command line are in bold. Text not in bold following the command name are to be replaced by case-specific data.
- Chapter 8.6: The 'panic action' example was re-created. The original was mangled, and was not a functional command.
- Chapter 7.2: comments in the /etc/printcap examples had been in the wrong places, shifted to appear next to a line other than the one they referred to. Those were all un-shifted, and now match up correctly.
- For lynx, <p> tags were inserted before <pre> tags, to make sure some vertical space appeared before literal text such as command lines and file listings.
NOTE: Tables still don't display properly in lynx, due to lynx's inability to cope with <p> tags in table data. And also due to lynx's poor rendering of tables in general. Hopefully, it will be possible to fully support lynx at a later time.
- Tables 4.1 and B-6 through B-9 were fixed to display all vertical and horizontal lines (for empty cells) so that they now display correctly in Netscape.
- In Chapter 1.3, hotlinks were added to RFCs 1001 and 1002 on the Internet.
- In Appendix B.3, near the bottom, references to Tables B.2 through B.4 were totally wrong:
"Figure 6-5" was changed to "Table B.3".
"Figure 6-4" was changed to "Table B.2".
"Figure 6-6" was changed to "Table B.4".
- In Appendix B.3.1, it said that,A 100 Mb/s Fast Ethernet will bottleneck below 65,000KB/s...Although that may be a true statement, I thought it would be more precise to change "65,000" to "6,500", which I assume is what was meant by the author. (I'm not sure I would agree with the accuracy of that number, but it is in agreement with the other figures in that section.)
- In Table B.5, one "CPU Throughput" cell appeared for no reason as 16000. It was changed to 6000 to match the other cells in that column.
Release 1.0, on 3 December 1999:
Let me know if you find any errors, or have suggestions for future versions.
- Essential GIF images were relocated into the "gifs" subdirectory. (This makes tarball installation into a subdirectory simpler).
- There were many errors in vertical and horizontal spacing, sometimes with multiple newlines inserted into command lines or path specifications. These manglings have all been corrected. (NOTE: I am using Netscape 4.7, and I have not checked with any other browser.)
- There were also odd errors of various sorts, such as weird and completely nonfunctional hypertext links and other oddities. Fixed.
- There is now a link to the Table of Contents at the top of each page.
- In the original, there were references to other chapters which were not set up as hypertext links. Now they are.
- There is now a more detailed Table of Contents, including sections within chapters. License Information and Index entries added. (O'Reilly has also added the Index to their Table of Contents.) The index is still mostly useless, since only page numbers within the treeware version are listed, and there are no hypertext links to the location in the HTML version.
- The image of the book cover was replaced with a smaller version.
- I removed some nonessential graphics that were linking to the O'Reilly Online Catalog on the O'Reilly server. (I left the O'Reilly website links at the bottom, so it is still possible to get directly to their website from any page.)
- A hypertext link was added to purchase the treeware book at Amazon.com. (In case as I do, you also like to have the "real book" in addition to the electronic version, and prefer buying at a discount - currently 20% at the time of this writing.)
- Also on the Table of Contents page, there is a link to visit my "Linux and Internet Book Store", which has online reviews of my favorite books from O'Reilly and other publishers, along with URLs to download the sample code (if available) from the books.