summaryrefslogtreecommitdiff
path: root/kerberosIV
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>1999-07-04 15:34:53 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>1999-07-04 15:34:53 +0000
commite94a2a8ae0628305db1694d0a36f4d91a50a53b1 (patch)
treee85b2a54ed4df63d82c6b481219830cad7979dc4 /kerberosIV
parent4d11060007f9622cb82a5aa7cce32f6d16257725 (diff)
new -mdoc man pages; kwesterback@home.com
Diffstat (limited to 'kerberosIV')
-rw-r--r--kerberosIV/man/krb.conf.569
-rw-r--r--kerberosIV/man/krb.realms.555
2 files changed, 73 insertions, 51 deletions
diff --git a/kerberosIV/man/krb.conf.5 b/kerberosIV/man/krb.conf.5
index b6ad8483d52..6876f66fd61 100644
--- a/kerberosIV/man/krb.conf.5
+++ b/kerberosIV/man/krb.conf.5
@@ -26,34 +26,53 @@
.\"this software for any purpose. It is provided "as is" without express
.\"or implied warranty.
.\"
-.\" $OpenBSD: krb.conf.5,v 1.6 1999/02/27 08:49:49 deraadt Exp $
-.TH KRB.CONF 5 "Kerberos Version 4.0" "MIT Project Athena"
-.SH NAME
-krb.conf \- Kerberos configuration file
-.SH DESCRIPTION
-.I krb.conf
+.\" $OpenBSD: krb.conf.5,v 1.7 1999/07/04 15:34:52 aaron Exp $
+.Dd 15 June, 1999
+.Os
+.Dt KRB.CONF 5
+.Sh NAME
+.Nm krb.conf
+.Nd Kerberos configuration file
+.Sh DESCRIPTION
+.Nm
contains configuration information describing the Kerberos realm and the
Kerberos key distribution center (KDC) servers for known realms.
-.PP
-.I krb.conf
-contains the name of the local realm in the first
-line, followed by lines indicating realm/host
-entries. The first token is a realm name, and the second is the hostname
-of a host running a KDC for that realm.
-The words "admin server" following the hostname indicate that
-the host also provides an administrative database server.
-
-A hash sign (#) as a first character of the krb.conf file disables kerberos
-authentication on the system.
-
-For example:
-.nf
-.in +1i
+.Pp
+The first line of
+.Nm
+contains the name of the local realm. If the first character in the first line
+is a hash sign
+.Pf ( Ql # ) ,
+then Kerberos authentication is disabled.
+.Pp
+Subsequent lines are of the form
+.Bd -ragged -offset indent
+.Fa realm
+.Fa KDC_server
+.Op admin server
+.Ed
+.Pp
+where
+.Fa realm
+is a Kerberos realm name and
+.Fa KDC_server
+is the name of a host running a KDC for
+.Fa realm .
+The words
+.Dq admin server
+following
+.Fa KDC_server
+indicate that the host also provides an administrative database server.
+.Pp
+.Sh EXAMPLES
+A krb.conf file for a host in the ATHENA.MIT.EDU realm might look like:
+.Bd -literal -offset indent
ATHENA.MIT.EDU
ATHENA.MIT.EDU kerberos-1.mit.edu admin server
ATHENA.MIT.EDU kerberos-2.mit.edu
LCS.MIT.EDU kerberos.lcs.mit.edu admin server
-.in -1i
-.SH SEE ALSO
-krb.realms(5), krb_get_krbhst(3), krb_get_lrealm(3)
-
+.Ed
+.Sh SEE ALSO
+.Xr krb_get_krbhst 3 ,
+.Xr krb_get_lrealm 3 ,
+.Xr krb.realms 5
diff --git a/kerberosIV/man/krb.realms.5 b/kerberosIV/man/krb.realms.5
index 3e48b53e024..6626622d55f 100644
--- a/kerberosIV/man/krb.realms.5
+++ b/kerberosIV/man/krb.realms.5
@@ -26,36 +26,39 @@
.\"this software for any purpose. It is provided "as is" without express
.\"or implied warranty.
.\"
-.\" $OpenBSD: krb.realms.5,v 1.5 1999/02/27 08:49:49 deraadt Exp $
-.TH KRB.REALMS 5 "Kerberos Version 4.0" "MIT Project Athena"
-.SH NAME
-krb.realms \- host to Kerberos realm translation file
-.SH DESCRIPTION
-.I krb.realms
+.\" $OpenBSD: krb.realms.5,v 1.6 1999/07/04 15:34:52 aaron Exp $
+.Dd 15 June, 1999
+.Os
+.Dt KRB.REALMS 5
+.Sh NAME
+.Nm krb.realms
+.Nd host to Kerberos realm translation file
+.Sh DESCRIPTION
+.Nm
provides a translation from a hostname to the Kerberos realm name for
the services provided by that host.
-.PP
+.Pp
Each line of the translation file is in one of the following forms
-(domain_name should be of the form .XXX.YYY, e.g. .LCS.MIT.EDU):
-.nf
-.in +5n
+.Pf ( Fa domain_name
+should be of the form .XXX.YYY, e.g. .LCS.MIT.EDU):
+.Bd -literal -offset indent
host_name kerberos_realm
domain_name kerberos_realm
-.in -5n
-.fi
-If a hostname exactly matches the
-.I host_name
-field in a line of the first
-form, the corresponding realm is the realm of the host.
-If a hostname does not match any
-.I host_name
-in the file, but its
-domain exactly matches the
-.I domain_name
-field in a line of the second
-form, the corresponding realm is the realm of the host.
-.PP
+.Ed
+.Pp
+If a hostname exactly matches the
+.Fa host_name
+field in a line of the first form, the corresponding
+.Fa kerberos_realm
+is the realm of the host. If a hostname does not match any
+.Fa host_name
+in the file, but its domain exactly matches the
+.Fa domain_name
+field in a line of the second form, the corresponding
+.Fa kerberos_realm
+is the realm of the host.
+.Pp
If no translation entry applies, the host's realm is considered to be
the hostname's domain portion converted to upper case.
-.SH SEE ALSO
-krb_realmofhost(3)
+.Sh SEE ALSO
+.Xr krb_realmofhost 3