Ignore:
Timestamp:
06/13/2004 05:38:30 AM (20 years ago)
Author:
DJ Lucas <dj@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
60384c68
Parents:
08254fc
Message:

Part VI xml update + bz815

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2307 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/other/samba3.xml

    r08254fc r0931098  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY samba3-download-http "http://us1.samba.org/samba/ftp/samba-&samba3-version;.tar.gz">
     8<!ENTITY samba3-download-ftp "ftp://ftp.samba.org/pub/samba/samba-&samba3-version;.tar.gz">
     9<!ENTITY samba3-size "14.4 MB">
     10<!ENTITY samba3-buildsize "123 MB">
     11<!ENTITY samba3-time "10.5 SBU">
     12
     13]>
     14
    115<sect1 id="samba3" xreflabel="Samba-&samba3-version;">
    216<?dbhtml filename="samba3.html"?>
    317<title>Samba-&samba3-version;</title>
    418
    5 &samba3-intro;
    6 &samba3-inst;
    7 &samba3-exp;
    8 &samba3-config;
    9 &samba3-desc;
     19<sect2>
     20<title>Introduction to <application>Samba</application></title>
     21
     22<para>The <application>Samba</application> package provides file and print
     23services to <acronym>SMB</acronym>/<acronym>CIFS</acronym> clients and
     24Windows networking to Linux clients.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&samba3-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&samba3-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &samba3-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &samba3-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &samba3-time;</para></listitem></itemizedlist>
     33</sect3>
     34
     35<sect3><title>Additional downloads</title>
     36<itemizedlist spacing='compact'>
     37<listitem><para>Maintainer Recommended patch:
     38<ulink url="&patch-root;/samba-3.0.4-maintainer.patch"/></para></listitem>
     39</itemizedlist>
     40</sect3>
     41
     42<sect3>
     43<title><application>Samba</application> dependencies</title>
     44<sect4>
     45<title>Optional</title>
     46<para>
     47<xref linkend="Linux_PAM"/>,
     48<xref linkend="readline"/>,
     49<xref linkend="openldap"/>,
     50<xref linkend="cups"/>,
     51<xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
     52<xref linkend="libxml2"/>,
     53<xref linkend="mysql"/> or <xref linkend="postgresql"/>,
     54<xref linkend="Python"/>, and
     55<ulink url="http://valgrind.kde.org/">Valgrind</ulink>
     56</para>
     57</sect4>
     58</sect3>
     59
     60</sect2>
     61
     62<sect2>
     63<title>Installation of <application>Samba</application></title>
     64
     65<para>Install <application>Samba</application> by running the following
     66commands:</para>
     67
     68<screen><userinput><command>patch -Np1 -i samba-3.0.4-maintainer.patch &amp;&amp;
     69cd source &amp;&amp;
     70install -d /var/cache/samba &amp;&amp;
     71./configure \
     72    --prefix=/usr \
     73    --sysconfdir=/etc \
     74    --localstatedir=/var \
     75    --with-piddir=/var/run \
     76    --with-fhs \
     77    --with-smbmount &amp;&amp;
     78make &amp;&amp;
     79make install &amp;&amp;
     80install -m755 nsswitch/libnss_win{s,bind}.so /lib &amp;&amp;
     81ln -sf libnss_winbind.so /lib/libnss_winbind.so.2 &amp;&amp;
     82ln -sf libnss_wins.so /lib/libnss_wins.so.2 &amp;&amp;
     83cp ../examples/smb.conf.default /etc/samba</command></userinput></screen>
     84
     85<note><para>You may want to run <command>configure</command> with the
     86<parameter>--help</parameter> parameter.  There may be other parameters
     87needed to take advantage of the optional dependencies.</para></note>
     88
     89</sect2>
     90
     91<sect2>
     92<title>Installation command explanations</title>
     93
     94<para><command>install -d /var/cache/samba</command>: This directory is
     95needed for proper operation of the <command>smbd</command> and
     96<command>nmbd</command> daemons.</para>
     97
     98<para><parameter>--sysconfdir=/etc</parameter>: Sets the configuration
     99file directory to avoid the default of <filename class="directory">/usr/etc</filename>.</para>
     100
     101<para><parameter>--localstatedir=/var</parameter>: Sets the variable
     102data directory to avoid the default of <filename class="directory">/usr/var</filename>.</para>
     103
     104<para><option>--with-fhs</option>: Assigns all other file paths in a manner
     105compliant with the Filesystem Hierarchy Standard
     106(<acronym>FHS</acronym>).</para>
     107
     108<para><option>--with-smbmount</option>: Orders the creation of an extra
     109binary for use by the <command>mount</command> command so that mounting remote
     110<acronym>SMB</acronym> (Windows) shares becomes no more complex than mounting
     111remote <acronym>NFS</acronym> shares.</para>
     112
     113<para><command>install -m755 nsswitch/libnss_win{s,bind}.so /lib</command>:
     114The nss libraries are not installed by default.  If you intend to use
     115winbindd for domain auth, and/or <acronym>WINS</acronym> name resolution,
     116you need these libraries.</para>
     117
     118<para><command>ln -sf libnss_winbind.so /lib/libnss_winbind.so.2</command>
     119and <command>ln -sf libnss_wins.so /lib/libnss_wins.so.2</command>:
     120These symlinks are required by glibc to use the nss libraries.</para>
     121
     122<para><command>cp ../examples/smb.conf.default /etc/samba</command>:
     123This copies a default <filename>smb.conf </filename>into
     124<filename>/etc/samba</filename>.  This sample configuration will not
     125work unless edited for your site, and renamed
     126<filename>smb.conf</filename>.</para>
     127
     128</sect2>
     129
     130<sect2>
     131<title>Configuring <application>Samba</application></title>
     132
     133<para>Because of the various uses for <application>Samba</application>,
     134complete configuration is well beyond the scope of the BLFS book. 
     135In fact, many complete books have been written on this topic alone. 
     136The included documentation, a popular book published by O'Reilly,
     137can be viewed by pointing your web browser to
     138<ulink url="file:///usr/share/samba/swat/using_samba/toc.html" />.
     139</para>
     140
     141<para>The built in <acronym>SWAT</acronym> (Samba Web Administration Tool)
     142utility can be used for basic configuration, however, before
     143using <acronym>SWAT</acronym> you must add an entry to
     144<filename>/etc/services</filename> and make changes to your
     145<command>inetd</command>/<command>xinetd</command>
     146configuration.</para>
     147
     148<para>Add the swat entry to <filename>/etc/services</filename> with the
     149following command: </para>
     150
     151<screen><userinput><command>echo "swat            901/tcp" &gt;&gt; /etc/services</command></userinput></screen>
     152
     153<para>If <command>inetd</command> is used, the following command will add the
     154swat entry to <filename>/etc/inetd.conf</filename>: </para>
     155
     156<screen><userinput><command>echo "swat stream tcp nowait.400 root /usr/sbin/swat swat" \
     157    &gt;&gt; /etc/inetd.conf</command></userinput></screen>
     158<para>Issue a <command>killall -HUP inetd</command> to reread the
     159changed <filename>inetd.conf</filename> file.</para>
     160
     161<para>If <command>xinetd</command> is used, the following command will
     162add the swat entry to <filename>/etc/xinetd.conf</filename>: </para>
     163
     164<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
     165service swat
     166{
     167    port            = 901
     168    socket_type     = stream
     169    wait            = no
     170    only_from       = 127.0.0.1
     171    user            = root
     172    server          = /usr/sbin/swat
     173    log_on_failure  += USERID
     174}
     175<command>EOF</command></userinput></screen>
     176
     177<para>Issue a <command>killall -HUP xinetd</command> to reread the
     178changed <filename>xinetd.conf</filename> file.</para>
     179
     180<para><acronym>SWAT</acronym> can be launched by pointing your web
     181browser to <ulink url="http://localhost:901"/>.</para>
     182
     183<para>For your convenience, boot scripts have been provided for
     184<application>Samba</application>.  There are two included in the
     185<xref linkend="intro-important-bootscripts"/> package.  The first,
     186<filename>samba</filename>, will start the <command>smbd</command> and
     187<command>nmbd</command> daemons needed to provide
     188<acronym>SMB</acronym>/<acronym>CIFS</acronym> services.  The second
     189script, <filename>winbind</filename>, starts the <command>winbindd</command>
     190daemon, used for providing Windows domain services to Linux clients.</para>
     191
     192<para>Install the <filename>samba</filename> script with the following
     193command:</para>
     194
     195<screen><userinput><command>make install-samba</command></userinput></screen>
     196
     197<para>If you also need the <filename>winbind</filename> script:</para>
     198
     199<screen><userinput><command>make install-winbind</command></userinput></screen>
     200
     201</sect2>
     202
     203<sect2>
     204<title>Contents</title>
     205
     206<para>The <application>Samba</application> package contains
     207<command>make_smbcodepage</command>,
     208<command>make_unicodemap</command>,
     209<command>mount.smbfs</command>,
     210<command>net</command>,
     211<command>nmbd</command>,
     212<command>nmblookup</command>,
     213<command>rpcclient</command>,
     214<command>smbcacls</command>,
     215<command>smbclient</command>,
     216<command>smbcontrol</command>,
     217<command>smbd</command>,
     218<command>smbpasswd</command>,
     219<command>smbspool</command>,
     220<command>smbstatus</command>,
     221<command>swat</command>,
     222<command>testparm</command>,
     223<command>testprns</command>,
     224<command>wbinfo</command> and
     225<command>winbindd.</command></para></sect2>
     226
     227<sect2>
     228<title>Description</title>
     229<sect3><title>make_smbcodepage</title>
     230<para><command>make_smbcodepage</command> converts text descriptions of code
     231pages to binary code page files and vice versa.</para></sect3>
     232<sect3><title>make_unicodemap</title>
     233<para><command>make_unicodemap</command> converts text Unicode map files to
     234binary, for use in mapping characters to 16 bit Unicode.</para></sect3>
     235<sect3><title>mount.smbfs</title>
     236<para><command>mount.smbfs</command> provides <command>/bin/mount</command>
     237with a way to mount remote Windows (or Samba) fileshares.</para></sect3>
     238<sect3><title>net</title>
     239<para><command>net</command> is a tool for administration of Samba and remote
     240CIFS servers, similar to the net utility for DOS/Windows.</para></sect3>
     241<sect3><title>nmbd</title>
     242<para><command>nmbd</command> is the Samba Net<acronym>BIOS</acronym> name
     243server.</para></sect3>
     244<sect3><title>nmblookup</title>
     245<para><command>nmblookup</command> is used to query
     246Net<acronym>BIOS</acronym> names and map them to <acronym>IP</acronym>
     247addresses.</para></sect3>
     248<sect3><title>rpcclient</title>
     249<para><command>rpcclient</command> is used to execute
     250MS-<acronym>RPC</acronym> client side functions.</para></sect3>
     251<sect3><title>smbcacls</title>
     252<para><command>smbcacls</command> is used to manipulate NT access control
     253lists.</para></sect3>
     254<sect3><title>smbclient</title>
     255<para><command>smbclient</command> is a <acronym>SMB</acronym>/<acronym>CIFS
     256</acronym> access utility, similar to <acronym>FTP</acronym>.</para></sect3>
     257<sect3><title>smbcontrol</title>
     258<para><command>smbcontrol</command> is used to control running <command>smbd</command>,
     259<command>nmbd</command> and <command>winbindd</command>
     260daemons.</para></sect3>
     261<sect3><title>smbd</title>
     262<para><command>smbd</command> is the main
     263<application>Samba</application> daemon.</para></sect3>
     264<sect3><title>smbpasswd</title>
     265<para><command>smbpasswd</command> changes a user's <application>Samba
     266</application> password.</para></sect3>
     267<sect3><title>smbspool</title>
     268<para><command>smbspool</command> sends a print job to an <acronym>SMB
     269</acronym> printer.</para></sect3>
     270<sect3><title>smbstatus</title>
     271<para><command>smbstatus</command> reports current
     272<application>Samba</application> connections.</para></sect3>
     273<sect3><title>swat</title>
     274<para><command>swat</command> is the Samba Web Administration Tool.</para>
     275</sect3>
     276<sect3><title>testparm</title>
     277<para><command>testparm</command> checks an <filename>smb.conf</filename> file
     278for proper syntax.</para></sect3>
     279<sect3><title>testprns</title>
     280<para><command>testprns</command> tests printer names.</para></sect3>
     281<sect3><title>wbinfo</title>
     282<para><command>wbinfo</command> queries a running <command>winbindd</command>
     283daemon.</para></sect3>
     284<sect3><title>winbindd</title>
     285<para><command>winbindd</command> resolves names from NT servers.</para></sect3>
     286</sect2>
    10287
    11288</sect1>
Note: See TracChangeset for help on using the changeset viewer.