← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/manpages-3/winbind_krb5_locator.7.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/manpages-3/winbind_krb5_locator.7.xml
 
1
<?xml version="1.0" encoding="iso-8859-1"?>
 
2
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
 
3
<refentry id="winbind_krb5_locator.7">
 
4
 
 
5
<refmeta>
 
6
        <refentrytitle>winbind_krb5_locator</refentrytitle>
 
7
        <manvolnum>7</manvolnum>
 
8
        <refmiscinfo class="source">Samba</refmiscinfo>
 
9
        <refmiscinfo class="manual">7</refmiscinfo>
 
10
        <refmiscinfo class="version">3.4</refmiscinfo>
 
11
</refmeta>
 
12
 
 
13
 
 
14
<refnamediv>
 
15
        <refname>winbind_krb5_locator</refname>
 
16
        <refpurpose>A plugin for MIT and Heimdal Kerberos for detecting KDCs using Windows semantics.</refpurpose>
 
17
</refnamediv>
 
18
 
 
19
 
 
20
<refsect1>
 
21
        <title>DESCRIPTION</title>
 
22
 
 
23
        <para>
 
24
        This plugin is part of the <citerefentry><refentrytitle>samba</refentrytitle>
 
25
        <manvolnum>7</manvolnum></citerefentry> suite.
 
26
        </para>
 
27
 
 
28
        <para>
 
29
                <command>winbind_krb5_locator</command> is a plugin that permits MIT and
 
30
                Heimdal Kerberos libraries to detect Kerberos Servers (for the KDC and
 
31
                kpasswd service) using the same semantics that other tools of the Samba
 
32
                suite use. This include site-aware DNS service record lookups and caching
 
33
                of closest dc.
 
34
                The plugin uses the public locator API provided by most modern Kerberos
 
35
                implementations.
 
36
        </para>
 
37
</refsect1>
 
38
<refsect1>
 
39
        <title>PREREQUISITES</title>
 
40
        <para>
 
41
                MIT Kerberos (at least version 1.5) or Heimdal Kerberos (at least version
 
42
                1.0) is required.
 
43
        </para>
 
44
 
 
45
        <para>
 
46
                The plugin queries the <citerefentry><refentrytitle>winbindd</refentrytitle>
 
47
                <manvolnum>8</manvolnum></citerefentry> daemon which needs to be configured
 
48
                and started separately.
 
49
        </para>
 
50
 
 
51
        <para>
 
52
                The <command>winbind_krb5_locator.so</command> file needs to be manually
 
53
                copied to the plugin directory of the system Kerberos library.
 
54
 
 
55
                For MIT Kerberos this is often:
 
56
                        <filename>/usr/lib/krb5/plugins/libkrb5/</filename>.
 
57
                For Heimdal Kerberos this is often:
 
58
                        <filename>/usr/lib/plugin/krb5/</filename>.
 
59
 
 
60
                Please check your local Kerberos installation for the correct
 
61
                paths. No modification in <filename>/etc/krb5.conf</filename>
 
62
                is required to enable the use of this plugin.
 
63
        </para>
 
64
        <para>
 
65
                After copying the locator plugin to the appropriate plugin
 
66
                directory it should immediately be available for use.
 
67
                Users should be able to kinit into their kerberized Windows
 
68
                environment without any modification or servers
 
69
                being put manually into <filename>/etc/krb5.conf</filename>.
 
70
        </para>
 
71
</refsect1>
 
72
 
 
73
<refsect1>
 
74
        <title>VERSION</title>
 
75
 
 
76
        <para>
 
77
        This man page is correct for version 3 of the Samba suite.
 
78
        </para>
 
79
</refsect1>
 
80
 
 
81
<refsect1>
 
82
        <title>AUTHOR</title>
 
83
 
 
84
        <para>
 
85
                The original Samba software and related utilities were created by Andrew
 
86
                Tridgell. Samba is now developed by the Samba Team as an Open Source
 
87
                project similar to the way the Linux kernel is developed.
 
88
        </para>
 
89
 
 
90
        <para>
 
91
                The winbind_krb5_locator manpage was written by Guenther Deschner.
 
92
        </para>
 
93
</refsect1>
 
94
 
 
95
</refentry>