*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> gss_export_sec_context (3)              


 gss_export_sec_context(3)                         gss_export_sec_context(3)

 NAME    [Toc]    [Back]
      gss_export_sec_context() - transfer a security context to another
      process on a single machine

 SYNOPSIS    [Toc]    [Back]
      #include <gssapi.h>

      OM_uint32  gss_export_sec_context (
                OM_uint32 *minor_status,
                gss_ctx_id_t *context_handle,
                gss_buffer_t interprocess_token)

 DESCRIPTION    [Toc]    [Back]
      The gss_export_sec_context() deactivates the security context for the
      calling process and creates an interprocess token which, when passed
      to gss_import_sec_context() 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.  gss_ctx_id_t 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
      GSS_C_NO_CONTEXT.  The ability to transfer a security context is
      indicated when the context is created, by gss_init_sec_context() or
      gss_accept_sec_context() setting the GSS_C_TRANS_FLAG bit in their
      ret_flags parameter.

    Input Parameters    [Toc]    [Back]
      context_handle        Specifies the context handle identifying the
                            context to transfer.

      interprocess_token    Specifies the token to be transferred to target

    Output Parameters    [Toc]    [Back]
      minor_status          Returns a status code from the security

 STATUS CODES    [Toc]    [Back]
      The following status codes can be returned:

      GSS_S_COMPLETE           The routine was completed successfully.

      GSS_S_CONTEXT_EXPIRED    The context has expired

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

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 gss_export_sec_context(3)                         gss_export_sec_context(3)

      GSS_S_UNAVAILABLE        The operation is not supported.

 AUTHOR    [Toc]    [Back]
      gss_export_sec_context() was developed by Sun Microsystems, Inc.

 SEE ALSO    [Toc]    [Back]

      The manpages for DCE-GSSAPI are included with the DCE-CoreTools
      product.  To see those manpages add /opt/dce/share/man to MANPATH.

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
gss_export_sec_context Tru64 Prepare security context for transfer to another process.
gss_process_context_token HP-UX process a context to the security service
gss_import_sec_context Tru64 Import a security context established by another process.
gss_init_sec_context HP-UX establish a security context between the context initiator and a context acceptor
slamch IRIX determine single precision machine parameters
gss_accept_sec_context HP-UX establish a security context between the application and a context acceptor
dmicsend IRIX transfer input to the image converter context
sulogin Tru64 single-user login program (Enhanced Security)
Getopt::Std IRIX Process single-character switches with switch clustering
gss_delete_sec_context HP-UX delete a security context
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service