diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-07-04 15:34:53 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-07-04 15:34:53 +0000 |
commit | e94a2a8ae0628305db1694d0a36f4d91a50a53b1 (patch) | |
tree | e85b2a54ed4df63d82c6b481219830cad7979dc4 /kerberosIV | |
parent | 4d11060007f9622cb82a5aa7cce32f6d16257725 (diff) |
new -mdoc man pages; kwesterback@home.com
Diffstat (limited to 'kerberosIV')
-rw-r--r-- | kerberosIV/man/krb.conf.5 | 69 | ||||
-rw-r--r-- | kerberosIV/man/krb.realms.5 | 55 |
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 |