2 KRB5_BUILD_PRINCIPAL(3) UNIX Programmer's Manual KRB5_BUILD_PRINCIPAL(3)
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
9 L
\bLI
\bIB
\bBR
\bRA
\bAR
\bRY
\bY
10 Kerberos 5 Library (libkrb5, -lkrb5)
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.)
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.)
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)
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)
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.)
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-
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.
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.
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
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)
58 HEIMDAL August 8, 1997 1