- Timestamp:
- Mar 1, 2010, 3:05:48 PM (15 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.3.x/docs/htmldocs/manpages/winbindd.8.html
r368 r411 1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>winbindd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.7 5.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="winbindd"><a name="winbindd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>winbindd — Name Service Switch daemon for resolving names2 from NT servers</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">winbindd</code> [-D] [-F] [-S] [-i] [-Y] [-d <debug level>] [-s <smb config file>] [-n]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489327"></a><h2>DESCRIPTION</h2><p>This program is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">winbindd</code> is a daemon that provides1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>winbindd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="winbindd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>winbindd — Name Service Switch daemon for resolving names 2 from NT servers</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">winbindd</code> [-D] [-F] [-S] [-i] [-Y] [-d <debug level>] [-s <smb config file>] [-n]</p></div></div><div class="refsect1" lang="en"><a name="id2483343"></a><h2>DESCRIPTION</h2><p>This program is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">winbindd</code> is a daemon that provides 3 3 a number of services to the Name Service Switch capability found 4 4 in most modern C libraries, to arbitrary applications via PAM … … 12 12 and system information to be obtained from different databases 13 13 services such as NIS or DNS. The exact behaviour can be configured 14 through tthe <code class="filename">/etc/nsswitch.conf</code> file.14 through the <code class="filename">/etc/nsswitch.conf</code> file. 15 15 Users and groups are allocated as they are resolved to a range 16 16 of user and group ids specified by the administrator of the … … 61 61 WINS server.</p><pre class="programlisting"> 62 62 hosts: files wins 63 </pre></div><div class="refsect1" title="OPTIONS"><a name="id2487531"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-F</span></dt><dd><p>If specified, this parameter causes63 </pre></div><div class="refsect1" lang="en"><a name="id2481550"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-F</span></dt><dd><p>If specified, this parameter causes 64 64 the main <code class="literal">winbindd</code> process to not daemonize, 65 65 i.e. double-fork and disassociate with the terminal. … … 114 114 default behavior is to launch a child process that is responsible for 115 115 updating expired cache entries. 116 </p></dd></dl></div></div><div class="refsect1" title="NAME AND ID RESOLUTION"><a name="id2487790"></a><h2>NAME AND ID RESOLUTION</h2><p>Users and groups on a Windows NT server are assigned116 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481809"></a><h2>NAME AND ID RESOLUTION</h2><p>Users and groups on a Windows NT server are assigned 117 117 a security id (SID) which is globally unique when the 118 118 user or group is created. To convert the Windows NT user or group … … 128 128 store is deleted or corrupted, there is no way for winbindd to 129 129 determine which user and group ids correspond to Windows NT user 130 and group rids. </p></div><div class="refsect1" title="CONFIGURATION"><a name="id2487828"></a><h2>CONFIGURATION</h2><p>Configuration of the <code class="literal">winbindd</code> daemon130 and group rids. </p></div><div class="refsect1" lang="en"><a name="id2481847"></a><h2>CONFIGURATION</h2><p>Configuration of the <code class="literal">winbindd</code> daemon 131 131 is done through configuration parameters in the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file. All parameters should be specified in the 132 [global] section of smb.conf. </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>133 <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR" target="_top">winbind separator</a></p></li><li class="listitem"><p>134 <a class="link" href="smb.conf.5.html#IDMAPUID" target="_top">idmap uid</a></p></li><li class="listitem"><p>135 <a class="link" href="smb.conf.5.html#IDMAPGID" target="_top">idmap gid</a></p></li><li class="listitem"><p>136 <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a></p></li><li class="listitem"><p>137 <a class="link" href="smb.conf.5.html#WINBINDCACHETIME" target="_top">winbind cache time</a></p></li><li class="listitem"><p>138 <a class="link" href="smb.conf.5.html#WINBINDENUMUSERS" target="_top">winbind enum users</a></p></li><li class="listitem"><p>139 <a class="link" href="smb.conf.5.html#WINBINDENUMGROUPS" target="_top">winbind enum groups</a></p></li><li class="listitem"><p>140 <a class="link" href="smb.conf.5.html#TEMPLATEHOMEDIR" target="_top">template homedir</a></p></li><li class="listitem"><p>141 <a class="link" href="smb.conf.5.html#TEMPLATESHELL" target="_top">template shell</a></p></li><li class="listitem"><p>142 <a class="link" href="smb.conf.5.html#WINBINDUSEDEFAULTDOMAIN" target="_top">winbind use default domain</a></p></li><li class="listitem"><p>132 [global] section of smb.conf. </p><div class="itemizedlist"><ul type="disc"><li><p> 133 <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR" target="_top">winbind separator</a></p></li><li><p> 134 <a class="link" href="smb.conf.5.html#IDMAPUID" target="_top">idmap uid</a></p></li><li><p> 135 <a class="link" href="smb.conf.5.html#IDMAPGID" target="_top">idmap gid</a></p></li><li><p> 136 <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a></p></li><li><p> 137 <a class="link" href="smb.conf.5.html#WINBINDCACHETIME" target="_top">winbind cache time</a></p></li><li><p> 138 <a class="link" href="smb.conf.5.html#WINBINDENUMUSERS" target="_top">winbind enum users</a></p></li><li><p> 139 <a class="link" href="smb.conf.5.html#WINBINDENUMGROUPS" target="_top">winbind enum groups</a></p></li><li><p> 140 <a class="link" href="smb.conf.5.html#TEMPLATEHOMEDIR" target="_top">template homedir</a></p></li><li><p> 141 <a class="link" href="smb.conf.5.html#TEMPLATESHELL" target="_top">template shell</a></p></li><li><p> 142 <a class="link" href="smb.conf.5.html#WINBINDUSEDEFAULTDOMAIN" target="_top">winbind use default domain</a></p></li><li><p> 143 143 <a class="link" href="smb.conf.5.html#WINBIND:RPCONLY" target="_top">winbind: rpc only</a> 144 144 Setting this parameter forces winbindd to use RPC 145 145 instead of LDAP to retrieve information from Domain 146 146 Controllers. 147 </p></li></ul></div></div><div class="refsect1" title="EXAMPLE SETUP"><a name="id2538487"></a><h2>EXAMPLE SETUP</h2><p>147 </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2532502"></a><h2>EXAMPLE SETUP</h2><p> 148 148 To setup winbindd for user and group lookups plus 149 149 authentication from a domain controller use something like the … … 164 164 use_first_pass shadow nullok 165 165 </pre><p> 166 </p><div class="note" title="Note"style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>166 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> 167 167 The PAM module pam_unix has recently replaced the module pam_pwdb. 168 168 Some Linux systems use the module pam_unix2 in place of pam_unix. … … 196 196 the DOMAIN+user syntax for the username. You may wish to use the 197 197 commands <code class="literal">getent passwd</code> and <code class="literal">getent group 198 </code> to confirm the correct operation of winbindd.</p></div><div class="refsect1" title="NOTES"><a name="id2538677"></a><h2>NOTES</h2><p>The following notes are useful when configuring and198 </code> to confirm the correct operation of winbindd.</p></div><div class="refsect1" lang="en"><a name="id2532693"></a><h2>NOTES</h2><p>The following notes are useful when configuring and 199 199 running <code class="literal">winbindd</code>: </p><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> must be running on the local machine 200 200 for <code class="literal">winbindd</code> to work. </p><p>PAM is really easy to misconfigure. Make sure you know what … … 204 204 be the same. The user and group ids will only be valid for the local 205 205 machine, unless a shared <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a> is configured.</p><p>If the the Windows NT SID to UNIX user and group id mapping 206 file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" title="SIGNALS"><a name="id2538742"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the206 file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" lang="en"><a name="id2532758"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the 207 207 <code class="literal">winbindd</code> daemon. </p><div class="variablelist"><dl><dt><span class="term">SIGHUP</span></dt><dd><p>Reload the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file and 208 208 apply any parameter changes to the running … … 212 212 winbindd</code> to write status information to the winbind 213 213 log file.</p><p>Log files are stored in the filename specified by the 214 log file parameter.</p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id2538805"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/nsswitch.conf(5)</code></span></dt><dd><p>Name service switch configuration file.</p></dd><dt><span class="term">/tmp/.winbindd/pipe</span></dt><dd><p>The UNIX pipe over which clients communicate with214 log file parameter.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2532821"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/nsswitch.conf(5)</code></span></dt><dd><p>Name service switch configuration file.</p></dd><dt><span class="term">/tmp/.winbindd/pipe</span></dt><dd><p>The UNIX pipe over which clients communicate with 215 215 the <code class="literal">winbindd</code> program. For security reasons, the 216 216 winbind client will only attempt to connect to the winbindd daemon … … 233 233 This directory is by default <code class="filename">/usr/local/samba/var/locks 234 234 </code>. </p></dd><dt><span class="term">$LOCKDIR/winbindd_cache.tdb</span></dt><dd><p>Storage for cached user and group information. 235 </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2538951"></a><h2>VERSION</h2><p>This man page is correct for version 3 of236 the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2538961"></a><h2>SEE ALSO</h2><p><code class="filename">nsswitch.conf(5)</code>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="wbinfo.1.html"><span class="citerefentry"><span class="refentrytitle">wbinfo</span>(1)</span></a>, <a class="citerefentry" href="ntlm_auth.8.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="pam_winbind.8.html"><span class="citerefentry"><span class="refentrytitle">pam_winbind</span>(8)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id2539017"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities235 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2532967"></a><h2>VERSION</h2><p>This man page is correct for version 3 of 236 the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2532978"></a><h2>SEE ALSO</h2><p><code class="filename">nsswitch.conf(5)</code>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="wbinfo.1.html"><span class="citerefentry"><span class="refentrytitle">wbinfo</span>(1)</span></a>, <a class="citerefentry" href="ntlm_auth.8.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="pam_winbind.8.html"><span class="citerefentry"><span class="refentrytitle">pam_winbind</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2533033"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities 237 237 were created by Andrew Tridgell. Samba is now developed 238 238 by the Samba Team as an Open Source project similar
Note:
See TracChangeset
for help on using the changeset viewer.
