source: trunk/server/docs/manpages/winbind_krb5_locator.7

Last change on this file was 862, checked in by Silvan Scherrer, 12 years ago

Samba Server: update trunk to 3.6.23

File size: 3.0 KB
RevLine 
[862]1'\" t
2.\" Title: winbind_krb5_locator
3.\" Author: [see the "AUTHOR" section]
4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5.\" Date: 09/18/2013
6.\" Manual: 7
7.\" Source: Samba 3.6
8.\" Language: English
9.\"
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 '
20.\" -----------------------------------------------------------------
21.\" * set default formatting
22.\" -----------------------------------------------------------------
23.\" disable hyphenation
24.nh
25.\" disable justification (adjust text to left margin only)
26.ad l
27.\" -----------------------------------------------------------------
28.\" * MAIN CONTENT STARTS HERE *
29.\" -----------------------------------------------------------------
30.SH "NAME"
31winbind_krb5_locator \- A plugin for MIT and Heimdal Kerberos for detecting KDCs using Windows semantics\&.
32.SH "DESCRIPTION"
33.PP
34This plugin is part of the
35\fBsamba\fR(7)
36suite\&.
37.PP
38
39winbind_krb5_locator
40is a plugin that permits MIT and Heimdal Kerberos libraries to detect Kerberos Servers (for the KDC and kpasswd service) using the same semantics that other tools of the Samba suite use\&. This include site\-aware DNS service record lookups and caching of closest dc\&. The plugin uses the public locator API provided by most modern Kerberos implementations\&.
41.SH "PREREQUISITES"
42.PP
43MIT Kerberos (at least version 1\&.5) or Heimdal Kerberos (at least version 1\&.0) is required\&.
44.PP
45The plugin queries the
46\fBwinbindd\fR(8)
47daemon which needs to be configured and started separately\&.
48.PP
49The
50winbind_krb5_locator\&.so
51file needs to be manually copied to the plugin directory of the system Kerberos library\&. For MIT Kerberos this is often:
52/usr/lib/krb5/plugins/libkrb5/\&. For Heimdal Kerberos this is often:
53/usr/lib/plugin/krb5/\&. Please check your local Kerberos installation for the correct paths\&. No modification in
54/etc/krb5\&.conf
55is required to enable the use of this plugin\&.
56.PP
57After copying the locator plugin to the appropriate plugin directory it should immediately be available for use\&. Users should be able to kinit into their kerberized Windows environment without any modification or servers being put manually into
58/etc/krb5\&.conf\&.
59.SH "VERSION"
60.PP
61This man page is correct for version 3 of the Samba suite\&.
62.SH "AUTHOR"
63.PP