From 60785b56e8e637e75d5e94a0aec021ce40177834 Mon Sep 17 00:00:00 2001 From: Tim Potter Date: Tue, 13 Jun 2000 02:15:10 +0000 Subject: Created manpage for wbinfo program. Misc documentation updates for winbindd manpage. (This used to be commit 1f225fddd93d8569d9836310e2f0a56be7f4250e) --- docs/htmldocs/wbinfo.1.html | 110 +++++++++++++++++++++++++++++++++++++++ docs/htmldocs/winbindd.8.html | 90 +++++++++++++++++++------------- docs/manpages/wbinfo.1 | 101 ++++++++++++++++++++++++++++++++++++ docs/manpages/winbindd.8 | 88 +++++++++++++++++++------------ docs/yodldocs/wbinfo.1.yo | 118 ++++++++++++++++++++++++++++++++++++++++++ docs/yodldocs/winbindd.8.yo | 95 ++++++++++++++++++++++------------ 6 files changed, 501 insertions(+), 101 deletions(-) create mode 100644 docs/htmldocs/wbinfo.1.html create mode 100644 docs/manpages/wbinfo.1 create mode 100644 docs/yodldocs/wbinfo.1.yo diff --git a/docs/htmldocs/wbinfo.1.html b/docs/htmldocs/wbinfo.1.html new file mode 100644 index 0000000000..ba60d8f1e9 --- /dev/null +++ b/docs/htmldocs/wbinfo.1.html @@ -0,0 +1,110 @@ + + + + + +wbinfo (1) + + + + + +

+ +

wbinfo (1)

Samba

13 Jun 2000

+ + + +

NAME

+ wbinfo - Query information from winbind daemon +

SYNOPSIS

+ +

wbinfo -u [-g] [-n name] +[-s sid] [-U uid] [-G gid] +[-S sid] [-Y sid] +

DESCRIPTION

+ +

This program is part of the Samba suite version 3.0 and describes +functionality not yet implemented in the main version of Samba. +

The wbinfo program queries and returns information created and used by +the winbindd(8) daemon. +

The winbindd(8) daemon must be configured and +running for the wbinfo program to be able to return information. +

OPTIONS

+ +

The following options are available to the wbinfo program: +

-u

This option will list all users available in the Windows NT domain for +which the winbindd(8) daemon is operating in. +Users in all trusted domains will also be listed. Note that this operation +does not assign user ids to any users that have not already been seen by +winbindd(8). +

-g

This option will list all groups available in the Windows NT domain for +which the winbindd(8) daemon is operating in. +Groups in all trusted domains will also be listed. Note that this +operation does not assign group ids to any groups that have not already +been seen by winbindd(8). +

-n name

The -n option queries winbindd(8) for the SID +associated with the name specified. Domain names can be specified before +the user name by using the winbind separator character. For example +DOM1/Administrator refers to the Administrator user in the domain +DOM1. If no domain is specified then the domain used is the one +specified in the smb.conf workgroup parameter. +

-s sid

Use -s to resolve a SID to a name. This is the inverse of the -n +option above. SIDs must be specified as ASCII strings in the traditional +Microsoft format. For example +S-1-5-21-1455342024-3071081365-2475485837-500. +

-U uid

Try to convert a UNIX user id to a Windows NT SID. If the uid specified +does not refer to one within the winbind uid range then the operation +will fail. +

-G gid

Try to convert a UNIX group id to a Windows NT SID. If the gid specified +does not refer to one within the winbind gid range then the operation +will fail. +

-S sid

Convert a SID to a UNIX user id. If the SID does not correspond to a UNIX +user mapped by winbindd(8) then the operation +will fail. +

-Y sid

Convert a SID to a UNIX group id. If the SID does not correspond to a UNIX +group mapped by winbindd(8) then the operation +will fail. +

EXIT STATUS

+ +

The wbinfo program returns 0 if the operation succeeded, or 1 if +the operation failed. If the winbindd(8) daemon +is not working wbinfo will always return failure. +

AUTHOR

+ +

The original Samba software and related utilities were created by +Andrew Tridgell. Samba is now developed by the Samba Team as an Open +Source project. +

wbinfo was written by Tim Potter. + + diff --git a/docs/htmldocs/winbindd.8.html b/docs/htmldocs/winbindd.8.html index d0bdbbfccf..9862d8f9d5 100644 --- a/docs/htmldocs/winbindd.8.html +++ b/docs/htmldocs/winbindd.8.html @@ -3,7 +3,7 @@ -winbindd (1) +winbindd (8) @@ -11,9 +11,9 @@

winbindd (1)

winbindd (8)

Samba

8 May 2000

13 Jun 2000

@@ -115,11 +115,13 @@ alternatives may be / (although that conflicts with the unix directory separator) or a + character. The + character appears to be the best choice for 100% compatibility with existing unix utilities, but may be an aesthetically bad choice depending on your taste. +

Default: + winbind separator = \

Example: winbind separator = +

winbind uid

The winbind uid parameter specifies the range of user ids that are -allocated by the winbindd daemon. This range of +allocated by the winbindd daemon. This range of ids should have no existing local or nis users within it as strange conflicts can occur otherwise.

Default: @@ -128,38 +130,36 @@ conflicts can occur otherwise. winbind uid = 10000-20000

winbind gid

The winbind gid parameter specifies the range of group ids that are -allocated by the winbindd daemon. This range of -group ids should have no existing local or nis groups within it as strange -conflicts can occur otherwise. +allocated by the winbindd daemon. This range of group ids should have +no existing local or nis groups within it as strange conflicts can occur +otherwise.

Default: winbind gid = <empty string>

Example: winbind gid = 10000-20000

winbind cache time

This parameter specifies the number of seconds the -winbindd daemon will cache user and group -information before querying a Windows NT server again. When a item in -the cache is older than this time winbindd will ask the domain -controller for the sequence number of the servers account database. If -the sequence number has not changed then the cached item is marked as -valid for a further "winbind cache time" seconds. Otherwise the item -is fetched from the server. This means that as long as the account +

This parameter specifies the number of seconds the winbindd daemon will +cache user and group information before querying a Windows NT server +again. When a item in the cache is older than this time winbindd will ask +the domain controller for the sequence number of the servers account +database. If the sequence number has not changed then the cached item is +marked as valid for a further "winbind cache time" seconds. Otherwise the +item is fetched from the server. This means that as long as the account database is not actively changing winbindd will only have to send one sequence number query packet every "winbind cache time" seconds.

Default: winbind cache time = 15

template homedir

When filling out the user information for a Windows NT user, the -winbindd daemon uses this parameter to fill in -the home directory for that user. If the string %D is present it is -substituted with the user's Windows NT domain name. If the string %U -is present it is substituted with the user's Windows NT user name. +winbindd daemon uses this parameter to fill in the home directory for +that user. If the string %D is present it is substituted with the +user's Windows NT domain name. If the string %U is present it is +substituted with the user's Windows NT user name.

Default: template homedir = /home/%D/%U

template shell

When filling out the user information for a Windows NT user, the -winbindd daemon uses this parameter to fill in -the shell for that user. +winbindd daemon uses this parameter to fill in the shell for that user.

Default: template shell = /bin/false

@@ -237,23 +237,44 @@ can login to your unix box as a domain user, using the 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. +

NOTES

+ +

The following notes are useful when configuring and running winbindd: +

+nmbd must be running on the local machine for +winbindd to work. +

+Client processes resolving names through the winbindd nsswitch module +read an environment variable named WINBINDD_DOMAIN. If this variable +contains a comma separated list of Windows NT domain names, then winbindd +will only resolve users and groups within those Windows NT domains. +

+PAM is really easy to misconfigure. Make sure you know what you are doing +when modifying PAM configuration files. It is possible to set up PAM +such that you can no longer log into your system. +

+If more than one UNIX machine is running winbindd, then in general the +user and groups ids allocated by winbindd will not be the same. The +user and group ids will only be valid for the local machine. +

+If the the Windows NT RID to UNIX user and group id mapping file +is damaged or destroyed then the mappings will be lost. +

SIGNALS

The following signals can be used to manipulate the -winbindd daemon. +

The following signals can be used to manipulate the winbindd daemon.

SIGHUP

Reload the smb.conf file and apply any parameter changes to the running -version of winbindd. This signal also clears any -cached user and group information. +version of winbindd. This signal also clears any cached user and group +information.

SIGUSR1

The SIGUSR1 signal will cause winbindd to -write status information to the winbind log file including information -about the number of user and group ids allocated by -winbindd. +

The SIGUSR1 signal will cause winbindd to write status information +to the winbind log file including information about the number of user and +group ids allocated by winbindd.

Log files are stored in the filename specified by the log file parameter.

@@ -272,9 +293,8 @@ For security reasons, the winbind client will only attempt to connect to the

/lib/libnss_winbind.so.X

Implementation of name service switch library.

$LOCKDIR/winbindd_idmap.tdb

Storage for the Windows NT rid to UNIX user/group id mapping. If this file -is damaged or destroyed then the mappings will be lost. -

The lock directory is specified when Samba is initially compiled using the +

Storage for the Windows NT rid to UNIX user/group id mapping. The lock +directory is specified when Samba is initially compiled using the --with-lockdir option. This directory is by default /usr/local/samba/var/locks.

$LOCKDIR/winbindd_cache.tdb

@@ -291,6 +311,6 @@ is damaged or destroyed then the mappings will be lost.

The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project. -

Winbindd was written by Tim Potter. +

winbindd was written by Tim Potter. diff --git a/docs/manpages/wbinfo.1 b/docs/manpages/wbinfo.1 new file mode 100644 index 0000000000..3b78cac9ab --- /dev/null +++ b/docs/manpages/wbinfo.1 @@ -0,0 +1,101 @@ +.TH "wbinfo " "1" "13 Jun 2000" "Samba" "SAMBA" +.PP +.SH "NAME" +wbinfo \- Query information from winbind daemon +.PP +.SH "SYNOPSIS" +.PP +\fBwbinfo\fP -u [-g] [-n name] +[-s sid] [-U uid] [-G gid] +[-S sid] [-Y sid] +.PP +.SH "DESCRIPTION" +.PP +This program is part of the \fBSamba\fP suite version 3\&.0 and describes +functionality not yet implemented in the main version of Samba\&. +.PP +The \fBwbinfo\fP program queries and returns information created and used by +the \fBwinbindd(8)\fP daemon\&. +.PP +The \fBwinbindd(8)\fP daemon must be configured and +running for the \fBwbinfo\fP program to be able to return information\&. +.PP +.SH "OPTIONS" +.PP +The following options are available to the \fBwbinfo\fP program: +.PP +.IP +.IP "\fB-u\fP" +.IP +This option will list all users available in the Windows NT domain for +which the \fBwinbindd(8)\fP daemon is operating in\&. +Users in all trusted domains will also be listed\&. Note that this operation +does not assign user ids to any users that have not already been seen by +\fBwinbindd(8)\fP\&. +.IP +.IP "\fB-g\fP" +.IP +This option will list all groups available in the Windows NT domain for +which the \fBwinbindd(8)\fP daemon is operating in\&. +Groups in all trusted domains will also be listed\&. Note that this +operation does not assign group ids to any groups that have not already +been seen by \fBwinbindd(8)\fP\&. +.IP +.IP "\fB-n name\fP" +.IP +The \fB-n\fP option queries \fBwinbindd(8)\fP for the SID +associated with the name specified\&. Domain names can be specified before +the user name by using the winbind separator character\&. For example +\f(CWDOM1/Administrator\fP refers to the \f(CWAdministrator\fP user in the domain +\f(CWDOM1\fP\&. If no domain is specified then the domain used is the one +specified in the \fBsmb\&.conf\fP \fBworkgroup\fP parameter\&. +.IP +.IP "\fB-s sid\fP" +.IP +Use \fB-s\fP to resolve a SID to a name\&. This is the inverse of the \fB-n\fP +option above\&. SIDs must be specified as ASCII strings in the traditional +Microsoft format\&. For example +\f(CWS-1-5-21-1455342024-3071081365-2475485837-500\fP\&. +.IP +.IP "\fB-U uid\fP" +.IP +Try to convert a UNIX user id to a Windows NT SID\&. If the uid specified +does not refer to one within the \fBwinbind uid range\fP then the operation +will fail\&. +.IP +.IP "\fB-G gid\fP" +.IP +Try to convert a UNIX group id to a Windows NT SID\&. If the gid specified +does not refer to one within the \fBwinbind gid range\fP then the operation +will fail\&. +.IP +.IP "\fB-S sid\fP" +.IP +Convert a SID to a UNIX user id\&. If the SID does not correspond to a UNIX +user mapped by \fBwinbindd(8)\fP then the operation +will fail\&. +.IP +.IP "\fB-Y sid\fP" +.IP +Convert a SID to a UNIX group id\&. If the SID does not correspond to a UNIX +group mapped by \fBwinbindd(8)\fP then the operation +will fail\&. +.IP +.PP +.SH "EXIT STATUS" +.PP +The \fBwbinfo\fP program returns 0 if the operation succeeded, or 1 if +the operation failed\&. If the \fBwinbindd(8)\fP daemon +is not working \fBwbinfo\fP will always return failure\&. +.PP +.SH "SEE ALSO" +.PP +\fBwinbindd(8)\fP +.PP +.SH "AUTHOR" +.PP +The original Samba software and related utilities were created by +Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open +Source project\&. +.PP +\fBwbinfo\fP was written by Tim Potter\&. diff --git a/docs/manpages/winbindd.8 b/docs/manpages/winbindd.8 index a54f01f781..5af9ca5f90 100644 --- a/docs/manpages/winbindd.8 +++ b/docs/manpages/winbindd.8 @@ -1,4 +1,4 @@ -.TH "winbindd " "1" "8 May 2000" "Samba" "SAMBA" +.TH "winbindd " "8" "13 Jun 2000" "Samba" "SAMBA" .PP .SH "NAME" winbindd \- Name Service Switch daemon for resolving names from NT servers @@ -114,6 +114,9 @@ separator) or a + character\&. The + character appears to be the best choice for 100% compatibility with existing unix utilities, but may be an aesthetically bad choice depending on your taste\&. .IP +\fBDefault:\fP +\f(CW winbind separator = \e\fP +.IP \fBExample:\fP \f(CW winbind separator = +\fP .IP @@ -133,9 +136,9 @@ conflicts can occur otherwise\&. .IP "winbind gid" .IP The winbind gid parameter specifies the range of group ids that are -allocated by the \fBwinbindd\fP daemon\&. This range of -group ids should have no existing local or nis groups within it as strange -conflicts can occur otherwise\&. +allocated by the \fBwinbindd\fP daemon\&. This range of group ids should have +no existing local or nis groups within it as strange conflicts can occur +otherwise\&. .IP \fBDefault:\fP \f(CW winbind gid = \fP @@ -145,14 +148,13 @@ conflicts can occur otherwise\&. .IP .IP "winbind cache time" .IP -This parameter specifies the number of seconds the -\fBwinbindd\fP daemon will cache user and group -information before querying a Windows NT server again\&. When a item in -the cache is older than this time winbindd will ask the domain -controller for the sequence number of the servers account database\&. If -the sequence number has not changed then the cached item is marked as -valid for a further "winbind cache time" seconds\&. Otherwise the item -is fetched from the server\&. This means that as long as the account +This parameter specifies the number of seconds the \fBwinbindd\fP daemon will +cache user and group information before querying a Windows NT server +again\&. When a item in the cache is older than this time winbindd will ask +the domain controller for the sequence number of the servers account +database\&. If the sequence number has not changed then the cached item is +marked as valid for a further "winbind cache time" seconds\&. Otherwise the +item is fetched from the server\&. This means that as long as the account database is not actively changing winbindd will only have to send one sequence number query packet every "winbind cache time" seconds\&. .IP @@ -162,10 +164,10 @@ sequence number query packet every "winbind cache time" seconds\&. .IP "template homedir" .IP When filling out the user information for a Windows NT user, the -\fBwinbindd\fP daemon uses this parameter to fill in -the home directory for that user\&. If the string \f(CW%D\fP is present it is -substituted with the user\'s Windows NT domain name\&. If the string \f(CW%U\fP -is present it is substituted with the user\'s Windows NT user name\&. +\fBwinbindd\fP daemon uses this parameter to fill in the home directory for +that user\&. If the string \f(CW%D\fP is present it is substituted with the +user\'s Windows NT domain name\&. If the string \f(CW%U\fP is present it is +substituted with the user\'s Windows NT user name\&. .IP \fBDefault:\fP \f(CW template homedir = /home/%D/%U\fP @@ -173,8 +175,7 @@ is present it is substituted with the user\'s Windows NT user name\&. .IP "template shell" .IP When filling out the user information for a Windows NT user, the -\fBwinbindd\fP daemon uses this parameter to fill in -the shell for that user\&. +\fBwinbindd\fP daemon uses this parameter to fill in the shell for that user\&. .IP \fBDefault:\fP \f(CW template shell = /bin/false\fP @@ -282,27 +283,52 @@ 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: \fBnmbd\fP must be running on the local machine for +.SH "NOTES" +.PP +The following notes are useful when configuring and running \fBwinbindd\fP: +.PP +.IP +.IP "" +\fBnmbd\fP must be running on the local machine for \fBwinbindd\fP to work\&. +.IP +.IP "" +Client processes resolving names through the \fBwinbindd\fP nsswitch module +read an environment variable named \f(CWWINBINDD_DOMAIN\fP\&. If this variable +contains a comma separated list of Windows NT domain names, then winbindd +will only resolve users and groups within those Windows NT domains\&. +.IP +.IP "" +PAM is really easy to misconfigure\&. Make sure you know what you are doing +when modifying PAM configuration files\&. It is possible to set up PAM +such that you can no longer log into your system\&. +.IP +.IP "" +If more than one UNIX machine is running \fBwinbindd\fP, then in general the +user and groups ids allocated by \fBwinbindd\fP will not be the same\&. The +user and group ids will only be valid for the local machine\&. +.IP +.IP "" +If the the Windows NT RID to UNIX user and group id mapping file +is damaged or destroyed then the mappings will be lost\&. +.IP .PP .SH "SIGNALS" .PP -The following signals can be used to manipulate the -\fBwinbindd\fP daemon\&. +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\&. +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\&. +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 @@ -330,10 +356,8 @@ Implementation of name service switch library\&. .IP .IP "$LOCKDIR/winbindd_idmap\&.tdb" .IP -Storage for the Windows NT rid to UNIX user/group id mapping\&. If this file -is damaged or destroyed then the mappings will be lost\&. -.IP -The lock directory is specified when Samba is initially compiled using the +Storage for the Windows NT rid to UNIX user/group id mapping\&. The lock +directory is specified when Samba is initially compiled using the \f(CW--with-lockdir\fP option\&. This directory is by default \f(CW/usr/local/samba/var/locks\fP\&. .IP @@ -353,4 +377,4 @@ The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project\&. .PP -Winbindd was written by Tim Potter\&. +\fBwinbindd\fP was written by Tim Potter\&. diff --git a/docs/yodldocs/wbinfo.1.yo b/docs/yodldocs/wbinfo.1.yo new file mode 100644 index 0000000000..a01d420ef3 --- /dev/null +++ b/docs/yodldocs/wbinfo.1.yo @@ -0,0 +1,118 @@ +mailto(samba-bugs@samba.org) +manpage(wbinfo htmlcommand((1)))(1)(13 Jun 2000)(Samba)(SAMBA) + +label(NAME) +manpagename(wbinfo)(Query information from winbind daemon) + +label(SYNOPSIS) +manpagesynopsis() + +bf(wbinfo) link(-u)(minusu) [link(-g)(minusg)] [link(-n name)(minusn)] +[link(-s sid)(minuss)] [link(-U uid)(minusU)] [link(-G gid)(minusG)] +[link(-S sid)(minusS)] [link(-Y sid)(minusY)] + +label(DESCRIPTION) +manpagedescription() + +This program is part of the bf(Samba) suite version 3.0 and describes +functionality not yet implemented in the main version of Samba. + +The bf(wbinfo) program queries and returns information created and used by +the url(bf(winbindd(8)))(winbindd.8.html) daemon. + +The url(bf(winbindd(8)))(winbindd.8.html) daemon must be configured and +running for the bf(wbinfo) program to be able to return information. + +label(OPTIONS) +manpageoptions() + +The following options are available to the bf(wbinfo) program: + +startdit() + +label(minusu) +dit(bf(-u)) + +This option will list all users available in the Windows NT domain for +which the url(bf(winbindd(8)))(winbindd.8.html) daemon is operating in. +Users in all trusted domains will also be listed. Note that this operation +does not assign user ids to any users that have not already been seen by +url(bf(winbindd(8)))(winbindd.8.html). + +label(minusg) +dit(bf(-g)) + +This option will list all groups available in the Windows NT domain for +which the url(bf(winbindd(8)))(winbindd.8.html) daemon is operating in. +Groups in all trusted domains will also be listed. Note that this +operation does not assign group ids to any groups that have not already +been seen by url(bf(winbindd(8)))(winbindd.8.html). + +label(minusn) +dit(bf(-n name)) + +The bf(-n) option queries url(bf(winbindd(8)))(winbindd.8.html) for the SID +associated with the name specified. Domain names can be specified before +the user name by using the winbind separator character. For example +tt(DOM1/Administrator) refers to the tt(Administrator) user in the domain +tt(DOM1). If no domain is specified then the domain used is the one +specified in the bf(smb.conf) bf(workgroup) parameter. + +label(minuss) +dit(bf(-s sid)) + +Use bf(-s) to resolve a SID to a name. This is the inverse of the bf(-n) +option above. SIDs must be specified as ASCII strings in the traditional +Microsoft format. For example +tt(S-1-5-21-1455342024-3071081365-2475485837-500). + +label(minusU) +dit(bf(-U uid)) + +Try to convert a UNIX user id to a Windows NT SID. If the uid specified +does not refer to one within the bf(winbind uid range) then the operation +will fail. + +label(minusG) +dit(bf(-G gid)) + +Try to convert a UNIX group id to a Windows NT SID. If the gid specified +does not refer to one within the bf(winbind gid range) then the operation +will fail. + +label(minusS) +dit(bf(-S sid)) + +Convert a SID to a UNIX user id. If the SID does not correspond to a UNIX +user mapped by url(bf(winbindd(8)))(winbindd.8.html) then the operation +will fail. + +label(minusY) +dit(bf(-Y sid)) + +Convert a SID to a UNIX group id. If the SID does not correspond to a UNIX +group mapped by url(bf(winbindd(8)))(winbindd.8.html) then the operation +will fail. + +enddit() + +label(EXIT STATUS) +manpagesection(EXIT STATUS) + +The bf(wbinfo) program returns 0 if the operation succeeded, or 1 if +the operation failed. If the url(bf(winbindd(8)))(winbindd.8.html) daemon +is not working bf(wbinfo) will always return failure. + +label(SEEALSO) +manpageseealso() + +url(bf(winbindd(8)))(winbindd.8.html) + +label(AUTHOR) +manpageauthor() + +The original Samba software and related utilities were created by +Andrew Tridgell. Samba is now developed by the Samba Team as an Open +Source project. + +bf(wbinfo) was written by Tim Potter. diff --git a/docs/yodldocs/winbindd.8.yo b/docs/yodldocs/winbindd.8.yo index 0e0477c84e..0a0da9f2d6 100644 --- a/docs/yodldocs/winbindd.8.yo +++ b/docs/yodldocs/winbindd.8.yo @@ -1,5 +1,5 @@ mailto(samba-bugs@samba.org) -manpage(winbindd htmlcommand((1)))(1)(8 May 2000)(Samba)(SAMBA) +manpage(winbindd htmlcommand((8)))(8)(13 Jun 2000)(Samba)(SAMBA) label(NAME) manpagename(winbindd)(Name Service Switch daemon for resolving names from NT servers) @@ -121,13 +121,16 @@ separator) or a + character. The + character appears to be the best choice for 100% compatibility with existing unix utilities, but may be an aesthetically bad choice depending on your taste. + bf(Default:) +tt( winbind separator = \) + bf(Example:) tt( winbind separator = +) dit(winbind uid) The winbind uid parameter specifies the range of user ids that are -allocated by the url(bf(winbindd))(winbindd.8.html) daemon. This range of +allocated by the bf(winbindd) daemon. This range of ids should have no existing local or nis users within it as strange conflicts can occur otherwise. @@ -140,9 +143,9 @@ tt( winbind uid = 10000-20000) dit(winbind gid) The winbind gid parameter specifies the range of group ids that are -allocated by the url(bf(winbindd))(winbindd.8.html) daemon. This range of -group ids should have no existing local or nis groups within it as strange -conflicts can occur otherwise. +allocated by the bf(winbindd) daemon. This range of group ids should have +no existing local or nis groups within it as strange conflicts can occur +otherwise. bf(Default:) tt( winbind gid = ) @@ -152,14 +155,13 @@ tt( winbind gid = 10000-20000) dit(winbind cache time) -This parameter specifies the number of seconds the -url(bf(winbindd))(winbindd.8.html) daemon will cache user and group -information before querying a Windows NT server again. When a item in -the cache is older than this time winbindd will ask the domain -controller for the sequence number of the servers account database. If -the sequence number has not changed then the cached item is marked as -valid for a further "winbind cache time" seconds. Otherwise the item -is fetched from the server. This means that as long as the account +This parameter specifies the number of seconds the bf(winbindd) daemon will +cache user and group information before querying a Windows NT server +again. When a item in the cache is older than this time winbindd will ask +the domain controller for the sequence number of the servers account +database. If the sequence number has not changed then the cached item is +marked as valid for a further "winbind cache time" seconds. Otherwise the +item is fetched from the server. This means that as long as the account database is not actively changing winbindd will only have to send one sequence number query packet every "winbind cache time" seconds. @@ -169,10 +171,10 @@ tt( winbind cache time = 15) dit(template homedir) When filling out the user information for a Windows NT user, the -url(bf(winbindd))(winbindd.8.html) daemon uses this parameter to fill in -the home directory for that user. If the string tt(%D) is present it is -substituted with the user's Windows NT domain name. If the string tt(%U) -is present it is substituted with the user's Windows NT user name. +bf(winbindd) daemon uses this parameter to fill in the home directory for +that user. If the string tt(%D) is present it is substituted with the +user's Windows NT domain name. If the string tt(%U) is present it is +substituted with the user's Windows NT user name. bf(Default:) tt( template homedir = /home/%D/%U) @@ -180,8 +182,7 @@ tt( template homedir = /home/%D/%U) dit(template shell) When filling out the user information for a Windows NT user, the -url(bf(winbindd))(winbindd.8.html) daemon uses this parameter to fill in -the shell for that user. +bf(winbindd) daemon uses this parameter to fill in the shell for that user. bf(Default:) tt( template shell = /bin/false) @@ -256,29 +257,57 @@ syntax for the username. You may wish to use the commands "getent passwd" and "getent group" to confirm the correct operation of winbindd. -NOTE: url(bf(nmbd))(nmbd.8.html) must be running on the local machine for -url(bf(winbindd))(winbindd.8.html) to work. +label(NOTES) +manpagesection(NOTES) + +The following notes are useful when configuring and running bf(winbindd): + +startdit() + +dit() +url(bf(nmbd))(nmbd.8.html) must be running on the local machine for +bf(winbindd) to work. + +dit() +Client processes resolving names through the bf(winbindd) nsswitch module +read an environment variable named tt(WINBINDD_DOMAIN). If this variable +contains a comma separated list of Windows NT domain names, then winbindd +will only resolve users and groups within those Windows NT domains. + +dit() +PAM is really easy to misconfigure. Make sure you know what you are doing +when modifying PAM configuration files. It is possible to set up PAM +such that you can no longer log into your system. + +dit() +If more than one UNIX machine is running bf(winbindd), then in general the +user and groups ids allocated by bf(winbindd) will not be the same. The +user and group ids will only be valid for the local machine. + +dit() +If the the Windows NT RID to UNIX user and group id mapping file +is damaged or destroyed then the mappings will be lost. + +enddit() label(SIGNALS) manpagesection(SIGNALS) -The following signals can be used to manipulate the -url(bf(winbindd))(winbindd.8.html) daemon. +The following signals can be used to manipulate the bf(winbindd) 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. +version of bf(winbindd). 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). +The tt(SIGUSR1) signal will cause bf(winbindd) to write status information +to the winbind log file including information about the number of user and +group ids allocated by bf(winbindd). Log files are stored in the filename specified by the bf(log file) parameter. @@ -309,10 +338,8 @@ Implementation of name service switch library. dit($LOCKDIR/winbindd_idmap.tdb) -Storage for the Windows NT rid to UNIX user/group id mapping. If this file -is damaged or destroyed then the mappings will be lost. - -The lock directory is specified when Samba is initially compiled using the +Storage for the Windows NT rid to UNIX user/group id mapping. The lock +directory is specified when Samba is initially compiled using the tt(--with-lockdir) option. This directory is by default tt(/usr/local/samba/var/locks). @@ -335,4 +362,4 @@ The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project. -Winbindd was written by Tim Potter. +bf(winbindd) was written by Tim Potter. -- cgit