gss_wrap(3)						     Library Functions Manual						       gss_wrap(3)

NAME

       gss_wrap() - attach a message integrity code (MIC) to a message, and optionally encrypt the message content

SYNOPSIS


DESCRIPTION

       The  routine  attaches a cryptographic message integrity code (MIC) and optionally encrypts the input_message.  The output_message contains
       both the MIC and the message.

       Although the qop_req parameter enables a choice between several qualities of protection, if you specify an unsupported protection, the rou-
       tine returns a status of

   Input Parameters
       context_handle	     Specifies the context on which the message is sent.

       conf_req_flag	     Specifies the requested level of confidentiality and integrity services, as follows:

			     Non-zero	 Both confidentiality and integrity services are requested.

			     Zero	 Only integrity services are requested.

       qop_req		     Specifies	the  cryptographic  algorithm, or quality of protection.  A mechanism-specific default may be requested by
			     setting qop_req to

       input_message_buffer  Specifies the message to be protected.

   Output Parameters
       conf_state	     Returns the requested level of confidentiality and integrity services, as follows:

			     Non-zero	 Confidentiality, data origin, authentication, and integrity services have been applied.

			     Zero	 Only integrity and data origin services have been applied.

       output_message_buffer Returns the buffer to receive the protected message.

       minor_status	     Returns a status code from the security mechanism.

STATUS CODES

       The following status codes can be returned:

       The routine was completed successfully.

       The context has already expired.

       The context is recognized but the associated
				credentials have expired.

       The routine failed. Check the
				minor_status parameter for details.

       The context identified in the
				context_handle parameter was not valid.

       The specified QOP is not supported by the mechanism.

AUTHOR

       was developed by Sun Microsystems, Inc.

SEE ALSO

       gss_unwrap(3), gss_wrap_size_limit(3).

       The manpages for DCE-GSSAPI are included with the DCE-CoreTools product.  To see those manpages add to

																       gss_wrap(3)