Adding upstream version 2:4.17.12+dfsg.upstream/2%4.17.12+dfsgupstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 332 insertions, 0 deletions

diff --git a/docs-xml/manpages/samba.7.xml b/docs-xml/manpages/samba.7.xml
new file mode 100644
index 0000000..627ba63
--- /dev/null
+++ b/docs-xml/manpages/samba.7.xml
@@ -0,0 +1,332 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
+<refentry id="samba.7">
+
+<refmeta>
+	<refentrytitle>samba</refentrytitle>
+	<manvolnum>7</manvolnum>
+	<refmiscinfo class="source">Samba</refmiscinfo>
+	<refmiscinfo class="manual">Miscellanea</refmiscinfo>
+	<refmiscinfo class="version">&doc.version;</refmiscinfo>
+</refmeta>
+
+
+<refnamediv>
+	<refname>samba</refname>
+	<refpurpose>A Windows AD and SMB/CIFS fileserver for UNIX</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+	<cmdsynopsis><command>samba</command></cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+	<title>DESCRIPTION</title>
+
+	<para>The Samba software suite is a collection of programs
+	that implements the Server Message Block (commonly abbreviated
+	as SMB) protocol for UNIX systems and provides Active Directory
+	services. The first version of the SMB protocol is sometimes also
+	referred to as the Common Internet File System (CIFS). For a more
+	thorough description, see <ulink url="http://www.ubiqx.org/cifs/">
+	http://www.ubiqx.org/cifs/</ulink>. Samba also implements the NetBIOS
+	protocol in nmbd.</para>
+
+	<variablelist>
+		<varlistentry>
+		<term><citerefentry><refentrytitle>samba</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para>The <command>samba</command> daemon provides the
+		Active Directory services and file and print services to
+		SMB clients. The configuration file
+		for this daemon is described in <citerefentry><refentrytitle>smb.conf</refentrytitle>
+		<manvolnum>5</manvolnum></citerefentry>.
+		</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para>The <command>smbd</command> daemon provides the file and print services to
+		SMB clients. The configuration file
+		for this daemon is described in <citerefentry><refentrytitle>smb.conf</refentrytitle>
+		<manvolnum>5</manvolnum></citerefentry>.
+		</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>nmbd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para>The <command>nmbd</command>
+		daemon provides NetBIOS nameservice and browsing
+		support. The configuration file for this daemon
+		is described in <citerefentry><refentrytitle>smb.conf</refentrytitle>
+		<manvolnum>5</manvolnum></citerefentry>.</para>
+		</listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>winbindd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para><command>winbindd</command> is a daemon
+		that is used for integrating authentication and
+		the user database into unix.</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbclient</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para>The <command>smbclient</command>
+		program implements a simple ftp-like client. This
+		is useful for accessing SMB shares on other compatible
+		SMB servers, and can also be used
+		to allow a UNIX box to print to a printer attached to
+		any SMB server.</para>
+		</listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>samba-tool</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para>The <command>samba-tool</command>
+		is the main Samba Administration tool regarding
+		Active Directory services.</para>
+		</listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>testparm</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para>The <command>testparm</command>
+		utility is a simple syntax checker for Samba's <citerefentry><refentrytitle>smb.conf</refentrytitle>
+		<manvolnum>5</manvolnum></citerefentry> configuration file.
+		In AD server mode <command>samba-tool testparm</command>
+		should be used though.</para>
+		</listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbstatus</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para>The <command>smbstatus</command>
+		tool provides access to information about the
+		current connections to <command>smbd</command>.</para>
+		</listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>nmblookup</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para>The <command>nmblookup</command>
+		tool allows NetBIOS name queries to be made.</para>
+		</listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbpasswd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para>The <command>smbpasswd</command>
+		command is a tool for setting passwords on local Samba but
+		also on	remote SMB servers.</para>
+		</listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbcacls</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para>The <command>smbcacls</command> command is
+		a tool to set ACL's on remote SMB servers.</para>
+		</listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbtree</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para>The <command>smbtree</command> command
+		is a text-based network neighborhood tool.</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbtar</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para>The <command>smbtar</command> can make
+		backups of data directly from SMB servers.</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbspool</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para><command>smbspool</command> is a
+		helper utility for printing on printers connected
+		to SMB servers. </para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbcontrol</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para><command>smbcontrol</command> is a utility
+		that can change the behaviour of running
+		<command>samba</command>, <command>smbd</command>, <command>nmbd</command> and
+		<command>winbindd</command> daemons.
+		</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>rpcclient</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para><command>rpcclient</command> is a utility
+		that can be used to execute RPC commands on remote
+		SMB servers.</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>pdbedit</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para>The <command>pdbedit</command> command
+		can be used to maintain the local user database on
+		a Samba server.</para></listitem></varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>net</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry></term>
+		<listitem><para>The <command>net</command> command
+		is the main administration tool for Samba member and
+		standalone servers.</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>wbinfo</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para><command>wbinfo</command> is a utility
+		that retrieves and stores information related to winbind.
+		</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>profiles</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para><command>profiles</command> is a command-line
+		utility that can be used to replace all occurrences of
+		a certain SID with another SID.
+		</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>log2pcap</refentrytitle>
+				<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para><command>log2pcap</command> is a utility
+				for generating pcap trace files from Samba log
+				files.</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>vfstest</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para><command>vfstest</command> is a utility
+		that can be used to test vfs modules.</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>ntlm_auth</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para><command>ntlm_auth</command> is a helper-utility
+		for external programs wanting to do NTLM-authentication.
+		</para></listitem></varlistentry>
+
+		<varlistentry>
+		<term><citerefentry><refentrytitle>smbcquotas</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry></term>
+		<listitem><para><command>smbcquotas</command> is a tool to
+		manage quotas on remote SMB servers. </para>
+		</listitem>
+		</varlistentry>
+	</variablelist>
+</refsect1>
+
+<refsect1>
+	<title>COMPONENTS</title>
+
+	<para>The Samba suite is made up of several components. Each
+	component is described in a separate manual page. It is strongly
+	recommended that you read the documentation that comes with Samba
+	and the manual pages of those components that you use. If the
+	manual pages and documents aren't clear enough then please visit
+	<ulink url="https://devel.samba.org/">https://devel.samba.org</ulink>
+	for information on how to file a bug report or submit a patch.</para>
+
+	<para>If you require help, visit the Samba webpage at
+	<ulink url="https://www.samba.org/">https://www.samba.org/</ulink> and
+	explore the many option available to you.
+	</para>
+</refsect1>
+
+<refsect1>
+	<title>AVAILABILITY</title>
+
+	<para>The Samba software suite is licensed under the
+	GNU Public License(GPL). A copy of that license should
+	have come with the package in the file COPYING. You are
+	encouraged to distribute copies of the Samba suite, but
+	please obey the terms of this license.</para>
+
+	<para>The latest version of the Samba suite can be
+	obtained from <ulink url="https://download.samba.org/pub/samba/">
+	https://download.samba.org/pub/samba/</ulink>.
+	</para>
+
+	<para>The Samba Wiki at
+	<ulink url="https://wiki.samba.org/">https://wiki.samba.org</ulink>
+	has also a lot of useful information.
+	On the Samba mailing list at
+	<ulink url="https://lists.samba.org/">https://lists.samba.org</ulink>
+	you can	find a lot of information in the archives and you can
+	subscribe to the samba list and ask for help or discuss things.
+	</para>
+</refsect1>
+
+<refsect1>
+	<title>VERSION</title>
+
+	<para>This man page is part of version &doc.version; of the
+	Samba suite. </para>
+</refsect1>
+
+<refsect1>
+	<title>CONTRIBUTIONS</title>
+
+	<para>If you wish to contribute to the Samba project,
+	then I suggest you join the Samba mailing list at
+	<ulink url="https://lists.samba.org/">https://lists.samba.org</ulink>.
+	</para>
+
+	<para>If you have patches to submit, visit
+	<ulink url="https://devel.samba.org/">https://devel.samba.org/</ulink>
+	for information on how to do it properly. We prefer patches
+	in <command>git format-patch</command> format.</para>
+</refsect1>
+
+<refsect1>
+	<title>CONTRIBUTORS</title>
+
+	<para>Contributors to the project are now too numerous
+	to mention here but all deserve the thanks of all Samba
+	users. To see a full list, look at the
+	<filename>change-log</filename> in the source package
+	for the pre-CVS changes and at <ulink
+	url="https://git.samba.org/">
+	https://git.samba.org/</ulink>
+	for the contributors to Samba post-GIT. GIT is the Open Source
+	source code control system used by the Samba Team to develop
+	Samba. The project would have been unmanageable without it.</para>
+</refsect1>
+
+<refsect1>
+	<title>AUTHOR</title>
+
+	<para>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.</para>
+</refsect1>
+
+</refentry>