1gss_import_sec_coGnetneexrti(c3GSSeSc)urity Services API Libragrsys_Fiumnpcotrito_nssec_context(3GSS)
2
3
4

NAME

6       gss_import_sec_context - import security context established by another
7       process
8

SYNOPSIS

10       cc [ flag... ] file... -lgss  [ library... ]
11       #include <gssapi/gssapi.h>
12
13       OM_uint32 gss_import_sec_context(OM_uint32 *minor_status,
14            const gss_buffer_t interprocess_token,gss_ctx_id_t *context_handle);
15
16

DESCRIPTION

18       The gss_import_sec_context() function allows  a  process  to  import  a
19       security  context  established by another process. A given interprocess
20       token can be imported only once. See gss_export_sec_context(3GSS).
21

PARAMETERS

23       The parameter descriptions for gss_import_sec_context() are as follows:
24
25       minor_status          A mechanism-specific status code.
26
27
28       interprocess_token    Token received from exporting process.
29
30
31       context_handle        Context  handle  of  newly  reactivated  context.
32                             Resources  associated  with  this  context handle
33                             must be released by  the  application  after  use
34                             with a call to gss_delete_sec_context(3GSS).
35
36

ERRORS

38       gss_import_sec_context() returns one of the following status codes:
39
40       GSS_S_COMPLETE           Successful completion.
41
42
43       GSS_S_NO_CONTEXT         The token did not contain a valid context ref‐
44                                erence.
45
46
47       GSS_S_DEFECTIVE_TOKEN    The token was invalid.
48
49
50       GSS_S_UNAVAILABLE        The operation is unavailable.
51
52
53       GSS_S_UNAUTHORIZED       Local policy prevents the import of this  con‐
54                                text by the current process.
55
56
57       GSS_S_FAILURE            The underlying mechanism detected an error for
58                                which no specific GSS status code is  defined.
59                                The mechanism-specific status code reported by
60                                means of the  minor_status  parameter  details
61                                the error condition.
62
63

ATTRIBUTES

65       See attributes(5) for descriptions of the following attributes:
66
67
68
69
70       ┌─────────────────────────────┬─────────────────────────────┐
71       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
72       ├─────────────────────────────┼─────────────────────────────┤
73       │Availability                 │SUNWgss (32-bit)             │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │                             │SUNWgssx (64-bit)            │
76       ├─────────────────────────────┼─────────────────────────────┤
77       │MT Level                     │Safe                         │
78       └─────────────────────────────┴─────────────────────────────┘
79

SEE ALSO

81       gss_accept_sec_context(3GSS),                   gss_context_time(3GSS),
82       gss_delete_sec_context(3GSS),             gss_export_sec_context(3GSS),
83       gss_init_sec_context(3GSS), gss_inquire_context(3GSS), gss_process_con‐
84       text_token(3GSS), gss_wrap_size_limit(3GSS), attributes(5)
85
86
87       Solaris Security for Developers Guide
88
89
90
91SunOS 5.11                        15 Jan 2003     gss_import_sec_context(3GSS)
Impressum