3party/libzmq
0
0
Fork 0
mirror of https://github.com/zeromq/libzmq.git synced 2024-12-28 16:15:23 +08:00
Code Issues Projects Releases Wiki Activity

Added comments to methods.

Browse Source
This commit is contained in:
Mike Gatny 2013-10-08 00:25:18 -05:00 committed by Chris Busbey
parent 3c414c4aac
commit 761508bf4b
1 changed files with 29 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
src/gssapi_mechanism_base.hpp
View File

@ -30,8 +30,9 @@ namespace zmq
class msg_t;
/// Commonalities between clients and servers are captured here.
/// For example, clients and server both need to produce and
/// process INITIATE and MESSAGE commands.
/// For example, clients and servers both need to produce and
/// process context-level GSSAPI tokens (via INITIATE commands)
/// and per-message GSSAPI tokens (via MESSAGE commands).
class gssapi_mechanism_base_t
{
public:
@ -39,51 +40,60 @@ namespace zmq
virtual ~gssapi_mechanism_base_t () = 0;
protected:
/// Produce an INITIATE during security context initialization
// Produce a context-level GSSAPI token (INITIATE command)
// during security context initialization.
int produce_initiate (msg_t *msg_, void *data_, size_t data_len_);
/// Process an INITIATE during security context initialization
// Process a context-level GSSAPI token (INITIATE command)
// during security context initialization.
int process_initiate (msg_t *msg_, void **data_, size_t &data_len_);
/// Encode a MESSAGE using the established security context
// Encode a per-message GSSAPI token (MESSAGE command) using
// the established security context.
int encode_message (msg_t *msg_);
/// Decode a MESSAGE using the established security context
// Decode a per-message GSSAPI token (MESSAGE command) using
// the established security context.
int decode_message (msg_t *msg_);
/// Acquire security context credentials
// Acquire security context credentials from the
// underlying mechanism.
static int acquire_credentials (char * service_name_,
gss_cred_id_t * cred_);
protected:
/// Opaque GSSAPI token for outgoing data
// Opaque GSSAPI token for outgoing data
gss_buffer_desc send_tok;
/// Opaque GSSAPI token for incoming data
// Opaque GSSAPI token for incoming data
gss_buffer_desc recv_tok;
/// Opaque GSSAPI representation of service_name
// Opaque GSSAPI representation of service_name
gss_name_t target_name;
/// Human-readable service principal name
// Human-readable service principal name
char * service_name;
/// Status code returned by GSSAPI functions
// Status code returned by GSSAPI functions
OM_uint32 maj_stat;
/// Status code returned by the underlying mechanism
// Status code returned by the underlying mechanism
OM_uint32 min_stat;
/// Status code returned by the underlying mechanism
/// during context initialization
// Status code returned by the underlying mechanism
// during context initialization
OM_uint32 init_sec_min_stat;
/// Flags returned by GSSAPI (ignored)
// Flags returned by GSSAPI (ignored)
OM_uint32 ret_flags;
/// Flags returned by GSSAPI (ignored)
// Flags returned by GSSAPI (ignored)
OM_uint32 gss_flags;
/// Credentials used to establish security context
// Credentials used to establish security context
gss_cred_id_t cred;
/// Opaque GSSAPI representation of the security context
// Opaque GSSAPI representation of the security context
gss_ctx_id_t context;
};