Ignore:
Timestamp:
Nov 24, 2016, 1:14:11 PM (9 years ago)
Author:
Silvan Scherrer
Message:

Samba Server: update vendor to version 4.4.3

Location:
vendor/current/docs-xml/manpages
Files:
1 edited
1 moved

Legend:

Unmodified
Added
Removed
  • vendor/current/docs-xml/manpages/samba.7.xml

    r860 r988  
    88        <refmiscinfo class="source">Samba</refmiscinfo>
    99        <refmiscinfo class="manual">Miscellanea</refmiscinfo>
    10         <refmiscinfo class="version">3.6</refmiscinfo>
     10        <refmiscinfo class="version">4.4</refmiscinfo>
    1111</refmeta>
    1212
     
    1414<refnamediv>
    1515        <refname>samba</refname>
    16         <refpurpose>A Windows SMB/CIFS fileserver for UNIX</refpurpose>
     16        <refpurpose>A Windows AD and SMB/CIFS fileserver for UNIX</refpurpose>
    1717</refnamediv>
    1818
     
    2323<refsect1>
    2424        <title>DESCRIPTION</title>
    25        
    26         <para>The Samba software suite is a collection of programs
    27         that implements the Server Message Block (commonly abbreviated
    28         as SMB) protocol for UNIX systems. This protocol is sometimes
    29         also referred to as the Common Internet File System (CIFS). For a
    30         more thorough description, see <ulink url="http://www.ubiqx.org/cifs/">
     25
     26        <para>The Samba software suite is a collection of programs
     27        that implements the Server Message Block (commonly abbreviated
     28        as SMB) protocol for UNIX systems and provides Active Directory
     29        services. This protocol is sometimes also referred to as the
     30        Common Internet File System (CIFS). For a more thorough description,
     31        see <ulink url="http://www.ubiqx.org/cifs/">
    3132        http://www.ubiqx.org/cifs/</ulink>. Samba also implements the NetBIOS
    3233        protocol in nmbd.</para>
    33        
     34
    3435        <variablelist>
    3536                <varlistentry>
     37                <term><citerefentry><refentrytitle>samba</refentrytitle>
     38                <manvolnum>8</manvolnum></citerefentry></term>
     39                <listitem><para>The <command>samba</command> daemon provides the
     40                Active Directory services and file and print services to
     41                SMB clients. The configuration file
     42                for this daemon is described in <citerefentry><refentrytitle>smb.conf</refentrytitle>
     43                <manvolnum>5</manvolnum></citerefentry>.
     44                </para></listitem>
     45                </varlistentry>
     46
     47                <varlistentry>
    3648                <term><citerefentry><refentrytitle>smbd</refentrytitle>
    3749                <manvolnum>8</manvolnum></citerefentry></term>
    38                 <listitem><para>The <command>smbd</command> daemon provides the file and print services to 
    39                 SMB clients, such as Windows 95/98, Windows NT, Windows 
    40                 for Workgroups or LanManager. The configuration file 
     50                <listitem><para>The <command>smbd</command> daemon provides the file and print services to
     51                SMB clients, such as Windows 95/98, Windows NT, Windows
     52                for Workgroups or LanManager. The configuration file
    4153                for this daemon is described in <citerefentry><refentrytitle>smb.conf</refentrytitle>
    42                 <manvolnum>5</manvolnum></citerefentry>
    43                 </para></listitem>
    44                 </varlistentry>
    45                
     54                <manvolnum>5</manvolnum></citerefentry>.
     55                </para></listitem>
     56                </varlistentry>
     57
    4658                <varlistentry>
    4759                <term><citerefentry><refentrytitle>nmbd</refentrytitle>
     
    4961                <listitem><para>The <command>nmbd</command>
    5062                daemon provides NetBIOS nameservice and browsing
    51                 support. The configuration file for this daemon 
     63                support. The configuration file for this daemon
    5264                is described in <citerefentry><refentrytitle>smb.conf</refentrytitle>
    53                 <manvolnum>5</manvolnum></citerefentry></para>
    54                 </listitem>
     65                <manvolnum>5</manvolnum></citerefentry>.</para>
     66                </listitem>
     67                </varlistentry>
     68
     69                <varlistentry>
     70                <term><citerefentry><refentrytitle>winbindd</refentrytitle>
     71                <manvolnum>8</manvolnum></citerefentry></term>
     72                <listitem><para><command>winbindd</command> is a daemon
     73                that is used for integrating authentication and
     74                the user database into unix.</para></listitem>
    5575                </varlistentry>
    5676
     
    5979                <manvolnum>1</manvolnum></citerefentry></term>
    6080                <listitem><para>The <command>smbclient</command>
    61                 program implements a simple ftp-like client. This 
     81                program implements a simple ftp-like client. This
    6282                is useful for accessing SMB shares on other compatible
    63                 servers (such as Windows NT), and can also be used 
    64                 to allow a UNIX box to print to a printer attached to 
     83                servers (such as Windows NT), and can also be used
     84                to allow a UNIX box to print to a printer attached to
    6585                any SMB server (such as a PC running Windows NT).</para>
     86                </listitem>
     87                </varlistentry>
     88
     89                <varlistentry>
     90                <term><citerefentry><refentrytitle>samba-tool</refentrytitle>
     91                <manvolnum>8</manvolnum></citerefentry></term>
     92                <listitem><para>The <command>samba-tool</command>
     93                is the main Samba Administration tool regarding
     94                Active Directory services.</para>
    6695                </listitem>
    6796                </varlistentry>
     
    77106
    78107                <varlistentry>
    79                 <term><citerefentry><refentrytitle>testprns</refentrytitle>
    80                 <manvolnum>1</manvolnum></citerefentry></term>
    81                 <listitem><para>The <command>testprns</command>
    82                 utility supports testing printer names defined
    83                 in your <filename>printcap</filename> file used
    84                 by Samba.</para>
    85                 </listitem>
    86                 </varlistentry>
    87 
    88                 <varlistentry>
    89108                <term><citerefentry><refentrytitle>smbstatus</refentrytitle>
    90109                <manvolnum>1</manvolnum></citerefentry></term>
    91110                <listitem><para>The <command>smbstatus</command>
    92                 tool provides access to information about the 
     111                tool provides access to information about the
    93112                current connections to <command>smbd</command>.</para>
    94113                </listitem>
     
    99118                <manvolnum>1</manvolnum></citerefentry></term>
    100119                <listitem><para>The <command>nmblookup</command>
    101                 tools allows NetBIOS name queries to be made 
     120                tools allows NetBIOS name queries to be made
    102121                from a UNIX host.</para>
    103122                </listitem>
     
    108127                <manvolnum>8</manvolnum></citerefentry></term>
    109128                <listitem><para>The <command>smbpasswd</command>
    110                 command is a tool for changing LanMan and Windows NT 
     129                command is a tool for changing LanMan and Windows NT
    111130                password hashes on Samba and Windows NT servers.</para>
    112131                </listitem>
     
    116135                <term><citerefentry><refentrytitle>smbcacls</refentrytitle>
    117136                <manvolnum>1</manvolnum></citerefentry></term>
    118                 <listitem><para>The <command>smbcacls</command> command is 
     137                <listitem><para>The <command>smbcacls</command> command is
    119138                a tool to set ACL's on remote CIFS servers. </para>
    120139                </listitem>
     
    122141
    123142                <varlistentry>
    124                 <term><citerefentry><refentrytitle>smbsh</refentrytitle>
    125                 <manvolnum>1</manvolnum></citerefentry></term>
    126                 <listitem><para>The <command>smbsh</command> command is
    127                 a program that allows you to run a unix shell with
    128                 with an overloaded VFS.</para></listitem>
    129                 </varlistentry>
    130 
    131                 <varlistentry>
    132143                <term><citerefentry><refentrytitle>smbtree</refentrytitle>
    133144                <manvolnum>1</manvolnum></citerefentry></term>
    134                 <listitem><para>The <command>smbtree</command> command 
     145                <listitem><para>The <command>smbtree</command> command
    135146                is a text-based network neighborhood tool.</para></listitem>
    136147                </varlistentry>
     
    139150                <term><citerefentry><refentrytitle>smbtar</refentrytitle>
    140151                <manvolnum>1</manvolnum></citerefentry></term>
    141                 <listitem><para>The <command>smbtar</command> can make 
     152                <listitem><para>The <command>smbtar</command> can make
    142153                backups of data on CIFS/SMB servers.</para></listitem>
    143154                </varlistentry>
     
    146157                <term><citerefentry><refentrytitle>smbspool</refentrytitle>
    147158                <manvolnum>8</manvolnum></citerefentry></term>
    148                 <listitem><para><command>smbspool</command> is a 
    149                 helper utility for printing on printers connected 
     159                <listitem><para><command>smbspool</command> is a
     160                helper utility for printing on printers connected
    150161                to CIFS servers. </para></listitem>
    151162                </varlistentry>
     
    155166                <manvolnum>1</manvolnum></citerefentry></term>
    156167                <listitem><para><command>smbcontrol</command> is a utility
    157                 that can change the behaviour of running samba daemons.
     168                that can change the behaviour of running
     169                <command>smbd</command>, <command>nmbd</command> and
     170                <command>winbindd</command> daemons.
    158171                </para></listitem>
    159172                </varlistentry>
     
    163176                <manvolnum>1</manvolnum></citerefentry></term>
    164177                <listitem><para><command>rpcclient</command> is a utility
    165                 that can be used to execute RPC commands on remote 
     178                that can be used to execute RPC commands on remote
    166179                CIFS servers.</para></listitem>
    167180                </varlistentry>
     
    170183                <term><citerefentry><refentrytitle>pdbedit</refentrytitle>
    171184                <manvolnum>8</manvolnum></citerefentry></term>
    172                 <listitem><para>The <command>pdbedit</command> command 
    173                 can be used to maintain the local user database on 
     185                <listitem><para>The <command>pdbedit</command> command
     186                can be used to maintain the local user database on
    174187                a samba server.</para></listitem></varlistentry>
    175188
     
    177190                <term><citerefentry><refentrytitle>findsmb</refentrytitle>
    178191                <manvolnum>1</manvolnum></citerefentry></term>
    179                 <listitem><para>The <command>findsmb</command> command 
     192                <listitem><para>The <command>findsmb</command> command
    180193                can be used to find SMB servers on the local network.
    181194                </para></listitem></varlistentry>
     
    184197                <term><citerefentry><refentrytitle>net</refentrytitle>
    185198                <manvolnum>8</manvolnum></citerefentry></term>
    186                 <listitem><para>The <command>net</command> command 
     199                <listitem><para>The <command>net</command> command
    187200                is supposed to work similar to the DOS/Windows
    188201                NET.EXE command.</para></listitem>
     
    190203
    191204                <varlistentry>
    192                 <term><citerefentry><refentrytitle>swat</refentrytitle>
    193                 <manvolnum>8</manvolnum></citerefentry></term>
    194                 <listitem><para><command>swat</command> is a web-based
    195                 interface to configuring <filename>smb.conf</filename>.
    196                 </para></listitem>
    197                 </varlistentry>
    198 
    199                 <varlistentry>
    200                 <term><citerefentry><refentrytitle>winbindd</refentrytitle>
    201                 <manvolnum>8</manvolnum></citerefentry></term>
    202                 <listitem><para><command>winbindd</command> is a daemon
    203                 that is used for integrating authentication and
    204                 the user database into unix.</para></listitem>
    205                 </varlistentry>
    206 
    207                 <varlistentry>
    208205                <term><citerefentry><refentrytitle>wbinfo</refentrytitle>
    209206                <manvolnum>1</manvolnum></citerefentry></term>
    210                 <listitem><para><command>wbinfo</command> is a utility 
     207                <listitem><para><command>wbinfo</command> is a utility
    211208                that retrieves and stores information related to winbind.
    212209                </para></listitem>
     
    225222                <term><citerefentry><refentrytitle>log2pcap</refentrytitle>
    226223                                <manvolnum>1</manvolnum></citerefentry></term>
    227                 <listitem><para><command>log2pcap</command> is a utility 
    228                                 for generating pcap trace files from Samba log 
     224                <listitem><para><command>log2pcap</command> is a utility
     225                                for generating pcap trace files from Samba log
    229226                                files.</para></listitem>
    230227                </varlistentry>
     
    245242
    246243                <varlistentry>
    247                         <term>
    248 <citerefentry><refentrytitle>smbmount</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
    249 <citerefentry><refentrytitle>smbumount</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
    250 <citerefentry><refentrytitle>smbmnt</refentrytitle><manvolnum>8</manvolnum></citerefentry></term>
    251                 <listitem><para><command>smbmount</command>,<command>smbumount</command> and <command>smbmnt</command> are commands that can be used to
    252                 mount CIFS/SMB shares on Linux.
    253                 </para></listitem>
    254                 </varlistentry>
    255 
    256                 <varlistentry>
    257244                <term><citerefentry><refentrytitle>smbcquotas</refentrytitle>
    258245                <manvolnum>1</manvolnum></citerefentry></term>
    259                 <listitem><para><command>smbcquotas</command> is a tool that 
     246                <listitem><para><command>smbcquotas</command> is a tool that
    260247                can set remote QUOTA's on server with NTFS 5. </para>
    261248                </listitem>
     
    266253<refsect1>
    267254        <title>COMPONENTS</title>
    268        
    269         <para>The Samba suite is made up of several components. Each 
    270         component is described in a separate manual page. It is strongly 
    271         recommended that you read the documentation that comes with Samba 
    272         and the manual pages of those components that you use. If the 
     255
     256        <para>The Samba suite is made up of several components. Each
     257        component is described in a separate manual page. It is strongly
     258        recommended that you read the documentation that comes with Samba
     259        and the manual pages of those components that you use. If the
    273260        manual pages and documents aren't clear enough then please visit
    274261        <ulink url="http://devel.samba.org/">http://devel.samba.org</ulink>
     
    283270<refsect1>
    284271        <title>AVAILABILITY</title>
    285        
    286         <para>The Samba software suite is licensed under the 
    287         GNU Public License(GPL). A copy of that license should 
    288         have come with the package in the file COPYING. You are 
    289         encouraged to distribute copies of the Samba suite, but 
     272
     273        <para>The Samba software suite is licensed under the
     274        GNU Public License(GPL). A copy of that license should
     275        have come with the package in the file COPYING. You are
     276        encouraged to distribute copies of the Samba suite, but
    290277        please obey the terms of this license.</para>
    291278
    292         <para>The latest version of the Samba suite can be 
     279        <para>The latest version of the Samba suite can be
    293280        obtained via anonymous ftp from samba.org in the
    294         directory pub/samba/. It is also available on several 
     281        directory pub/samba/. It is also available on several
    295282        mirror sites worldwide.</para>
    296        
    297         <para>You may also find useful information about Samba 
     283
     284        <para>You may also find useful information about Samba
    298285        on the newsgroup <ulink url="news:comp.protocols.smb">
    299         comp.protocol.smb</ulink> and the Samba mailing 
    300         list. Details on how to join the mailing list are given in 
     286        comp.protocol.smb</ulink> and the Samba mailing
     287        list. Details on how to join the mailing list are given in
    301288        the README file that comes with Samba.</para>
    302        
     289
    303290        <para>If you have access to a WWW viewer (such as Mozilla
    304         or Konqueror) then you will also find lots of useful information, 
     291        or Konqueror) then you will also find lots of useful information,
    305292        including back issues of the Samba mailing list, at
    306293        <ulink url="http://lists.samba.org/">http://lists.samba.org</ulink>.</para>
     
    309296<refsect1>
    310297        <title>VERSION</title>
    311        
    312         <para>This man page is correct for version 3 of the
     298
     299        <para>This man page is correct for version 4 of the
    313300        Samba suite. </para>
    314301</refsect1>
     
    316303<refsect1>
    317304        <title>CONTRIBUTIONS</title>
    318        
    319         <para>If you wish to contribute to the Samba project, 
    320         then I suggest you join the Samba mailing list at 
     305
     306        <para>If you wish to contribute to the Samba project,
     307        then I suggest you join the Samba mailing list at
    321308        <ulink url="http://lists.samba.org/">http://lists.samba.org</ulink>.
    322309        </para>
     
    324311        <para>If you have patches to submit, visit
    325312        <ulink url="http://devel.samba.org/">http://devel.samba.org/</ulink>
    326         for information on how to do it properly. We prefer patches 
    327         in <command>diff -u</command> format.</para>
     313        for information on how to do it properly. We prefer patches
     314        in <command>git format-patch</command> format.</para>
    328315</refsect1>
    329316
    330317<refsect1>
    331318        <title>CONTRIBUTORS</title>
    332        
    333         <para>Contributors to the project are now too numerous 
    334         to mention here but all deserve the thanks of all Samba 
     319
     320        <para>Contributors to the project are now too numerous
     321        to mention here but all deserve the thanks of all Samba
    335322        users. To see a full list, look at the
    336         <filename>change-log</filename> in the source package 
    337         for the pre-CVS changes and at <ulink 
    338         url="http://cvs.samba.org/">
    339         http://cvs.samba.org/</ulink>
    340         for the contributors to Samba post-CVS. CVS is the Open Source
    341         source code control system used by the Samba Team to develop 
     323        <filename>change-log</filename> in the source package
     324        for the pre-CVS changes and at <ulink
     325        url="http://git.samba.org/">
     326        http://git.samba.org/</ulink>
     327        for the contributors to Samba post-GIT. GIT is the Open Source
     328        source code control system used by the Samba Team to develop
    342329        Samba. The project would have been unmanageable without it.</para>
    343330</refsect1>
     
    345332<refsect1>
    346333        <title>AUTHOR</title>
    347        
    348         <para>The original Samba software and related utilities 
     334
     335        <para>The original Samba software and related utilities
    349336        were created by Andrew Tridgell. Samba is now developed
    350         by the Samba Team as an Open Source project similar 
     337        by the Samba Team as an Open Source project similar
    351338        to the way the Linux kernel is developed.</para>
    352        
    353         <para>The original Samba man pages were written by Karl Auer. 
    354         The man page sources were converted to YODL format (another 
     339
     340        <para>The original Samba man pages were written by Karl Auer.
     341        The man page sources were converted to YODL format (another
    355342        excellent piece of Open Source software, available at <ulink url="ftp://ftp.icce.rug.nl/pub/unix/">
    356         ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0 
    357         release by Jeremy Allison.  The conversion to DocBook for 
     343        ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0
     344        release by Jeremy Allison.  The conversion to DocBook for
    358345        Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML
    359346        4.2 for Samba 3.0 was done by Alexander Bokovoy.</para>
Note: See TracChangeset for help on using the changeset viewer.