1@subheading shishi_encticketpart_get_key
2@anchor{shishi_encticketpart_get_key}
3@deftypefun {int} {shishi_encticketpart_get_key} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, Shishi_key ** @var{key})
4@var{handle}: shishi handle as allocated by @code{shishi_init()}.
5
6@var{encticketpart}: input EncTicketPart variable.
7
8@var{key}: newly allocated key.
9
10Extract the session key in the Ticket.
11
12@strong{Return value:} Returns @code{SHISHI_OK} iff successful.
13@end deftypefun
14
15@subheading shishi_encticketpart_key_set
16@anchor{shishi_encticketpart_key_set}
17@deftypefun {int} {shishi_encticketpart_key_set} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, Shishi_key * @var{key})
18@var{handle}: shishi handle as allocated by @code{shishi_init()}.
19
20@var{encticketpart}: input EncTicketPart variable.
21
22@var{key}: key handle with information to store in encticketpart.
23
24Set the EncTicketPart.key field to key type and value of supplied
25key.
26
27@strong{Return value:} Returns @code{SHISHI_OK} iff successful.
28@end deftypefun
29
30@subheading shishi_encticketpart_flags_set
31@anchor{shishi_encticketpart_flags_set}
32@deftypefun {int} {shishi_encticketpart_flags_set} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, int @var{flags})
33@var{handle}: shishi handle as allocated by @code{shishi_init()}.
34
35@var{encticketpart}: input EncTicketPart variable.
36
37@var{flags}: flags to set in encticketpart.
38
39Set the EncTicketPart.flags to supplied value.
40
41@strong{Return value:} Returns @code{SHISHI_OK} iff successful.
42@end deftypefun
43
44@subheading shishi_encticketpart_crealm_set
45@anchor{shishi_encticketpart_crealm_set}
46@deftypefun {int} {shishi_encticketpart_crealm_set} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, const char * @var{realm})
47@var{handle}: shishi handle as allocated by @code{shishi_init()}.
48
49@var{encticketpart}: input EncTicketPart variable.
50
51@var{realm}: input array with name of realm.
52
53Set the realm field in the KDC-REQ.
54
55@strong{Return value:} Returns SHISHI_OK iff successful.
56@end deftypefun
57
58@subheading shishi_encticketpart_cname_set
59@anchor{shishi_encticketpart_cname_set}
60@deftypefun {int} {shishi_encticketpart_cname_set} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, Shishi_name_type @var{name_type}, const char * @var{principal})
61@var{handle}: shishi handle as allocated by @code{shishi_init()}.
62
63@var{encticketpart}: input EncTicketPart variable.
64
65@var{name_type}: type of principial, see Shishi_name_type, usually
66SHISHI_NT_UNKNOWN.
67
68@var{principal}: input array with principal name.
69
70Set the client name field in the EncTicketPart.
71
72@strong{Return value:} Returns SHISHI_OK iff successful.
73@end deftypefun
74
75@subheading shishi_encticketpart_transited_set
76@anchor{shishi_encticketpart_transited_set}
77@deftypefun {int} {shishi_encticketpart_transited_set} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, int32_t @var{trtype}, const char * @var{trdata}, size_t @var{trdatalen})
78@var{handle}: shishi handle as allocated by @code{shishi_init()}.
79
80@var{encticketpart}: input EncTicketPart variable.
81
82@var{trtype}: transitedencoding type, e.g. SHISHI_TR_DOMAIN_X500_COMPRESS.
83
84@var{trdata}: actual transited realm data.
85
86@var{trdatalen}: length of actual transited realm data.
87
88Set the EncTicketPart.transited field to supplied value.
89
90@strong{Return value:} Returns @code{SHISHI_OK} iff successful.
91@end deftypefun
92
93@subheading shishi_encticketpart_authtime_set
94@anchor{shishi_encticketpart_authtime_set}
95@deftypefun {int} {shishi_encticketpart_authtime_set} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, const char * @var{authtime})
96@var{handle}: shishi handle as allocated by @code{shishi_init()}.
97
98@var{encticketpart}: input EncTicketPart variable.
99
100@var{authtime}: character buffer containing a generalized time string.
101
102Set the EncTicketPart.authtime to supplied value.
103
104@strong{Return value:} Returns @code{SHISHI_OK} iff successful.
105@end deftypefun
106
107@subheading shishi_encticketpart_endtime_set
108@anchor{shishi_encticketpart_endtime_set}
109@deftypefun {int} {shishi_encticketpart_endtime_set} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, const char * @var{endtime})
110@var{handle}: shishi handle as allocated by @code{shishi_init()}.
111
112@var{encticketpart}: input EncTicketPart variable.
113
114@var{endtime}: character buffer containing a generalized time string.
115
116Set the EncTicketPart.endtime to supplied value.
117
118@strong{Return value:} Returns @code{SHISHI_OK} iff successful.
119@end deftypefun
120
121@subheading shishi_encticketpart_client
122@anchor{shishi_encticketpart_client}
123@deftypefun {int} {shishi_encticketpart_client} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, char ** @var{client}, size_t * @var{clientlen})
124@var{handle}: Shishi library handle create by @code{shishi_init()}.
125
126@var{encticketpart}: EncTicketPart variable to get client name from.
127
128@var{client}: pointer to newly allocated zero terminated string containing
129principal name.  May be @code{NULL} (to only populate @code{clientlen}).
130
131@var{clientlen}: pointer to length of @code{client} on output, excluding terminating
132zero.  May be @code{NULL} (to only populate @code{client}).
133
134Represent client principal name in EncTicketPart as zero-terminated
135string.  The string is allocate by this function, and it is the
136responsibility of the caller to deallocate it.  Note that the
137output length @code{clientlen} does not include the terminating zero.
138
139@strong{Return value:} Returns SHISHI_OK iff successful.
140@end deftypefun
141
142@subheading shishi_encticketpart_clientrealm
143@anchor{shishi_encticketpart_clientrealm}
144@deftypefun {int} {shishi_encticketpart_clientrealm} (Shishi * @var{handle}, Shishi_asn1 @var{encticketpart}, char ** @var{client}, size_t * @var{clientlen})
145@var{handle}: Shishi library handle create by @code{shishi_init()}.
146
147@var{encticketpart}: EncTicketPart variable to get client name and realm from.
148
149@var{client}: pointer to newly allocated zero terminated string containing
150principal name and realm.  May be @code{NULL} (to only populate @code{clientlen}).
151
152@var{clientlen}: pointer to length of @code{client} on output, excluding terminating
153zero.  May be @code{NULL} (to only populate @code{client}).
154
155Convert cname and realm fields from EncTicketPart to printable
156principal name format.  The string is allocate by this function,
157and it is the responsibility of the caller to deallocate it.  Note
158that the output length @code{clientlen} does not include the terminating
159zero.
160
161@strong{Return value:} Returns SHISHI_OK iff successful.
162@end deftypefun
163
164