crypto/heimdal-0.6.3/lib/krb5/krb5_aname_to_localname.cat3

   1
   2 KRB5_ANAME_TO_LOCALNAME(3) UNIX Programmer's Manual KRB5_ANAME_TO_LOCALNAME(3)
   3
   4 N\bNA\bAM\bME\bE
   5      k\bkr\brb\bb5\b5_\b_a\ban\bna\bam\bme\be_\b_t\bto\bo_\b_l\blo\boc\bca\bal\bln\bna\bam\bme\be - converts a principal to a system local name.
   6
   7 L\bLI\bIB\bBR\bRA\bAR\bRY\bY
   8      Kerberos 5 Library (libkrb5, -lkrb5)
   9
  10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  11      _\bk_\br_\bb_\b5_\b__\bb_\bo_\bo_\bl_\be_\ba_\bn
  12      k\bkr\brb\bb5\b5_\b_a\ban\bna\bam\bme\be_\b_t\bto\bo_\b_l\blo\boc\bca\bal\bln\bna\bam\bme\be(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bs_\bt_\b__\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl _\bn_\ba_\bm_\be,
  13              _\bs_\bi_\bz_\be_\b__\bt _\bl_\bn_\bs_\bi_\bz_\be, _\bc_\bh_\ba_\br _\b*_\bl_\bn_\ba_\bm_\be)
  14
  15 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  16      This function takes a principal _\bn_\ba_\bm_\be, verifies its in the local realm
  17      (using k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bms\bs()) and then returns the local name of the
  18      principal.
  19
  20      If _\bn_\ba_\bm_\be isn't in one of the local realms and error is returned.
  21
  22      If size (_\bl_\bn_\bs_\bi_\bz_\be) of the local name (_\bl_\bn_\ba_\bm_\be) is to small, an error is re-
  23      turned.
  24
  25      k\bkr\brb\bb5\b5_\b_a\ban\bna\bam\bme\be_\b_t\bto\bo_\b_l\blo\boc\bca\bal\bln\bna\bam\bme\be() should only be use by application that imple-
  26      ments protocols that doesn't transport the login name and thus needs to
  27      convert a principal to a local name.
  28
  29      Protocols should be designed so that the it autheticates using Kerberos,
  30      send over the login name and then verifies in the principal that authen-
  31      ticated is allowed to login and the login name.  A way to check if a user
  32      is allowed to login is using the function k\bkr\brb\bb5\b5_\b_k\bku\bus\bse\ber\bro\bok\bk().
  33
  34 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
  35      krb5_get_default_realms(3),  krb5_kuserok(3)
  36
  37  HEIMDAL                        March 17, 2003                               1