Initial import from FreeBSD RELENG_4:
[dragonfly.git] / crypto / kerberosIV / man / krb.realms.5
1 .\" $Id: krb.realms.5,v 1.2 1996/06/12 21:29:22 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.REALMS 5 "Kerberos Version 4.0" "MIT Project Athena"
8 .SH NAME
9 /etc/krb.realms \- host to Kerberos realm translation file
10 .SH DESCRIPTION
11 .I krb.realms
12 provides a translation from a hostname to the Kerberos realm name for
13 the services provided by that host.
14 .PP
15 Each line of the translation file is in one of the following forms
16 (domain_name should be of the form .XXX.YYY, e.g. .LCS.MIT.EDU):
17 .nf
18 .in +5n
19 host_name kerberos_realm
20 domain_name kerberos_realm
21 .in -5n
22 .fi
23 If a hostname exactly matches the 
24 .I host_name
25 field in a line of the first
26 form, the corresponding realm is the realm of the host.
27 If a hostname does not match any 
28 .I host_name
29 in the file, but its
30 domain exactly matches the 
31 .I domain_name
32 field in a line of the second
33 form, the corresponding realm is the realm of the host.
34 .PP
35 If no translation entry applies, the host's realm is considered to be
36 the hostname's domain portion converted to upper case.
37 .SH SEE ALSO
38 krb_realmofhost(3)