1 files changed, 38 insertions, 39 deletions

diff --git a/lib/krb5/krb5_set_default_realm.cat3 b/lib/krb5/krb5_set_default_realm.cat3
index ff645cc106f0..2bf0a5b825b8 100644
--- a/lib/krb5/krb5_set_default_realm.cat3
+++ b/lib/krb5/krb5_set_default_realm.cat3
@@ -1,70 +1,69 @@
-
 KRB5_SET_DEFAULT_REAL... BSD Library Functions Manual KRB5_SET_DEFAULT_REAL...
 
-NNAAMMEE
-     kkrrbb55__ccooppyy__hhoosstt__rreeaallmm, kkrrbb55__ffrreeee__hhoosstt__rreeaallmm, kkrrbb55__ggeett__ddeeffaauulltt__rreeaallmm,
-     kkrrbb55__ggeett__ddeeffaauulltt__rreeaallmmss, kkrrbb55__ggeett__hhoosstt__rreeaallmm, kkrrbb55__sseett__ddeeffaauulltt__rreeaallmm --
+NAME
+     krb5_copy_host_realm, krb5_free_host_realm, krb5_get_default_realm,
+     krb5_get_default_realms, krb5_get_host_realm, krb5_set_default_realm --
      default and host realm read and manipulation routines
 
-LLIIBBRRAARRYY
+LIBRARY
      Kerberos 5 Library (libkrb5, -lkrb5)
 
-SSYYNNOOPPSSIISS
-     ##iinncclluuddee <<kkrrbb55..hh>>
+SYNOPSIS
+     #include <krb5.h>
 
-     _k_r_b_5___e_r_r_o_r___c_o_d_e
-     kkrrbb55__ccooppyy__hhoosstt__rreeaallmm(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _c_o_n_s_t _k_r_b_5___r_e_a_l_m _*_f_r_o_m,
-         _k_r_b_5___r_e_a_l_m _*_*_t_o);
+     krb5_error_code
+     krb5_copy_host_realm(krb5_context context, const krb5_realm *from,
+         krb5_realm **to);
 
-     _k_r_b_5___e_r_r_o_r___c_o_d_e
-     kkrrbb55__ffrreeee__hhoosstt__rreeaallmm(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _k_r_b_5___r_e_a_l_m _*_r_e_a_l_m_l_i_s_t);
+     krb5_error_code
+     krb5_free_host_realm(krb5_context context, krb5_realm *realmlist);
 
-     _k_r_b_5___e_r_r_o_r___c_o_d_e
-     kkrrbb55__ggeett__ddeeffaauulltt__rreeaallmm(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _k_r_b_5___r_e_a_l_m _*_r_e_a_l_m);
+     krb5_error_code
+     krb5_get_default_realm(krb5_context context, krb5_realm *realm);
 
-     _k_r_b_5___e_r_r_o_r___c_o_d_e
-     kkrrbb55__ggeett__ddeeffaauulltt__rreeaallmmss(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _k_r_b_5___r_e_a_l_m _*_*_r_e_a_l_m);
+     krb5_error_code
+     krb5_get_default_realms(krb5_context context, krb5_realm **realm);
 
-     _k_r_b_5___e_r_r_o_r___c_o_d_e
-     kkrrbb55__ggeett__hhoosstt__rreeaallmm(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _c_o_n_s_t _c_h_a_r _*_h_o_s_t,
-         _k_r_b_5___r_e_a_l_m _*_*_r_e_a_l_m_s);
+     krb5_error_code
+     krb5_get_host_realm(krb5_context context, const char *host,
+         krb5_realm **realms);
 
-     _k_r_b_5___e_r_r_o_r___c_o_d_e
-     kkrrbb55__sseett__ddeeffaauulltt__rreeaallmm(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _c_o_n_s_t _c_h_a_r _*_r_e_a_l_m);
+     krb5_error_code
+     krb5_set_default_realm(krb5_context context, const char *realm);
 
-DDEESSCCRRIIPPTTIIOONN
-     kkrrbb55__ccooppyy__hhoosstt__rreeaallmm() copies the list of realms from _f_r_o_m to _t_o.  _t_o
-     should be freed by the caller using _k_r_b_5___f_r_e_e___h_o_s_t___r_e_a_l_m.
+DESCRIPTION
+     krb5_copy_host_realm() copies the list of realms from from to to.  to
+     should be freed by the caller using krb5_free_host_realm.
 
-     kkrrbb55__ffrreeee__hhoosstt__rreeaallmm() frees all memory allocated by _r_e_a_l_m_l_i_s_t.
+     krb5_free_host_realm() frees all memory allocated by realmlist.
 
-     kkrrbb55__ggeett__ddeeffaauulltt__rreeaallmm() returns the first default realm for this host.
-     The realm returned should be freed with kkrrbb55__xxffrreeee().
+     krb5_get_default_realm() returns the first default realm for this host.
+     The realm returned should be freed with krb5_xfree().
 
-     kkrrbb55__ggeett__ddeeffaauulltt__rreeaallmmss() returns a NULL terminated list of default
-     realms for this context.  Realms returned by kkrrbb55__ggeett__ddeeffaauulltt__rreeaallmmss()
-     should be freed with kkrrbb55__ffrreeee__hhoosstt__rreeaallmm().
+     krb5_get_default_realms() returns a NULL terminated list of default
+     realms for this context.  Realms returned by krb5_get_default_realms()
+     should be freed with krb5_free_host_realm().
 
-     kkrrbb55__ggeett__hhoosstt__rreeaallmm() returns a NULL terminated list of realms for _h_o_s_t
-     by looking up the information in the [domain_realm] in _k_r_b_5_._c_o_n_f or in
+     krb5_get_host_realm() returns a NULL terminated list of realms for host
+     by looking up the information in the [domain_realm] in krb5.conf or in
      DNS.  If the mapping in [domain_realm] results in the string dns_locate,
      DNS is used to lookup the realm.
 
      When using DNS to a resolve the domain for the host a.b.c,
-     kkrrbb55__ggeett__hhoosstt__rreeaallmm() looks for a TXT resource record named
+     krb5_get_host_realm() looks for a TXT resource record named
      _kerberos.a.b.c, and if not found, it strips off the first component and
      tries a again (_kerberos.b.c) until it reaches the root.
 
      If there is no configuration or DNS information found,
-     kkrrbb55__ggeett__hhoosstt__rreeaallmm() assumes it can use the domain part of the _h_o_s_t to
-     form a realm.  Caller must free _r_e_a_l_m_l_i_s_t with kkrrbb55__ffrreeee__hhoosstt__rreeaallmm().
+     krb5_get_host_realm() assumes it can use the domain part of the host to
+     form a realm.  Caller must free realmlist with krb5_free_host_realm().
 
-     kkrrbb55__sseett__ddeeffaauulltt__rreeaallmm() sets the default realm for the _c_o_n_t_e_x_t.  If NULL
-     is used as a _r_e_a_l_m, the [libdefaults]default_realm stanza in _k_r_b_5_._c_o_n_f is
+     krb5_set_default_realm() sets the default realm for the context.  If NULL
+     is used as a realm, the [libdefaults]default_realm stanza in krb5.conf is
      used.  If there is no such stanza in the configuration file, the
-     kkrrbb55__ggeett__hhoosstt__rreeaallmm() function is used to form a default realm.
+     krb5_get_host_realm() function is used to form a default realm.
 
-SSEEEE AALLSSOO
+SEE ALSO
      free(3), krb5.conf(5)
 
 HEIMDAL                         April 24, 2005                         HEIMDAL