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

   1
   2 KRB5_BUILD_PRINCIPAL(3)    UNIX Programmer's Manual    KRB5_BUILD_PRINCIPAL(3)
   3
   4 N\bNA\bAM\bME\bE
   5      k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl, k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_e\bex\bxt\bt, k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_v\bva\ba,
   6      k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_v\bva\ba_\b_e\bex\bxt\bt, k\bkr\brb\bb5\b5_\b_m\bma\bak\bke\be_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl - principal creation
   7      functions
   8
   9 L\bLI\bIB\bBR\bRA\bAR\bRY\bY
  10      Kerberos 5 Library (libkrb5, -lkrb5)
  11
  12 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  13      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  14      k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl _\b*_\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl,
  15              _\bi_\bn_\bt _\br_\be_\ba_\bl_\bm_\b__\bl_\be_\bn, _\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bs_\bt_\b__\br_\be_\ba_\bl_\bm _\br_\be_\ba_\bl_\bm, _\b._\b._\b.)
  16
  17      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  18      k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_e\bex\bxt\bt(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl _\b*_\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl,
  19              _\bi_\bn_\bt _\br_\be_\ba_\bl_\bm_\b__\bl_\be_\bn, _\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bs_\bt_\b__\br_\be_\ba_\bl_\bm _\br_\be_\ba_\bl_\bm, _\b._\b._\b.)
  20
  21      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  22      k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_v\bva\ba(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl _\b*_\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl,
  23              _\bi_\bn_\bt _\br_\be_\ba_\bl_\bm_\b__\bl_\be_\bn, _\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bs_\bt_\b__\br_\be_\ba_\bl_\bm _\br_\be_\ba_\bl_\bm, _\bv_\ba_\b__\bl_\bi_\bs_\bt _\ba_\bp)
  24
  25      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  26      k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_v\bva\ba_\b_e\bex\bxt\bt(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt,
  27              _\bk_\br_\bb_\b5_\b__\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl _\b*_\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl, _\bi_\bn_\bt _\br_\be_\ba_\bl_\bm_\b__\bl_\be_\bn, _\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bs_\bt_\b__\br_\be_\ba_\bl_\bm _\br_\be_\ba_\bl_\bm,
  28              _\bv_\ba_\b__\bl_\bi_\bs_\bt _\ba_\bp)
  29
  30      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  31      k\bkr\brb\bb5\b5_\b_m\bma\bak\bke\be_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl _\b*_\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl,
  32              _\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bs_\bt_\b__\br_\be_\ba_\bl_\bm _\br_\be_\ba_\bl_\bm, _\b._\b._\b.)
  33
  34 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  35      These functions create a Kerberos 5 principal from a realm and a list of
  36      components.  All of these functions return an allocated principal in the
  37      _\bp_\br_\bi_\bn_\bc_\bi_\bp_\ba_\bl parameter, this should be freed with k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl() af-
  38      ter use.
  39
  40      The ``build'' functions take a _\br_\be_\ba_\bl_\bm and the length of the realm.  The
  41      k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl() and k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_v\bva\ba() also takes a list of
  42      components (zero-terminated strings), terminated with NULL. The
  43      k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_e\bex\bxt\bt() and k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl_\b_v\bva\ba_\b_e\bex\bxt\bt() takes a list
  44      of length-value pairs, the list is terminated with a zero length.
  45
  46      The k\bkr\brb\bb5\b5_\b_m\bma\bak\bke\be_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl() is a wrapper around k\bkr\brb\bb5\b5_\b_b\bbu\bui\bil\bld\bd_\b_p\bpr\bri\bin\bnc\bci\bip\bpa\bal\bl().  If
  47      the realm is NULL, the default realm will be used.
  48
  49 B\bBU\bUG\bGS\bS
  50      You can not have a NUL in a component. Until someone can give a good ex-
  51      ample of where it would be a good idea to have NUL's in a component, this
  52      will not be fixed.
  53
  54 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
  55      krb5_425_conv_principal(3),  krb5_free_principal(3),  krb5_parse_name(3),
  56       krb5_sname_to_principal(3),  krb5_unparse_name(3)
  57
  58  HEIMDAL                        August 8, 1997                               1