diff options
-rw-r--r-- | docs/htmldocs/winbindd.8.html | 38 | ||||
-rw-r--r-- | docs/manpages/winbindd.8 | 43 | ||||
-rw-r--r-- | docs/yodldocs/winbindd.8.yo | 46 |
3 files changed, 97 insertions, 30 deletions
diff --git a/docs/htmldocs/winbindd.8.html b/docs/htmldocs/winbindd.8.html index 1e6b822d34..d0bdbbfccf 100644 --- a/docs/htmldocs/winbindd.8.html +++ b/docs/htmldocs/winbindd.8.html @@ -169,7 +169,7 @@ the shell for that user. <p>To setup winbindd for user and group lookups plus authentication from a domain controller use something like the following setup. This was tested on a RedHat 6.2 Linux box. -<p>In /etc/nsswitch.conf put the following: +<p>In <code>/etc/nsswitch.conf</code> put the following: <pre> passwd: files winbind @@ -177,7 +177,7 @@ tested on a RedHat 6.2 Linux box. </pre> -<p>In /etc/pam.d/* replace the auth lines with something like this: +<p>In <code>/etc/pam.d/*</code> replace the <code>auth</code> lines with something like this: <pre> auth required /lib/security/pam_securetty.so @@ -187,8 +187,8 @@ tested on a RedHat 6.2 Linux box. </pre> -<p>Note in particular the use of the sufficient keyword and the -use_first_pass keyword. +<p>Note in particular the use of the <code>sufficient</code> keyword and the +<code>use_first_pass</code> keyword. <p>Now replace the account lines with this: <pre> @@ -211,10 +211,10 @@ program like this: </pre> -<p>This assumes your domain is called DOMAIN and your Samba workstation -is called MACHINE. -<p>Next copy libnss_winbind.so.2 to /lib and pam_winbind.so to -/lib/security. +<p>This assumes your domain is called <code>DOMAIN</code> and your Samba workstation +is called <code>MACHINE</code>. +<p>Next copy <code>libnss_winbind.so.2</code> to <code>/lib</code> and <code>pam_winbind.so</code> to +<code>/lib/security</code>. <p>Finally, setup a smb.conf containing directives like the following: <pre> @@ -233,11 +233,29 @@ is called MACHINE. <p>Now start winbindd and you should find that your user and group database is expanded to include your NT users and groups, and that you -can login to your unix box as a domain user, using the DOMAIN+user +can login to your unix box as a domain user, using the <code>DOMAIN+user</code> syntax for the username. You may wish to use the commands "getent passwd" and "getent group" to confirm the correct operation of winbindd. -<p>NOTE: nmbd must be running on the local machine for winbindd to work. +<p>NOTE: <a href="nmbd.8.html"><strong>nmbd</strong></a> must be running on the local machine for +<a href="winbindd.8.html"><strong>winbindd</strong></a> to work. +<p><a name="SIGNALS"></a> +<h2>SIGNALS</h2> + +<p>The following signals can be used to manipulate the +<a href="winbindd.8.html"><strong>winbindd</strong></a> daemon. +<p><dl> +<p><p></p><dt><strong><code>SIGHUP</code></strong><dd> +<p>Reload the <code>smb.conf</code> file and apply any parameter changes to the running +version of <a href="winbindd.8.html"><strong>winbindd</strong></a>. This signal also clears any +cached user and group information. +<p><p></p><dt><strong><code>SIGUSR1</code></strong><dd> +<p>The <code>SIGUSR1</code> signal will cause <a href="winbindd.8.html"><strong>winbindd</strong></a> to +write status information to the winbind log file including information +about the number of user and group ids allocated by +<a href="winbindd.8.html"><strong>winbindd</strong></a>. +<p>Log files are stored in the filename specified by the <strong>log file</strong> parameter. +<p></dl> <p><a name="FILES"></a> <h2>FILES</h2> diff --git a/docs/manpages/winbindd.8 b/docs/manpages/winbindd.8 index e35fe0815b..a54f01f781 100644 --- a/docs/manpages/winbindd.8 +++ b/docs/manpages/winbindd.8 @@ -186,7 +186,7 @@ To setup winbindd for user and group lookups plus authentication from a domain controller use something like the following setup\&. This was tested on a RedHat 6\&.2 Linux box\&. .PP -In /etc/nsswitch\&.conf put the following: +In \f(CW/etc/nsswitch\&.conf\fP put the following: .nf @@ -198,7 +198,7 @@ In /etc/nsswitch\&.conf put the following: .PP -In /etc/pam\&.d/* replace the auth lines with something like this: +In \f(CW/etc/pam\&.d/*\fP replace the \f(CWauth\fP lines with something like this: .nf @@ -212,8 +212,8 @@ In /etc/pam\&.d/* replace the auth lines with something like this: .PP -Note in particular the use of the sufficient keyword and the -use_first_pass keyword\&. +Note in particular the use of the \f(CWsufficient\fP keyword and the +\f(CWuse_first_pass\fP keyword\&. .PP Now replace the account lines with this: @@ -249,11 +249,11 @@ Then within samedit run the command: .PP -This assumes your domain is called DOMAIN and your Samba workstation -is called MACHINE\&. +This assumes your domain is called \f(CWDOMAIN\fP and your Samba workstation +is called \f(CWMACHINE\fP\&. .PP -Next copy libnss_winbind\&.so\&.2 to /lib and pam_winbind\&.so to -/lib/security\&. +Next copy \f(CWlibnss_winbind\&.so\&.2\fP to \f(CW/lib\fP and \f(CWpam_winbind\&.so\fP to +\f(CW/lib/security\fP\&. .PP Finally, setup a smb\&.conf containing directives like the following: @@ -277,12 +277,35 @@ Finally, setup a smb\&.conf containing directives like the following: .PP Now start winbindd and you should find that your user and group database is expanded to include your NT users and groups, and that you -can login to your unix box as a domain user, using the DOMAIN+user +can login to your unix box as a domain user, using the \f(CWDOMAIN+user\fP syntax for the username\&. You may wish to use the commands "getent passwd" and "getent group" to confirm the correct operation of winbindd\&. .PP -NOTE: nmbd must be running on the local machine for winbindd to work\&. +NOTE: \fBnmbd\fP must be running on the local machine for +\fBwinbindd\fP to work\&. +.PP +.SH "SIGNALS" +.PP +The following signals can be used to manipulate the +\fBwinbindd\fP daemon\&. +.PP +.IP +.IP "\f(CWSIGHUP\fP" +.IP +Reload the \f(CWsmb\&.conf\fP file and apply any parameter changes to the running +version of \fBwinbindd\fP\&. This signal also clears any +cached user and group information\&. +.IP +.IP "\f(CWSIGUSR1\fP" +.IP +The \f(CWSIGUSR1\fP signal will cause \fBwinbindd\fP to +write status information to the winbind log file including information +about the number of user and group ids allocated by +\fBwinbindd\fP\&. +.IP +Log files are stored in the filename specified by the \fBlog file\fP parameter\&. +.IP .PP .SH "FILES" .PP diff --git a/docs/yodldocs/winbindd.8.yo b/docs/yodldocs/winbindd.8.yo index ce32565755..0e0477c84e 100644 --- a/docs/yodldocs/winbindd.8.yo +++ b/docs/yodldocs/winbindd.8.yo @@ -196,13 +196,13 @@ To setup winbindd for user and group lookups plus authentication from a domain controller use something like the following setup. This was tested on a RedHat 6.2 Linux box. -In /etc/nsswitch.conf put the following: +In tt(/etc/nsswitch.conf) put the following: verb( passwd: files winbind group: files winbind ) -In /etc/pam.d/* replace the auth lines with something like this: +In tt(/etc/pam.d/*) replace the tt(auth) lines with something like this: verb( auth required /lib/security/pam_securetty.so auth required /lib/security/pam_nologin.so @@ -210,8 +210,8 @@ verb( auth required /lib/security/pam_pwdb.so use_first_pass shadow nullok ) -Note in particular the use of the sufficient keyword and the -use_first_pass keyword. +Note in particular the use of the tt(sufficient) keyword and the +tt(use_first_pass) keyword. Now replace the account lines with this: verb( @@ -229,11 +229,11 @@ verb( createuser MACHINE$ -j DOMAIN -L ) -This assumes your domain is called DOMAIN and your Samba workstation -is called MACHINE. +This assumes your domain is called tt(DOMAIN) and your Samba workstation +is called tt(MACHINE). -Next copy libnss_winbind.so.2 to /lib and pam_winbind.so to -/lib/security. +Next copy tt(libnss_winbind.so.2) to tt(/lib) and tt(pam_winbind.so) to +tt(/lib/security). Finally, setup a smb.conf containing directives like the following: verb( @@ -251,12 +251,38 @@ verb( Now start winbindd and you should find that your user and group database is expanded to include your NT users and groups, and that you -can login to your unix box as a domain user, using the DOMAIN+user +can login to your unix box as a domain user, using the tt(DOMAIN+user) syntax for the username. You may wish to use the commands "getent passwd" and "getent group" to confirm the correct operation of winbindd. -NOTE: nmbd must be running on the local machine for winbindd to work. +NOTE: url(bf(nmbd))(nmbd.8.html) must be running on the local machine for +url(bf(winbindd))(winbindd.8.html) to work. + +label(SIGNALS) +manpagesection(SIGNALS) + +The following signals can be used to manipulate the +url(bf(winbindd))(winbindd.8.html) daemon. + +startdit() + +dit(tt(SIGHUP)) + +Reload the tt(smb.conf) file and apply any parameter changes to the running +version of url(bf(winbindd))(winbindd.8.html). This signal also clears any +cached user and group information. + +dit(tt(SIGUSR1)) + +The tt(SIGUSR1) signal will cause url(bf(winbindd))(winbindd.8.html) to +write status information to the winbind log file including information +about the number of user and group ids allocated by +url(bf(winbindd))(winbindd.8.html). + +Log files are stored in the filename specified by the bf(log file) parameter. + +enddit() label(FILES) manpagefiles() |