gss_export_sec_context(3)				     Library Functions Manual					 gss_export_sec_context(3)

NAME

       gss_export_sec_context() - transfer a security context to another process on a single machine

SYNOPSIS

       DESCRIPTION
	      The  deactivates	the  security  context	for the calling process and creates an interprocess token which, when passed to in another
	      process, will re-activate the context in the second process.

       Only a single instantiation  of a given context may be active at any one time; a subsequent attempt by a context  exporter  to  access  the
       exported security context will fail.  is created such that it is functionally identical to the original context.

       If  creation  of  the  interprocess token is successful, the implementation shall deallocate all process-wide resources associated with the
       security context, and set the context_handle to The ability to transfer a security context is indicated when the context is created, by	or
       setting the bit in their ret_flags parameter.

   Input Parameters
       context_handle	     Specifies the context handle identifying the context to transfer.

       interprocess_token    Specifies the token to be transferred to target process.

   Output Parameters
       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 expired

       The supplied context handle did not refer to a valid context.

       The operation is not supported.

AUTHOR

       was developed by Sun Microsystems, Inc.

SEE ALSO

       gss_import_sec_context(3).

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

															 gss_export_sec_context(3)