Ignore:
Timestamp:
May 12, 2014, 8:58:38 PM (11 years ago)
Author:
Silvan Scherrer
Message:

Samba 3.6: updated vendor to latest version

Location:
vendor/current/docs/manpages
Files:
1 added
1 deleted
81 edited

Legend:

Unmodified
Added
Removed
  • vendor/current/docs/manpages/eventlogadm.8

    r746 r860  
    22.\"     Title: eventlogadm
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "EVENTLOGADM" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "EVENTLOGADM" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/findsmb.1

    r746 r860  
    22.\"     Title: findsmb
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "FINDSMB" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "FINDSMB" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    6978for any name: IP address, NetBIOS name, Workgroup name, operating system, and SMB server version\&.
    7079.PP
    71 There will be a \'+\' in front of the workgroup name for machines that are local master browsers for that workgroup\&. There will be an \'*\' in front of the workgroup name for machines that are the domain master browser for that workgroup\&. Machines that are running Windows for Workgroups, Windows 95 or Windows 98 will not show any information about the operating system or server version\&.
     80There will be a \*(Aq+\*(Aq in front of the workgroup name for machines that are local master browsers for that workgroup\&. There will be an \*(Aq*\*(Aq in front of the workgroup name for machines that are the domain master browser for that workgroup\&. Machines that are running Windows for Workgroups, Windows 95 or Windows 98 will not show any information about the operating system or server version\&.
    7281.PP
    7382The command with
  • vendor/current/docs/manpages/idmap_ad.8

    r746 r860  
    22.\"     Title: idmap_ad
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_AD" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_AD" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_ad \- Samba\'s idmap_ad Backend for Winbind
     31idmap_ad \- Samba\*(Aqs idmap_ad Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
    25 The idmap_ad plugin provides a way for Winbind to read id mappings from an AD server that uses RFC2307/SFU schema extensions\&. This module implements only the "idmap" API, and is READONLY\&. Mappings must be provided in advance by the administrator by adding the posixAccount/posixGroup classes and relative attribute/value pairs to the user and group objects in the AD\&.
     34The idmap_ad plugin provides a way for Winbind to read id mappings from an AD server that uses RFC2307/SFU schema extensions\&. This module implements only the "idmap" API, and is READONLY\&. Mappings must be provided in advance by the administrator by adding the uidNumber attributes for users and gidNumber attributes for groups in the AD\&. Winbind will only map users that have a uidNumber and whose primary group have a gidNumber attribute set\&. It is however recommended that all groups in use have gidNumber attributes assigned, otherwise they are not working\&.
    2635.PP
    2736Note that the idmap_ad module has changed considerably since Samba versions 3\&.0 and 3\&.2\&. Currently, the
  • vendor/current/docs/manpages/idmap_adex.8

    r746 r860  
    22.\"     Title: idmap_adex
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_ADEX" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_ADEX" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_adex \- Samba\'s idmap_adex Backend for Winbind
     31idmap_adex \- Samba\*(Aqs idmap_adex Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
  • vendor/current/docs/manpages/idmap_autorid.8

    r746 r860  
    22.\"     Title: idmap_autorid
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_AUTORID" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_AUTORID" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_autorid \- Samba\'s idmap_autorid Backend for Winbind
     31idmap_autorid \- Samba\*(Aqs idmap_autorid Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
  • vendor/current/docs/manpages/idmap_hash.8

    r746 r860  
    22.\"     Title: idmap_hash
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_HASH" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_HASH" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_hash \- Samba\'s idmap_hash Backend for Winbind
     31idmap_hash \- Samba\*(Aqs idmap_hash Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
  • vendor/current/docs/manpages/idmap_ldap.8

    r746 r860  
    22.\"     Title: idmap_ldap
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_LDAP" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_LDAP" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_ldap \- Samba\'s idmap_ldap Backend for Winbind
     31idmap_ldap \- Samba\*(Aqs idmap_ldap Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
     
    5059.SH "EXAMPLES"
    5160.PP
    52 The following example shows how an ldap directory is used as the default idmap backend\&. It also configures the idmap range and base directory suffix\&. The secret for the ldap_user_dn has to be set with "net idmap secret \'*\' password"\&.
     61The following example shows how an ldap directory is used as the default idmap backend\&. It also configures the idmap range and base directory suffix\&. The secret for the ldap_user_dn has to be set with "net idmap secret \*(Aq*\*(Aq password"\&.
    5362.sp
    5463.if n \{\
  • vendor/current/docs/manpages/idmap_nss.8

    r746 r860  
    22.\"     Title: idmap_nss
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_NSS" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_NSS" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_nss \- Samba\'s idmap_nss Backend for Winbind
     31idmap_nss \- Samba\*(Aqs idmap_nss Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
  • vendor/current/docs/manpages/idmap_rid.8

    r746 r860  
    22.\"     Title: idmap_rid
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_RID" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_RID" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_rid \- Samba\'s idmap_rid Backend for Winbind
     31idmap_rid \- Samba\*(Aqs idmap_rid Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
  • vendor/current/docs/manpages/idmap_tdb.8

    r746 r860  
    22.\"     Title: idmap_tdb
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_TDB" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_TDB" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_tdb \- Samba\'s idmap_tdb Backend for Winbind
     31idmap_tdb \- Samba\*(Aqs idmap_tdb Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
  • vendor/current/docs/manpages/idmap_tdb2.8

    r746 r860  
    22.\"     Title: idmap_tdb2
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "IDMAP_TDB2" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "IDMAP_TDB2" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 idmap_tdb2 \- Samba\'s idmap_tdb2 Backend for Winbind
     31idmap_tdb2 \- Samba\*(Aqs idmap_tdb2 Backend for Winbind
    2332.SH "DESCRIPTION"
    2433.PP
  • vendor/current/docs/manpages/libsmbclient.7

    r746 r860  
    22.\"     Title: libsmbclient
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: 7
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "LIBSMBCLIENT" "7" "10/29/2012" "Samba 3\&.6" "7"
     10.TH "LIBSMBCLIENT" "7" "09/18/2013" "Samba 3\&.6" "7"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3443
    3544libsmbclient
    36 is a library toolset that permits applications to manipulate CIFS/SMB network resources using many of the standards POSIX functions available for manipulating local UNIX/Linux files\&. It permits much more than just browsing, files can be opened and read or written, permissions changed, file times modified, attributes and ACL\'s can be manipulated, and so on\&. Of course, its functionality includes all the capabilities commonly called browsing\&.
     45is a library toolset that permits applications to manipulate CIFS/SMB network resources using many of the standards POSIX functions available for manipulating local UNIX/Linux files\&. It permits much more than just browsing, files can be opened and read or written, permissions changed, file times modified, attributes and ACL\*(Aqs can be manipulated, and so on\&. Of course, its functionality includes all the capabilities commonly called browsing\&.
    3746.PP
    3847
  • vendor/current/docs/manpages/lmhosts.5

    r746 r860  
    22.\"     Title: lmhosts
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: File Formats and Conventions
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "LMHOSTS" "5" "10/29/2012" "Samba 3\&.6" "File Formats and Conventions"
     10.TH "LMHOSTS" "5" "09/18/2013" "Samba 3\&.6" "File Formats and Conventions"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    4150.SH "FILE FORMAT"
    4251.PP
    43 It is an ASCII file containing one line for NetBIOS name\&. The two fields on each line are separated from each other by white space\&. Any entry beginning with \'#\' is ignored\&. Each line in the lmhosts file contains the following information:
     52It is an ASCII file containing one line for NetBIOS name\&. The two fields on each line are separated from each other by white space\&. Any entry beginning with \*(Aq#\*(Aq is ignored\&. Each line in the lmhosts file contains the following information:
    4453.sp
    4554.RS 4
     
    6271.IP \(bu 2.3
    6372.\}
    64 NetBIOS Name \- This name format is a maximum fifteen character host name, with an optional trailing \'#\' character followed by the NetBIOS name type as two hexadecimal digits\&.
     73NetBIOS Name \- This name format is a maximum fifteen character host name, with an optional trailing \*(Aq#\*(Aq character followed by the NetBIOS name type as two hexadecimal digits\&.
    6574.sp
    66 If the trailing \'#\' is omitted then the given IP address will be returned for all names that match the given name, whatever the NetBIOS name type in the lookup\&.
     75If the trailing \*(Aq#\*(Aq is omitted then the given IP address will be returned for all names that match the given name, whatever the NetBIOS name type in the lookup\&.
    6776.RE
    6877.sp
  • vendor/current/docs/manpages/log2pcap.1

    r746 r860  
    22.\"     Title: log2pcap
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "LOG2PCAP" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "LOG2PCAP" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    104113Only SMB data is extracted from the samba logs, no LDAP, NetBIOS lookup or other data\&.
    105114.PP
    106 The generated TCP and IP headers don\'t contain a valid checksum\&.
     115The generated TCP and IP headers don\*(Aqt contain a valid checksum\&.
    107116.SH "SEE ALSO"
    108117.PP
  • vendor/current/docs/manpages/net.8

    r746 r860  
    22.\"     Title: net
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "NET" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "NET" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    7180.RS 4
    7281This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the
    73 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     82\m[blue]\fBnetbios name\fR\m[]
    7483parameter in the
    7584smb\&.conf
     
    115124.sp
    116125Note that specifying this parameter here will override the
    117 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     126\m[blue]\fBlog level\fR\m[]
    118127parameter in the
    119128smb\&.conf
     
    153162[UPN] (ADS only) set the principalname attribute during the join\&. The default format is host/netbiosname@REALM\&.
    154163.PP
    155 [OU] (ADS only) Precreate the computer account in a specific OU\&. The OU string reads from top to bottom without RDNs, and is delimited by a \'/\'\&. Please note that \'\e\' is used for escape by both the shell and ldap, so it may need to be doubled or quadrupled to pass through, and it is not used as a delimiter\&.
     164[OU] (ADS only) Precreate the computer account in a specific OU\&. The OU string reads from top to bottom without RDNs, and is delimited by a \*(Aq/\*(Aq\&. Please note that \*(Aq\e\*(Aq is used for escape by both the shell and ldap, so it may need to be doubled or quadrupled to pass through, and it is not used as a delimiter\&.
    156165.SS "[RPC] OLDJOIN [options]"
    157166.PP
     
    348357.SS "LOOKUP DC [DOMAIN]"
    349358.PP
    350 Give IP\'s of Domain Controllers for specified
     359Give IP\*(Aqs of Domain Controllers for specified
    351360\fI DOMAIN\fR\&. Defaults to local domain\&.
    352361.SS "LOOKUP MASTER DOMAIN"
     
    357366.SS "CACHE"
    358367.PP
    359 Samba uses a general caching interface called \'gencache\'\&. It can be controlled using \'NET CACHE\'\&.
     368Samba uses a general caching interface called \*(Aqgencache\*(Aq\&. It can be controlled using \*(AqNET CACHE\*(Aq\&.
    360369.PP
    361370All the timeout parameters support the suffixes:
     
    461470.IP \(bu 2.3
    462471.\}
    463 type \- Type of the group; either \'domain\', \'local\', or \'builtin\'
     472type \- Type of the group; either \*(Aqdomain\*(Aq, \*(Aqlocal\*(Aq, or \*(Aqbuiltin\*(Aq
    464473.RE
    465474.sp
     
    522531.SS "MAXRID"
    523532.PP
    524 Prints out the highest RID currently in use on the local server (by the active \'passdb backend\')\&.
     533Prints out the highest RID currently in use on the local server (by the active \*(Aqpassdb backend\*(Aq)\&.
    525534.SS "RPC INFO"
    526535.PP
     
    539548\fIDOMAIN$\fR
    540549with the account flag
    541 \fB\'I\'\fR
     550\fB\*(AqI\*(Aq\fR
    542551(interdomain trust account)\&. This is required for incoming trusts to work\&. It makes Samba be a trusted domain of the foreign (trusting) domain\&. Users of the Samba domain will be made available in the foreign domain\&. If the command is used against localhost it has the same effect as
    543552smbpasswd \-a \-i DOMAIN\&. Please note that both commands expect a appropriate UNIX account\&.
     
    549558.SS "RPC TRUSTDOM ESTABLISH DOMAIN"
    550559.PP
    551 Establish a trust relationship to a trusted domain\&. Interdomain account must already be created on the remote PDC\&. This is required for outgoing trusts to work\&. It makes Samba be a trusting domain of a foreign (trusted) domain\&. Users of the foreign domain will be made available in our domain\&. You\'ll need winbind and a working idmap config to make them appear in your system\&.
     560Establish a trust relationship to a trusted domain\&. Interdomain account must already be created on the remote PDC\&. This is required for outgoing trusts to work\&. It makes Samba be a trusting domain of a foreign (trusted) domain\&. Users of the foreign domain will be made available in our domain\&. You\*(Aqll need winbind and a working idmap config to make them appear in your system\&.
    552561.SS "RPC TRUSTDOM REVOKE DOMAIN"
    553562.PP
     
    691700.SS "RPC RIGHTS"
    692701.PP
    693 This subcommand is used to view and manage Samba\'s rights assignments (also referred to as privileges)\&. There are three options currently available:
     702This subcommand is used to view and manage Samba\*(Aqs rights assignments (also referred to as privileges)\&. There are three options currently available:
    694703\fIlist\fR,
    695704\fIgrant\fR, and
    696 \fIrevoke\fR\&. More details on Samba\'s privilege model and its use can be found in the Samba\-HOWTO\-Collection\&.
     705\fIrevoke\fR\&. More details on Samba\*(Aqs privilege model and its use can be found in the Samba\-HOWTO\-Collection\&.
    697706.SS "RPC ABORTSHUTDOWN"
    698707.PP
     
    762771.PP
    763772Example:
    764 \fBnet ads search \'(objectCategory=group)\' sAMAccountName\fR
     773\fBnet ads search \*(Aq(objectCategory=group)\*(Aq sAMAccountName\fR
    765774.SS "ADS DN \fIDN\fR \fI(attributes)\fR"
    766775.PP
     
    768777.PP
    769778Example:
    770 \fBnet ads dn \'CN=administrator,CN=Users,DC=my,DC=domain\' SAMAccountName\fR
     779\fBnet ads dn \*(AqCN=administrator,CN=Users,DC=my,DC=domain\*(Aq SAMAccountName\fR
    771780.SS "ADS WORKGROUP"
    772781.PP
     
    901910\-T|\-\-test
    902911.RS 4
    903 Dry run, show what changes would be made but don\'t touch anything\&.
     912Dry run, show what changes would be made but don\*(Aqt touch anything\&.
    904913.RE
    905914.PP
     
    984993Get info on user defined shares owned by the current user matching the given pattern, or all users\&.
    985994.PP
    986 net usershare info on its own dumps out info on the user defined shares that were created by the current user, or restricts them to share names that match the given wildcard pattern (\'*\' matches one or more characters, \'?\' matches only one character)\&. If the \'\-l\' or \'\-\-long\' option is also given, it prints out info on user defined shares created by other users\&.
     995net usershare info on its own dumps out info on the user defined shares that were created by the current user, or restricts them to share names that match the given wildcard pattern (\*(Aq*\*(Aq matches one or more characters, \*(Aq?\*(Aq matches only one character)\&. If the \*(Aq\-l\*(Aq or \*(Aq\-\-long\*(Aq option is also given, it prints out info on user defined shares created by other users\&.
    987996.PP
    988997The information given about a share looks like: [foobar] path=/home/jeremy comment=testme usershare_acl=Everyone:F guest_ok=n And is a list of the current settings of the user defined share that can be modified by the "net usershare add" command\&.
     
    9911000List all the user defined shares owned by the current user matching the given pattern, or all users\&.
    9921001.PP
    993 net usershare list on its own list out the names of the user defined shares that were created by the current user, or restricts the list to share names that match the given wildcard pattern (\'*\' matches one or more characters, \'?\' matches only one character)\&. If the \'\-l\' or \'\-\-long\' option is also given, it includes the names of user defined shares created by other users\&.
     1002net usershare list on its own list out the names of the user defined shares that were created by the current user, or restricts the list to share names that match the given wildcard pattern (\*(Aq*\*(Aq matches one or more characters, \*(Aq?\*(Aq matches only one character)\&. If the \*(Aq\-l\*(Aq or \*(Aq\-\-long\*(Aq option is also given, it includes the names of user defined shares created by other users\&.
    9941003.SS "CONF"
    9951004.PP
     
    11001109.SS "REGISTRY"
    11011110.PP
    1102 Manipulate Samba\'s registry\&.
     1111Manipulate Samba\*(Aqs registry\&.
    11031112.PP
    11041113The registry commands are:
  • vendor/current/docs/manpages/nmbd.8

    r746 r860  
    22.\"     Title: nmbd
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "NMBD" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "NMBD" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    7786and
    7887svscan
    79 from Daniel J\&. Bernstein\'s
     88from Daniel J\&. Bernstein\*(Aqs
    8089daemontools
    8190package, or the AIX process monitor\&.
     
    135144.sp
    136145Note that specifying this parameter here will override the
    137 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     146\m[blue]\fBlog level\fR\m[]
    138147parameter in the
    139148smb\&.conf
     
    164173UDP port number is a positive integer value\&. This option changes the default UDP port number (normally 137) that
    165174nmbd
    166 responds to name queries on\&. Don\'t use this option unless you are an expert, in which case you won\'t need help!
     175responds to name queries on\&. Don\*(Aqt use this option unless you are an expert, in which case you won\*(Aqt need help!
    167176.RE
    168177.SH "FILES"
     
    262271\fBsmbclient\fR(1),
    263272\fBtestparm\fR(1),
    264 \fBtestprns\fR(1), and the Internet RFC\'s
     273\fBtestprns\fR(1), and the Internet RFC\*(Aqs
    265274rfc1001\&.txt,
    266275rfc1002\&.txt\&. In addition the CIFS (formerly SMB) specification is available as a link from the Web page
  • vendor/current/docs/manpages/nmblookup.1

    r746 r860  
    22.\"     Title: nmblookup
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "NMBLOOKUP" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "NMBLOOKUP" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    4251\fI name\fR
    4352is "\-" then it does a lookup on the special name
    44 \fB__MSBROWSE__\fR\&. Please note that in order to use the name "\-", you need to make sure "\-" isn\'t parsed as an argument, e\&.g\&. use :
     53\fB__MSBROWSE__\fR\&. Please note that in order to use the name "\-", you need to make sure "\-" isn\*(Aqt parsed as an argument, e\&.g\&. use :
    4554\fBnmblookup \-M \-\- \-\fR\&.
    4655.RE
     
    7382.RS 4
    7483This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the
    75 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     84\m[blue]\fBnetbios name\fR\m[]
    7685parameter in the
    7786smb\&.conf
     
    133142.sp
    134143Note that specifying this parameter here will override the
    135 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     144\m[blue]\fBlog level\fR\m[]
    136145parameter in the
    137146smb\&.conf
     
    174183name
    175184.RS 4
    176 This is the NetBIOS name being queried\&. Depending upon the previous options this may be a NetBIOS name or IP address\&. If a NetBIOS name then the different name types may be specified by appending \'#<type>\' to the name\&. This name may also be \'*\', which will return all registered names within a broadcast area\&.
     185This is the NetBIOS name being queried\&. Depending upon the previous options this may be a NetBIOS name or IP address\&. If a NetBIOS name then the different name types may be specified by appending \*(Aq#<type>\*(Aq to the name\&. This name may also be \*(Aq*\*(Aq, which will return all registered names within a broadcast area\&.
    177186.RE
    178187.SH "EXAMPLES"
     
    185194must be called like this:
    186195.PP
    187 nmblookup \-U server \-R \'name\'
     196nmblookup \-U server \-R \*(Aqname\*(Aq
    188197.PP
    189198For example, running :
    190199.PP
    191 nmblookup \-U samba\&.org \-R \'IRIX#1B\'
     200nmblookup \-U samba\&.org \-R \*(AqIRIX#1B\*(Aq
    192201.PP
    193202would query the WINS server samba\&.org for the domain master browser (1B name type) for the IRIX workgroup\&.
  • vendor/current/docs/manpages/ntlm_auth.1

    r746 r860  
    22.\"     Title: ntlm_auth
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "NTLM_AUTH" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "NTLM_AUTH" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 ntlm_auth \- tool to allow external access to Winbind\'s NTLM authentication function
     31ntlm_auth \- tool to allow external access to Winbind\*(Aqs NTLM authentication function
    2332.SH "SYNOPSIS"
    2433.HP \w'\ 'u
     
    5564squid\-2\&.4\-basic
    5665.RS 4
    57 Server\-side helper for use with Squid 2\&.4\'s basic (plaintext) authentication\&.
     66Server\-side helper for use with Squid 2\&.4\*(Aqs basic (plaintext) authentication\&.
    5867.RE
    5968.PP
    6069squid\-2\&.5\-basic
    6170.RS 4
    62 Server\-side helper for use with Squid 2\&.5\'s basic (plaintext) authentication\&.
     71Server\-side helper for use with Squid 2\&.5\*(Aqs basic (plaintext) authentication\&.
    6372.RE
    6473.PP
    6574squid\-2\&.5\-ntlmssp
    6675.RS 4
    67 Server\-side helper for use with Squid 2\&.5\'s NTLMSSP authentication\&.
     76Server\-side helper for use with Squid 2\&.5\*(Aqs NTLMSSP authentication\&.
    6877.sp
    6978Requires access to the directory
     
    7887ntlmssp\-client\-1
    7988.RS 4
    80 Client\-side helper for use with arbitrary external programs that may wish to use Samba\'s NTLMSSP authentication knowledge\&.
     89Client\-side helper for use with arbitrary external programs that may wish to use Samba\*(Aqs NTLMSSP authentication knowledge\&.
    8190.sp
    8291This helper is a client, and as such may be run by any user\&. The protocol used is effectively the reverse of the previous protocol\&. A
     
    103112ntlm\-server\-1
    104113.RS 4
    105 Server\-side helper protocol, intended for use by a RADIUS server or the \'winbind\' plugin for pppd, for the provision of MSCHAP and MSCHAPv2 authentication\&.
     114Server\-side helper protocol, intended for use by a RADIUS server or the \*(Aqwinbind\*(Aq plugin for pppd, for the provision of MSCHAP and MSCHAPv2 authentication\&.
    106115.sp
    107116This protocol consists of lines in the form:
     
    116125Username
    117126.RS 4
    118 The username, expected to be in Samba\'s
     127The username, expected to be in Samba\*(Aqs
    119128\m[blue]\fBunix charset\fR\m[]\&.
    120 .PP \fBExample\ \&1.\ \&\fR Username: bob
    121 .PP \fBExample\ \&2.\ \&\fR Username:: Ym9i
     129.PP
     130Examples:
     131.RS 4
     132Username: bob
     133.sp
     134Username:: Ym9i
     135.RE
    122136.RE
    123137.PP
    124138NT\-Domain
    125139.RS 4
    126 The user\'s domain, expected to be in Samba\'s
     140The user\*(Aqs domain, expected to be in Samba\*(Aqs
    127141\m[blue]\fBunix charset\fR\m[]\&.
    128 .PP \fBExample\ \&3.\ \&\fR NT\-Domain: WORKGROUP
    129 .PP \fBExample\ \&4.\ \&\fR NT\-Domain:: V09SS0dST1VQ
     142.PP
     143Examples:
     144.RS 4
     145NT\-Domain: WORKGROUP
     146.sp
     147NT\-Domain:: V09SS0dST1VQ
     148.RE
    130149.RE
    131150.PP
    132151Full\-Username
    133152.RS 4
    134 The fully qualified username, expected to be in Samba\'s
     153The fully qualified username, expected to be in Samba\*(Aqs
    135154\m[blue]\fBunix charset\fR\m[]
    136155and qualified with the
    137156\m[blue]\fBwinbind separator\fR\m[]\&.
    138 .PP \fBExample\ \&5.\ \&\fR Full\-Username: WORKGROUP\ebob
    139 .PP \fBExample\ \&6.\ \&\fR Full\-Username:: V09SS0dST1VQYm9i
     157.PP
     158Examples:
     159.RS 4
     160Full\-Username: WORKGROUP\ebob
     161.sp
     162Full\-Username:: V09SS0dST1VQYm9i
     163.RE
    140164.RE
    141165.PP
     
    145169LANMAN Challenge
    146170value, generated randomly by the server, or (in cases such as MSCHAPv2) generated in some way by both the server and the client\&.
    147 .PP \fBExample\ \&7.\ \&\fR LANMAN\-Challenge: 0102030405060708
     171.PP
     172Examples:
     173.RS 4
     174LANMAN\-Challenge: 0102030405060708
     175.RE
    148176.RE
    149177.PP
     
    152180The 24 byte
    153181LANMAN Response
    154 value, calculated from the user\'s password and the supplied
     182value, calculated from the user\*(Aqs password and the supplied
    155183LANMAN Challenge\&. Typically, this is provided over the network by a client wishing to authenticate\&.
    156 .PP \fBExample\ \&8.\ \&\fR LANMAN\-Response: 0102030405060708090A0B0C0D0E0F101112131415161718
     184.PP
     185Examples:
     186.RS 4
     187LANMAN\-Response: 0102030405060708090A0B0C0D0E0F101112131415161718
     188.RE
    157189.RE
    158190.PP
     
    161193The >= 24 byte
    162194NT Response
    163 calculated from the user\'s password and the supplied
     195calculated from the user\*(Aqs password and the supplied
    164196LANMAN Challenge\&. Typically, this is provided over the network by a client wishing to authenticate\&.
    165 .PP \fBExample\ \&9.\ \&\fR NT\-Response: 0102030405060708090A0B0C0D0E0F101112131415161718
     197.PP
     198Examples:
     199.RS 4
     200NT\-Response: 0102030405060708090A0B0C0D0E0F10111213141516171
     201.RE
    166202.RE
    167203.PP
    168204Password
    169205.RS 4
    170 The user\'s password\&. This would be provided by a network client, if the helper is being used in a legacy situation that exposes plaintext passwords in this way\&.
    171 .PP \fBExample\ \&10.\ \&\fR Password: samba2
    172 .PP \fBExample\ \&11.\ \&\fR Password:: c2FtYmEy
     206The user\*(Aqs password\&. This would be provided by a network client, if the helper is being used in a legacy situation that exposes plaintext passwords in this way\&.
     207.PP
     208Examples:
     209.RS 4
     210Password: samba2
     211.sp
     212Password:: c2FtYmEy
     213.RE
    173214.RE
    174215.PP
     
    176217.RS 4
    177218Upon successful authenticaiton, return the user session key associated with the login\&.
    178 .PP \fBExample\ \&12.\ \&\fR Request\-User\-Session\-Key: Yes
     219.PP
     220Examples:
     221.RS 4
     222Request\-User\-Session\-Key: Yes
     223.RE
    179224.RE
    180225.PP
     
    182227.RS 4
    183228Upon successful authenticaiton, return the LANMAN session key associated with the login\&.
    184 .PP \fBExample\ \&13.\ \&\fR Request\-LanMan\-Session\-Key: Yes
    185 .RE
     229.PP
     230Examples:
     231.RS 4
     232Request\-LanMan\-Session\-Key: Yes
     233.RE
     234.RE
     235.RE
     236.sp
    186237.if n \{\
    187238.sp
     
    196247.ps -1
    197248.br
    198 Implementers should take care to base64 encode
    199                 any data (such as usernames/passwords) that may contain malicous user data, such as
    200                 a newline\&.  They may also need to decode strings from
    201                 the helper, which likewise may have been base64 encoded\&..sp .5v
    202 .RE
     249Implementers should take care to base64 encode any data (such as usernames/passwords) that may contain malicous user data, such as a newline\&. They may also need to decode strings from the helper, which likewise may have been base64 encoded\&.
     250.sp .5v
    203251.RE
    204252.RE
     
    236284\-\-password=PASSWORD
    237285.RS 4
    238 User\'s plaintext password
     286User\*(Aqs plaintext password
    239287.sp
    240288If not specified on the command line, this is prompted for when required\&.
     
    275323.sp
    276324Note that specifying this parameter here will override the
    277 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     325\m[blue]\fBlog level\fR\m[]
    278326parameter in the
    279327smb\&.conf
     
    350398.\}
    351399.nf
    352 auth_param ntlm program ntlm_auth \-\-helper\-protocol=squid\-2\&.5\-ntlmssp \-\-require\-membership\-of=\'WORKGROUP\eDomain Users\'
    353 auth_param basic program ntlm_auth \-\-helper\-protocol=squid\-2\&.5\-basic \-\-require\-membership\-of=\'WORKGROUP\eDomain Users\'
     400auth_param ntlm program ntlm_auth \-\-helper\-protocol=squid\-2\&.5\-ntlmssp \-\-require\-membership\-of=\*(AqWORKGROUP\eDomain Users\*(Aq
     401auth_param basic program ntlm_auth \-\-helper\-protocol=squid\-2\&.5\-basic \-\-require\-membership\-of=\*(AqWORKGROUP\eDomain Users\*(Aq
    354402.fi
    355403.if n \{\
     
    358406.SH "TROUBLESHOOTING"
    359407.PP
    360 If you\'re experiencing problems with authenticating Internet Explorer running under MS Windows 9X or Millennium Edition against ntlm_auth\'s NTLMSSP authentication helper (\-\-helper\-protocol=squid\-2\&.5\-ntlmssp), then please read
     408If you\*(Aqre experiencing problems with authenticating Internet Explorer running under MS Windows 9X or Millennium Edition against ntlm_auth\*(Aqs NTLMSSP authentication helper (\-\-helper\-protocol=squid\-2\&.5\-ntlmssp), then please read
    361409the Microsoft Knowledge Base article #239869 and follow instructions described there\&.
    362410.SH "VERSION"
  • vendor/current/docs/manpages/pam_winbind.8

    r746 r860  
    22.\"     Title: pam_winbind
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: 8
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "PAM_WINBIND" "8" "10/29/2012" "Samba 3\&.6" "8"
     10.TH "PAM_WINBIND" "8" "09/18/2013" "Samba 3\&.6" "8"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/pam_winbind.conf.5

    r746 r860  
    22.\"     Title: pam_winbind.conf
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: 5
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "PAM_WINBIND\&.CONF" "5" "10/29/2012" "Samba 3\&.6" "5"
     10.TH "PAM_WINBIND\&.CONF" "5" "09/18/2013" "Samba 3\&.6" "5"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/pdbedit.8

    r746 r860  
    22.\"     Title: pdbedit
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "PDBEDIT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "PDBEDIT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3948\-L|\-\-list
    4049.RS 4
    41 This option lists all the user accounts present in the users database\&. This option prints a list of user/uid pairs separated by the \':\' character\&.
     50This option lists all the user accounts present in the users database\&. This option prints a list of user/uid pairs separated by the \*(Aq:\*(Aq character\&.
    4251.sp
    4352Example:
     
    129138\-f|\-\-fullname fullname
    130139.RS 4
    131 This option can be used while adding or modifying a user account\&. It will specify the user\'s full name\&.
     140This option can be used while adding or modifying a user account\&. It will specify the user\*(Aqs full name\&.
    132141.sp
    133142Example:
     
    137146\-h|\-\-homedir homedir
    138147.RS 4
    139 This option can be used while adding or modifying a user account\&. It will specify the user\'s home directory network path\&.
     148This option can be used while adding or modifying a user account\&. It will specify the user\*(Aqs home directory network path\&.
    140149.sp
    141150Example:
     
    153162\-S|\-\-script script
    154163.RS 4
    155 This option can be used while adding or modifying a user account\&. It will specify the user\'s logon script path\&.
     164This option can be used while adding or modifying a user account\&. It will specify the user\*(Aqs logon script path\&.
    156165.sp
    157166Example:
     
    161170\-p|\-\-profile profile
    162171.RS 4
    163 This option can be used while adding or modifying a user account\&. It will specify the user\'s profile directory\&.
     172This option can be used while adding or modifying a user account\&. It will specify the user\*(Aqs profile directory\&.
    164173.sp
    165174Example:
     
    167176.RE
    168177.PP
    169 \-M|\'\-\-machine SID\' SID|rid
    170 .RS 4
    171 This option can be used while adding or modifying a machine account\&. It will specify the machines\' new primary group SID (Security Identifier) or rid\&.
     178\-M|\*(Aq\-\-machine SID\*(Aq SID|rid
     179.RS 4
     180This option can be used while adding or modifying a machine account\&. It will specify the machines\*(Aq new primary group SID (Security Identifier) or rid\&.
    172181.sp
    173182Example:
     
    175184.RE
    176185.PP
    177 \-U|\'\-\-user SID\' SID|rid
    178 .RS 4
    179 This option can be used while adding or modifying a user account\&. It will specify the users\' new SID (Security Identifier) or rid\&.
     186\-U|\*(Aq\-\-user SID\*(Aq SID|rid
     187.RS 4
     188This option can be used while adding or modifying a user account\&. It will specify the users\*(Aq new SID (Security Identifier) or rid\&.
    180189.sp
    181190Example:
     
    183192.sp
    184193Example:
    185 \'\-\-user SID\' S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-5004
     194\*(Aq\-\-user SID\*(Aq S\-1\-5\-21\-2447931902\-1787058256\-3961074038\-5004
    186195.sp
    187196Example:
     
    189198.sp
    190199Example:
    191 \'\-\-user SID\' 5004
     200\*(Aq\-\-user SID\*(Aq 5004
    192201.RE
    193202.PP
    194203\-c|\-\-account\-control account\-control
    195204.RS 4
    196 This option can be used while adding or modifying a user account\&. It will specify the users\' account control property\&. Possible flags are listed below\&.
     205This option can be used while adding or modifying a user account\&. It will specify the users\*(Aq account control property\&. Possible flags are listed below\&.
    197206.sp
    198207
     
    368377.sp
    369378If you wish to add a user and synchronise the password that immediately, use
    370 smbpasswd\'s
     379smbpasswd\*(Aqs
    371380\fB\-a\fR
    372381option\&.
     
    504513\-N|\-\-account\-desc description
    505514.RS 4
    506 This option can be used while adding or modifying a user account\&. It will specify the user\'s description field\&.
     515This option can be used while adding or modifying a user account\&. It will specify the user\*(Aqs description field\&.
    507516.sp
    508517Example:
     
    512521\-Z|\-\-logon\-hours\-reset
    513522.RS 4
    514 This option can be used while adding or modifying a user account\&. It will reset the user\'s allowed logon hours\&. A user may login at any time afterwards\&.
     523This option can be used while adding or modifying a user account\&. It will reset the user\*(Aqs allowed logon hours\&. A user may login at any time afterwards\&.
    515524.sp
    516525Example:
     
    536545\-I|\-\-domain
    537546.RS 4
    538 This option can be used while adding or modifying a user account\&. It will specify the user\'s domain field\&.
     547This option can be used while adding or modifying a user account\&. It will specify the user\*(Aqs domain field\&.
    539548.sp
    540549Example:
     
    562571.sp
    563572Note that specifying this parameter here will override the
    564 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     573\m[blue]\fBlog level\fR\m[]
    565574parameter in the
    566575smb\&.conf
  • vendor/current/docs/manpages/profiles.1

    r746 r860  
    22.\"     Title: profiles
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "PROFILES" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "PROFILES" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/rpcclient.1

    r746 r860  
    22.\"     Title: rpcclient
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "RPCCLIENT" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "RPCCLIENT" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    7483.sp
    7584Note that specifying this parameter here will override the
    76 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     85\m[blue]\fBlog level\fR\m[]
    7786parameter in the
    7887smb\&.conf
     
    163172.RS 4
    164173This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the
    165 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     174\m[blue]\fBnetbios name\fR\m[]
    166175parameter in the
    167176smb\&.conf
     
    468477deldriver <driver>
    469478.RS 4
    470 Delete the specified printer driver for all architectures\&. This does not delete the actual driver files from the server, only the entry from the server\'s list of drivers\&.
     479Delete the specified printer driver for all architectures\&. This does not delete the actual driver files from the server, only the entry from the server\*(Aqs list of drivers\&.
    471480.RE
    472481.PP
     
    653662is designed as a developer testing tool and may not be robust in certain areas (such as command line parsing)\&. It has been known to generate a core dump upon failures when invalid parameters where passed to the interpreter\&.
    654663.PP
    655 From Luke Leighton\'s original rpcclient man page:
     664From Luke Leighton\*(Aqs original rpcclient man page:
    656665.PP
    657666\fIWARNING!\fR
    658 The MSRPC over SMB code has been developed from examining Network traces\&. No documentation is available from the original creators (Microsoft) on how MSRPC over SMB works, or how the individual MSRPC services work\&. Microsoft\'s implementation of these services has been demonstrated (and reported) to be\&.\&.\&. a bit flaky in places\&.
    659 .PP
    660 The development of Samba\'s implementation is also a bit rough, and as more of the services are understood, it can even result in versions of
     667The MSRPC over SMB code has been developed from examining Network traces\&. No documentation is available from the original creators (Microsoft) on how MSRPC over SMB works, or how the individual MSRPC services work\&. Microsoft\*(Aqs implementation of these services has been demonstrated (and reported) to be\&.\&.\&. a bit flaky in places\&.
     668.PP
     669The development of Samba\*(Aqs implementation is also a bit rough, and as more of the services are understood, it can even result in versions of
    661670\fBsmbd\fR(8)
    662671and
  • vendor/current/docs/manpages/samba.7

    r746 r860  
    22.\"     Title: samba
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: Miscellanea
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SAMBA" "7" "10/29/2012" "Samba 3\&.6" "Miscellanea"
     10.TH "SAMBA" "7" "09/18/2013" "Samba 3\&.6" "Miscellanea"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    5665The
    5766testparm
    58 utility is a simple syntax checker for Samba\'s
     67utility is a simple syntax checker for Samba\*(Aqs
    5968\fBsmb.conf\fR(5)
    6069configuration file\&.
     
    96105The
    97106smbcacls
    98 command is a tool to set ACL\'s on remote CIFS servers\&.
     107command is a tool to set ACL\*(Aqs on remote CIFS servers\&.
    99108.RE
    100109.PP
     
    213222.RS 4
    214223smbcquotas
    215 is a tool that can set remote QUOTA\'s on server with NTFS 5\&.
     224is a tool that can set remote QUOTA\*(Aqs on server with NTFS 5\&.
    216225.RE
    217226.SH "COMPONENTS"
    218227.PP
    219 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
     228The 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\*(Aqt clear enough then please visit
    220229http://devel\&.samba\&.org
    221230for information on how to file a bug report or submit a patch\&.
  • vendor/current/docs/manpages/sharesec.1

    r746 r860  
    22.\"     Title: sharesec
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SHARESEC" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SHARESEC" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    8998.sp
    9099Note that specifying this parameter here will override the
    91 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     100\m[blue]\fBlog level\fR\m[]
    92101parameter in the
    93102smb\&.conf
     
    226235.\}
    227236\fIREAD\fR
    228 \- Equivalent to \'RX\' permissions
     237\- Equivalent to \*(AqRX\*(Aq permissions
    229238.RE
    230239.sp
     
    238247.\}
    239248\fICHANGE\fR
    240 \- Equivalent to \'RXWD\' permissions
     249\- Equivalent to \*(AqRXWD\*(Aq permissions
    241250.RE
    242251.sp
     
    250259.\}
    251260\fIFULL\fR
    252 \- Equivalent to \'RWXDPO\' permissions
     261\- Equivalent to \*(AqRWXDPO\*(Aq permissions
    253262.RE
    254263.SH "EXIT STATUS"
     
    260269If the operation succeeded, sharesec returns and exit status of 0\&. If
    261270sharesec
    262 couldn\'t connect to the specified server, or there was an error getting or setting the ACLs, an exit status of 1 is returned\&. If there was an error parsing any command line arguments, an exit status of 2 is returned\&.
     271couldn\*(Aqt connect to the specified server, or there was an error getting or setting the ACLs, an exit status of 1 is returned\&. If there was an error parsing any command line arguments, an exit status of 2 is returned\&.
    263272.SH "EXAMPLES"
    264273.PP
  • vendor/current/docs/manpages/smb.conf.5

    r746 r860  
    22.\"     Title: smb.conf
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: File Formats and Conventions
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMB\&.CONF" "5" "10/29/2012" "Samba 3\&.6" "File Formats and Conventions"
     10.TH "SMB\&.CONF" "5" "09/18/2013" "Samba 3\&.6" "File Formats and Conventions"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    148157.IP \(bu 2.3
    149158.\}
    150 If no path was given, the path is set to the user\'s home directory\&.
     159If no path was given, the path is set to the user\*(Aqs home directory\&.
    151160.RE
    152161.sp
     
    200209This section works like [homes], but for printers\&.
    201210.PP
    202 If a [printers] section occurs in the configuration file, users are able to connect to any printer specified in the local host\'s printcap file\&.
     211If a [printers] section occurs in the configuration file, users are able to connect to any printer specified in the local host\*(Aqs printcap file\&.
    203212.PP
    204213When a connection request is made, the existing sections are scanned\&. If a match is found, it is used\&. If no match is found, but a [homes] section exists, it is used as described above\&. Otherwise, the requested section name is treated as a printer name and the appropriate printcap file is scanned to see if the requested section name is a valid printer share name\&. If a match is found, a new printer share is created by cloning the [printers] section\&.
     
    258267.\}
    259268.PP
    260 All aliases given for a printer in the printcap file are legitimate printer names as far as the server is concerned\&. If your printing subsystem doesn\'t work like that, you will have to set up a pseudo\-printcap\&. This is a file consisting of one or more lines like this:
     269All aliases given for a printer in the printcap file are legitimate printer names as far as the server is concerned\&. If your printing subsystem doesn\*(Aqt work like that, you will have to set up a pseudo\-printcap\&. This is a file consisting of one or more lines like this:
    261270.sp
    262271.if n \{\
     
    533542%p
    534543.RS 4
    535 the path of the service\'s home directory, obtained from your NIS auto\&.map entry\&. The NIS auto\&.map entry is split up as
     544the path of the service\*(Aqs home directory, obtained from your NIS auto\&.map entry\&. The NIS auto\&.map entry is split up as
    536545%N:%p\&.
    537546.RE
     
    544553Samba supports
    545554name mangling
    546 so that DOS and Windows clients can use files that don\'t conform to the 8\&.3 format\&. It can also be set to adjust the case of 8\&.3 format filenames\&.
     555so that DOS and Windows clients can use files that don\*(Aqt conform to the 8\&.3 format\&. It can also be set to adjust the case of 8\&.3 format filenames\&.
    547556.PP
    548557There are several options that control the way mangling is performed, and they are grouped here rather than listed separately\&. For the defaults look at the output of the testparm program\&.
     
    554563case sensitive = yes/no/auto
    555564.RS 4
    556 controls whether filenames are case sensitive\&. If they aren\'t, Samba must do a filename search and match on passed names\&. The default setting of auto allows clients that support case sensitive filenames (Linux CIFSVFS and smbclient 3\&.0\&.5 and above currently) to tell the Samba server on a per\-packet basis that they wish to access the file system in a case\-sensitive manner (to support UNIX case sensitive semantics)\&. No Windows or DOS system supports case\-sensitive filename so setting this option to auto is that same as setting it to no for them\&. Default
     565controls whether filenames are case sensitive\&. If they aren\*(Aqt, Samba must do a filename search and match on passed names\&. The default setting of auto allows clients that support case sensitive filenames (Linux CIFSVFS and smbclient 3\&.0\&.5 and above currently) to tell the Samba server on a per\-packet basis that they wish to access the file system in a case\-sensitive manner (to support UNIX case sensitive semantics)\&. No Windows or DOS system supports case\-sensitive filename so setting this option to auto is that same as setting it to no for them\&. Default
    557566\fIauto\fR\&.
    558567.RE
     
    560569default case = upper/lower
    561570.RS 4
    562 controls what the default case is for new filenames (ie\&. files that don\'t currently exist in the filesystem)\&. Default
     571controls what the default case is for new filenames (ie\&. files that don\*(Aqt currently exist in the filesystem)\&. Default
    563572\fIlower\fR\&. IMPORTANT NOTE: As part of the optimizations for directories containing large numbers of files, the following special case applies\&. If the options
    564573\m[blue]\fBcase sensitive = yes\fR\m[],
     
    572581preserve case = yes/no
    573582.RS 4
    574 controls whether new files (ie\&. files that don\'t currently exist in the filesystem) are created with the case that the client passes, or if they are forced to be the
     583controls whether new files (ie\&. files that don\*(Aqt currently exist in the filesystem) are created with the case that the client passes, or if they are forced to be the
    575584default
    576585case\&. Default
     
    580589short preserve case = yes/no
    581590.RS 4
    582 controls if new files (ie\&. files that don\'t currently exist in the filesystem) which conform to 8\&.3 syntax, that is all in upper case and of suitable length, are created upper case, or if they are forced to be the
     591controls if new files (ie\&. files that don\*(Aqt currently exist in the filesystem) which conform to 8\&.3 syntax, that is all in upper case and of suitable length, are created upper case, or if they are forced to be the
    583592default
    584593case\&. This option can be used with
     
    605614.IP "  1." 4.2
    606615.\}
    607 If the client has passed a username/password pair and that username/password pair is validated by the UNIX system\'s password programs, the connection is made as that username\&. This includes the
     616If the client has passed a username/password pair and that username/password pair is validated by the UNIX system\*(Aqs password programs, the connection is made as that username\&. This includes the
    608617\e\eserver\eservice%\fIusername\fR
    609618method of passing a username\&.
     
    629638.IP "  3." 4.2
    630639.\}
    631 The client\'s NetBIOS name and any previously used usernames are checked against the supplied password\&. If they match, the connection is allowed as the corresponding user\&.
     640The client\*(Aqs NetBIOS name and any previously used usernames are checked against the supplied password\&. If they match, the connection is allowed as the corresponding user\&.
    632641.RE
    633642.sp
     
    655664field is given in the
    656665smb\&.conf
    657 file for the service and the client has supplied a password, and that password matches (according to the UNIX system\'s password checking) with one of the usernames from the
     666file for the service and the client has supplied a password, and that password matches (according to the UNIX system\*(Aqs password checking) with one of the usernames from the
    658667user =
    659668field, the connection is made as the username in the
     
    787796.RS 4
    788797This boolean parameter controls what
    789 \fBsmbd\fR(8)does on receiving a protocol request of "open for delete" from a Windows client\&. If a Windows client doesn\'t have permissions to delete a file then they expect this to be denied at open time\&. POSIX systems normally only detect restrictions on delete by actually attempting to delete the file or directory\&. As Windows clients can (and do) "back out" a delete request by unsetting the "delete on close" bit Samba cannot delete the file immediately on "open for delete" request as we cannot restore such a deleted file\&. With this parameter set to true (the default) then smbd checks the file system permissions directly on "open for delete" and denies the request without actually deleting the file if the file system permissions would seem to deny it\&. This is not perfect, as it\'s possible a user could have deleted a file without Samba being able to check the permissions correctly, but it is close enough to Windows semantics for mostly correct behaviour\&. Samba will correctly check POSIX ACL semantics in this case\&.
    790 .sp
    791 If this parameter is set to "false" Samba doesn\'t check permissions on "open for delete" and allows the open\&. If the user doesn\'t have permission to delete the file this will only be discovered at close time, which is too late for the Windows user tools to display an error message to the user\&. The symptom of this is files that appear to have been deleted "magically" re\-appearing on a Windows explorer refresh\&. This is an extremely advanced protocol option which should not need to be changed\&. This parameter was introduced in its final form in 3\&.0\&.21, an earlier version with slightly different semantics was introduced in 3\&.0\&.20\&. That older version is not documented here\&.
     798\fBsmbd\fR(8)does on receiving a protocol request of "open for delete" from a Windows client\&. If a Windows client doesn\*(Aqt have permissions to delete a file then they expect this to be denied at open time\&. POSIX systems normally only detect restrictions on delete by actually attempting to delete the file or directory\&. As Windows clients can (and do) "back out" a delete request by unsetting the "delete on close" bit Samba cannot delete the file immediately on "open for delete" request as we cannot restore such a deleted file\&. With this parameter set to true (the default) then smbd checks the file system permissions directly on "open for delete" and denies the request without actually deleting the file if the file system permissions would seem to deny it\&. This is not perfect, as it\*(Aqs possible a user could have deleted a file without Samba being able to check the permissions correctly, but it is close enough to Windows semantics for mostly correct behaviour\&. Samba will correctly check POSIX ACL semantics in this case\&.
     799.sp
     800If this parameter is set to "false" Samba doesn\*(Aqt check permissions on "open for delete" and allows the open\&. If the user doesn\*(Aqt have permission to delete the file this will only be discovered at close time, which is too late for the Windows user tools to display an error message to the user\&. The symptom of this is files that appear to have been deleted "magically" re\-appearing on a Windows explorer refresh\&. This is an extremely advanced protocol option which should not need to be changed\&. This parameter was introduced in its final form in 3\&.0\&.21, an earlier version with slightly different semantics was introduced in 3\&.0\&.20\&. That older version is not documented here\&.
    792801.sp
    793802Default:
     
    877886This is the full pathname to a script that will be run by
    878887\fBsmbd\fR(8)
    879 when a machine is added to Samba\'s domain and a Unix account matching the machine\'s name appended with a "$" does not already exist\&.
     888when a machine is added to Samba\*(Aqs domain and a Unix account matching the machine\*(Aqs name appended with a "$" does not already exist\&.
    880889.sp
    881890This option is very similar to the
     
    10251034The
    10261035\fIaddprinter command\fR
    1027 program can output a single line of text, which Samba will set as the port the new printer is connected to\&. If this line isn\'t output, Samba won\'t reload its printer shares\&.
     1036program can output a single line of text, which Samba will set as the port the new printer is connected to\&. If this line isn\*(Aqt output, Samba won\*(Aqt reload its printer shares\&.
    10281037.sp
    10291038Default:
     
    13381347Setting this option to a larger value could be useful to sites transitioning from WinNT and Win2k, as existing user and group rids would otherwise clash with sytem users etc\&.
    13391348.sp
    1340 All UIDs and GIDs must be able to be resolved into SIDs for the correct operation of ACLs on the server\&. As such the algorithmic mapping can\'t be \'turned off\', but pushing it \'out of the way\' should resolve the issues\&. Users and groups can then be assigned \'low\' RIDs in arbitrary\-rid supporting backends\&.
     1349All UIDs and GIDs must be able to be resolved into SIDs for the correct operation of ACLs on the server\&. As such the algorithmic mapping can\*(Aqt be \*(Aqturned off\*(Aq, but pushing it \*(Aqout of the way\*(Aq should resolve the issues\&. Users and groups can then be assigned \*(Aqlow\*(Aq RIDs in arbitrary\-rid supporting backends\&.
    13411350.sp
    13421351Default:
     
    15091518is set then
    15101519nmbd
    1511 will check the source address of any packets coming in on the broadcast sockets and discard any that don\'t match the broadcast addresses of the interfaces in the
     1520will check the source address of any packets coming in on the broadcast sockets and discard any that don\*(Aqt match the broadcast addresses of the interfaces in the
    15121521\m[blue]\fBinterfaces\fR\m[]
    15131522parameter list\&. As unicast packets are received on the other sockets it allows
     
    15501559parameter list then
    15511560smbpasswd
    1552 will fail to connect in it\'s default mode\&.
     1561will fail to connect in it\*(Aqs default mode\&.
    15531562smbpasswd
    15541563can be forced to use the primary IP interface of the local host by using its
     
    16961705.PP
    16971706.RS 4
    1698 This parameter specifies whether Samba should reply to a client\'s file change notify requests\&.
     1707This parameter specifies whether Samba should reply to a client\*(Aqs file change notify requests\&.
    16991708.sp
    17001709You should never need to change this parameter
     
    18031812.PP
    18041813.RS 4
    1805 The name of a program that can be used to check password complexity\&. The password is sent to the program\'s standard input\&.
     1814The name of a program that can be used to check password complexity\&. The password is sent to the program\*(Aqs standard input\&.
    18061815.sp
    18071816The program must return 0 on a good password, or any other value if the password is bad\&. In case the password is considered weak (the program does not return 0) the user will be notified and the password change will fail\&.
     
    18961905client lanman auth\&.
    18971906.sp
    1898 Note that Windows Vista and later versions already use NTLMv2 by default, and some sites (particularly those following \'best practice\' security polices) only allow NTLMv2 responses, and not the weaker LM or NTLM\&.
     1907Note that Windows Vista and later versions already use NTLMv2 by default, and some sites (particularly those following \*(Aqbest practice\*(Aq security polices) only allow NTLMv2 responses, and not the weaker LM or NTLM\&.
    18991908.sp
    19001909Default:
     
    19591968If disabled, Samba will use the name used to look up the server when asking the KDC for a ticket\&. This avoids situations where a server may impersonate another, soliciting authentication as one principal while being known on the network as another\&.
    19601969.sp
    1961 Note that Windows XP SP2 and later versions already follow this behaviour, and Windows Vista and later servers no longer supply this \'rfc4178 hint\' principal on the server side\&.
     1970Note that Windows XP SP2 and later versions already follow this behaviour, and Windows Vista and later servers no longer supply this \*(Aqrfc4178 hint\*(Aq principal on the server side\&.
    19621971.sp
    19631972Default:
     
    20182027.sp
    20192028Example:
    2020 \fI\fIcomment\fR\fR\fI = \fR\fIFred\'s Files\fR\fI \fR
     2029\fI\fIcomment\fR\fR\fI = \fR\fIFred\*(Aqs Files\fR\fI \fR
    20212030.RE
    20222031
     
    20562065This option takes the usual substitutions, which can be very useful\&.
    20572066.sp
    2058 If the config file doesn\'t exist then it won\'t be loaded (allowing you to special case the config files of just a few clients)\&.
     2067If the config file doesn\*(Aqt exist then it won\*(Aqt be loaded (allowing you to special case the config files of just a few clients)\&.
    20592068.sp
    20602069\fINo default\fR
     
    20682077.PP
    20692078.RS 4
    2070 This parameter allows you to "clone" service entries\&. The specified service is simply duplicated under the current service\'s name\&. Any parameters specified in the current section will override those in the section being copied\&.
    2071 .sp
    2072 This feature lets you set up a \'template\' service and create similar services easily\&. Note that the service being copied must occur earlier in the configuration file than the service doing the copying\&.
     2079This parameter allows you to "clone" service entries\&. The specified service is simply duplicated under the current service\*(Aqs name\&. Any parameters specified in the current section will override those in the section being copied\&.
     2080.sp
     2081This feature lets you set up a \*(Aqtemplate\*(Aq service and create similar services easily\&. Note that the service being copied must occur earlier in the configuration file than the service doing the copying\&.
    20732082.sp
    20742083Default:
     
    21052114.PP
    21062115.RS 4
    2107 When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to UNIX permissions, and the resulting UNIX mode is then bit\-wise \'AND\'ed with this parameter\&. This parameter may be thought of as a bit\-wise MASK for the UNIX modes of a file\&. Any bit
     2116When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to UNIX permissions, and the resulting UNIX mode is then bit\-wise \*(AqAND\*(Aqed with this parameter\&. This parameter may be thought of as a bit\-wise MASK for the UNIX modes of a file\&. Any bit
    21082117\fInot\fR
    21092118set here will be removed from the modes set on a file when it is created\&.
     
    21152124write and execute bits from the UNIX modes\&.
    21162125.sp
    2117 Following this Samba will bit\-wise \'OR\' the UNIX mode created from this parameter with the value of the
     2126Following this Samba will bit\-wise \*(AqOR\*(Aq the UNIX mode created from this parameter with the value of the
    21182127\m[blue]\fBforce create mode\fR\m[]
    21192128parameter which is set to 000 by default\&.
     
    22462255\fBcups\fR\&. Its value is a free form string of options passed directly to the cups library\&.
    22472256.sp
    2248 You can pass any generic print option known to CUPS (as listed in the CUPS "Software Users\' Manual")\&. You can also pass any printer specific option (as listed in "lpoptions \-d printername \-l") valid for the target queue\&. Multiple parameters should be space\-delimited name/value pairs according to the PAPI text option ABNF specification\&. Collection values ("name={a=\&.\&.\&. b=\&.\&.\&. c=\&.\&.\&.}") are stored with the curley brackets intact\&.
     2257You can pass any generic print option known to CUPS (as listed in the CUPS "Software Users\*(Aq Manual")\&. You can also pass any printer specific option (as listed in "lpoptions \-d printername \-l") valid for the target queue\&. Multiple parameters should be space\-delimited name/value pairs according to the PAPI text option ABNF specification\&. Collection values ("name={a=\&.\&.\&. b=\&.\&.\&. c=\&.\&.\&.}") are stored with the curley brackets intact\&.
    22492258.sp
    22502259You should set this parameter to
     
    22522261if your CUPS server
    22532262error_log
    2254 file contains messages such as "Unsupported format \'application/octet\-stream\'" when printing from a Windows client through Samba\&. It is no longer necessary to enable system wide raw printing in
     2263file contains messages such as "Unsupported format \*(Aqapplication/octet\-stream\*(Aq" when printing from a Windows client through Samba\&. It is no longer necessary to enable system wide raw printing in
    22552264/etc/cups/mime\&.{convs,types}\&.
    22562265.sp
     
    22922301The value of the parameter (a decimal integer) represents the number of minutes of inactivity before a connection is considered dead, and it is disconnected\&. The deadtime only takes effect if the number of open files is zero\&.
    22932302.sp
    2294 This is useful to stop a server\'s resources being exhausted by a large number of inactive connections\&.
     2303This is useful to stop a server\*(Aqs resources being exhausted by a large number of inactive connections\&.
    22952304.sp
    22962305Most clients have an auto\-reconnect feature when a connection is broken so in most cases this parameter should be transparent to users\&.
     
    24352444services\&. When smbd is serving Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba server has a Device Mode which defines things such as paper size and orientation and duplex settings\&. The device mode can only correctly be generated by the printer driver itself (which can only be executed on a Win32 platform)\&. Because smbd is unable to execute the driver code to generate the device mode, the default behavior is to set this field to NULL\&.
    24362445.sp
    2437 Most problems with serving printer drivers to Windows NT/2k/XP clients can be traced to a problem with the generated device mode\&. Certain drivers will do things such as crashing the client\'s Explorer\&.exe with a NULL devmode\&. However, other printer drivers can cause the client\'s spooler service (spoolsv\&.exe) to die if the devmode was not created by the driver itself (i\&.e\&. smbd generates a default devmode)\&.
     2446Most problems with serving printer drivers to Windows NT/2k/XP clients can be traced to a problem with the generated device mode\&. Certain drivers will do things such as crashing the client\*(Aqs Explorer\&.exe with a NULL devmode\&. However, other printer drivers can cause the client\*(Aqs spooler service (spoolsv\&.exe) to die if the devmode was not created by the driver itself (i\&.e\&. smbd generates a default devmode)\&.
    24382447.sp
    24392448This parameter should be used with care and tested with the printer driver in question\&. It is better to leave the device mode to NULL and let the Windows client set the correct values\&. Because drivers do not do this all the time, setting
     
    26452654when managing users with remote RPC (NT) tools\&.
    26462655.sp
    2647 This script is called when a remote client removes a user from the server, normally using \'User Manager for Domains\' or
     2656This script is called when a remote client removes a user from the server, normally using \*(AqUser Manager for Domains\*(Aq or
    26482657rpcclient\&.
    26492658.sp
     
    27282737 
    27292738#!/bin/sh
    2730 df $1 | tail \-1 | awk \'{print $(NF\-4),$(NF\-2)}\'
     2739df $1 | tail \-1 | awk \*(Aq{print $(NF\-4),$(NF\-2)}\*(Aq
    27312740.fi
    27322741.if n \{\
     
    27422751 
    27432752#!/bin/sh
    2744 /usr/bin/df \-k $1 | tail \-1 | awk \'{print $3" "$5}\'
     2753/usr/bin/df \-k $1 | tail \-1 | awk \*(Aq{print $3" "$5}\*(Aq
    27452754.fi
    27462755.if n \{\
     
    27722781This parameter is the octal modes which are used when converting DOS modes to UNIX modes when creating UNIX directories\&.
    27732782.sp
    2774 When a directory is created, the necessary permissions are calculated according to the mapping from DOS modes to UNIX permissions, and the resulting UNIX mode is then bit\-wise \'AND\'ed with this parameter\&. This parameter may be thought of as a bit\-wise MASK for the UNIX modes of a directory\&. Any bit
     2783When a directory is created, the necessary permissions are calculated according to the mapping from DOS modes to UNIX permissions, and the resulting UNIX mode is then bit\-wise \*(AqAND\*(Aqed with this parameter\&. This parameter may be thought of as a bit\-wise MASK for the UNIX modes of a directory\&. Any bit
    27752784\fInot\fR
    27762785set here will be removed from the modes set on a directory when it is created\&.
    27772786.sp
    2778 The default value of this parameter removes the \'group\' and \'other\' write bits from the UNIX mode, allowing only the user who owns the directory to modify it\&.
    2779 .sp
    2780 Following this Samba will bit\-wise \'OR\' the UNIX mode created from this parameter with the value of the
     2787The default value of this parameter removes the \*(Aqgroup\*(Aq and \*(Aqother\*(Aq write bits from the UNIX mode, allowing only the user who owns the directory to modify it\&.
     2788.sp
     2789Following this Samba will bit\-wise \*(AqOR\*(Aq the UNIX mode created from this parameter with the value of the
    27812790\m[blue]\fBforce directory mode\fR\m[]
    27822791parameter\&. This parameter is set to 000 by default (i\&.e\&. no extra mode bits are added)\&.
     
    28082817This parameter controls what UNIX permission bits will be set when a Windows NT client is manipulating the UNIX permission on a directory using the native NT security dialog box\&.
    28092818.sp
    2810 This parameter is applied as a mask (AND\'ed with) to the incoming permission bits, thus resetting any bits not in this mask\&. Make sure not to mix up this parameter with
     2819This parameter is applied as a mask (AND\*(Aqed with) to the incoming permission bits, thus resetting any bits not in this mask\&. Make sure not to mix up this parameter with
    28112820\m[blue]\fBforce directory security mode\fR\m[], which works similar like this one but uses logical OR instead of AND\&. Essentially, zero bits in this mask are a set of bits that will always be set to zero\&.
    28122821.sp
     
    28432852.ps -1
    28442853.br
    2845 Clients that only support netbios won\'t be able to see your samba server when netbios support is disabled\&.
     2854Clients that only support netbios won\*(Aqt be able to see your samba server when netbios support is disabled\&.
    28462855.sp .5v
    28472856.RE
     
    28542863.PP
    28552864.RS 4
    2856 Enabling this parameter will disable Samba\'s support for the SPOOLSS set of MS\-RPC\'s and will yield identical behavior as Samba 2\&.0\&.x\&. Windows NT/2000 clients will downgrade to using Lanman style printing commands\&. Windows 9x/ME will be unaffected by the parameter\&. However, this will also disable the ability to upload printer drivers to a Samba server via the Windows NT Add Printer Wizard or by using the NT printer properties dialog window\&. It will also disable the capability of Windows NT/2000 clients to download print drivers from the Samba host upon demand\&.
     2865Enabling this parameter will disable Samba\*(Aqs support for the SPOOLSS set of MS\-RPC\*(Aqs and will yield identical behavior as Samba 2\&.0\&.x\&. Windows NT/2000 clients will downgrade to using Lanman style printing commands\&. Windows 9x/ME will be unaffected by the parameter\&. However, this will also disable the ability to upload printer drivers to a Samba server via the Windows NT Add Printer Wizard or by using the NT printer properties dialog window\&. It will also disable the capability of Windows NT/2000 clients to download print drivers from the Samba host upon demand\&.
    28572866\fIBe very careful about enabling this parameter\&.\fR
    28582867.sp
     
    29582967\m[blue]\fBdomain logons = Yes\fR\m[]
    29592968the default setting for this parameter is Yes, with the result that Samba will be a PDC\&. If
    2960 \m[blue]\fBdomain master = No\fR\m[], Samba will function as a BDC\&. In general, this parameter should be set to \'No\' only on a BDC\&.
     2969\m[blue]\fBdomain master = No\fR\m[], Samba will function as a BDC\&. In general, this parameter should be set to \*(AqNo\*(Aq only on a BDC\&.
    29612970.sp
    29622971Default:
     
    31803189This option is mainly used as a compatibility option for Visual C++ when used against Samba shares\&. Visual C++ generated makefiles have the object directory as a dependency for each object file, and a make rule to create the directory\&. Also, when NMAKE compares timestamps it uses the creation time when examining a directory\&. Thus the object directory will be created if it does not exist, but once it does exist it will always have an earlier timestamp than the object files it contains\&.
    31813190.sp
    3182 However, Unix time semantics mean that the create time reported by Samba will be updated whenever a file is created or or deleted in the directory\&. NMAKE finds all object files in the object directory\&. The timestamp of the last one built is then compared to the timestamp of the object directory\&. If the directory\'s timestamp if newer, then all object files will be rebuilt\&. Enabling this option ensures directories always predate their contents and an NMAKE build will proceed as expected\&.
     3191However, Unix time semantics mean that the create time reported by Samba will be updated whenever a file is created or or deleted in the directory\&. NMAKE finds all object files in the object directory\&. The timestamp of the last one built is then compared to the timestamp of the object directory\&. If the directory\*(Aqs timestamp if newer, then all object files will be rebuilt\&. Enabling this option ensures directories always predate their contents and an NMAKE build will proceed as expected\&.
    31833192.sp
    31843193Default:
     
    32333242This parameter specifies a set of UNIX mode bit permissions that will
    32343243\fIalways\fR
    3235 be set on a file created by Samba\&. This is done by bitwise \'OR\'ing these bits onto the mode bits of a file that is being created\&. The default for this parameter is (in octal) 000\&. The modes in this parameter are bitwise \'OR\'ed onto the file mode after the mask set in the
     3244be set on a file created by Samba\&. This is done by bitwise \*(AqOR\*(Aqing these bits onto the mode bits of a file that is being created\&. The default for this parameter is (in octal) 000\&. The modes in this parameter are bitwise \*(AqOR\*(Aqed onto the file mode after the mask set in the
    32363245\fIcreate mask\fR
    32373246parameter is applied\&.
    32383247.sp
    3239 The example below would force all newly created files to have read and execute permissions set for \'group\' and \'other\' as well as the read/write/execute bits set for the \'user\'\&.
     3248The example below would force all newly created files to have read and execute permissions set for \*(Aqgroup\*(Aq and \*(Aqother\*(Aq as well as the read/write/execute bits set for the \*(Aquser\*(Aq\&.
    32403249.sp
    32413250Default:
     
    32523261This parameter specifies a set of UNIX mode bit permissions that will
    32533262\fIalways\fR
    3254 be set on a directory created by Samba\&. This is done by bitwise \'OR\'ing these bits onto the mode bits of a directory that is being created\&. The default for this parameter is (in octal) 0000 which will not add any extra permission bits to a created directory\&. This operation is done after the mode mask in the parameter
     3263be set on a directory created by Samba\&. This is done by bitwise \*(AqOR\*(Aqing these bits onto the mode bits of a directory that is being created\&. The default for this parameter is (in octal) 0000 which will not add any extra permission bits to a created directory\&. This operation is done after the mode mask in the parameter
    32553264\fIdirectory mask\fR
    32563265is applied\&.
    32573266.sp
    3258 The example below would force all created directories to have read and execute permissions set for \'group\' and \'other\' as well as the read/write/execute bits set for the \'user\'\&.
     3267The example below would force all created directories to have read and execute permissions set for \*(Aqgroup\*(Aq and \*(Aqother\*(Aq as well as the read/write/execute bits set for the \*(Aquser\*(Aq\&.
    32593268.sp
    32603269Default:
     
    32713280This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating the UNIX permission on a directory using the native NT security dialog box\&.
    32723281.sp
    3273 This parameter is applied as a mask (OR\'ed with) to the changed permission bits, thus forcing any bits in this mask that the user may have modified to be on\&. Make sure not to mix up this parameter with
     3282This parameter is applied as a mask (OR\*(Aqed with) to the changed permission bits, thus forcing any bits in this mask that the user may have modified to be on\&. Make sure not to mix up this parameter with
    32743283\m[blue]\fBdirectory security mask\fR\m[], which works in a similar manner to this one, but uses a logical AND instead of an OR\&.
    32753284.sp
     
    33133322This specifies a UNIX group name that will be assigned as the default primary group for all users connecting to this service\&. This is useful for sharing files by ensuring that all access to files on service will use the named group for their permissions checking\&. Thus, by assigning permissions for this group to the files and directories within this service the Samba administrator can restrict or allow sharing of these files\&.
    33143323.sp
    3315 In Samba 2\&.0\&.5 and above this parameter has extended functionality in the following way\&. If the group name listed here has a \'+\' character prepended to it then the current user accessing the share only has the primary group default assigned to this group if they are already assigned as a member of that group\&. This allows an administrator to decide that only users who are already in a particular group will create files with group ownership set to that group\&. This gives a finer granularity of ownership assignment\&. For example, the setting
     3324In Samba 2\&.0\&.5 and above this parameter has extended functionality in the following way\&. If the group name listed here has a \*(Aq+\*(Aq character prepended to it then the current user accessing the share only has the primary group default assigned to this group if they are already assigned as a member of that group\&. This allows an administrator to decide that only users who are already in a particular group will create files with group ownership set to that group\&. This gives a finer granularity of ownership assignment\&. For example, the setting
    33163325force group = +sys
    33173326means that only users who are already in group sys will have their default primary group assigned to sys when accessing this Samba share\&. All other users will retain their ordinary primary group\&.
     
    33413350option)\&.
    33423351.sp
    3343 When assigning a new driver to a printer on a remote Windows compatible print server such as Samba, the Windows client will rename the printer to match the driver name just uploaded\&. This can result in confusion for users when multiple printers are bound to the same driver\&. To prevent Samba from allowing the printer\'s printername to differ from the sharename defined in smb\&.conf, set
     3352When assigning a new driver to a printer on a remote Windows compatible print server such as Samba, the Windows client will rename the printer to match the driver name just uploaded\&. This can result in confusion for users when multiple printers are bound to the same driver\&. To prevent Samba from allowing the printer\*(Aqs printername to differ from the sharename defined in smb\&.conf, set
    33443353\fIforce printername = yes\fR\&.
    33453354.sp
    33463355Be aware that enabling this parameter may affect migrating printers from a Windows server to Samba since Windows has no way to force the sharename and printername to match\&.
    33473356.sp
    3348 It is recommended that this parameter\'s value not be changed once the printer is in use by clients as this could cause a user not be able to delete printer connections from their local Printers folder\&.
     3357It is recommended that this parameter\*(Aqs value not be changed once the printer is in use by clients as this could cause a user not be able to delete printer connections from their local Printers folder\&.
    33493358.sp
    33503359Default:
     
    33583367This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating the UNIX permission on a file using the native NT security dialog box\&.
    33593368.sp
    3360 This parameter is applied as a mask (OR\'ed with) to the changed permission bits, thus forcing any bits in this mask that the user may have modified to be on\&. Make sure not to mix up this parameter with
     3369This parameter is applied as a mask (OR\*(Aqed with) to the changed permission bits, thus forcing any bits in this mask that the user may have modified to be on\&. Make sure not to mix up this parameter with
    33613370\m[blue]\fBsecurity mask\fR\m[], which works similar like this one but uses logical AND instead of OR\&.
    33623371.sp
     
    37293738.PP
    37303739.RS 4
    3731 This is a list of files or directories that are not visible but are accessible\&. The DOS \'hidden\' attribute is applied to any files or directories that match\&.
    3732 .sp
    3733 Each entry in the list must be separated by a \'/\', which allows spaces to be included in the entry\&. \'*\' and \'?\' can be used to specify multiple files or directories as in DOS wildcards\&.
    3734 .sp
    3735 Each entry must be a Unix path, not a DOS path and must not include the Unix directory separator \'/\'\&.
     3740This is a list of files or directories that are not visible but are accessible\&. The DOS \*(Aqhidden\*(Aq attribute is applied to any files or directories that match\&.
     3741.sp
     3742Each entry in the list must be separated by a \*(Aq/\*(Aq, which allows spaces to be included in the entry\&. \*(Aq*\*(Aq and \*(Aq?\*(Aq can be used to specify multiple files or directories as in DOS wildcards\&.
     3743.sp
     3744Each entry must be a Unix path, not a DOS path and must not include the Unix directory separator \*(Aq/\*(Aq\&.
    37363745.sp
    37373746Note that the case sensitivity option is applicable in hiding files\&.
     
    37633772.PP
    37643773.RS 4
    3765 This parameter prevents clients from seeing special files such as sockets, devices and fifo\'s in directory listings\&.
     3774This parameter prevents clients from seeing special files such as sockets, devices and fifo\*(Aqs in directory listings\&.
    37663775.sp
    37673776Default:
     
    38003809is also acting as a Win95/98
    38013810\fIlogon server\fR
    3802 then this parameter specifies the NIS (or YP) map from which the server for the user\'s home directory should be extracted\&. At present, only the Sun auto\&.home map format is understood\&. The form of the map is:
     3811then this parameter specifies the NIS (or YP) map from which the server for the user\*(Aqs home directory should be extracted\&. At present, only the Sun auto\&.home map format is understood\&. The form of the map is:
    38033812.sp
    38043813.if n \{\
     
    38123821.\}
    38133822.sp
    3814 and the program will extract the servername from before the first \':\'\&. There should probably be a better parsing system that copes with different map formats and also Amd (another automounter) maps\&.
     3823and the program will extract the servername from before the first \*(Aq:\*(Aq\&. There should probably be a better parsing system that copes with different map formats and also Amd (another automounter) maps\&.
    38153824.if n \{\
    38163825.sp
     
    39893998.PP
    39903999.RS 4
    3991 This parameter specifies the number of seconds that Winbind\'s idmap interface will cache positive SID/uid/gid query results\&.
     4000This parameter specifies the number of seconds that Winbind\*(Aqs idmap interface will cache positive SID/uid/gid query results\&.
    39924001.sp
    39934002Default:
     
    39994008.PP
    40004009.RS 4
    4001 ID mapping in Samba is the mapping between Windows SIDs and Unix user and group IDs\&. This is performed by Winbindd with a configurable plugin interface\&. Samba\'s ID mapping is configured by options starting with the
     4010ID mapping in Samba is the mapping between Windows SIDs and Unix user and group IDs\&. This is performed by Winbindd with a configurable plugin interface\&. Samba\*(Aqs ID mapping is configured by options starting with the
    40024011\m[blue]\fBidmap config\fR\m[]
    40034012prefix\&. An idmap option consists of the
     
    40824091.PP
    40834092.RS 4
    4084 This parameter specifies the number of seconds that Winbind\'s idmap interface will cache negative SID/uid/gid query results\&.
     4093This parameter specifies the number of seconds that Winbind\*(Aqs idmap interface will cache negative SID/uid/gid query results\&.
    40854094.sp
    40864095Default:
     
    41574166The ownership of new files and directories is normally governed by effective uid of the connected user\&. This option allows the Samba administrator to specify that the ownership for new files and directories should be controlled by the ownership of the parent directory\&.
    41584167.sp
    4159 Common scenarios where this behavior is useful is in implementing drop\-boxes where users can create and edit files but not delete them and to ensure that newly create files in a user\'s roaming profile directory are actually owner by the user\&.
     4168Common scenarios where this behavior is useful is in implementing drop\-boxes where users can create and edit files but not delete them and to ensure that newly create files in a user\*(Aqs roaming profile directory are actually owner by the user\&.
    41604169.sp
    41614170Default:
     
    42774286The "mask" parameters can either be a bit length (such as 24 for a C class network) or a full netmask in dotted decimal form\&.
    42784287.sp
    4279 The "IP" parameters above can either be a full dotted decimal IP address or a hostname which will be looked up via the OS\'s normal hostname resolution mechanisms\&.
     4288The "IP" parameters above can either be a full dotted decimal IP address or a hostname which will be looked up via the OS\*(Aqs normal hostname resolution mechanisms\&.
    42804289.sp
    42814290By default Samba enables all active interfaces that are broadcast capable except the loopback adaptor (IP address 127\&.0\&.0\&.1)\&.
     
    42984307check to absolutely ensure an improper setting does not breach your security\&.
    42994308.sp
    4300 A name starting with a \'@\' is interpreted as an NIS netgroup first (if your system supports NIS), and then as a UNIX group if the name was not found in the NIS netgroup database\&.
    4301 .sp
    4302 A name starting with \'+\' is interpreted only by looking in the UNIX group database via the NSS getgrnam() interface\&. A name starting with \'&\' is interpreted only by looking in the NIS netgroup database (this requires NIS to be working on your system)\&. The characters \'+\' and \'&\' may be used at the start of the name in either order so the value
     4309A name starting with a \*(Aq@\*(Aq is interpreted as an NIS netgroup first (if your system supports NIS), and then as a UNIX group if the name was not found in the NIS netgroup database\&.
     4310.sp
     4311A name starting with \*(Aq+\*(Aq is interpreted only by looking in the UNIX group database via the NSS getgrnam() interface\&. A name starting with \*(Aq&\*(Aq is interpreted only by looking in the NIS netgroup database (this requires NIS to be working on your system)\&. The characters \*(Aq+\*(Aq and \*(Aq&\*(Aq may be used at the start of the name in either order so the value
    43034312\fI+&group\fR
    43044313means check the UNIX group database, followed by the NIS netgroup database, and the value
    43054314\fI&+group\fR
    4306 means check the NIS netgroup database, followed by the UNIX group database (the same as the \'@\' prefix)\&.
     4315means check the NIS netgroup database, followed by the UNIX group database (the same as the \*(Aq@\*(Aq prefix)\&.
    43074316.sp
    43084317The current servicename is substituted for
     
    44634472When this parameter is set to
    44644473no
    4465 this will also result in sambaLMPassword in Samba\'s passdb being blanked after the next password change\&. As a result of that lanman clients won\'t be able to authenticate, even if lanman auth is reenabled later on\&.
     4474this will also result in sambaLMPassword in Samba\*(Aqs passdb being blanked after the next password change\&. As a result of that lanman clients won\*(Aqt be able to authenticate, even if lanman auth is reenabled later on\&.
    44664475.sp
    44674476Unlike the
     
    44694478option, this parameter cannot alter client behaviour, and the LANMAN response will still be sent over the network\&. See the
    44704479client lanman auth
    4471 to disable this for Samba\'s clients (such as smbclient)
     4480to disable this for Samba\*(Aqs clients (such as smbclient)
    44724481.sp
    44734482If this option, and
     
    45394548for tracing function calls\&.
    45404549.sp
    4541 The debug ouput from the LDAP libraries appears with the prefix [LDAP] in Samba\'s logging output\&. The level at which LDAP logging is printed is controlled by the parameter
     4550The debug ouput from the LDAP libraries appears with the prefix [LDAP] in Samba\*(Aqs logging output\&. The level at which LDAP logging is printed is controlled by the parameter
    45424551\fIldap debug threshold\fR\&.
    45434552.sp
     
    46024611\fIoff\fR
    46034612to disable this, and
    4604 \fIauto\fR, to use the libldap default settings\&. libldap\'s choice of following referrals or not is set in /etc/openldap/ldap\&.conf with the REFERRALS parameter as documented in ldap\&.conf(5)\&.
     4613\fIauto\fR, to use the libldap default settings\&. libldap\*(Aqs choice of following referrals or not is set in /etc/openldap/ldap\&.conf with the REFERRALS parameter as documented in ldap\&.conf(5)\&.
    46054614.sp
    46064615Default:
     
    47324741.PP
    47334742.RS 4
    4734 When Samba is asked to write to a read\-only LDAP replica, we are redirected to talk to the read\-write master server\&. This server then replicates our changes back to the \'local\' server, however the replication might take some seconds, especially over slow links\&. Certain client activities, particularly domain joins, can become confused by the \'success\' that does not immediately change the LDAP back\-end\'s data\&.
     4743When Samba is asked to write to a read\-only LDAP replica, we are redirected to talk to the read\-write master server\&. This server then replicates our changes back to the \*(Aqlocal\*(Aq server, however the replication might take some seconds, especially over slow links\&. Certain client activities, particularly domain joins, can become confused by the \*(Aqsuccess\*(Aq that does not immediately change the LDAP back\-end\*(Aqs data\&.
    47354744.sp
    47364745This option simply causes Samba to wait a short time, to allow the LDAP server to catch up\&. If you have a particularly high\-latency network, you may wish to time the LDAP replication with a network sniffer, and increase this value accordingly\&. Be aware that no checking is performed that the data has actually replicated\&.
     
    48564865This option is used to define whether or not Samba should use SSL when connecting to the ldap server using
    48574866\fIads\fR
    4858 methods\&. Rpc methods are not affected by this parameter\&. Please note, that this parameter won\'t have any effect if
     4867methods\&. Rpc methods are not affected by this parameter\&. Please note, that this parameter won\*(Aqt have any effect if
    48594868\m[blue]\fBldap ssl\fR\m[]
    48604869is set to
     
    48764885This option is used to define whether or not Samba should use SSL when connecting to the ldap server This is
    48774886\fINOT\fR
    4878 related to Samba\'s previous SSL support which was enabled by specifying the
     4887related to Samba\*(Aqs previous SSL support which was enabled by specifying the
    48794888\-\-with\-ssl
    48804889option to the
     
    50795088\fByes\fR\&. Setting this value to
    50805089\fByes\fR
    5081 doesn\'t mean that Samba will
     5090doesn\*(Aqt mean that Samba will
    50825091\fIbecome\fR
    50835092the local master browser on a subnet, just that
     
    54605469This option takes the standard substitutions, allowing you to have separate logon scripts for each user or machine\&.
    54615470.sp
    5462 This parameter can be used with Win9X workstations to ensure that roaming profiles are stored in a subdirectory of the user\'s home directory\&. This is done in the following way:
     5471This parameter can be used with Win9X workstations to ensure that roaming profiles are stored in a subdirectory of the user\*(Aqs home directory\&. This is done in the following way:
    54635472.sp
    54645473
     
    56185627This parameter specifies the command to be executed on the server host in order to stop printing or spooling a specific print job\&.
    56195628.sp
    5620 This command should be a program or script which takes a printer name and job number to pause the print job\&. One way of implementing this is by using job priorities, where jobs having a too low priority won\'t be sent to the printer\&.
     5629This command should be a program or script which takes a printer name and job number to pause the print job\&. One way of implementing this is by using job priorities, where jobs having a too low priority won\*(Aqt be sent to the printer\&.
    56215630.sp
    56225631If a
     
    56485657command used by the system, so if you use different
    56495658lpq
    5650 commands for different users then they won\'t share cache information\&.
     5659commands for different users then they won\*(Aqt share cache information\&.
    56515660.sp
    56525661The cache files are stored in
     
    59005909Note that the character to use may be specified using the
    59015910\m[blue]\fBmangling char\fR\m[]
    5902 option, if you don\'t like \'~\'\&.
    5903 .RE
    5904 .sp
    5905 .RS 4
    5906 .ie n \{\
    5907 \h'-04'\(bu\h'+03'\c
    5908 .\}
    5909 .el \{\
    5910 .sp -1
    5911 .IP \(bu 2.3
    5912 .\}
    5913 Files whose UNIX name begins with a dot will be presented as DOS hidden files\&. The mangled name will be created as for other filenames, but with the leading dot removed and "___" as its extension regardless of actual original extension (that\'s three underscores)\&.
     5911option, if you don\*(Aqt like \*(Aq~\*(Aq\&.
     5912.RE
     5913.sp
     5914.RS 4
     5915.ie n \{\
     5916\h'-04'\(bu\h'+03'\c
     5917.\}
     5918.el \{\
     5919.sp -1
     5920.IP \(bu 2.3
     5921.\}
     5922Files whose UNIX name begins with a dot will be presented as DOS hidden files\&. The mangled name will be created as for other filenames, but with the leading dot removed and "___" as its extension regardless of actual original extension (that\*(Aqs three underscores)\&.
    59145923.RE
    59155924.sp
     
    59475956\fImagic\fR
    59485957character in
    5949 \m[blue]\fBname mangling\fR\m[]\&. The default is a \'~\' but this may interfere with some software\&. Use this option to set it to whatever you prefer\&. This is effective only when mangling method is hash\&.
     5958\m[blue]\fBname mangling\fR\m[]\&. The default is a \*(Aq~\*(Aq but this may interfere with some software\&. Use this option to set it to whatever you prefer\&. This is effective only when mangling method is hash\&.
    59505959.sp
    59515960Default:
     
    59755984This boolean parameter controls whether
    59765985\fBsmbd\fR(8)
    5977 will attempt to map the \'inherit\' and \'protected\' access control entry flags stored in Windows ACLs into an extended attribute called user\&.SAMBA_PAI\&. This parameter only takes effect if Samba is being run on a platform that supports extended attributes (Linux and IRIX so far) and allows the Windows 2000 ACL editor to correctly use inheritance with the Samba POSIX ACL mapping code\&.
     5986will attempt to map the \*(Aqinherit\*(Aq and \*(Aqprotected\*(Aq access control entry flags stored in Windows ACLs into an extended attribute called user\&.SAMBA_PAI\&. This parameter only takes effect if Samba is being run on a platform that supports extended attributes (Linux and IRIX so far) and allows the Windows 2000 ACL editor to correctly use inheritance with the Samba POSIX ACL mapping code\&.
    59785987.sp
    59795988Default:
     
    61126121This parameter can take four different values, which tell
    61136122\fBsmbd\fR(8)
    6114 what to do with user login requests that don\'t match a valid UNIX user in some way\&.
     6123what to do with user login requests that don\*(Aqt match a valid UNIX user in some way\&.
    61156124.sp
    61166125The four settings are :
     
    61946203.PP
    61956204.RS 4
    6196 If a client connects to smbd using an untrusted domain name, such as BOGUS\euser, smbd replaces the BOGUS domain with it\'s SAM name before attempting to authenticate that user\&. In the case where smbd is acting as a PDC this will be DOMAIN\euser\&. In the case where smbd is acting as a domain member server or a standalone server this will be WORKSTATION\euser\&.
     6205If a client connects to smbd using an untrusted domain name, such as BOGUS\euser, smbd replaces the BOGUS domain with it\*(Aqs SAM name before attempting to authenticate that user\&. In the case where smbd is acting as a PDC this will be DOMAIN\euser\&. In the case where smbd is acting as a domain member server or a standalone server this will be WORKSTATION\euser\&.
    61976206.sp
    61986207In previous versions of Samba (pre 3\&.4), if smbd was acting as a domain member server, the BOGUS domain name would instead be replaced by the primary domain which smbd was a member of\&. In this case authentication would be deferred off to a DC using the credentials DOMAIN\euser\&.
     
    62346243\fImax disk size\fR\&.
    62356244.sp
    6236 This option is primarily useful to work around bugs in some pieces of software that can\'t handle very large disks, particularly disks over 1GB in size\&.
     6245This option is primarily useful to work around bugs in some pieces of software that can\*(Aqt handle very large disks, particularly disks over 1GB in size\&.
    62376246.sp
    62386247A
     
    63846393.IP \(bu 2.3
    63856394.\}
    6386 \fBSMB2\fR: Re\-implementation of the SMB protocol\&. Used by Windows Vista and newer\&. The Samba implementation of SMB2 is currently marked experimental!
     6395\fBSMB2\fR: Re\-implementation of the SMB protocol\&. Used by Windows Vista and newer\&.
    63876396.RE
    63886397.sp
     
    64486457This option tells
    64496458\fBnmbd\fR(8)
    6450 what the default \'time to live\' of NetBIOS names should be (in seconds) when
     6459what the default \*(Aqtime to live\*(Aq of NetBIOS names should be (in seconds) when
    64516460nmbd
    64526461is requesting a name using either a broadcast packet or from a WINS server\&. You should never need to change this parameter\&. The default is 3 days\&.
     
    64626471This option tells
    64636472\fBsmbd\fR(8)
    6464 when acting as a WINS server (\m[blue]\fBwins support = yes\fR\m[]) what the maximum \'time to live\' of NetBIOS names that
     6473when acting as a WINS server (\m[blue]\fBwins support = yes\fR\m[]) what the maximum \*(Aqtime to live\*(Aq of NetBIOS names that
    64656474nmbd
    64666475will grant will be (in seconds)\&. You should never need to change this parameter\&. The default is 6 days (518400 seconds)\&.
     
    64976506.\}
    64986507.nf
    6499 message command = csh \-c \'xedit %s;rm %s\' &
     6508message command = csh \-c \*(Aqxedit %s;rm %s\*(Aq &
    65006509.fi
    65016510.if n \{\
     
    65056514This delivers the message using
    65066515xedit, then removes it afterwards\&.
    6507 \fINOTE THAT IT IS VERY IMPORTANT THAT THIS COMMAND RETURN IMMEDIATELY\fR\&. That\'s why I have the \'&\' on the end\&. If it doesn\'t return immediately then your PCs may freeze when sending messages (they should recover after 30 seconds, hopefully)\&.
     6516\fINOTE THAT IT IS VERY IMPORTANT THAT THIS COMMAND RETURN IMMEDIATELY\fR\&. That\*(Aqs why I have the \*(Aq&\*(Aq on the end\&. If it doesn\*(Aqt return immediately then your PCs may freeze when sending messages (they should recover after 30 seconds, hopefully)\&.
    65086517.sp
    65096518All messages are delivered as the global guest user\&. The command takes the standard substitutions, although
    65106519\fI %u\fR
    6511 won\'t work (\fI%U\fR
     6520won\*(Aqt work (\fI%U\fR
    65126521may be better in this case)\&.
    65136522.sp
     
    65536562You could make this command send mail, or whatever else takes your fancy\&. Please let us know of any really interesting ideas you have\&.
    65546563.sp
    6555 Here\'s a way of sending the messages as mail to root:
     6564Here\*(Aqs a way of sending the messages as mail to root:
    65566565.sp
    65576566.if n \{\
     
    65596568.\}
    65606569.nf
    6561 message command = /bin/mail \-s \'message from %f on %m\' root < %s; rm %s
     6570message command = /bin/mail \-s \*(Aqmessage from %f on %m\*(Aq root < %s; rm %s
    65626571.fi
    65636572.if n \{\
     
    65656574.\}
    65666575.sp
    6567 If you don\'t have a message command then the message won\'t be delivered and Samba will tell the sender there was an error\&. Unfortunately WfWg totally ignores the error code and carries on regardless, saying that the message was delivered\&.
     6576If you don\*(Aqt have a message command then the message won\*(Aqt be delivered and Samba will tell the sender there was an error\&. Unfortunately WfWg totally ignores the error code and carries on regardless, saying that the message was delivered\&.
    65686577.sp
    65696578If you want to silently delete it then try:
     
    65836592.sp
    65846593Example:
    6585 \fI\fImessage command\fR\fR\fI = \fR\fIcsh \-c \'xedit %s; rm %s\' &\fR\fI \fR
     6594\fI\fImessage command\fR\fR\fI = \fR\fIcsh \-c \*(Aqxedit %s; rm %s\*(Aq &\fR\fI \fR
    65866595.RE
    65876596
     
    66426651This option tells
    66436652\fBnmbd\fR(8)
    6644 when acting as a WINS server (\m[blue]\fBwins support = yes\fR\m[]) what the minimum \'time to live\' of NetBIOS names that
     6653when acting as a WINS server (\m[blue]\fBwins support = yes\fR\m[]) what the minimum \*(Aqtime to live\*(Aq of NetBIOS names that
    66456654nmbd
    66466655will grant will be (in seconds)\&. You should never need to change this parameter\&. The default is 6 hours (21600 seconds)\&.
     
    66976706.PP
    66986707.RS 4
    6699 Specifies the number of seconds it takes before entries in samba\'s hostname resolve cache time out\&. If the timeout is set to 0\&. the caching is disabled\&.
     6708Specifies the number of seconds it takes before entries in samba\*(Aqs hostname resolve cache time out\&. If the timeout is set to 0\&. the caching is disabled\&.
    67006709.sp
    67016710Default:
     
    67956804.sp
    67966805\&.
    6797         This will allow Samba and other unix processes to interact over DCE/RPC without using TCP/IP\&. Additionally a sub\-directory \'np\' has restricted permissions, and allows a trusted communication channel between Samba processes
     6806        This will allow Samba and other unix processes to interact over DCE/RPC without using TCP/IP\&. Additionally a sub\-directory \*(Aqnp\*(Aq has restricted permissions, and allows a trusted communication channel between Samba processes
    67986807.sp
    67996808Default:
     
    68216830.PP
    68226831.RS 4
    6823 This sets the NetBIOS name by which a Samba server is known\&. By default it is the same as the first component of the host\'s DNS name\&. If a machine is a browse server or logon server this name (or the first component of the hosts DNS name) will be the name that these services are advertised under\&.
     6832This sets the NetBIOS name by which a Samba server is known\&. By default it is the same as the first component of the host\*(Aqs DNS name\&. If a machine is a browse server or logon server this name (or the first component of the hosts DNS name) will be the name that these services are advertised under\&.
    68246833.sp
    68256834There is a bug in Samba\-3 that breaks operation of browsing and access to shares if the netbios name is set to the literal name
     
    68486857.PP
    68496858.RS 4
    6850 Get the home share server from a NIS map\&. For UNIX systems that use an automounter, the user\'s home directory will often be mounted on a workstation on demand from a remote server\&.
     6859Get the home share server from a NIS map\&. For UNIX systems that use an automounter, the user\*(Aqs home directory will often be mounted on a workstation on demand from a remote server\&.
    68516860.sp
    68526861When the Samba logon server is not the actual home directory server, but is mounting the home directories via NFS then two network hops would be required to access the users home directory if the logon server told the client to use itself as the SMB server for home directories (one over SMB and one over NFS)\&. This can be very slow\&.
     
    69516960.PP
    69526961.RS 4
    6953 When Samba 3\&.0 is configured to enable PAM support (i\&.e\&. \-\-with\-pam), this parameter will control whether or not Samba should obey PAM\'s account and session management directives\&. The default behavior is to use PAM for clear text authentication only and to ignore any account or session management\&. Note that Samba always ignores PAM for authentication in the case of
     6962When Samba 3\&.0 is configured to enable PAM support (i\&.e\&. \-\-with\-pam), this parameter will control whether or not Samba should obey PAM\*(Aqs account and session management directives\&. The default behavior is to use PAM for clear text authentication only and to ignore any account or session management\&. Note that Samba always ignores PAM for authentication in the case of
    69546963\m[blue]\fBencrypt passwords = yes\fR\m[]\&. The reason is that PAM modules cannot support the challenge/response authentication mechanism needed in the presence of SMB password encryption\&.
    69556964.sp
     
    69706979level security\&.
    69716980.sp
    6972 Note that this also means Samba won\'t try to deduce usernames from the service name\&. This can be annoying for the [homes] section\&. To get around this you could use
     6981Note that this also means Samba won\*(Aqt try to deduce usernames from the service name\&. This can be annoying for the [homes] section\&. To get around this you could use
    69736982user = %S
    69746983which means your
     
    70987107.PP
    70997108.RS 4
    7100 With the addition of better PAM support in Samba 2\&.2, this parameter, it is possible to use PAM\'s password change control flag for Samba\&. If enabled, then PAM will be used for password changes when requested by an SMB client instead of the program listed in
     7109With the addition of better PAM support in Samba 2\&.2, this parameter, it is possible to use PAM\*(Aqs password change control flag for Samba\&. If enabled, then PAM will be used for password changes when requested by an SMB client instead of the program listed in
    71017110\m[blue]\fBpasswd program\fR\m[]\&. It should be possible to enable this without changing your
    71027111\m[blue]\fBpasswd chat\fR\m[]
     
    71427151This option allows the administrator to chose which backend will be used for storing user and possibly group information\&. This allows you to swap between different storage mechanisms without recompile\&.
    71437152.sp
    7144 The parameter value is divided into two parts, the backend\'s name, and a \'location\' string that has meaning only to that particular backed\&. These are separated by a : character\&.
     7153The parameter value is divided into two parts, the backend\*(Aqs name, and a \*(Aqlocation\*(Aq string that has meaning only to that particular backed\&. These are separated by a : character\&.
    71457154.sp
    71467155Available backends can include:
     
    72227231.PP
    72237232.RS 4
    7224 This parameter controls whether Samba substitutes %\-macros in the passdb fields if they are explicitly set\&. We used to expand macros here, but this turned out to be a bug because the Windows client can expand a variable %G_osver% in which %G would have been substituted by the user\'s primary group\&.
     7233This parameter controls whether Samba substitutes %\-macros in the passdb fields if they are explicitly set\&. We used to expand macros here, but this turned out to be a bug because the Windows client can expand a variable %G_osver% in which %G would have been substituted by the user\*(Aqs primary group\&.
    72257234.sp
    72267235Default:
     
    72707279conversation that takes places between
    72717280\fBsmbd\fR(8)
    7272 and the local password changing program to change the user\'s password\&. The string describes a sequence of response\-receive pairs that
     7281and the local password changing program to change the user\*(Aqs password\&. The string describes a sequence of response\-receive pairs that
    72737282\fBsmbd\fR(8)
    72747283uses to determine what to send to the
     
    72837292\fByes\fR\&. This sequence is then called
    72847293\fIAS ROOT\fR
    7285 when the SMB password in the smbpasswd file is being changed, without access to the old password cleartext\&. This means that root must be able to reset the user\'s password without knowing the text of the previous password\&. In the presence of NIS/YP, this means that the
     7294when the SMB password in the smbpasswd file is being changed, without access to the old password cleartext\&. This means that root must be able to reset the user\*(Aqs password without knowing the text of the previous password\&. In the presence of NIS/YP, this means that the
    72867295\m[blue]\fBpasswd program\fR\m[]
    72877296must be executed on the NIS master\&.
     
    72917300which is substituted for the new password\&. The old passsword (\fI%o\fR) is only available when
    72927301\m[blue]\fBencrypt passwords\fR\m[]
    7293 has been disabled\&. The chat sequence can also contain the standard macros \en, \er, \et and \es to give line\-feed, carriage\-return, tab and space\&. The chat sequence string can also contain a \'*\' which matches any sequence of characters\&. Double quotes can be used to collect strings with spaces in them into a single string\&.
     7302has been disabled\&. The chat sequence can also contain the standard macros \en, \er, \et and \es to give line\-feed, carriage\-return, tab and space\&. The chat sequence string can also contain a \*(Aq*\*(Aq which matches any sequence of characters\&. Double quotes can be used to collect strings with spaces in them into a single string\&.
    72947303.sp
    72957304If the send string in any part of the chat sequence is a full stop "\&.", then no string is sent\&. Similarly, if the expect string is a full stop then no string is expected\&.
     
    73997408\fBads\fR, then this option
    74007409\fIshould not\fR
    7401 be used, as the default \'*\' indicates to Samba to determine the best DC to contact dynamically, just as all other hosts in an AD domain do\&. This allows the domain to be maintained without modification to the smb\&.conf file\&. The cryptograpic protection on the authenticated RPC calls used to verify passwords ensures that this default is safe\&.
    7402 .sp
    7403 \fIIt is strongly recommended that you use the default of \'*\'\fR, however if in your particular environment you have reason to specify a particular DC list, then the list of machines in this option must be a list of names or IP addresses of Domain controllers for the Domain\&. If you use the default of \'*\', or list several hosts in the
     7410be used, as the default \*(Aq*\*(Aq indicates to Samba to determine the best DC to contact dynamically, just as all other hosts in an AD domain do\&. This allows the domain to be maintained without modification to the smb\&.conf file\&. The cryptograpic protection on the authenticated RPC calls used to verify passwords ensures that this default is safe\&.
     7411.sp
     7412\fIIt is strongly recommended that you use the default of \*(Aq*\*(Aq\fR, however if in your particular environment you have reason to specify a particular DC list, then the list of machines in this option must be a list of names or IP addresses of Domain controllers for the Domain\&. If you use the default of \*(Aq*\*(Aq, or list several hosts in the
    74047413\fIpassword server\fR
    74057414option then
     
    74077416will try each in turn till it finds one that responds\&. This is useful in case your primary server goes down\&.
    74087417.sp
    7409 If the list of servers contains both names/IP\'s and the \'*\' character, the list is treated as a list of preferred domain controllers, but an auto lookup of all remaining DC\'s will be added to the list as well\&. Samba will not attempt to optimize this list by locating the closest DC\&.
     7418If the list of servers contains both names/IP\*(Aqs and the \*(Aq*\*(Aq character, the list is treated as a list of preferred domain controllers, but an auto lookup of all remaining DC\*(Aqs will be added to the list as well\&. Samba will not attempt to optimize this list by locating the closest DC\&.
    74107419.sp
    74117420If parameter is a name, it is looked up using the parameter
     
    74807489.\}
    74817490Using a password server means your UNIX box (running Samba) is only as secure as (a host masqurading as) your password server\&.
    7482 \fIDO NOT CHOOSE A PASSWORD SERVER THAT YOU DON\'T COMPLETELY TRUST\fR\&.
     7491\fIDO NOT CHOOSE A PASSWORD SERVER THAT YOU DON\*(AqT COMPLETELY TRUST\fR\&.
    74837492.RE
    74847493.sp
     
    75317540This parameter specifies a directory to which the user of the service is to be given access\&. In the case of printable services, this is where print data will spool prior to being submitted to the host for printing\&.
    75327541.sp
    7533 For a printable service offering guest access, the service should be readonly and the path should be world\-writeable and have the sticky bit set\&. This is not mandatory of course, but you probably won\'t get the results you expect if you do otherwise\&.
     7542For a printable service offering guest access, the service should be readonly and the path should be world\-writeable and have the sticky bit set\&. This is not mandatory of course, but you probably won\*(Aqt get the results you expect if you do otherwise\&.
    75347543.sp
    75357544Any occurrences of
     
    76307639.sp
    76317640
    7632 preexec = csh \-c \'echo \e"Welcome to %S!\e" | /usr/local/samba/bin/smbclient \-M %m \-I %I\' &
     7641preexec = csh \-c \*(Aqecho \e"Welcome to %S!\e" | /usr/local/samba/bin/smbclient \-M %m \-I %I\*(Aq &
    76337642.sp
    76347643Of course, this could get annoying after a while :\-)
     
    78197828.\}
    78207829.sp
    7821 where the \'|\' separates aliases of a printer\&. The fact that the second alias has a space in it gives a hint to Samba that it\'s a comment\&.
     7830where the \*(Aq|\*(Aq separates aliases of a printer\&. The fact that the second alias has a space in it gives a hint to Samba that it\*(Aqs a comment\&.
    78227831.if n \{\
    78237832.sp
     
    78537862After a print job has finished spooling to a service, this command will be used via a
    78547863system()
    7855 call to process the spool file\&. Typically the command specified will submit the spool file to the host\'s printing subsystem, but there is no requirement that this be the case\&. The server will not remove the spool file, so whatever command you specify should remove the spool file when it has been processed, otherwise you will need to manually remove old spool files\&.
     7864call to process the spool file\&. Typically the command specified will submit the spool file to the host\*(Aqs printing subsystem, but there is no requirement that this be the case\&. The server will not remove the spool file, so whatever command you specify should remove the spool file when it has been processed, otherwise you will need to manually remove old spool files\&.
    78567865.sp
    78577866The print command is simply a text string\&. It will be used verbatim after macro substitutions have been made:
     
    78897898in the [global] section\&.
    78907899.sp
    7891 You can form quite complex print commands by realizing that they are just passed to a shell\&. For example the following will log a print job, print the file, then remove it\&. Note that \';\' is the usual separator for command in shell scripts\&.
     7900You can form quite complex print commands by realizing that they are just passed to a shell\&. For example the following will log a print job, print the file, then remove it\&. Note that \*(Aq;\*(Aq is the usual separator for command in shell scripts\&.
    78927901.sp
    78937902print command = echo Printing %s >> /tmp/print\&.log; lpr \-P %p %s; rm %s
     
    81378146.sp
    81388147If this parameter is
    8139 \fByes\fR, then users of a service may not create or modify files in the service\'s directory\&.
     8148\fByes\fR, then users of a service may not create or modify files in the service\*(Aqs directory\&.
    81408149.sp
    81418150Note that a printable service (printable = yes) will
     
    82088217to periodically announce itself to arbitrary IP addresses with an arbitrary workgroup name\&.
    82098218.sp
    8210 This is useful if you want your Samba server to appear in a remote workgroup for which the normal browse propagation rules don\'t work\&. The remote workgroup can be anywhere that you can send IP packets to\&.
     8219This is useful if you want your Samba server to appear in a remote workgroup for which the normal browse propagation rules don\*(Aqt work\&. The remote workgroup can be anywhere that you can send IP packets to\&.
    82118220.sp
    82128221For example:
     
    82448253to periodically request synchronization of browse lists with the master browser of a Samba server that is on a remote segment\&. This option will allow you to gain browse lists for multiple workgroups across routed networks\&. This is done in a manner that does not work with any non\-Samba servers\&.
    82458254.sp
    8246 This is useful if you want your Samba server and all local clients to appear in a remote workgroup for which the normal browse propagation rules don\'t work\&. The remote workgroup can be anywhere that you can send IP packets to\&.
     8255This is useful if you want your Samba server and all local clients to appear in a remote workgroup for which the normal browse propagation rules don\*(Aqt work\&. The remote workgroup can be anywhere that you can send IP packets to\&.
    82478256.sp
    82488257For example:
     
    84838492This parameter controls what UNIX permission bits will be set when a Windows NT client is manipulating the UNIX permission on a file using the native NT security dialog box\&.
    84848493.sp
    8485 This parameter is applied as a mask (AND\'ed with) to the incoming permission bits, thus resetting any bits not in this mask\&. Make sure not to mix up this parameter with
     8494This parameter is applied as a mask (AND\*(Aqed with) to the incoming permission bits, thus resetting any bits not in this mask\&. Make sure not to mix up this parameter with
    84868495\m[blue]\fBforce security mode\fR\m[], which works in a manner similar to this one but uses a logical OR instead of an AND\&.
    84878496.sp
     
    85588567that the name of the resource being requested is
    85598568\fInot\fR
    8560 sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\'t work in user level security without allowing the server to automatically map unknown users into the
     8569sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\*(Aqt work in user level security without allowing the server to automatically map unknown users into the
    85618570\m[blue]\fBguest account\fR\m[]\&. See the
    85628571\m[blue]\fBmap to guest\fR\m[]
     
    85798588.sp
    85808589\fINote\fR
    8581 that from the client\'s point of view
     8590that from the client\*(Aqs point of view
    85828591security = domain
    85838592is the same as
     
    85878596that the name of the resource being requested is
    85888597\fInot\fR
    8589 sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\'t work in user level security without allowing the server to automatically map unknown users into the
     8598sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\*(Aqt work in user level security without allowing the server to automatically map unknown users into the
    85908599\m[blue]\fBguest account\fR\m[]\&. See the
    85918600\m[blue]\fBmap to guest\fR\m[]
     
    87478756.ps -1
    87488757.br
    8749 This mode of operation has significant pitfalls since it is more vulnerable to man\-in\-the\-middle attacks and server impersonation\&. In particular, this mode of operation can cause significant resource consumption on the PDC, as it must maintain an active connection for the duration of the user\'s session\&. Furthermore, if this connection is lost, there is no way to reestablish it, and further authentications to the Samba server may fail (from a single client, till it disconnects)\&.
     8758This mode of operation has significant pitfalls since it is more vulnerable to man\-in\-the\-middle attacks and server impersonation\&. In particular, this mode of operation can cause significant resource consumption on the PDC, as it must maintain an active connection for the duration of the user\*(Aqs session\&. Furthermore, if this connection is lost, there is no way to reestablish it, and further authentications to the Samba server may fail (from a single client, till it disconnects)\&.
    87508759.sp .5v
    87518760.RE
     
    87788787.ps -1
    87798788.br
    8780 From the client\'s point of view,
     8789From the client\*(Aqs point of view,
    87818790security = server
    87828791is the same as
     
    88028811that the name of the resource being requested is
    88038812\fInot\fR
    8804 sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\'t work in user level security without allowing the server to automatically map unknown users into the
     8813sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\*(Aqt work in user level security without allowing the server to automatically map unknown users into the
    88058814\m[blue]\fBguest account\fR\m[]\&. See the
    88068815\m[blue]\fBmap to guest\fR\m[]
     
    88418850If enabled, Samba can attempt to help clients to use Kerberos to contact it, even when known only by IP address or a name not registered with our KDC as a service principal name\&. Kerberos relies on names, so ordinarily cannot function in this situation\&.
    88428851.sp
    8843 If disabled, Samba will send the string not_defined_in_RFC4178@please_ignore as the \'rfc4178 hint\', following the updated RFC and Windows 2008 behaviour in this area\&.
     8852If disabled, Samba will send the string not_defined_in_RFC4178@please_ignore as the \*(Aqrfc4178 hint\*(Aq, following the updated RFC and Windows 2008 behaviour in this area\&.
    88448853.sp
    88458854Note that Windows XP SP2 and later versions already ignored this value in all circumstances\&.
     
    89498958.sp
    89508959Example:
    8951 \fI\fIset primary group script\fR\fR\fI = \fR\fI/usr/sbin/usermod \-g \'%g\' \'%u\'\fR\fI \fR
     8960\fI\fIset primary group script\fR\fR\fI = \fR\fI/usr/sbin/usermod \-g \*(Aq%g\*(Aq \*(Aq%u\*(Aq\fR\fI \fR
    89528961.RE
    89538962
     
    95509559.RE
    95519560Those marked with a
    9552 \fI\'*\'\fR
    9553 take an integer argument\&. The others can optionally take a 1 or 0 argument to enable or disable the option, by default they will be enabled if you don\'t specify 1 or 0\&.
     9561\fI\*(Aq*\*(Aq\fR
     9562take an integer argument\&. The others can optionally take a 1 or 0 argument to enable or disable the option, by default they will be enabled if you don\*(Aqt specify 1 or 0\&.
    95549563.sp
    95559564To specify an argument use the syntax SOME_OPTION = VALUE for example
     
    96349643the server will change from UNIX behaviour of not committing real disk storage blocks when a file is extended to the Windows behaviour of actually forcing the disk system to allocate real storage blocks when a file is created or extended to be a given size\&. In UNIX terminology this means that Samba will stop creating sparse files\&.
    96359644.sp
    9636 This option is really desgined for file systems that support fast allocation of large numbers of blocks such as extent\-based file systems\&. On file systems that don\'t support extents (most notably ext3) this can make Samba slower\&. When you work with large files over >100MB on file systems without extents you may even run into problems with clients running into timeouts\&.
    9637 .sp
    9638 When you have an extent based filesystem it\'s likely that we can make use of unwritten extents which allows Samba to allocate even large amounts of space very fast and you will not see any timeout problems caused by strict allocate\&. With strict allocate in use you will also get much better out of quota messages in case you use quotas\&. Another advantage of activating this setting is that it will help to reduce file fragmentation\&.
     9645This option is really desgined for file systems that support fast allocation of large numbers of blocks such as extent\-based file systems\&. On file systems that don\*(Aqt support extents (most notably ext3) this can make Samba slower\&. When you work with large files over >100MB on file systems without extents you may even run into problems with clients running into timeouts\&.
     9646.sp
     9647When you have an extent based filesystem it\*(Aqs likely that we can make use of unwritten extents which allows Samba to allocate even large amounts of space very fast and you will not see any timeout problems caused by strict allocate\&. With strict allocate in use you will also get much better out of quota messages in case you use quotas\&. Another advantage of activating this setting is that it will help to reduce file fragmentation\&.
    96399648.sp
    96409649To give you an idea on which filesystems this setting might currently be a good option for you: XFS, ext4, btrfs, ocfs2 on Linux and JFS2 on AIX support unwritten extents\&. On Filesystems that do not support it, preallocation is probably an expensive operation where you will see reduced performance and risk to let clients run into timeouts when creating large files\&. Examples are ext3, ZFS, HFS+ and most others, so be aware if you activate this setting on those filesystems\&.
     
    96879696The administrator must create a directory name
    96889697svcctl
    9689 in Samba\'s $(libdir) and create symbolic links to the init scripts in
     9698in Samba\*(Aqs $(libdir) and create symbolic links to the init scripts in
    96909699/etc/init\&.d/\&. The name of the links must match the names given as part of the
    96919700\fIsvcctl list\fR\&.
     
    97049713This is a boolean parameter that controls whether writes will always be written to stable storage before the write call returns\&. If this is
    97059714\fBno\fR
    9706 then the server will be guided by the client\'s request in each write call (clients can set a bit indicating that a particular write should be synchronous)\&. If this is
     9715then the server will be guided by the client\*(Aqs request in each write call (clients can set a bit indicating that a particular write should be synchronous)\&. If this is
    97079716\fByes\fR
    97089717then every write will be followed by a
     
    97569765daemon uses this parameter to fill in the home directory for that user\&. If the string
    97579766\fI%D\fR
    9758 is present it is substituted with the user\'s Windows NT domain name\&. If the string
     9767is present it is substituted with the user\*(Aqs Windows NT domain name\&. If the string
    97599768\fI%U\fR
    9760 is present it is substituted with the user\'s Windows NT user name\&.
     9769is present it is substituted with the user\*(Aqs Windows NT user name\&.
    97619770.sp
    97629771Default:
     
    98959904.PP
    98969905.RS 4
    9897 This option helps Samba to try and \'guess\' at the real UNIX username, as many DOS clients send an all\-uppercase username\&. By default Samba tries all lowercase, followed by the username with the first letter capitalized, and fails if the username is not found on the UNIX machine\&.
     9906This option helps Samba to try and \*(Aqguess\*(Aq at the real UNIX username, as many DOS clients send an all\-uppercase username\&. By default Samba tries all lowercase, followed by the username with the first letter capitalized, and fails if the username is not found on the UNIX machine\&.
    98989907.sp
    98999908If this parameter is set to non\-zero the behavior changes\&. This parameter is a number that specifies the number of uppercase combinations to try while trying to determine the UNIX user name\&. The higher the number the more combinations will be tried, but the slower the discovery of usernames will be\&. Use this parameter when you have strange usernames on your UNIX machine, such as
     
    99569965DOMAIN\efoo)\&.
    99579966.sp
    9958 The map file is parsed line by line\&. Each line should contain a single UNIX username on the left then a \'=\' followed by a list of usernames on the right\&. The list of usernames on the right may contain names of the form @group in which case they will match any UNIX username in that group\&. The special client name \'*\' is a wildcard and matches any name\&. Each line of the map file may be up to 1023 characters long\&.
    9959 .sp
    9960 The file is processed on each line by taking the supplied username and comparing it with each username on the right hand side of the \'=\' signs\&. If the supplied name matches any of the names on the right hand side then it is replaced with the name on the left\&. Processing then continues with the next line\&.
    9961 .sp
    9962 If any line begins with a \'#\' or a \';\' then it is ignored\&.
    9963 .sp
    9964 If any line begins with an \'!\' then the processing will stop after that line if a mapping was done by the line\&. Otherwise mapping continues with every line being processed\&. Using \'!\' is most useful when you have a wildcard mapping line later in the file\&.
     9967The map file is parsed line by line\&. Each line should contain a single UNIX username on the left then a \*(Aq=\*(Aq followed by a list of usernames on the right\&. The list of usernames on the right may contain names of the form @group in which case they will match any UNIX username in that group\&. The special client name \*(Aq*\*(Aq is a wildcard and matches any name\&. Each line of the map file may be up to 1023 characters long\&.
     9968.sp
     9969The file is processed on each line by taking the supplied username and comparing it with each username on the right hand side of the \*(Aq=\*(Aq signs\&. If the supplied name matches any of the names on the right hand side then it is replaced with the name on the left\&. Processing then continues with the next line\&.
     9970.sp
     9971If any line begins with a \*(Aq#\*(Aq or a \*(Aq;\*(Aq then it is ignored\&.
     9972.sp
     9973If any line begins with an \*(Aq!\*(Aq then the processing will stop after that line if a mapping was done by the line\&. Otherwise mapping continues with every line being processed\&. Using \*(Aq!\*(Aq is most useful when you have a wildcard mapping line later in the file\&.
    99659974.sp
    99669975For example to map from the name
     
    1001810027would map the windows username "Andrew Tridgell" to the unix username "tridge"\&.
    1001910028.sp
    10020 The following example would map mary and fred to the unix user sys, and map the rest to guest\&. Note the use of the \'!\' to tell Samba to stop processing if it gets a match on that line:
     10029The following example would map mary and fred to the unix user sys, and map the rest to guest\&. Note the use of the \*(Aq!\*(Aq to tell Samba to stop processing if it gets a match on that line:
    1002110030.sp
    1002210031.if n \{\
     
    1004210051(if you have one)\&. The password server will receive whatever username the client supplies without modification\&.
    1004310052.sp
    10044 Also note that no reverse mapping is done\&. The main effect this has is with printing\&. Users who have been mapped may have trouble deleting print jobs as PrintManager under WfWg will think they don\'t own the print job\&.
     10053Also note that no reverse mapping is done\&. The main effect this has is with printing\&. Users who have been mapped may have trouble deleting print jobs as PrintManager under WfWg will think they don\*(Aqt own the print job\&.
    1004510054.sp
    1004610055Samba versions prior to 3\&.0\&.8 would only support reading the fully qualified username (e\&.g\&.:
     
    1010810117parameter\&.
    1010910118.sp
    10110 If any of the usernames begin with a \'@\' then the name will be looked up first in the NIS netgroups list (if Samba is compiled with netgroup support), followed by a lookup in the UNIX groups database and will expand to a list of all users in the group of that name\&.
    10111 .sp
    10112 If any of the usernames begin with a \'+\' then the name will be looked up only in the UNIX groups database and will expand to a list of all users in the group of that name\&.
    10113 .sp
    10114 If any of the usernames begin with a \'&\' then the name will be looked up only in the NIS netgroups database (if Samba is compiled with netgroup support) and will expand to a list of all users in the netgroup group of that name\&.
     10119If any of the usernames begin with a \*(Aq@\*(Aq then the name will be looked up first in the NIS netgroups list (if Samba is compiled with netgroup support), followed by a lookup in the UNIX groups database and will expand to a list of all users in the group of that name\&.
     10120.sp
     10121If any of the usernames begin with a \*(Aq+\*(Aq then the name will be looked up only in the UNIX groups database and will expand to a list of all users in the group of that name\&.
     10122.sp
     10123If any of the usernames begin with a \*(Aq&\*(Aq then the name will be looked up only in the NIS netgroups database (if Samba is compiled with netgroup support) and will expand to a list of all users in the netgroup group of that name\&.
    1011510124.sp
    1011610125Note that searching though a groups database can take quite some time, and some clients may time out during the search\&.
     
    1019110200.PP
    1019210201.RS 4
    10193 This parameter specifies a list of absolute pathnames the root of which are allowed to be exported by user defined share definitions\&. If the pathname to be exported doesn\'t start with one of the strings in this list, the user defined share will not be allowed\&. This allows the Samba administrator to restrict the directories on the system that can be exported by user defined shares\&.
     10202This parameter specifies a list of absolute pathnames the root of which are allowed to be exported by user defined share definitions\&. If the pathname to be exported doesn\*(Aqt start with one of the strings in this list, the user defined share will not be allowed\&. This allows the Samba administrator to restrict the directories on the system that can be exported by user defined shares\&.
    1019410203.sp
    1019510204If there is a "usershare prefix deny list" and also a "usershare prefix allow list" the deny list is processed first, followed by the allow list, thus leading to the most restrictive interpretation\&.
     
    1023910248\fByes\fR, and the
    1024010249\fBsendfile()\fR
    10241 system call is supported by the underlying operating system, then some SMB read calls (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that are exclusively oplocked\&. This may make more efficient use of the system CPU\'s and cause Samba to be faster\&. Samba automatically turns this off for clients that use protocol levels lower than NT LM 0\&.12 and when it detects a client is Windows 9x (using sendfile from Linux will cause these clients to fail)\&.
     10250system call is supported by the underlying operating system, then some SMB read calls (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that are exclusively oplocked\&. This may make more efficient use of the system CPU\*(Aqs and cause Samba to be faster\&. Samba automatically turns this off for clients that use protocol levels lower than NT LM 0\&.12 and when it detects a client is Windows 9x (using sendfile from Linux will cause these clients to fail)\&.
    1024210251.sp
    1024310252Default:
     
    1029210301.PP
    1029310302.RS 4
    10294 This is a list of users that should be allowed to login to this service\&. Names starting with \'@\', \'+\' and \'&\' are interpreted using the same rules as described in the
     10303This is a list of users that should be allowed to login to this service\&. Names starting with \*(Aq@\*(Aq, \*(Aq+\*(Aq and \*(Aq&\*(Aq are interpreted using the same rules as described in the
    1029510304\fIinvalid users\fR
    1029610305parameter\&.
     
    1032610335.PP
    1032710336.RS 4
    10328 This is a list of files and directories that are neither visible nor accessible\&. Each entry in the list must be separated by a \'/\', which allows spaces to be included in the entry\&. \'*\' and \'?\' can be used to specify multiple files or directories as in DOS wildcards\&.
     10337This is a list of files and directories that are neither visible nor accessible\&. Each entry in the list must be separated by a \*(Aq/\*(Aq, which allows spaces to be included in the entry\&. \*(Aq*\*(Aq and \*(Aq?\*(Aq can be used to specify multiple files or directories as in DOS wildcards\&.
    1032910338.sp
    1033010339Each entry must be a unix path, not a DOS path and must
    1033110340\fInot\fR
    10332 include the unix directory separator \'/\'\&.
     10341include the unix directory separator \*(Aq/\*(Aq\&.
    1033310342.sp
    1033410343Note that the
     
    1033610345option is applicable in vetoing files\&.
    1033710346.sp
    10338 One feature of the veto files parameter that it is important to be aware of is Samba\'s behaviour when trying to delete a directory\&. If a directory that is to be deleted contains nothing but veto files this deletion will
     10347One feature of the veto files parameter that it is important to be aware of is Samba\*(Aqs behaviour when trying to delete a directory\&. If a directory that is to be deleted contains nothing but veto files this deletion will
    1033910348\fIfail\fR
    1034010349unless you also set the
     
    1058410593.PP
    1058510594.RS 4
    10586 If set to yes, this parameter activates the support for nested groups\&. Nested groups are also called local groups or aliases\&. They work like their counterparts in Windows: Nested groups are defined locally on any machine (they are shared between DC\'s through their SAM) and can contain users and global groups from any trusted SAM\&. To be able to use nested groups, you need to run nss_winbind\&.
     10595If set to yes, this parameter activates the support for nested groups\&. Nested groups are also called local groups or aliases\&. They work like their counterparts in Windows: Nested groups are defined locally on any machine (they are shared between DC\*(Aqs through their SAM) and can contain users and global groups from any trusted SAM\&. To be able to use nested groups, you need to run nss_winbind\&.
    1058710596.sp
    1058810597Default:
     
    1060910618.PP
    1061010619.RS 4
    10611 This parameter is designed to control how Winbind retrieves Name Service Information to construct a user\'s home directory and login shell\&. Currently the following settings are available:
     10620This parameter is designed to control how Winbind retrieves Name Service Information to construct a user\*(Aqs home directory and login shell\&. Currently the following settings are available:
    1061210621.sp
    1061310622.RS 4
     
    1071710726.sp
    1071810727Default:
    10719 \fI\fIwinbind separator\fR\fR\fI = \fR\fI\'\e\'\fR\fI \fR
     10728\fI\fIwinbind separator\fR\fR\fI = \fR\fI\*(Aq\e\*(Aq\fR\fI \fR
    1072010729.sp
    1072110730Example:
     
    1072710736.PP
    1072810737.RS 4
    10729 This parameter is designed to allow Samba servers that are members of a Samba controlled domain to use UNIX accounts distributed via NIS, rsync, or LDAP as the uid\'s for winbindd users in the hosts primary domain\&. Therefore, the user
     10738This parameter is designed to allow Samba servers that are members of a Samba controlled domain to use UNIX accounts distributed via NIS, rsync, or LDAP as the uid\*(Aqs for winbindd users in the hosts primary domain\&. Therefore, the user
    1073010739DOMAIN\euser1
    1073110740would be mapped to the account user1 in /etc/passwd instead of allocating a new uid for him or her\&.
     
    1074510754This parameter specifies whether the
    1074610755\fBwinbindd\fR(8)
    10747 daemon should operate on users without domain component in their username\&. Users without a domain component are treated as is part of the winbindd server\'s own domain\&. While this does not benefit Windows users, it makes SSH, FTP and e\-mail function in a way much closer to the way they would in a native unix system\&.
     10756daemon should operate on users without domain component in their username\&. Users without a domain component are treated as is part of the winbindd server\*(Aqs own domain\&. While this does not benefit Windows users, it makes SSH, FTP and e\-mail function in a way much closer to the way they would in a native unix system\&.
    1074810757.sp
    1074910758This option should be avoided if possible\&. It can cause confusion about responsibilities for a user or group\&. In many situations it is not clear whether winbind or /etc/passwd should be seen as authoritative for a user, likewise for groups\&.
     
    1084910858This specifies the IP address (or DNS name: IP address for preference) of the WINS server that
    1085010859\fBnmbd\fR(8)
    10851 should register with\&. If you have a WINS server on your network then you should set this to the WINS server\'s IP\&.
     10860should register with\&. If you have a WINS server on your network then you should set this to the WINS server\*(Aqs IP\&.
    1085210861.sp
    1085310862You should point this at your WINS server if you have a multi\-subnetted network\&.
    1085410863.sp
    10855 If you want to work in multiple namespaces, you can give every wins server a \'tag\'\&. For each tag, only one (working) server will be queried for a name\&. The tag should be separated from the ip address by a colon\&.
     10864If you want to work in multiple namespaces, you can give every wins server a \*(Aqtag\*(Aq\&. For each tag, only one (working) server will be queried for a name\&. The tag should be separated from the ip address by a colon\&.
    1085610865.if n \{\
    1085710866.sp
     
    1087510884.sp
    1087610885Example:
    10877 \fI\fIwins server\fR\fR\fI = \fR\fImary:192\&.9\&.200\&.1 fred:192\&.168\&.3\&.199 mary:192\&.168\&.2\&.61 # For this example when querying a certain name, 192\&.19\&.200\&.1 will be asked first and if that doesn\'t respond 192\&.168\&.2\&.61\&. If either of those doesn\'t know the name 192\&.168\&.3\&.199 will be queried\&.\fR\fI \fR
     10886\fI\fIwins server\fR\fR\fI = \fR\fImary:192\&.9\&.200\&.1 fred:192\&.168\&.3\&.199 mary:192\&.168\&.2\&.61 # For this example when querying a certain name, 192\&.19\&.200\&.1 will be asked first and if that doesn\*(Aqt respond 192\&.168\&.2\&.61\&. If either of those doesn\*(Aqt know the name 192\&.168\&.3\&.199 will be queried\&.\fR\fI \fR
    1087810887.sp
    1087910888Example:
     
    1097910988.PP
    1098010989.RS 4
    10981 This parameter controls whether or not the server will support raw write SMB\'s when transferring data from clients\&. You should never need to change this parameter\&.
     10990This parameter controls whether or not the server will support raw write SMB\*(Aqs when transferring data from clients\&. You should never need to change this parameter\&.
    1098210991.sp
    1098310992Default:
     
    1100411013.SH "WARNINGS"
    1100511014.PP
    11006 Although the configuration file permits service names to contain spaces, your client software may not\&. Spaces will be ignored in comparisons anyway, so it shouldn\'t be a problem \- but be aware of the possibility\&.
     11015Although the configuration file permits service names to contain spaces, your client software may not\&. Spaces will be ignored in comparisons anyway, so it shouldn\*(Aqt be a problem \- but be aware of the possibility\&.
    1100711016.PP
    1100811017On a similar note, many clients \- especially DOS clients \- limit service names to eight characters\&.
  • vendor/current/docs/manpages/smbcacls.1

    r746 r860  
    22.\"     Title: smbcacls
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBCACLS" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SMBCACLS" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    91100\-t|\-\-test\-args
    92101.RS 4
    93 Don\'t actually do anything, only validate the correctness of the arguments\&.
     102Don\*(Aqt actually do anything, only validate the correctness of the arguments\&.
    94103.RE
    95104.PP
     
    109118.sp
    110119Note that specifying this parameter here will override the
    111 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     120\m[blue]\fBlog level\fR\m[]
    112121parameter in the
    113122smb\&.conf
     
    355364.\}
    356365\fIREAD\fR
    357 \- Equivalent to \'RX\' permissions
     366\- Equivalent to \*(AqRX\*(Aq permissions
    358367.RE
    359368.sp
     
    367376.\}
    368377\fICHANGE\fR
    369 \- Equivalent to \'RXWD\' permissions
     378\- Equivalent to \*(AqRXWD\*(Aq permissions
    370379.RE
    371380.sp
     
    379388.\}
    380389\fIFULL\fR
    381 \- Equivalent to \'RWXDPO\' permissions
     390\- Equivalent to \*(AqRWXDPO\*(Aq permissions
    382391.RE
    383392.SH "EXIT STATUS"
     
    389398If the operation succeeded, smbcacls returns and exit status of 0\&. If
    390399smbcacls
    391 couldn\'t connect to the specified server, or there was an error getting or setting the ACLs, an exit status of 1 is returned\&. If there was an error parsing any command line arguments, an exit status of 2 is returned\&.
     400couldn\*(Aqt connect to the specified server, or there was an error getting or setting the ACLs, an exit status of 1 is returned\&. If there was an error parsing any command line arguments, an exit status of 2 is returned\&.
    392401.SH "VERSION"
    393402.PP
  • vendor/current/docs/manpages/smbclient.1

    r746 r860  
    22.\"     Title: smbclient
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBCLIENT" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SMBCLIENT" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3342.PP
    3443smbclient
    35 is a client that can \'talk\' to an SMB/CIFS server\&. It offers an interface similar to that of the ftp program (see
     44is a client that can \*(Aqtalk\*(Aq to an SMB/CIFS server\&. It offers an interface similar to that of the ftp program (see
    3645\fBftp\fR(1))\&. Operations include things like getting files from the server to the local machine, putting files from the local machine to the server, retrieving directory information from the server and so on\&.
    3746.SH "OPTIONS"
     
    218227This parameter causes the client to write messages to the standard error stream (stderr) rather than to the standard output stream\&.
    219228.sp
    220 By default, the client writes messages to standard output \- typically the user\'s tty\&.
     229By default, the client writes messages to standard output \- typically the user\*(Aqs tty\&.
    221230.RE
    222231.PP
     
    227236and a list should appear\&. The
    228237\fI\-I \fR
    229 option may be useful if your NetBIOS names don\'t match your TCP/IP DNS host names or if you are trying to reach a host on another network\&.
     238option may be useful if your NetBIOS names don\*(Aqt match your TCP/IP DNS host names or if you are trying to reach a host on another network\&.
    230239.RE
    231240.PP
     
    250259.sp
    251260Note that specifying this parameter here will override the
    252 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     261\m[blue]\fBlog level\fR\m[]
    253262parameter in the
    254263smb\&.conf
     
    339348.RS 4
    340349This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the
    341 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     350\m[blue]\fBnetbios name\fR\m[]
    342351parameter in the
    343352smb\&.conf
     
    492501.\}
    493502\fIr\fR
    494 \- Regular expression include or exclude\&. Uses regular expression matching for excluding or excluding files if compiled with HAVE_REGEX_H\&. However this mode can be very slow\&. If not compiled with HAVE_REGEX_H, does a limited wildcard match on \'*\' and \'?\'\&.
     503\- Regular expression include or exclude\&. Uses regular expression matching for excluding or excluding files if compiled with HAVE_REGEX_H\&. However this mode can be very slow\&. If not compiled with HAVE_REGEX_H, does a limited wildcard match on \*(Aq*\*(Aq and \*(Aq?\*(Aq\&.
    495504.RE
    496505.sp
     
    528537\fITar Long File Names\fR
    529538.sp
    530 smbclient\'s tar option now supports long file names both on backup and restore\&. However, the full path name of the file must be less than 1024 bytes\&. Also, when a tar archive is created,
    531 smbclient\'s tar option places all files in the archive with relative names, not absolute names\&.
     539smbclient\*(Aqs tar option now supports long file names both on backup and restore\&. However, the full path name of the file must be less than 1024 bytes\&. Also, when a tar archive is created,
     540smbclient\*(Aqs tar option places all files in the archive with relative names, not absolute names\&.
    532541.sp
    533542\fITar Filenames\fR
    534543.sp
    535 All file names can be given as DOS path names (with \'\e\e\' as the component separator) or as UNIX path names (with \'/\' as the component separator)\&.
     544All file names can be given as DOS path names (with \*(Aq\e\e\*(Aq as the component separator) or as UNIX path names (with \*(Aq/\*(Aq as the component separator)\&.
    536545.sp
    537546\fIExamples\fR
     
    580589.sp
    581590This is particularly useful in scripts and for printing stdin to the server, e\&.g\&.
    582 \-c \'print \-\'\&.
     591\-c \*(Aqprint \-\*(Aq\&.
    583592.RE
    584593.SH "OPERATIONS"
     
    963972tarmode <full|inc|reset|noreset>
    964973.RS 4
    965 Changes tar\'s behavior with regard to archive bits\&. In full mode, tar will back up everything regardless of the archive bit setting (this is the default mode)\&. In incremental mode, tar will only back up files with the archive bit set\&. In reset mode, tar will reset the archive bit on all files it backs up (implies read/write share)\&.
     974Changes tar\*(Aqs behavior with regard to archive bits\&. In full mode, tar will back up everything regardless of the archive bit setting (this is the default mode)\&. In incremental mode, tar will only back up files with the archive bit set\&. In reset mode, tar will reset the archive bit on all files it backs up (implies read/write share)\&.
    966975.RE
    967976.PP
  • vendor/current/docs/manpages/smbcontrol.1

    r746 r860  
    22.\"     Title: smbcontrol
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBCONTROL" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SMBCONTROL" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    106115close\-share
    107116.RS 4
    108 Order smbd to close the client connections to the named share\&. Note that this doesn\'t affect client connections to any other shares\&. This message\-type takes an argument of the share name for which client connections will be closed, or the "*" character which will close all currently open shares\&. This may be useful if you made changes to the access controls on the share\&. This message can only be sent to
     117Order smbd to close the client connections to the named share\&. Note that this doesn\*(Aqt affect client connections to any other shares\&. This message\-type takes an argument of the share name for which client connections will be closed, or the "*" character which will close all currently open shares\&. This may be useful if you made changes to the access controls on the share\&. This message can only be sent to
    109118\fBsmbd\fR\&.
    110119.RE
     
    171180.RE
    172181.sp
    173 Note that this message only sends notification that an event has occurred\&. It doesn\'t actually cause the event to happen\&.
     182Note that this message only sends notification that an event has occurred\&. It doesn\*(Aqt actually cause the event to happen\&.
    174183.sp
    175184This message can only be sent to
  • vendor/current/docs/manpages/smbcquotas.1

    r746 r860  
    22.\"     Title: smbcquotas
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBCQUOTAS" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SMBCQUOTAS" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    4150\-u user
    4251.RS 4
    43 Specifies the user of whom the quotas are get or set\&. By default the current user\'s username will be used\&.
     52Specifies the user of whom the quotas are get or set\&. By default the current user\*(Aqs username will be used\&.
    4453.RE
    4554.PP
     
    6675\-t
    6776.RS 4
    68 Don\'t actually do anything, only validate the correctness of the arguments\&.
     77Don\*(Aqt actually do anything, only validate the correctness of the arguments\&.
    6978.RE
    7079.PP
     
    8998.sp
    9099Note that specifying this parameter here will override the
    91 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     100\m[blue]\fBlog level\fR\m[]
    92101parameter in the
    93102smb\&.conf
     
    199208If the operation succeeded, smbcquotas returns an exit status of 0\&. If
    200209smbcquotas
    201 couldn\'t connect to the specified server, or when there was an error getting or setting the quota(s), an exit status of 1 is returned\&. If there was an error parsing any command line arguments, an exit status of 2 is returned\&.
     210couldn\*(Aqt connect to the specified server, or when there was an error getting or setting the quota(s), an exit status of 1 is returned\&. If there was an error parsing any command line arguments, an exit status of 2 is returned\&.
    202211.SH "VERSION"
    203212.PP
  • vendor/current/docs/manpages/smbd.8

    r746 r860  
    22.\"     Title: smbd
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBD" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "SMBD" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    6675and
    6776svscan
    68 from Daniel J\&. Bernstein\'s
     77from Daniel J\&. Bernstein\*(Aqs
    6978daemontools
    7079package, or the AIX process monitor\&.
     
    97106.sp
    98107Note that specifying this parameter here will override the
    99 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     108\m[blue]\fBlog level\fR\m[]
    100109parameter in the
    101110smb\&.conf
     
    222231.IP \(bu 2.3
    223232.\}
    224 \fISession Management\fR: When not using share level security, users must pass PAM\'s session checks before access is granted\&. Note however, that this is bypassed in share level security\&. Note also that some older pam configuration files may need a line added for session support\&.
     233\fISession Management\fR: When not using share level security, users must pass PAM\*(Aqs session checks before access is granted\&. Note however, that this is bypassed in share level security\&. Note also that some older pam configuration files may need a line added for session support\&.
    225234.RE
    226235.SH "VERSION"
     
    236245.SH "TDB FILES"
    237246.PP
    238 Samba stores it\'s data in several TDB (Trivial Database) files, usually located in
     247Samba stores it\*(Aqs data in several TDB (Trivial Database) files, usually located in
    239248/var/lib/samba\&.
    240249.PP
     
    318327sessionid\&.tdb
    319328.RS 4
    320 session information (e\&.g\&. support for \'utmp = yes\')
     329session information (e\&.g\&. support for \*(Aqutmp = yes\*(Aq)
    321330.RE
    322331.PP
     
    328337winbindd_cache\&.tdb
    329338.RS 4
    330 winbindd\'s cache of user lists, etc\&.\&.\&.
     339winbindd\*(Aqs cache of user lists, etc\&.\&.\&.
    331340.RE
    332341.PP
    333342winbindd_idmap\&.tdb*
    334343.RS 4
    335 winbindd\'s local idmap db
     344winbindd\*(Aqs local idmap db
    336345.RE
    337346.PP
    338347wins\&.dat*
    339348.RS 4
    340 wins database when \'wins support = yes\'
     349wins database when \*(Aqwins support = yes\*(Aq
    341350.RE
    342351.SH "SIGNALS"
     
    348357configuration file within a short period of time\&.
    349358.PP
    350 To shut down a user\'s
     359To shut down a user\*(Aqs
    351360smbd
    352361process it is recommended that
     
    375384\fBsmbclient\fR(1),
    376385\fBtestparm\fR(1),
    377 \fBtestprns\fR(1), and the Internet RFC\'s
     386\fBtestprns\fR(1), and the Internet RFC\*(Aqs
    378387rfc1001\&.txt,
    379388rfc1002\&.txt\&. In addition the CIFS (formerly SMB) specification is available as a link from the Web page
  • vendor/current/docs/manpages/smbget.1

    r746 r860  
    22.\"     Title: smbget
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBGET" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SMBGET" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    6877\-n, \-\-nonprompt
    6978.RS 4
    70 Don\'t ask anything (non\-interactive)
     79Don\*(Aqt ask anything (non\-interactive)
    7180.RE
    7281.PP
     
    127136.SH "SMB URLS"
    128137.PP
    129 SMB URL\'s should be specified in the following format:
     138SMB URL\*(Aqs should be specified in the following format:
    130139.PP
    131140.if n \{\
     
    164173.\}
    165174.nf
    166 # Recursively download \'src\' directory
     175# Recursively download \*(Aqsrc\*(Aq directory
    167176smbget \-R smb://rhonwyn/jelmer/src
    168177# Download FreeBSD ISO and enable resuming
  • vendor/current/docs/manpages/smbgetrc.5

    r746 r860  
    22.\"     Title: smbgetrc
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: File Formats and Conventions
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBGETRC" "5" "10/29/2012" "Samba 3\&.6" "File Formats and Conventions"
     10.TH "SMBGETRC" "5" "09/18/2013" "Samba 3\&.6" "File Formats and Conventions"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/smbpasswd.5

    r746 r860  
    22.\"     Title: smbpasswd
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: File Formats and Conventions
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBPASSWD" "5" "10/29/2012" "Samba 3\&.6" "File Formats and Conventions"
     10.TH "SMBPASSWD" "5" "09/18/2013" "Samba 3\&.6" "File Formats and Conventions"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3544The format of the smbpasswd file used by Samba 2\&.2 is very similar to the familiar Unix
    3645passwd(5)
    37 file\&. It is an ASCII file containing one line for each user\&. Each field ithin each line is separated from the next by a colon\&. Any entry beginning with \'#\' is ignored\&. The smbpasswd file contains the following information for each user:
     46file\&. It is an ASCII file containing one line for each user\&. Each field ithin each line is separated from the next by a colon\&. Any entry beginning with \*(Aq#\*(Aq is ignored\&. The smbpasswd file contains the following information for each user:
    3847.PP
    3948name
     
    4958Lanman Password Hash
    5059.RS 4
    51 This is the LANMAN hash of the user\'s password, encoded as 32 hex digits\&. The LANMAN hash is created by DES encrypting a well known string with the user\'s password as the DES key\&. This is the same password used by Windows 95/98 machines\&. Note that this password hash is regarded as weak as it is vulnerable to dictionary attacks and if two users choose the same password this entry will be identical (i\&.e\&. the password is not "salted" as the UNIX password is)\&. If the user has a null password this field will contain the characters "NO PASSWORD" as the start of the hex string\&. If the hex string is equal to 32 \'X\' characters then the user\'s account is marked as
     60This is the LANMAN hash of the user\*(Aqs password, encoded as 32 hex digits\&. The LANMAN hash is created by DES encrypting a well known string with the user\*(Aqs password as the DES key\&. This is the same password used by Windows 95/98 machines\&. Note that this password hash is regarded as weak as it is vulnerable to dictionary attacks and if two users choose the same password this entry will be identical (i\&.e\&. the password is not "salted" as the UNIX password is)\&. If the user has a null password this field will contain the characters "NO PASSWORD" as the start of the hex string\&. If the hex string is equal to 32 \*(AqX\*(Aq characters then the user\*(Aqs account is marked as
    5261\fBdisabled\fR
    5362and the user will not be able to log onto the Samba server\&.
     
    6372NT Password Hash
    6473.RS 4
    65 This is the Windows NT hash of the user\'s password, encoded as 32 hex digits\&. The Windows NT hash is created by taking the user\'s password as represented in 16\-bit, little\-endian UNICODE and then applying the MD4 (internet rfc1321) hashing algorithm to it\&.
     74This is the Windows NT hash of the user\*(Aqs password, encoded as 32 hex digits\&. The Windows NT hash is created by taking the user\*(Aqs password as represented in 16\-bit, little\-endian UNICODE and then applying the MD4 (internet rfc1321) hashing algorithm to it\&.
    6675.sp
    6776This password hash is considered more secure than the LANMAN Password Hash as it preserves the case of the password and uses a much higher quality hashing algorithm\&. However, it is still the case that if two users choose the same password this entry will be identical (i\&.e\&. the password is not "salted" as the UNIX password is)\&.
     
    7685Account Flags
    7786.RS 4
    78 This section contains flags that describe the attributes of the users account\&. This field is bracketed by \'[\' and \']\' characters and is always 13 characters in length (including the \'[\' and \']\' characters)\&. The contents of this field may be any of the following characters:
     87This section contains flags that describe the attributes of the users account\&. This field is bracketed by \*(Aq[\*(Aq and \*(Aq]\*(Aq characters and is always 13 characters in length (including the \*(Aq[\*(Aq and \*(Aq]\*(Aq characters)\&. The contents of this field may be any of the following characters:
    7988.sp
    8089.RS 4
     
    150159Last Change Time
    151160.RS 4
    152 This field consists of the time the account was last modified\&. It consists of the characters \'LCT\-\' (standing for "Last Change Time") followed by a numeric encoding of the UNIX time in seconds since the epoch (1970) that the last change was made\&.
     161This field consists of the time the account was last modified\&. It consists of the characters \*(AqLCT\-\*(Aq (standing for "Last Change Time") followed by a numeric encoding of the UNIX time in seconds since the epoch (1970) that the last change was made\&.
    153162.RE
    154163.PP
  • vendor/current/docs/manpages/smbpasswd.8

    r746 r860  
    22.\"     Title: smbpasswd
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBPASSWD" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "SMBPASSWD" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    2029.\" -----------------------------------------------------------------
    2130.SH "NAME"
    22 smbpasswd \- change a user\'s SMB password
     31smbpasswd \- change a user\*(Aqs SMB password
    2332.SH "SYNOPSIS"
    2433.HP \w'\ 'u
     
    3443user or not\&. When run as a normal user it allows the user to change the password used for their SMB sessions on any machines that store SMB passwords\&.
    3544.PP
    36 By default (when run with no arguments) it will attempt to change the current user\'s SMB password on the local machine\&. This is similar to the way the
     45By default (when run with no arguments) it will attempt to change the current user\*(Aqs SMB password on the local machine\&. This is similar to the way the
    3746passwd(1)
    3847program works\&.
     
    8392\fBdisabled\fR
    8493in the local smbpasswd file\&. This is done by writing a
    85 \fB\'D\'\fR
     94\fB\*(AqD\*(Aq\fR
    8695flag into the account control space in the smbpasswd file\&. Once this is done all attempts to authenticate via SMB using this username will fail\&.
    8796.sp
    88 If the smbpasswd file is in the \'old\' format (pre\-Samba 2\&.0 format) there is no space in the user\'s password entry to write this information and the command will FAIL\&. See
     97If the smbpasswd file is in the \*(Aqold\*(Aq format (pre\-Samba 2\&.0 format) there is no space in the user\*(Aqs password entry to write this information and the command will FAIL\&. See
    8998\fBsmbpasswd\fR(5)
    90 for details on the \'old\' and new password file formats\&.
     99for details on the \*(Aqold\*(Aq and new password file formats\&.
    91100.sp
    92101This option is only available when running smbpasswd as root\&.
     
    99108in the local smbpasswd file, if the account was previously disabled\&. If the account was not disabled this option has no effect\&. Once the account is enabled then the user will be able to authenticate via SMB once again\&.
    100109.sp
    101 If the smbpasswd file is in the \'old\' format, then
     110If the smbpasswd file is in the \*(Aqold\*(Aq format, then
    102111smbpasswd
    103112will FAIL to enable the account\&. See
    104113\fBsmbpasswd\fR(5)
    105 for details on the \'old\' and new password file formats\&.
     114for details on the \*(Aqold\*(Aq and new password file formats\&.
    106115.sp
    107116This option is only available when running smbpasswd as root\&.
     
    252261\m[blue]\fBldap admin dn\fR\m[]\&. Note that the password is stored in the
    253262secrets\&.tdb
    254 and is keyed off of the admin\'s DN\&. This means that if the value of
     263and is keyed off of the admin\*(Aqs DN\&. This means that if the value of
    255264\fIldap admin dn\fR
    256265ever changes, the password will need to be manually updated as well\&.
     
    267276\m[blue]\fBldap admin dn\fR\m[]\&. Note that the password is stored in the
    268277secrets\&.tdb
    269 and is keyed off of the admin\'s DN\&. This means that if the value of
     278and is keyed off of the admin\*(Aqs DN\&. This means that if the value of
    270279\fIldap admin dn\fR
    271280ever changes, the password will need to be manually updated as well\&.
  • vendor/current/docs/manpages/smbspool.8

    r746 r860  
    22.\"     Title: smbspool
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBSPOOL" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "SMBSPOOL" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    115124.IP \(bu 2.3
    116125.\}
    117 The user argument (argv[2]) contains the print user\'s name and is presently not used by smbspool\&.
     126The user argument (argv[2]) contains the print user\*(Aqs name and is presently not used by smbspool\&.
    118127.RE
    119128.sp
  • vendor/current/docs/manpages/smbstatus.1

    r746 r860  
    22.\"     Title: smbstatus
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBSTATUS" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SMBSTATUS" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    5463.sp
    5564Note that specifying this parameter here will override the
    56 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     65\m[blue]\fBlog level\fR\m[]
    5766parameter in the
    5867smb\&.conf
  • vendor/current/docs/manpages/smbta-util.8

    r746 r860  
    22.\"     Title: smbta-util
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBTA\-UTIL" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "SMBTA\-UTIL" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/smbtar.1

    r746 r860  
    22.\"     Title: smbtar
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBTAR" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SMBTAR" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    124133The
    125134smbtar
    126 script has different options from ordinary tar and from smbclient\'s tar command\&.
     135script has different options from ordinary tar and from smbclient\*(Aqs tar command\&.
    127136.SH "CAVEATS"
    128137.PP
  • vendor/current/docs/manpages/smbtree.1

    r746 r860  
    22.\"     Title: smbtree
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMBTREE" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "SMBTREE" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    5968.sp
    6069Note that specifying this parameter here will override the
    61 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     70\m[blue]\fBlog level\fR\m[]
    6271parameter in the
    6372smb\&.conf
  • vendor/current/docs/manpages/swat.8

    r746 r860  
    22.\"     Title: swat
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SWAT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "SWAT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    8392.sp
    8493Note that specifying this parameter here will override the
    85 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     94\m[blue]\fBlog level\fR\m[]
    8695parameter in the
    8796smb\&.conf
     
    175184file\&.
    176185.PP
    177 the choice of port number isn\'t really important except that it should be less than 1024 and not currently used (using a number above 1024 presents an obscure security hole depending on the implementation details of your
     186the choice of port number isn\*(Aqt really important except that it should be less than 1024 and not currently used (using a number above 1024 presents an obscure security hole depending on the implementation details of your
    178187inetd
    179188daemon)\&.
     
    229238options\&. If you have a carefully crafted
    230239smb\&.conf
    231 then back it up or don\'t use swat!
     240then back it up or don\*(Aqt use swat!
    232241.SH "VERSION"
    233242.PP
  • vendor/current/docs/manpages/tdbbackup.8

    r746 r860  
    22.\"     Title: tdbbackup
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "TDBBACKUP" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "TDBBACKUP" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/tdbdump.8

    r746 r860  
    22.\"     Title: tdbdump
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "TDBDUMP" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "TDBDUMP" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3140.PP
    3241tdbdump
    33 is a very simple utility that \'dumps\' the contents of a TDB (Trivial DataBase) file to standard output in a human\-readable format\&.
     42is a very simple utility that \*(Aqdumps\*(Aq the contents of a TDB (Trivial DataBase) file to standard output in a human\-readable format\&.
    3443.PP
    3544This tool can be used when debugging problems with TDB files\&. It is intended for those who are somewhat familiar with Samba internals\&.
  • vendor/current/docs/manpages/tdbtool.8

    r746 r860  
    22.\"     Title: tdbtool
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "TDBTOOL" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "TDBTOOL" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/testparm.1

    r746 r860  
    22.\"     Title: testparm
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "TESTPARM" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "TESTPARM" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_acl_tdb.8

    r746 r860  
    22.\"     Title: vfs_acl_tdb
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_ACL_TDB" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_ACL_TDB" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_acl_xattr.8

    r746 r860  
    22.\"     Title: vfs_acl_xattr
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_ACL_XATTR" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_ACL_XATTR" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_aio_fork.8

    r748 r860  
    22.\"     Title: vfs_aio_fork
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_AIO_FORK" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_AIO_FORK" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_aio_pthread.8

    r748 r860  
    22.\"     Title: vfs_aio_pthread
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_AIO_PTHREAD" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_AIO_PTHREAD" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_audit.8

    r746 r860  
    22.\"     Title: vfs_audit
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_AUDIT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_AUDIT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_cacheprime.8

    r746 r860  
    22.\"     Title: vfs_cacheprime
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_CACHEPRIME" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_CACHEPRIME" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_cap.8

    r746 r860  
    22.\"     Title: vfs_cap
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_CAP" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_CAP" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_catia.8

    r746 r860  
    22.\"     Title: vfs_catia
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_CATIA" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_CATIA" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3241The Catia CAD package commonly creates filenames that use characters that are illegal in CIFS filenames\&. The
    3342vfs_catia
    34 VFS module implements a fixed character mapping so that these files can be shared with CIFS clients\&.
     43VFS module implements a character mapping so that these files can be shared with CIFS clients\&.
    3544.PP
    3645This module is stackable\&.
     46.PP
     47Up to samba version 3\&.4\&.x a fixed character mapping was used\&. The invalid windows characters \e / : * ? " < > | and the blank character were mapped in a hardcoded way\&.
     48.PP
     49Starting with samba\-3\&.5\&.0 a more flexible mapping was introduced\&. The new parameter "catia:mappings" now specifies the mapping on a char by char basis using the notation: unix hex char 0x\&.\&. : windows hex char 0x\&.\&. Multiple character mappings are separated by a comma\&.
    3750.SH "EXAMPLES"
     51.PP
     52Samba versions up to 3\&.4\&.x:
    3853.PP
    3954Map Catia filenames on the [CAD] share:
     
    5065.RE
    5166.\}
     67.PP
     68Samba versions 3\&.5\&.0 and later:
     69.PP
     70Map Catia filenames on the [CAD] share:
     71.sp
     72.if n \{\
     73.RS 4
     74.\}
     75.nf
     76        \fI[CAD]\fR
     77        \m[blue]\fBpath = /data/cad\fR\m[]
     78        \m[blue]\fBvfs objects = catia\fR\m[]
     79        \m[blue]\fBcatia:mappings = 0x22:0xa8\fR\m[]
     80.fi
     81.if n \{\
     82.RE
     83.\}
     84.PP
     85To get the full formerly fixed mappings:
     86.sp
     87.if n \{\
     88.RS 4
     89.\}
     90.nf
     91        \fI[CAD]\fR
     92        \m[blue]\fBpath = /data/cad\fR\m[]
     93        \m[blue]\fBvfs objects = catia\fR\m[]
     94        \m[blue]\fBcatia:mappings = 0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6,0x20:0xb1\fR\m[]
     95.fi
     96.if n \{\
     97.RE
     98.\}
     99.PP
     100Unix filename to be translated (Note that the path delimiter "/" is not used here):
     101.PP
     102a\ea:a*a?a"a<a>a|a a
     103.PP
     104Resulting windows filename:
     105.PP
     106aÿa\(dia\(Csa\(r?a\(ada\(Foa\(Fca\(bba\(+-a
     107.PP
     108Note that the character mapping must work in BOTH directions (unix \-> windows and windows \-> unix) to get unique and existing file names!
     109.PP
     110A NOT working example:
     111.sp
     112.if n \{\
     113.RS 4
     114.\}
     115.nf
     116        \fI[CAD]\fR
     117        \m[blue]\fBpath = /data/cad\fR\m[]
     118        \m[blue]\fBvfs objects = catia\fR\m[]
     119        \m[blue]\fBcatia:mappings = 0x3a:0x5f\fR\m[]
     120.fi
     121.if n \{\
     122.RE
     123.\}
     124.PP
     125Here the colon ":" is mapped to the underscore "_"\&.
     126.PP
     127Assuming a unix filename "a:should_work", which is well translated to windows as "a_should_work"\&.
     128.PP
     129BUT the reverse mapping from windows "a_should_work" to unix will result in "a:should:work" \- something like "file not found" will be returned\&.
    52130.SH "VERSION"
    53131.PP
    54 This man page is correct for version 3\&.0\&.25 of the Samba suite\&.
     132This man page is correct for all versions up to 4\&.0\&.3 of the Samba suite\&.
    55133.SH "AUTHOR"
    56134.PP
    57135The 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\&.
     136.PP
     137New version written by Guenter Kukkukk kukks@samba\&.org
  • vendor/current/docs/manpages/vfs_commit.8

    r746 r860  
    22.\"     Title: vfs_commit
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_COMMIT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_COMMIT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_crossrename.8

    r746 r860  
    22.\"     Title: vfs_crossrename
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_CROSSRENAME" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_CROSSRENAME" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3241The
    3342vfs_crossrename
    34 VFS module allows server side rename operations even if source and target are on different physical devices\&. A "move" in Explorer is usually a rename operation if it is inside of a single share or device\&. Usually such a rename operation returns NT_STATUS_NOT_SAME_DEVICE and the client has to move the file by manual copy and delete operations\&. If the rename by copy is done by the server this can be much more efficient\&. vfs_crossrename tries to do this server\-side cross\-device rename operation\&. There are however limitations that this module currently does not solve:
     43VFS module allows server side rename operations even if source and target are on different physical devices\&. A "move" in Explorer is usually a rename operation if it is inside of a single share or device\&. Usually such a rename operation returns NT_STATUS_NOT_SAME_DEVICE and the client has to move the file by manual copy and delete operations\&. If the rename by copy is done by the server this can be much more efficient\&. vfs_crossrename tries to do this server\-side cross\-device rename operation\&.
     44.PP
     45There are however limitations that this module currently does not solve:
    3546.PP
    3647.RS 4
    37 
    38                 the ACLs of files are not preserved
    39                 .RE
     48.PP
     49The ACLs of files are not preserved,
     50.RE
    4051.PP
    4152.RS 4
    42 
    43                 meta data in EAs are not preserved
    44                 .RE
     53.PP
     54meta data in EAs are not preserved,
     55.RE
    4556.PP
    4657.RS 4
    47 
    48                 renames of whole subdirectories cannot be done recursively,
    49                 in that case we still return STATUS_NOT_SAME_DEVICE and
    50                 let the client decide what to do
    51                 .RE
     58.PP
     59renames of whole subdirectories cannot be done recursively, in that case we still return STATUS_NOT_SAME_DEVICE and let the client decide what to do,
     60.RE
    5261.PP
    5362.RS 4
    54 
    55                 rename operations of huge files can cause hangs on the
    56                 client because clients expect a rename operation to
    57                 return fast
    58                 .RE
     63.PP
     64rename operations of huge files can cause hangs on the client because clients expect a rename operation to return fast\&.
     65.RE
    5966.PP
    6067This module is stackable\&.
  • vendor/current/docs/manpages/vfs_default_quota.8

    r746 r860  
    22.\"     Title: vfs_default_quota
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_DEFAULT_QUOTA" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_DEFAULT_QUOTA" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_dirsort.8

    r746 r860  
    22.\"     Title: vfs_dirsort
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_DIRSORT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_DIRSORT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_extd_audit.8

    r746 r860  
    22.\"     Title: vfs_extd_audit
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_EXTD_AUDIT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_EXTD_AUDIT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_fake_perms.8

    r746 r860  
    22.\"     Title: vfs_fake_perms
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_FAKE_PERMS" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_FAKE_PERMS" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_fileid.8

    r746 r860  
    22.\"     Title: vfs_fileid
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_FILEID" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_FILEID" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_full_audit.8

    r746 r860  
    22.\"     Title: vfs_full_audit
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_FULL_AUDIT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_FULL_AUDIT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    325334.PP
    326335vfs_full_audit
    327 records operations in fixed format consisting of fields separated by \'|\' characters\&. The format is:
     336records operations in fixed format consisting of fields separated by \*(Aq|\*(Aq characters\&. The format is:
    328337.sp
    329338.if n \{\
  • vendor/current/docs/manpages/vfs_gpfs.8

    r746 r860  
    22.\"     Title: vfs_gpfs
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_GPFS" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_GPFS" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    212221gpfs_get_realfilename_path()\&. It seems that
    213222gpfs_get_realfilename_path()
    214 doesn\'t work on AIX\&.
     223doesn\*(Aqt work on AIX\&.
    215224.RE
    216225.sp
     
    220229gpfs:winattr = [ yes | no ]
    221230.RS 4
    222 Enable/Disable usage of the windows attributes in GPFS\&. GPFS is able to store windows file attributes e\&.g\&. HIDDEN, READONLY, SYSTEM and others natively\&. That means Samba doesn\'t need to map them to permission bits or extended attributes\&.
     231Enable/Disable usage of the windows attributes in GPFS\&. GPFS is able to store windows file attributes e\&.g\&. HIDDEN, READONLY, SYSTEM and others natively\&. That means Samba doesn\*(Aqt need to map them to permission bits or extended attributes\&.
    223232.sp
    224233.RS 4
     
    253262gpfs:merge_writeappend = [ yes | no ]
    254263.RS 4
    255 GPFS ACLs doesn\'t know about the \'APPEND\' right\&. This optionen lets Samba map the \'APPEND\' right to \'WRITE\'\&.
     264GPFS ACLs doesn\*(Aqt know about the \*(AqAPPEND\*(Aq right\&. This optionen lets Samba map the \*(AqAPPEND\*(Aq right to \*(AqWRITE\*(Aq\&.
    256265.sp
    257266.RS 4
     
    265274
    266275yes(default)
    267 \- map \'APPEND\' to \'WRITE\'\&.
     276\- map \*(AqAPPEND\*(Aq to \*(AqWRITE\*(Aq\&.
    268277.RE
    269278.sp
     
    278287
    279288no
    280 \- do not map \'APPEND\' to \'WRITE\'\&.
     289\- do not map \*(AqAPPEND\*(Aq to \*(AqWRITE\*(Aq\&.
    281290.RE
    282291.sp
     
    286295gpfs:refuse_dacl_protected = [ yes | no ]
    287296.RS 4
    288 As GPFS does not support the ACE4_FLAG_NO_PROPAGATE NFSv4 flag (which would be the mapping for the DESC_DACL_PROTECTED flag), the status of this flag is currently silently ignored by Samba\&. That means that if you deselect the "Allow inheritable permissions\&.\&.\&." checkbox in Windows\' ACL dialog and then apply the ACL, the flag will be back immediately\&.
     297As GPFS does not support the ACE4_FLAG_NO_PROPAGATE NFSv4 flag (which would be the mapping for the DESC_DACL_PROTECTED flag), the status of this flag is currently silently ignored by Samba\&. That means that if you deselect the "Allow inheritable permissions\&.\&.\&." checkbox in Windows\*(Aq ACL dialog and then apply the ACL, the flag will be back immediately\&.
    289298.sp
    290299To make sure that automatic migration with e\&.g\&. robocopy does not lead to ACLs silently (and unintentionally) changed, you can set
     
    393402.\}
    394403ignore
    395 \- don\'t include the second matching ACE
     404\- don\*(Aqt include the second matching ACE
    396405.RE
    397406.sp
  • vendor/current/docs/manpages/vfs_netatalk.8

    r746 r860  
    22.\"     Title: vfs_netatalk
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_NETATALK" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_NETATALK" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_notify_fam.8

    r746 r860  
    22.\"     Title: vfs_notify_fam
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_NOTIFY_FAM" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_NOTIFY_FAM" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_prealloc.8

    r746 r860  
    22.\"     Title: vfs_prealloc
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_PREALLOC" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_PREALLOC" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_preopen.8

    r746 r860  
    22.\"     Title: vfs_preopen
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_PREOPEN" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_PREOPEN" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3241This module assists applications that want to read numbered files in sequence with very strict latency requirements\&. One area where this happens in video streaming applications that want to read one file per frame\&.
    3342.PP
    34 When you use this module, a number of helper processes is started that speculatively open files and read a number of bytes to prime the file system cache, so that later on when the real application\'s request comes along, no disk access is necessary\&.
     43When you use this module, a number of helper processes is started that speculatively open files and read a number of bytes to prime the file system cache, so that later on when the real application\*(Aqs request comes along, no disk access is necessary\&.
    3544.PP
    3645This module is stackable\&.
  • vendor/current/docs/manpages/vfs_readahead.8

    r746 r860  
    22.\"     Title: vfs_readahead
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_READAHEAD" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_READAHEAD" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_readonly.8

    r746 r860  
    22.\"     Title: vfs_readonly
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_READONLY" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_READONLY" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_recycle.8

    r746 r860  
    22.\"     Title: vfs_recycle
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_RECYCLE" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_RECYCLE" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    7281recycle:touch = BOOL
    7382.RS 4
    74 Specifies whether a file\'s access date should be updated when the file is moved to the repository\&.
     83Specifies whether a file\*(Aqs access date should be updated when the file is moved to the repository\&.
    7584.RE
    7685.PP
    7786recycle:touch_mtime = BOOL
    7887.RS 4
    79 Specifies whether a file\'s last modified date should be updated when the file is moved to the repository\&.
     88Specifies whether a file\*(Aqs last modified date should be updated when the file is moved to the repository\&.
    8089.RE
    8190.PP
  • vendor/current/docs/manpages/vfs_scannedonly.8

    r746 r860  
    22.\"     Title: vfs_scannedonly
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_SCANNEDONLY" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_SCANNEDONLY" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3948file exists, and is newer than the pertinent file\&. If this is the case, the file is shown to the user\&. If this is not the case, the file is not returned in a directory listing (configurable), and cannot be opened (configurable)\&. The Samba vfs module will notify the daemon to scan this file\&.
    4049.PP
    41 So what happens for the user in the default configuration\&. The first time a directory is listed, it shows files as \'file is being scanned for viruses, but after the first time all files are shown\&. There is a utility scannedonly_prescan that can help you to prescan all directories\&. When new files are written the daemon is notified immediately after the file is complete\&.
     50So what happens for the user in the default configuration\&. The first time a directory is listed, it shows files as \*(Aqfile is being scanned for viruses, but after the first time all files are shown\&. There is a utility scannedonly_prescan that can help you to prescan all directories\&. When new files are written the daemon is notified immediately after the file is complete\&.
    4251.PP
    4352If a virus is found by the daemon, a file with a warning message is created in the directory of the user, a warning is sent to the logs, and the file is renamed to have prefix
     
    7584scannedonly:show_special_files = True
    7685.RS 4
    77 Whether sockets, devices and fifo\'s (all not scanned for viruses) should be visible to the user
     86Whether sockets, devices and fifo\*(Aqs (all not scanned for viruses) should be visible to the user
    7887.RE
    7988.PP
  • vendor/current/docs/manpages/vfs_shadow_copy.8

    r746 r860  
    22.\"     Title: vfs_shadow_copy
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_SHADOW_COPY" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_SHADOW_COPY" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_shadow_copy2.8

    r746 r860  
    22.\"     Title: vfs_shadow_copy2
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_SHADOW_COPY2" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_SHADOW_COPY2" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    4453.IP "  1." 4.2
    4554.\}
    46 You don\'t need to populate your shares with symlinks to the snapshots\&. This can be very important when you have thousands of shares, or use [homes]\&.
     55You don\*(Aqt need to populate your shares with symlinks to the snapshots\&. This can be very important when you have thousands of shares, or use [homes]\&.
    4756.RE
    4857.sp
     
    5564.IP "  2." 4.2
    5665.\}
    57 The inode number of the files is altered so it is different from the original\&. This allows the \'restore\' button to work without a sharing violation\&.
     66The inode number of the files is altered so it is different from the original\&. This allows the \*(Aqrestore\*(Aq button to work without a sharing violation\&.
    5867.RE
    5968.sp
     
    192201If you enable
    193202shadow:fixinodes
    194 then this module will modify the apparent inode number of files in the snapshot directories using a hash of the files path\&. This is needed for snapshot systems where the snapshots have the same device:inode number as the original files (such as happens with GPFS snapshots)\&. If you don\'t set this option then the \'restore\' button in the shadow copy UI will fail with a sharing violation\&.
     203then this module will modify the apparent inode number of files in the snapshot directories using a hash of the files path\&. This is needed for snapshot systems where the snapshots have the same device:inode number as the original files (such as happens with GPFS snapshots)\&. If you don\*(Aqt set this option then the \*(Aqrestore\*(Aq button in the shadow copy UI will fail with a sharing violation\&.
    195204.RE
    196205.SH "EXAMPLES"
  • vendor/current/docs/manpages/vfs_smb_traffic_analyzer.8

    r746 r860  
    22.\"     Title: smb_traffic_analyzer
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "SMB_TRAFFIC_ANALYZER" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "SMB_TRAFFIC_ANALYZER" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3241The
    3342vfs_smb_traffic_analyzer
    34 VFS module logs client file operations on a Samba server and sends this data over a socket to a helper program (in the following the "Receiver"), which feeds a SQL database\&. More information on the helper programs can be obtained from the homepage of the project at: http://holger123\&.wordpress\&.com/smb\-traffic\-analyzer/ Since the VFS module depends on a receiver that is doing something with the data, it is evolving in it\'s development\&. Therefore, the module works with different protocol versions, and the receiver has to be able to decode the protocol that is used\&. The protocol version 1 was introduced to Samba at September 25, 2008\&. It was a very simple protocol, supporting only a small list of VFS operations, and had several drawbacks\&. The protocol version 2 is a try to solve the problems version 1 had while at the same time adding new features\&. With the release of Samba 3\&.6\&.0, the module will run protocol version 2 by default\&.
     43VFS module logs client file operations on a Samba server and sends this data over a socket to a helper program (in the following the "Receiver"), which feeds a SQL database\&. More information on the helper programs can be obtained from the homepage of the project at: http://holger123\&.wordpress\&.com/smb\-traffic\-analyzer/ Since the VFS module depends on a receiver that is doing something with the data, it is evolving in it\*(Aqs development\&. Therefore, the module works with different protocol versions, and the receiver has to be able to decode the protocol that is used\&. The protocol version 1 was introduced to Samba at September 25, 2008\&. It was a very simple protocol, supporting only a small list of VFS operations, and had several drawbacks\&. The protocol version 2 is a try to solve the problems version 1 had while at the same time adding new features\&. With the release of Samba 3\&.6\&.0, the module will run protocol version 2 by default\&.
    3544.SH "PROTOCOL VERSION 1 DOCUMENTATION"
    3645.PP
     
    192201
    193202Insecure network transfer \-
    194 Protocol version 1 sends all it\'s data as plaintext over the network\&.
     203Protocol version 1 sends all it\*(Aqs data as plaintext over the network\&.
    195204.RE
    196205.sp
     
    218227
    219228No subreleases of the protocol \-
    220 Protocol version 1 is fixed on it\'s version, making it unable to introduce new features or bugfixes through compatible sub\-releases\&.
     229Protocol version 1 is fixed on it\*(Aqs version, making it unable to introduce new features or bugfixes through compatible sub\-releases\&.
    221230.RE
    222231.SH "VERSION 2 OF THE PROTOCOL"
     
    295304smb_traffic_analyzer:total_anonymization = STRING
    296305.RS 4
    297 If STRING matches to \'yes\', the module will replace any user name with the string given by the option smb_traffic_analyzer:anonymize_prefix, without generating an additional hash number\&. This means that any transfer data will be mapped to a single user, leading to a total anonymization of user related data\&. In version 2\&.x of the protocol, the users SID will also be anonymized\&.
     306If STRING matches to \*(Aqyes\*(Aq, the module will replace any user name with the string given by the option smb_traffic_analyzer:anonymize_prefix, without generating an additional hash number\&. This means that any transfer data will be mapped to a single user, leading to a total anonymization of user related data\&. In version 2\&.x of the protocol, the users SID will also be anonymized\&.
    298307.RE
    299308.PP
  • vendor/current/docs/manpages/vfs_streams_depot.8

    r746 r860  
    22.\"     Title: vfs_streams_depot
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_STREAMS_DEPOT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_STREAMS_DEPOT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_streams_xattr.8

    r746 r860  
    22.\"     Title: vfs_streams_xattr
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_STREAMS_XATTR" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_STREAMS_XATTR" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfs_time_audit.8

    r746 r860  
    22.\"     Title: vfs_time_audit
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_TIME_AUDIT" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_TIME_AUDIT" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    3544time_audit:audit_timeout\&. It will log the calls and the time spent in it\&.
    3645.PP
    37 It\'s kind of comparable with
     46It\*(Aqs kind of comparable with
    3847strace \-T
    3948and is helpful to reveal performance problems with the underlying file and storage subsystems\&.
  • vendor/current/docs/manpages/vfs_xattr_tdb.8

    r746 r860  
    22.\"     Title: vfs_xattr_tdb
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFS_XATTR_TDB" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "VFS_XATTR_TDB" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/vfstest.1

    r746 r860  
    22.\"     Title: vfstest
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "VFSTEST" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "VFSTEST" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    4756.RS 4
    4857File name for log/debug files\&. The extension
    49 \fB\'\&.client\'\fR
     58\fB\*(Aq\&.client\*(Aq\fR
    5059will be appended\&. The log file is never removed by the client\&.
    5160.RE
     
    6170.sp
    6271Note that specifying this parameter here will override the
    63 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     72\m[blue]\fBlog level\fR\m[]
    6473parameter in the
    6574smb\&.conf
  • vendor/current/docs/manpages/wbinfo.1

    r746 r860  
    22.\"     Title: wbinfo
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: User Commands
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "WBINFO" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
     10.TH "WBINFO" "1" "09/18/2013" "Samba 3\&.6" "User Commands"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    99108\-\-domain \fIname\fR
    100109.RS 4
    101 This parameter sets the domain on which any specified operations will performed\&. If special domain name \'\&.\' is used to represent the current domain to which
     110This parameter sets the domain on which any specified operations will performed\&. If special domain name \*(Aq\&.\*(Aq is used to represent the current domain to which
    102111\fBwinbindd\fR(8)
    103112belongs\&. Currently only the
     
    233242Check whether
    234243\fBwinbindd\fR(8)
    235 is still alive\&. Prints out either \'succeeded\' or \'failed\'\&.
     244is still alive\&. Prints out either \*(Aqsucceeded\*(Aq or \*(Aqfailed\*(Aq\&.
    236245.RE
    237246.PP
  • vendor/current/docs/manpages/winbind_krb5_locator.7

    r746 r860  
    22.\"     Title: winbind_krb5_locator
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: 7
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "WINBIND_KRB5_LOCATOR" "7" "10/29/2012" "Samba 3\&.6" "7"
     10.TH "WINBIND_KRB5_LOCATOR" "7" "09/18/2013" "Samba 3\&.6" "7"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
  • vendor/current/docs/manpages/winbindd.8

    r746 r860  
    22.\"     Title: winbindd
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
    5 .\"      Date: 10/29/2012
     4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
     5.\"      Date: 09/18/2013
    66.\"    Manual: System Administration tools
    77.\"    Source: Samba 3.6
    88.\"  Language: English
    99.\"
    10 .TH "WINBINDD" "8" "10/29/2012" "Samba 3\&.6" "System Administration tools"
     10.TH "WINBINDD" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     11.\" -----------------------------------------------------------------
     12.\" * Define some portability stuff
     13.\" -----------------------------------------------------------------
     14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     15.\" http://bugs.debian.org/507673
     16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
     17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     18.ie \n(.g .ds Aq \(aq
     19.el       .ds Aq '
    1120.\" -----------------------------------------------------------------
    1221.\" * set default formatting
     
    4251PAM module, by managing connections to domain controllers\&. In this configuration the
    4352\m[blue]\fBidmap config * : range\fR\m[]
    44 parameter is not required\&. (This is known as `netlogon proxy only mode\'\&.)
     53parameter is not required\&. (This is known as `netlogon proxy only mode\*(Aq\&.)
    4554.PP
    4655The Name Service Switch allows user and system information to be obtained from different databases services such as NIS or DNS\&. The exact behaviour can be configured through the
     
    5059The service provided by
    5160winbindd
    52 is called `winbind\' and can be used to resolve user and group information from a Windows NT server\&. The service can also provide authentication services via an associated PAM module\&.
     61is called `winbind\*(Aq and can be used to resolve user and group information from a Windows NT server\&. The service can also provide authentication services via an associated PAM module\&.
    5362.PP
    5463The
     
    152161and
    153162svscan
    154 from Daniel J\&. Bernstein\'s
     163from Daniel J\&. Bernstein\*(Aqs
    155164daemontools
    156165package, or the AIX process monitor\&.
     
    174183.sp
    175184Note that specifying this parameter here will override the
    176 \m[blue]\fB\%smb.conf.5.html#\fR\m[]
     185\m[blue]\fBlog level\fR\m[]
    177186parameter in the
    178187smb\&.conf
     
    219228\-n
    220229.RS 4
    221 Disable caching\&. This means winbindd will always have to wait for a response from the domain controller before it can respond to a client and this thus makes things slower\&. The results will however be more accurate, since results from the cache might not be up\-to\-date\&. This might also temporarily hang winbindd if the DC doesn\'t respond\&.
     230Disable caching\&. This means winbindd will always have to wait for a response from the domain controller before it can respond to a client and this thus makes things slower\&. The results will however be more accurate, since results from the cache might not be up\-to\-date\&. This might also temporarily hang winbindd if the DC doesn\*(Aqt respond\&.
    222231.RE
    223232.SH "NAME AND ID RESOLUTION"
     
    533542$LOCKDIR/winbindd_privileged/pipe
    534543.RS 4
    535 The UNIX pipe over which \'privileged\' clients communicate with the
     544The UNIX pipe over which \*(Aqprivileged\*(Aq clients communicate with the
    536545winbindd
    537546program\&. For security reasons, access to some winbindd functions \- like those needed by the
    538547ntlm_auth
    539 utility \- is restricted\&. By default, only users in the \'root\' group will get this access, however the administrator may change the group permissions on $LOCKDIR/winbindd_privileged to allow programs like \'squid\' to use ntlm_auth\&. Note that the winbind client will only attempt to connect to the winbindd daemon if both the
     548utility \- is restricted\&. By default, only users in the \*(Aqroot\*(Aq group will get this access, however the administrator may change the group permissions on $LOCKDIR/winbindd_privileged to allow programs like \*(Aqsquid\*(Aq to use ntlm_auth\&. Note that the winbind client will only attempt to connect to the winbindd daemon if both the
    540549$LOCKDIR/winbindd_privileged
    541550directory and
Note: See TracChangeset for help on using the changeset viewer.