1GSSAPI::Status(3) User Contributed Perl Documentation GSSAPI::Status(3)
2
3
4
6 GSSAPI::Status - methods for handlings GSSAPI statuses
7
9 use GSSAPI;
10
11 $status = GSSAPI::Status->new(GSS_S_COMPLETE, 0);
12
13 if (GSS_ERROR($status->major)) {
14 die "a horrible death";
15 }
16 if (! $status) { # another way of writing the above
17 die "a horrible death";
18 }
19
20 $status = $some_GSSAPI->someop($args1, etc);
21 if ($status) {
22 foreach ($status->generic_message, $status->specific_message) {
23 print "GSSAPI error: $_\n";
24 }
25 die "help me";
26 }
27
29 "GSSAPI::Status" objects are returned by most other GSSAPI operations.
30 Such statuses consist of a GSSAPI generic code and, for most
31 operations, a mechanism specific code. These numeric codes can be
32 accessed via the methods "major" and "minor". The standard textual
33 messages that go with the current status can be obtained via the
34 "generic_message" and "specific_message" methods. Each of these
35 returns a list of text which should presumably be displayed in order.
36
37 The generic code part of a GSSAPI::Status is composed of three
38 subfields that can be accessed with the "GSS_CALLING_ERROR",
39 "GSS_ROUTINE_ERROR", and "GSS_SUPPLEMENTARY_INFO" functions. The
40 returned values can be compared against the constants whose names start
41 with "GSS_S_" if your code wants to handle particular errors itself.
42 The "GSS_ERROR" function returns true if and only if the given generic
43 code contains neither a calling error nor a routine error.
44
45 When evaluated in a boolean context, a "GSSAPI::Status" object will be
46 true if and only if the major status code is "GSS_S_COMPLETE".
47
48 When evaluated in a string contect, a "GSSAPI::Status" object will
49 return the generic and specific messages all joined together with
50 newlines. This may or may not make "die $status" work usefully.
51
53 The base objects are currently implmented as a blessed C structure
54 containing the major and minor status codes. It should probably be a
55 blessed array or hash instead, thereby cutting down on the amount of C
56 code involved and making it more flexible.
57
59 Philip Guenther <pguen@cpan.org>
60
62 perl(1) RFC2743
63
64
65
66perl v5.36.0 2023-01-20 GSSAPI::Status(3)