Initial import from FreeBSD RELENG_4:
[dragonfly.git] / crypto / kerberosIV / man / krb.conf.5
1 .\" $Id: krb.conf.5,v 1.4 1999/08/02 16:09:57 bg Exp $
2 .\" Copyright 1989 by the Massachusetts Institute of Technology.
3 .\"
4 .\" For copying and distribution information,
5 .\" please see the file <mit-copyright.h>.
6 .\"
7 .TH KRB.CONF 5 "Kerberos Version 4.0" "MIT Project Athena"
8 .SH NAME
9 /etc/krb.conf \- Kerberos configuration file
10 .SH DESCRIPTION
11 .I krb.conf
12 contains configuration information describing the Kerberos realm(s) and the
13 Kerberos key distribution center (KDC) servers for known realms.
14 .PP
15 .I krb.conf
16 starts with a definition of the local realm on the first line, this is
17 followed by any number lines defining supplementary local realms.  The
18 rest of the file consists of lines indicating realm/host entries. The
19 first token is a realm name, and the second is a server specification
20 of a host running a KDC for that realm. The words "admin server"
21 following the hostname indicate that the host also provides an
22 administrative database server.
23
24 To be able to communicate with the KDC through a firewall it is
25 sometimes necessary to tunnel requests over HTTP or TCP. Tunnel
26 protocols and port numbers are specified in the server specification
27 using the syntax [(UDP|TCP|HTTP)/]hostname[:port].
28
29 For example:
30 .nf
31 .in +1i
32 SICS.SE
33 NADA.KTH.SE
34 SICS.SE     TCP/kerberos.sics.se:88 admin server
35 NADA.KTH.SE kerberos.nada.kth.se    admin server
36 NADA.KTH.SE kerberos-1.nada.kth.se
37 NADA.KTH.SE kerberos-2.nada.kth.se
38 NADA.KTH.SE HTTP/kerberos-3.nada.kth.se
39 KTH.SE      kerberos.kth.se         admin server
40 .in -1i
41 .SH SEE ALSO
42 krb.realms(5), krb_get_krbhst(3), krb_get_lrealm(3)