1GSSAPI::Status(3)     User Contributed Perl Documentation    GSSAPI::Status(3)
2
3
4

NAME

6       GSSAPI::Status - methods for handlings GSSAPI statuses
7

SYNOPSIS

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

DESCRIPTION

29       "GSSAPI::Status" objects are returned by most other GSSAPI operations.
30       Such statuses consist of a GSSAPI generic code and, for most opera‐
31       tions, a mechanism specific code.  These numeric codes can be accessed
32       via the methods "major" and "minor".  The standard textual messages
33       that go with the current status can be obtained via the "generic_mes‐
34       sage" and "specific_message" methods.  Each of these returns a list of
35       text which should presumably be displayed in order.
36
37       The generic code part of a GSSAPI::Status is composed of three sub‐
38       fields that can be accessed with the "GSS_CALLING_ERROR", "GSS_ROU‐
39       TINE_ERROR", and "GSS_SUPPLEMENTARY_INFO" functions.  The returned val‐
40       ues can be compared against the constants whose names start with
41       "GSS_S_" if your code wants to handle particular errors itself.  The
42       "GSS_ERROR" function returns true if and only if the given generic code
43       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 new‐
50       lines.  This may or may not make "die $status" work usefully.
51

BUGS

53       The base objects are currently implmented as a blessed C structure con‐
54       taining 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

AUTHOR

59       Philip Guenther <pguen@cpan.org>
60

SEE ALSO

62       perl(1) RFC2743
63
64
65
66perl v5.8.8                       2007-02-16                 GSSAPI::Status(3)
Impressum