- _\bk_\br_\bb__\br_\be_\ba_\bl_\bm_\bo_\bf_\bh_\bo_\bs_\bt returns the Kerberos realm of the host _\bh_\bo_\bs_\bt,
- as determined by the translation table
- /_\be_\bt_\bc/_\bk_\be_\br_\bb_\be_\br_\bo_\bs_\bI_\bV/_\bk_\br_\bb._\br_\be_\ba_\bl_\bm_\bs. _\bh_\bo_\bs_\bt should be the fully-
- qualified domain-style primary host name of the host in
- question. In order to prevent certain security attacks,
- this routine must either have _\ba _\bp_\br_\bi_\bo_\br_\bi knowledge of a host's
- realm, or obtain such information securely.
+ _\bk_\br_\bb_\b__\br_\be_\ba_\bl_\bm_\bo_\bf_\bh_\bo_\bs_\bt returns the Kerberos realm of the host
+ _\bh_\bo_\bs_\bt, as determined by the translation table
+ _\b/_\be_\bt_\bc_\b/_\bk_\be_\br_\bb_\be_\br_\bo_\bs_\bI_\bV_\b/_\bk_\br_\bb_\b._\br_\be_\ba_\bl_\bm_\bs. _\bh_\bo_\bs_\bt should be the fully-
+ qualified domain-style primary host name of the host in
+ question. In order to prevent certain security attacks,
+ this routine must either have _\ba _\bp_\br_\bi_\bo_\br_\bi knowledge of a
+ host's realm, or obtain such information securely.
+
+ The format of the translation file is described by
+ _\bk_\br_\bb_\b._\br_\be_\ba_\bl_\bm_\bs(5). If _\bh_\bo_\bs_\bt exactly matches a host_name line,
+ the corresponding realm is returned. Otherwise, if the
+ domain portion of _\bh_\bo_\bs_\bt matches a domain_name line, the
+ corresponding realm is returned. If _\bh_\bo_\bs_\bt contains a
+ domain, but no translation is found, _\bh_\bo_\bs_\bt's domain is con-
+ verted to upper-case and returned. If _\bh_\bo_\bs_\bt contains no
+ discernible domain, or an error occurs, the local realm
+ name, as supplied by _\bk_\br_\bb_\b__\bg_\be_\bt_\b__\bl_\br_\be_\ba_\bl_\bm(3), is returned.