Move Recent-FAQ's to the new SGML FAQ

(This used to be commit 8a15a8c195285550be55bac63f7508bf34b36411)
author: Jelmer Vernooij <jelmer@samba.org> 2002-10-04 17:20:45 +0000
committer: Jelmer Vernooij <jelmer@samba.org> 2002-10-04 17:20:45 +0000
commit: 2f57636fcfce3e5158597d6afb1f690076f40407 (patch)
tree: 12524b041d8ea55ee8b33fdc04a0ceb7c6e42de1 /docs
parent: 42efc1092dcb3042724e280c0bb18e813b3aac98 (diff)
download: samba-2f57636fcfce3e5158597d6afb1f690076f40407.tar.gz
samba-2f57636fcfce3e5158597d6afb1f690076f40407.tar.bz2
samba-2f57636fcfce3e5158597d6afb1f690076f40407.zip
6 files changed, 352 insertions, 69 deletions
diff --git a/docs/docbook/faq/errors.sgml b/docs/docbook/faq/errors.sgml
new file mode 100644
index 0000000000..53e4d01e20
--- /dev/null
+++ b/docs/docbook/faq/errors.sgml
@@ -0,0 +1,85 @@
+<chapter id="errors">
+
+<title>Common errors</title>
+
+<sect1>
+<title>Not listening for calling name</title>
+
+<para>
+<programlisting>
+Session request failed (131,129) with myname=HOBBES destname=CALVIN
+Not listening for calling name
+</programlisting>
+</para>
+
+<para>
+If you get this when talking to a Samba box then it means that your
+global "hosts allow" or "hosts deny" settings are causing the Samba 
+server to refuse the connection. 
+</para>
+
+<para>
+Look carefully at your "hosts allow" and "hosts deny" lines in the
+global section of smb.conf. 
+</para>
+
+<para>
+It can also be a problem with reverse DNS lookups not functioning 
+correctly, leading to the remote host identity not being able to
+be confirmed, but that is less likely.
+</para>
+</sect1>
+
+<sect1>
+<title>System Error 1240</title>
+
+<para>
+System error 1240 means that the client is refusing to talk
+to a non-encrypting server. Microsoft changed WinNT in service
+pack 3 to refuse to connect to servers that do not support
+SMB password encryption.
+</para>
+
+<para>There are two main solutions:
+<simplelist>
+<member>enable SMB password encryption in Samba. See the encryption part of 
+the samba HOWTO Collection</member>
+
+<member>disable this new behaviour in NT. See the section about 
+Windows NT in the chapter "Portability" of the samba HOWTO collection
+</member>
+</simplelist>
+
+</sect1>
+
+<sect1>
+<title>smbclient ignores -N !</title>
+
+<para>
+<quote>When getting the list of shares available on a host using the command
+<command>smbclient -N -L</command>
+the program always prompts for the password if the server is a Samba server.
+It also ignores the "-N" argument when querying some (but not all) of our
+NT servers.
+</quote>
+
+<para>
+No, it does not ignore -N, it is just that your server rejected the 
+null password in the connection, so smbclient prompts for a password
+to try again.
+</para>
+
+<para>
+To get the behaviour that you probably want use <command>smbclient -L host -U%</command>
+</para>
+
+<para>
+This will set both the username and password to null, which is
+an anonymous login for SMB. Using -N would only set the password
+to null, and this is not accepted as an anonymous login for most
+SMB servers.
+</para>
+
+</sect1>
+
+</chapter>
diff --git a/docs/docbook/faq/sambafaq.sgml b/docs/docbook/faq/sambafaq.sgml
index db918e349f..b6d8016fc4 100644
--- a/docs/docbook/faq/sambafaq.sgml
+++ b/docs/docbook/faq/sambafaq.sgml
@@ -1,6 +1,7 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
 <!ENTITY general SYSTEM "general.sgml">
 <!ENTITY install SYSTEM "install.sgml">
+<!ENTITY errors SYSTEM "errors.sgml">
 <!ENTITY clientapp SYSTEM "clientapp.sgml">
 ]>
 
@@ -20,11 +21,13 @@ allows file and printer connections from clients such as Windows,
 OS/2, Linux and others. Current to version 3.0. Please send any
 corrections to the samba documentation mailinglist at
 <ulink url="mailto:samba-doc@samba.org">samba-doc@samba.org</ulink>. 
-This FAQ is based on the old Samba FAQ by Dan Shearer and Paul Blackman.
+This FAQ was based on the old Samba FAQ by Dan Shearer and Paul Blackman, 
+and the old samba text documents which were mostly written by John Terpstra.
 </para>
 </dedication>
 
 &general;
 &install;
 &clientapp;
+&errors;
 </book>
diff --git a/docs/faq/clientapp.html b/docs/faq/clientapp.html
index 0081891331..fd120f90cd 100644
--- a/docs/faq/clientapp.html
+++ b/docs/faq/clientapp.html
@@ -11,7 +11,10 @@ TITLE="Samba FAQ"
 HREF="samba-faq.html"><LINK
 REL="PREVIOUS"
 TITLE="Compiling and installing Samba on a Unix host"
-HREF="install.html"></HEAD
+HREF="install.html"><LINK
+REL="NEXT"
+TITLE="Common errors"
+HREF="errors.html"></HEAD
 ><BODY
 CLASS="CHAPTER"
 BGCOLOR="#FFFFFF"
@@ -52,7 +55,11 @@ VALIGN="bottom"
 WIDTH="10%"
 ALIGN="right"
 VALIGN="bottom"
->&nbsp;</TD
+><A
+HREF="errors.html"
+ACCESSKEY="N"
+>Next</A
+></TD
 ></TR
 ></TABLE
 ><HR
@@ -182,7 +189,11 @@ ACCESSKEY="H"
 WIDTH="33%"
 ALIGN="right"
 VALIGN="top"
->&nbsp;</TD
+><A
+HREF="errors.html"
+ACCESSKEY="N"
+>Next</A
+></TD
 ></TR
 ><TR
 ><TD
@@ -199,7 +210,7 @@ VALIGN="top"
 WIDTH="33%"
 ALIGN="right"
 VALIGN="top"
->&nbsp;</TD
+>Common errors</TD
 ></TR
 ></TABLE
 ></DIV
diff --git a/docs/faq/errors.html b/docs/faq/errors.html
new file mode 100644
index 0000000000..36aafdaa01
--- /dev/null
+++ b/docs/faq/errors.html
@@ -0,0 +1,222 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML
+><HEAD
+><TITLE
+>Common errors</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.77"><LINK
+REL="HOME"
+TITLE="Samba FAQ"
+HREF="samba-faq.html"><LINK
+REL="PREVIOUS"
+TITLE="Specific client application problems"
+HREF="clientapp.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Samba FAQ</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="clientapp.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+>&nbsp;</TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="ERRORS"
+></A
+>Chapter 4. Common errors</H1
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN192"
+></A
+>4.1. Not listening for calling name</H1
+><P
+><PRE
+CLASS="PROGRAMLISTING"
+>Session request failed (131,129) with myname=HOBBES destname=CALVIN
+Not listening for calling name</PRE
+></P
+><P
+>If you get this when talking to a Samba box then it means that your
+global "hosts allow" or "hosts deny" settings are causing the Samba 
+server to refuse the connection. </P
+><P
+>Look carefully at your "hosts allow" and "hosts deny" lines in the
+global section of smb.conf. </P
+><P
+>It can also be a problem with reverse DNS lookups not functioning 
+correctly, leading to the remote host identity not being able to
+be confirmed, but that is less likely.</P
+></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN199"
+></A
+>4.2. System Error 1240</H1
+><P
+>System error 1240 means that the client is refusing to talk
+to a non-encrypting server. Microsoft changed WinNT in service
+pack 3 to refuse to connect to servers that do not support
+SMB password encryption.</P
+><P
+>There are two main solutions:
+<P
+></P
+><TABLE
+BORDER="0"
+><TBODY
+><TR
+><TD
+>enable SMB password encryption in Samba. See the encryption part of 
+the samba HOWTO Collection</TD
+></TR
+><TR
+><TD
+>disable this new behaviour in NT. See the section about 
+Windows NT in the chapter "Portability" of the samba HOWTO collection</TD
+></TR
+></TBODY
+></TABLE
+><P
+></P
+>&#13;</P
+></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN206"
+></A
+>4.3. smbclient ignores -N !</H1
+><P
+><SPAN
+CLASS="QUOTE"
+>"When getting the list of shares available on a host using the command
+<B
+CLASS="COMMAND"
+>smbclient -N -L</B
+>
+the program always prompts for the password if the server is a Samba server.
+It also ignores the "-N" argument when querying some (but not all) of our
+NT servers."</SPAN
+>&#13;</P
+><P
+>No, it does not ignore -N, it is just that your server rejected the 
+null password in the connection, so smbclient prompts for a password
+to try again.</P
+><P
+>To get the behaviour that you probably want use <B
+CLASS="COMMAND"
+>smbclient -L host -U%</B
+></P
+><P
+>This will set both the username and password to null, which is
+an anonymous login for SMB. Using -N would only set the password
+to null, and this is not accepted as an anonymous login for most
+SMB servers.</P
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="clientapp.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="samba-faq.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>&nbsp;</TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Specific client application problems</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>&nbsp;</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
diff --git a/docs/faq/samba-faq.html b/docs/faq/samba-faq.html
index 14b62edcc1..8efb6989de 100644
--- a/docs/faq/samba-faq.html
+++ b/docs/faq/samba-faq.html
@@ -52,7 +52,8 @@ HREF="mailto:samba-doc@samba.org"
 TARGET="_top"
 >samba-doc@samba.org</A
 >. 
-This FAQ is based on the old Samba FAQ by Dan Shearer and Paul Blackman.</P
+This FAQ was based on the old Samba FAQ by Dan Shearer and Paul Blackman, 
+and the old samba text documents which were mostly written by John Terpstra.</P
 ><DIV
 CLASS="TOC"
 ><DL
@@ -172,6 +173,30 @@ HREF="clientapp.html#AEN175"
 ></DT
 ></DL
 ></DD
+><DT
+>4. <A
+HREF="errors.html"
+>Common errors</A
+></DT
+><DD
+><DL
+><DT
+>4.1. <A
+HREF="errors.html#AEN192"
+>Not listening for calling name</A
+></DT
+><DT
+>4.2. <A
+HREF="errors.html#AEN199"
+>System Error 1240</A
+></DT
+><DT
+>4.3. <A
+HREF="errors.html#AEN206"
+>smbclient ignores -N !</A
+></DT
+></DL
+></DD
 ></DL
 ></DIV
 ></DIV
diff --git a/docs/textdocs/Recent-FAQs.txt b/docs/textdocs/Recent-FAQs.txt
deleted file mode 100644
index d6f4d6b99f..0000000000
--- a/docs/textdocs/Recent-FAQs.txt
+++ /dev/null
@@ -1,63 +0,0 @@
-Contributor:	Samba-bugs@samba.org
-Date:		October 2002
-Status:		Current
-
-=============================================================================
-Subject: Recent FAQ answers to common questions / problems
-=============================================================================
-
-Not listening for calling name
-==============================
-
-> Session request failed (131,129) with myname=HOBBES destname=CALVIN
-> Not listening for calling name
-
-If you get this when talking to a Samba box then it means that your
-global "hosts allow" or "hosts deny" settings are causing the Samba 
-server to refuse the connection. 
-
-Look carefully at your "hosts allow" and "hosts deny" lines in the
-global section of smb.conf. 
-
-It can also be a problem with reverse DNS lookups not functioning 
-correctly, leading to the remote host identity not being able to
-be confirmed, but that is less likely.
-===============================================================================
-
-System Error 1240
-=================
-System error 1240 means that the client is refusing to talk
-to a non-encrypting server. Microsoft changed WinNT in service
-pack 3 to refuse to connect to servers that do not support
-SMB password encryption.
-
-There are two main solutions:
-
-1) enable SMB password encryption in Samba. See ENCRYPTION.txt in the 
-Samba docs
-
-2) disable this new behaviour in NT. See WinNT.txt in the 
-Samba docs
-===============================================================================
-
-smbclient -N
-============
-> When getting the list of shares available on a host using the command
->   smbclient -N -L <server>
-> the program always prompts for the password if the server is a Samba server.
-> It also ignores the "-N" argument when querying some (but not all) of our
-> NT servers.
-
-No, it does not ignore -N, it is just that your server rejected the 
-null password in the connection, so smbclient prompts for a password
-to try again.
-
-To get the behaviour that you probably want use 
-	smbclient -L host -U%
-
-this will set both the username and password to null, which is
-an anonymous login for SMB. Using -N would only set the password
-to null, and this is not accepted as an anonymous login for most
-SMB servers.
-===============================================================================
-
author	Jelmer Vernooij <jelmer@samba.org>	2002-10-04 17:20:45 +0000
committer	Jelmer Vernooij <jelmer@samba.org>	2002-10-04 17:20:45 +0000
commit	2f57636fcfce3e5158597d6afb1f690076f40407 (patch)
tree	12524b041d8ea55ee8b33fdc04a0ceb7c6e42de1 /docs
parent	42efc1092dcb3042724e280c0bb18e813b3aac98 (diff)
download	samba-2f57636fcfce3e5158597d6afb1f690076f40407.tar.gz samba-2f57636fcfce3e5158597d6afb1f690076f40407.tar.bz2 samba-2f57636fcfce3e5158597d6afb1f690076f40407.zip