Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gssapi::status(3pm) [debian man page]

GSSAPI::Status(3pm)					User Contributed Perl Documentation				       GSSAPI::Status(3pm)

NAME
GSSAPI::Status - methods for handlings GSSAPI statuses SYNOPSIS
use GSSAPI; $status = GSSAPI::Status->new(GSS_S_COMPLETE, 0); if (GSS_ERROR($status->major)) { die "a horrible death"; } if (! $status) { # another way of writing the above die "a horrible death"; } $status = $some_GSSAPI->someop($args1, etc); if ($status) { foreach ($status->generic_message, $status->specific_message) { print "GSSAPI error: $_ "; } die "help me"; } DESCRIPTION
"GSSAPI::Status" objects are returned by most other GSSAPI operations. Such statuses consist of a GSSAPI generic code and, for most operations, a mechanism specific code. These numeric codes can be accessed via the methods "major" and "minor". The standard textual messages that go with the current status can be obtained via the "generic_message" and "specific_message" methods. Each of these returns a list of text which should presumably be displayed in order. The generic code part of a GSSAPI::Status is composed of three subfields that can be accessed with the "GSS_CALLING_ERROR", "GSS_ROUTINE_ERROR", and "GSS_SUPPLEMENTARY_INFO" functions. The returned values can be compared against the constants whose names start with "GSS_S_" if your code wants to handle particular errors itself. The "GSS_ERROR" function returns true if and only if the given generic code contains neither a calling error nor a routine error. When evaluated in a boolean context, a "GSSAPI::Status" object will be true if and only if the major status code is "GSS_S_COMPLETE". When evaluated in a string contect, a "GSSAPI::Status" object will return the generic and specific messages all joined together with newlines. This may or may not make "die $status" work usefully. BUGS
The base objects are currently implmented as a blessed C structure containing the major and minor status codes. It should probably be a blessed array or hash instead, thereby cutting down on the amount of C code involved and making it more flexible. AUTHOR
Philip Guenther <pguen@cpan.org> SEE ALSO
perl(1) RFC2743 perl v5.14.2 2008-02-02 GSSAPI::Status(3pm)

Check Out this Related Man Page

Error Construction(3)						globus gssapi error					     Error Construction(3)

NAME
Error Construction - Defines #define GLOBUS_ERROR_TYPE_GSSAPI Construct Error globus_object_t * globus_error_construct_gssapi_error (globus_module_descriptor_t *base_source, globus_object_t *base_cause, const OM_uint32 major_status, const OM_uint32 minor_status) Initialize Error globus_object_t * globus_error_initialize_gssapi_error (globus_object_t *error, globus_module_descriptor_t *base_source, globus_object_t *base_cause, const OM_uint32 major_status, const OM_uint32 minor_status) Detailed Description Create and initialize a Globus GSSAPI Error object. This section defines operations to create and initialize Globus GSSAPI Error objects. Define Documentation #define GLOBUS_ERROR_TYPE_GSSAPI Error type definition. Function Documentation globus_object_t* globus_error_construct_gssapi_error (globus_module_descriptor_t *base_source, globus_object_t *base_cause, const OM_uint32major_status, const OM_uint32minor_status) Allocate and initialize an error of type GLOBUS_ERROR_TYPE_GSSAPI. Parameters: base_source Pointer to the originating module. base_cause The error object causing the error. If this is the original error, this paramater may be NULL. major_status The GSSAPI major status minor_status The GSSAPI minor status Returns: The resulting error object. It is the user's responsibility to eventually free this object using globus_object_free(). A globus_result_t may be obtained by calling globus_error_put() on this object. globus_object_t* globus_error_initialize_gssapi_error (globus_object_t *error, globus_module_descriptor_t *base_source, globus_object_t *base_cause, const OM_uint32major_status, const OM_uint32minor_status) Initialize a previously allocated error of type GLOBUS_ERROR_TYPE_GSSAPI. Parameters: error The previously allocated error object. base_source Pointer to the originating module. base_cause The error object causing the error. If this is the original error this paramater may be NULL. major_status The GSSAPI major status minor_status The GSSAPI minor status Returns: The resulting error object. You may have to call globus_error_put() on this object before passing it on. Author Generated automatically by Doxygen for globus gssapi error from the source code. Version 4.1 Wed Jan 25 2012 Error Construction(3)
Man Page

Featured Tech Videos