- Regenerate docs

- Fix db2latex (it depended on the $Id$ tags) - Fix CUPS-Printing syntax - Update instructions in docbook.txt (This used to be commit 8d7c96a4e267c5546518d097edbe03e27b1ad073)
author: Jelmer Vernooij <jelmer@samba.org> 2003-06-06 20:07:16 +0000
committer: Jelmer Vernooij <jelmer@samba.org> 2003-06-06 20:07:16 +0000
commit: f7e07eafc88128a556efbc94a9b062fd48ad91f4 (patch)
tree: eca1673bc2ad9c752869b4f0d99abee35c31acf1 /docs/htmldocs/smbsh.1.html
parent: bea0cf2c7930b01035109c201d57e43cd29a0591 (diff)
download: samba-f7e07eafc88128a556efbc94a9b062fd48ad91f4.tar.gz
samba-f7e07eafc88128a556efbc94a9b062fd48ad91f4.tar.bz2
samba-f7e07eafc88128a556efbc94a9b062fd48ad91f4.zip
1 files changed, 97 insertions, 454 deletions
diff --git a/docs/htmldocs/smbsh.1.html b/docs/htmldocs/smbsh.1.html
index bab2b45cdd..935576af6b 100644
--- a/docs/htmldocs/smbsh.1.html
+++ b/docs/htmldocs/smbsh.1.html
@@ -1,467 +1,110 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
-<HTML
-><HEAD
-><TITLE
->smbsh</TITLE
-><META
-NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"></HEAD
-><BODY
-CLASS="REFENTRY"
-BGCOLOR="#FFFFFF"
-TEXT="#000000"
-LINK="#0000FF"
-VLINK="#840084"
-ALINK="#0000FF"
-><H1
-><A
-NAME="SMBSH">smbsh</H1
-><DIV
-CLASS="REFNAMEDIV"
-><A
-NAME="AEN5"
-></A
-><H2
->Name</H2
->smbsh&nbsp;--&nbsp;Allows access to Windows NT filesystem 
-	using UNIX commands</DIV
-><DIV
-CLASS="REFSYNOPSISDIV"
-><A
-NAME="AEN8"><H2
->Synopsis</H2
-><P
-><B
-CLASS="COMMAND"
->smbsh</B
-> [-W workgroup] [-U username] [-P prefix] [-R &#60;name resolve order&#62;] [-d &#60;debug level&#62;] [-l logfile] [-L libdir]</P
-></DIV
-><DIV
-CLASS="REFSECT1"
-><A
-NAME="AEN18"
-></A
-><H2
->DESCRIPTION</H2
-><P
->This tool is part of the <A
-HREF="samba.7.html"
-TARGET="_top"
->	Samba</A
-> suite.</P
-><P
-><B
-CLASS="COMMAND"
->smbsh</B
-> allows you to access an NT filesystem 
-	using UNIX commands such as <B
-CLASS="COMMAND"
->ls</B
->, <B
-CLASS="COMMAND"
->	egrep</B
->, and <B
-CLASS="COMMAND"
->rcp</B
->. You must use a 
-	shell that is dynamically linked in order for <B
-CLASS="COMMAND"
->smbsh</B
-> 
-	to work correctly.</P
-></DIV
-><DIV
-CLASS="REFSECT1"
-><A
-NAME="AEN28"
-></A
-><H2
->OPTIONS</H2
-><P
-></P
-><DIV
-CLASS="VARIABLELIST"
-><DL
-><DT
->-W WORKGROUP</DT
-><DD
-><P
->Override the default workgroup specified in the 
-		workgroup parameter of the <TT
-CLASS="FILENAME"
->smb.conf</TT
-> file 
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbsh</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbsh.1"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>Name</h2><p>smbsh &#8212; Allows access to Windows NT filesystem 
+	using UNIX commands</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">smbsh</tt>  [-W workgroup] [-U username] [-P prefix] [-R &lt;name resolve order&gt;] [-d &lt;debug level&gt;] [-l logfile] [-L libdir]</p></div></div><div class="refsect1" lang="en"><h2>DESCRIPTION</h2><p>This tool is part of the <a href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a> suite.</p><p><b class="command">smbsh</b> allows you to access an NT filesystem 
+	using UNIX commands such as <b class="command">ls</b>, <b class="command">
+	egrep</b>, and <b class="command">rcp</b>. You must use a 
+	shell that is dynamically linked in order for <b class="command">smbsh</b> 
+	to work correctly.</p></div><div class="refsect1" lang="en"><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-W WORKGROUP</span></dt><dd><p>Override the default workgroup specified in the 
+		workgroup parameter of the <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file 
 		for this session. This may be needed to connect to some 
-		servers. </P
-></DD
-><DT
->-U username[%pass]</DT
-><DD
-><P
->Sets the SMB username or username and password.
+		servers. </p></dd><dt><span class="term">-U username[%pass]</span></dt><dd><p>Sets the SMB username or username and password.
 		If this option is not specified, the user will be prompted for 
 		both the username and the password.  If %pass is not specified, 
 		the user will be prompted for the password.
-		</P
-></DD
-><DT
->-P prefix</DT
-><DD
-><P
->This option allows
+		</p></dd><dt><span class="term">-P prefix</span></dt><dd><p>This option allows
 		the user to set the directory prefix for SMB access. The 
 		default value if this option is not specified is 
-		<I
-CLASS="EMPHASIS"
->smb</I
->.
-		</P
-></DD
-><DT
->-R &#60;name resolve order&#62;</DT
-><DD
-><P
->This option is used to determine what naming 
-		services and in what order to resolve 
-		host names to IP addresses. The option takes a space-separated 
-		string of different name resolution options.</P
-><P
->The options are :"lmhosts", "host", "wins" and "bcast". 
-		They cause names to be resolved as follows :</P
-><P
-></P
-><UL
-><LI
-><P
-><TT
-CLASS="CONSTANT"
->lmhosts</TT
-> : 
-			Lookup an IP address in the Samba lmhosts file. If the 
-			line in lmhosts has no name type attached to the 
-			NetBIOS name 
-			(see the <A
-HREF="lmhosts.5.html"
-TARGET="_top"
->lmhosts(5)</A
->
-			for details) then any name type matches for lookup.
-			</P
-></LI
-><LI
-><P
-><TT
-CLASS="CONSTANT"
->host</TT
-> : 
-			Do a standard host name to IP address resolution, using
-			the system <TT
-CLASS="FILENAME"
->/etc/hosts</TT
->, NIS, or DNS
-			lookups. This method of name resolution is operating 
-			system dependent, for instance on IRIX or Solaris this 
-			may be controlled by the <TT
-CLASS="FILENAME"
->/etc/nsswitch.conf
-			</TT
-> file).  Note that this method is only used 
-			if the NetBIOS name type being queried is the 0x20 
-			(server) name type, otherwise it is ignored.
-			</P
-></LI
-><LI
-><P
-><TT
-CLASS="CONSTANT"
->wins</TT
-> : 
-			Query a name with the IP address listed in the 
-			<TT
-CLASS="PARAMETER"
-><I
->wins server</I
-></TT
-> parameter.  If no 
-			WINS server has been specified this method will be 
-			ignored.
-			</P
-></LI
-><LI
-><P
-><TT
-CLASS="CONSTANT"
->bcast</TT
-> : 
-			Do a broadcast on each of the known local interfaces 
-			listed in the <TT
-CLASS="PARAMETER"
-><I
->interfaces</I
-></TT
->
-			parameter. This is the least reliable of the name 
-			resolution methods as it depends on the target host 
-			being on a locally connected subnet.
-			</P
-></LI
-></UL
-><P
->If this parameter is not set then the name resolve order 
-		defined in the <TT
-CLASS="FILENAME"
->smb.conf</TT
-> file parameter  
-		(name resolve order) will be used. </P
-><P
->The default order is lmhosts, host, wins, bcast. Without 
-		this parameter or any entry in the <TT
-CLASS="PARAMETER"
-><I
->name resolve order
-		</I
-></TT
-> parameter of the <TT
-CLASS="FILENAME"
->smb.conf</TT
-> 
-		file, the name resolution methods will be attempted in this 
-		order. </P
-></DD
-><DT
->-d &#60;debug level&#62;</DT
-><DD
-><P
->debug level is an integer from 0 to 10.</P
-><P
->The default value if this parameter is not specified
-		is zero.</P
-><P
->The higher this value, the more detail will be logged
-		about the activities of <B
-CLASS="COMMAND"
->nmblookup</B
->. At level
-		0, only critical errors and serious warnings will be logged.
-		</P
-></DD
-><DT
->-l logfilename</DT
-><DD
-><P
->If specified causes all debug messages to be
-		written to the file specified by <TT
-CLASS="REPLACEABLE"
-><I
->logfilename
-		</I
-></TT
->. If not specified then all messages will be 
-		written to<TT
-CLASS="REPLACEABLE"
-><I
->stderr</I
-></TT
->.
-		</P
-></DD
-><DT
->-L libdir</DT
-><DD
-><P
->This parameter specifies the location of the 
-		shared libraries used by <B
-CLASS="COMMAND"
->smbsh</B
->. The default
+		<span class="emphasis"><em>smb</em></span>.
+		</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the 
+configuration details required by the server.  The 
+information in this file includes server-specific
+information such as what printcap file to use, as well 
+as descriptions of all the services that the server is 
+to provide. See <a href="smb.conf.5.html" target="_top"><tt class="filename">
+smb.conf(5)</tt></a> for more information.
+The default configuration file name is determined at 
+compile time.</p></dd><dt><span class="term">-d|--debug=debuglevel</span></dt><dd><p><i class="replaceable"><tt>debuglevel</tt></i> is an integer 
+from 0 to 10.  The default value if this parameter is 
+not specified is zero.</p><p>The higher this value, the more detail will be 
+logged to the log files about the activities of the 
+server. At level 0, only critical errors and serious 
+warnings will be logged. Level 1 is a reasonable level for
+day to day running - it generates a small amount of 
+information about operations carried out.</p><p>Levels above 1 will generate considerable 
+amounts of log data, and should only be used when 
+investigating a problem. Levels above 3 are designed for 
+use only by developers and generate HUGE amounts of log
+data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will 
+override the <a href="smb.conf.5.html#loglevel" target="_top">log
+level</a> parameter in the <a href="smb.conf.5.html" target="_top">
+<tt class="filename">smb.conf(5)</tt></a> file.</p></dd><dt><span class="term">-R &lt;name resolve order&gt;</span></dt><dd><p>This option is used to determine what naming 
+services and in what order to resolve 
+host names to IP addresses. The option takes a space-separated 
+string of different name resolution options.</p><p>The options are: &quot;lmhosts&quot;, &quot;host&quot;, &quot;wins&quot; and &quot;bcast&quot;. 
+They cause names to be resolved as follows :</p><div class="itemizedlist"><ul type="disc"><li><p><tt class="constant">lmhosts</tt>: 
+Lookup an IP address in the Samba lmhosts file. If the 
+line in lmhosts has no name type attached to the 
+NetBIOS name 
+(see the <a href="lmhosts.5.html"><span class="citerefentry"><span class="refentrytitle">lmhosts</span>(5)</span></a>	for details) 
+then any name type matches for lookup.
+</p></li><li><p><tt class="constant">host</tt>: 
+Do a standard host name to IP address resolution, using
+the system <tt class="filename">/etc/hosts</tt>, NIS, or DNS
+lookups. This method of name resolution is operating 
+system dependent, for instance on IRIX or Solaris this 
+may be controlled by the <tt class="filename">/etc/nsswitch.conf
+</tt> file).  Note that this method is only used 
+if the NetBIOS name type being queried is the 0x20 
+(server) name type, otherwise it is ignored.
+</p></li><li><p><tt class="constant">wins</tt>: 
+Query a name with the IP address listed in the 
+<i class="parameter"><tt>wins server</tt></i> parameter.  If no 
+WINS server has been specified this method will be 
+ignored.
+</p></li><li><p><tt class="constant">bcast</tt>: 
+Do a broadcast on each of the known local interfaces 
+listed in the <i class="parameter"><tt>interfaces</tt></i>
+parameter. This is the least reliable of the name 
+resolution methods as it depends on the target host 
+being on a locally connected subnet.
+</p></li></ul></div><p>If this parameter is not set then the name resolve order 
+defined in the <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file parameter  
+(<i class="parameter"><tt>name resolve order</tt></i>) will be used. </p><p>The default order is lmhosts, host, wins, bcast. Without 
+this parameter or any entry in the <i class="parameter"><tt>name resolve order
+</tt></i> parameter of the <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file, the name resolution methods 
+will be attempted in this order. </p></dd><dt><span class="term">-L libdir</span></dt><dd><p>This parameter specifies the location of the 
+		shared libraries used by <b class="command">smbsh</b>. The default
 		value is specified at compile time.
-		</P
-></DD
-></DL
-></DIV
-></DIV
-><DIV
-CLASS="REFSECT1"
-><A
-NAME="AEN91"
-></A
-><H2
->EXAMPLES</H2
-><P
->To use the <B
-CLASS="COMMAND"
->smbsh</B
-> command, execute <B
-CLASS="COMMAND"
->	smbsh</B
-> from the prompt and enter the username and password 
+		</p></dd></dl></div></div><div class="refsect1" lang="en"><h2>EXAMPLES</h2><p>To use the <b class="command">smbsh</b> command, execute <b class="command">
+	smbsh</b> from the prompt and enter the username and password 
 	that authenticates you to the machine running the Windows NT 
-	operating system.</P
-><P
-><TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="PROGRAMLISTING"
->	<TT
-CLASS="PROMPT"
->system% </TT
-><TT
-CLASS="USERINPUT"
-><B
->smbsh</B
-></TT
->
-	<TT
-CLASS="PROMPT"
->Username: </TT
-><TT
-CLASS="USERINPUT"
-><B
->user</B
-></TT
->
-	<TT
-CLASS="PROMPT"
->Password: </TT
-><TT
-CLASS="USERINPUT"
-><B
->XXXXXXX</B
-></TT
->
-	</PRE
-></TD
-></TR
-></TABLE
-></P
-><P
->Any dynamically linked command you execute from 
-	this shell will access the <TT
-CLASS="FILENAME"
->/smb</TT
-> directory 
-	using the smb protocol. For example, the command <B
-CLASS="COMMAND"
->ls /smb
-	</B
-> will show a list of workgroups. The command 
-	<B
-CLASS="COMMAND"
->ls /smb/MYGROUP </B
-> will show all the machines in 
+	operating system.
+</p><pre class="programlisting">
+<tt class="prompt">system% </tt><b class="userinput"><tt>smbsh</tt></b>
+<tt class="prompt">Username: </tt><b class="userinput"><tt>user</tt></b>
+<tt class="prompt">Password: </tt><b class="userinput"><tt>XXXXXXX</tt></b>
+</pre><p>Any dynamically linked command you execute from 
+	this shell will access the <tt class="filename">/smb</tt> directory 
+	using the smb protocol. For example, the command <b class="command">ls /smb
+	</b> will show a list of workgroups. The command 
+	<b class="command">ls /smb/MYGROUP </b> will show all the machines in 
 	the  workgroup MYGROUP. The command 
-	<B
-CLASS="COMMAND"
->ls /smb/MYGROUP/&#60;machine-name&#62;</B
-> will show the share 
-	names for that machine. You could then, for example, use the <B
-CLASS="COMMAND"
->	cd</B
-> command to change directories, <B
-CLASS="COMMAND"
->vi</B
-> to 
-	edit files, and <B
-CLASS="COMMAND"
->rcp</B
->  to copy files.</P
-></DIV
-><DIV
-CLASS="REFSECT1"
-><A
-NAME="AEN112"
-></A
-><H2
->VERSION</H2
-><P
->This man page is correct for version 3.0 of 
-	the Samba suite.</P
-></DIV
-><DIV
-CLASS="REFSECT1"
-><A
-NAME="AEN115"
-></A
-><H2
->BUGS</H2
-><P
-><B
-CLASS="COMMAND"
->smbsh</B
-> works by intercepting the standard 
-	libc calls with the dynamically loaded versions in <TT
-CLASS="FILENAME"
->	smbwrapper.o</TT
->. Not all calls have been "wrapped", so 
-	some programs may not function correctly under <B
-CLASS="COMMAND"
->smbsh
-	</B
->.</P
-><P
->Programs which are not dynamically linked cannot make 
-	use of <B
-CLASS="COMMAND"
->smbsh</B
->'s functionality. Most versions 
-	of UNIX have a <B
-CLASS="COMMAND"
->file</B
-> command that will 
-	describe how a program was linked.</P
-></DIV
-><DIV
-CLASS="REFSECT1"
-><A
-NAME="AEN124"
-></A
-><H2
->SEE ALSO</H2
-><P
-><A
-HREF="smbd.8.html"
-TARGET="_top"
-><B
-CLASS="COMMAND"
->smbd(8)</B
-></A
->, 
-	<A
-HREF="smb.conf.5.html"
-TARGET="_top"
->smb.conf(5)</A
->
-	</P
-></DIV
-><DIV
-CLASS="REFSECT1"
-><A
-NAME="AEN130"
-></A
-><H2
->AUTHOR</H2
-><P
->The original Samba software and related utilities 
+	<b class="command">ls /smb/MYGROUP/&lt;machine-name&gt;</b> will show the share 
+	names for that machine. You could then, for example, use the <b class="command">
+	cd</b> command to change directories, <b class="command">vi</b> to 
+	edit files, and <b class="command">rcp</b>  to copy files.</p></div><div class="refsect1" lang="en"><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><h2>BUGS</h2><p><b class="command">smbsh</b> works by intercepting the standard 
+	libc calls with the dynamically loaded versions in <tt class="filename">
+	smbwrapper.o</tt>. Not all calls have been &quot;wrapped&quot;, so 
+	some programs may not function correctly under <b class="command">smbsh
+	</b>.</p><p>Programs which are not dynamically linked cannot make 
+	use of <b class="command">smbsh</b>'s functionality. Most versions 
+	of UNIX have a <b class="command">file</b> command that will 
+	describe how a program was linked.</p></div><div class="refsect1" lang="en"><h2>SEE ALSO</h2><p><a href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a></p></div><div class="refsect1" lang="en"><h2>AUTHOR</h2><p>The original Samba software and related utilities 
 	were created by Andrew Tridgell. Samba is now developed
 	by the Samba Team as an Open Source project similar 
-	to the way the Linux kernel is developed.</P
-><P
->The original Samba man pages were written by Karl Auer. 
+	to the way the Linux kernel is developed.</p><p>The original Samba man pages were written by Karl Auer. 
 	The man page sources were converted to YODL format (another 
-	excellent piece of Open Source software, available at
-	<A
-HREF="ftp://ftp.icce.rug.nl/pub/unix/"
-TARGET="_top"
->	ftp://ftp.icce.rug.nl/pub/unix/</A
->) and updated for the Samba 2.0 
+	excellent piece of Open Source software, available at <a href="ftp://ftp.icce.rug.nl/pub/unix/" target="_top">
+	ftp://ftp.icce.rug.nl/pub/unix/</a>) and updated for the Samba 2.0 
 	release by Jeremy Allison.  The conversion to DocBook for 
-	Samba 2.2 was done by Gerald Carter</P
-></DIV
-></BODY
-></HTML
->
-\ No newline at end of file
+	Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2
+	for Samba 3.0 was done by Alexander Bokovoy.</p></div></div></body></html>
author	Jelmer Vernooij <jelmer@samba.org>	2003-06-06 20:07:16 +0000
committer	Jelmer Vernooij <jelmer@samba.org>	2003-06-06 20:07:16 +0000
commit	f7e07eafc88128a556efbc94a9b062fd48ad91f4 (patch)
tree	eca1673bc2ad9c752869b4f0d99abee35c31acf1 /docs/htmldocs/smbsh.1.html
parent	bea0cf2c7930b01035109c201d57e43cd29a0591 (diff)
download	samba-f7e07eafc88128a556efbc94a9b062fd48ad91f4.tar.gz samba-f7e07eafc88128a556efbc94a9b062fd48ad91f4.tar.bz2 samba-f7e07eafc88128a556efbc94a9b062fd48ad91f4.zip