gssapi.h revision 178828
1/* 2 * Copyright (C) The Internet Society (2000). All Rights Reserved. 3 * 4 * This document and translations of it may be copied and furnished to 5 * others, and derivative works that comment on or otherwise explain it 6 * or assist in its implementation may be prepared, copied, published 7 * and distributed, in whole or in part, without restriction of any 8 * kind, provided that the above copyright notice and this paragraph are 9 * included on all such copies and derivative works. However, this 10 * document itself may not be modified in any way, such as by removing 11 * the copyright notice or references to the Internet Society or other 12 * Internet organizations, except as needed for the purpose of 13 * developing Internet standards in which case the procedures for 14 * copyrights defined in the Internet Standards process must be 15 * followed, or as required to translate it into languages other than 16 * English. 17 * 18 * The limited permissions granted above are perpetual and will not be 19 * revoked by the Internet Society or its successors or assigns. 20 * 21 * This document and the information contained herein is provided on an 22 * "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 23 * TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 24 * BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 25 * HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 26 * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 27 * 28 * $FreeBSD: head/include/gssapi/gssapi.h 178828 2008-05-07 13:53:12Z dfr $ 29 */ 30 31#ifndef _GSSAPI_GSSAPI_H_ 32#define _GSSAPI_GSSAPI_H_ 33 34/* 35 * First, include stddef.h to get size_t defined. 36 */ 37#include <stddef.h> 38 39/* 40 * Include stdint.h to get explicitly sized data types. 41 */ 42#include <stdint.h> 43 44#ifndef _SSIZE_T_DECLARED 45typedef __ssize_t ssize_t; 46#define _SSIZE_T_DECLARED 47#endif 48 49#if 0 50/* 51 * If the platform supports the xom.h header file, it should be 52 * included here. 53 */ 54#include <xom.h> 55#endif 56 57 58/* 59 * Now define the three implementation-dependent types. 60 */ 61typedef struct _gss_ctx_id_t *gss_ctx_id_t; 62typedef struct _gss_cred_id_t *gss_cred_id_t; 63typedef struct _gss_name_t *gss_name_t; 64 65/* 66 * The following type must be defined as the smallest natural 67 * unsigned integer supported by the platform that has at least 68 * 32 bits of precision. 69 */ 70typedef uint32_t gss_uint32; 71 72 73#ifdef OM_STRING 74/* 75 * We have included the xom.h header file. Verify that OM_uint32 76 * is defined correctly. 77 */ 78 79#if sizeof(gss_uint32) != sizeof(OM_uint32) 80#error Incompatible definition of OM_uint32 from xom.h 81#endif 82 83typedef OM_object_identifier gss_OID_desc, *gss_OID; 84 85#else 86 87/* 88 * We can't use X/Open definitions, so roll our own. 89 */ 90 91typedef gss_uint32 OM_uint32; 92 93typedef struct gss_OID_desc_struct { 94 OM_uint32 length; 95 void *elements; 96} gss_OID_desc, *gss_OID; 97 98#endif 99 100typedef struct gss_OID_set_desc_struct { 101 size_t count; 102 gss_OID elements; 103} gss_OID_set_desc, *gss_OID_set; 104 105typedef struct gss_buffer_desc_struct { 106 size_t length; 107 void *value; 108} gss_buffer_desc, *gss_buffer_t; 109 110typedef struct gss_channel_bindings_struct { 111 OM_uint32 initiator_addrtype; 112 gss_buffer_desc initiator_address; 113 OM_uint32 acceptor_addrtype; 114 gss_buffer_desc acceptor_address; 115 gss_buffer_desc application_data; 116} *gss_channel_bindings_t; 117 118/* 119 * For now, define a QOP-type as an OM_uint32 120 */ 121typedef OM_uint32 gss_qop_t; 122 123typedef int gss_cred_usage_t; 124 125/* 126 * Flag bits for context-level services. 127 */ 128#define GSS_C_DELEG_FLAG 1 129#define GSS_C_MUTUAL_FLAG 2 130#define GSS_C_REPLAY_FLAG 4 131#define GSS_C_SEQUENCE_FLAG 8 132#define GSS_C_CONF_FLAG 16 133#define GSS_C_INTEG_FLAG 32 134#define GSS_C_ANON_FLAG 64 135#define GSS_C_PROT_READY_FLAG 128 136#define GSS_C_TRANS_FLAG 256 137 138/* 139 * Credential usage options 140 */ 141#define GSS_C_BOTH 0 142#define GSS_C_INITIATE 1 143#define GSS_C_ACCEPT 2 144 145/* 146 * Status code types for gss_display_status 147 */ 148#define GSS_C_GSS_CODE 1 149#define GSS_C_MECH_CODE 2 150 151/* 152 * The constant definitions for channel-bindings address families 153 */ 154#define GSS_C_AF_UNSPEC 0 155#define GSS_C_AF_LOCAL 1 156#define GSS_C_AF_INET 2 157#define GSS_C_AF_IMPLINK 3 158#define GSS_C_AF_PUP 4 159#define GSS_C_AF_CHAOS 5 160#define GSS_C_AF_NS 6 161#define GSS_C_AF_NBS 7 162#define GSS_C_AF_ECMA 8 163#define GSS_C_AF_DATAKIT 9 164#define GSS_C_AF_CCITT 10 165#define GSS_C_AF_SNA 11 166#define GSS_C_AF_DECnet 12 167#define GSS_C_AF_DLI 13 168#define GSS_C_AF_LAT 14 169#define GSS_C_AF_HYLINK 15 170#define GSS_C_AF_APPLETALK 16 171#define GSS_C_AF_BSC 17 172#define GSS_C_AF_DSS 18 173#define GSS_C_AF_OSI 19 174#define GSS_C_AF_X25 21 175#define GSS_C_AF_NULLADDR 255 176 177/* 178 * Various Null values 179 */ 180#define GSS_C_NO_NAME ((gss_name_t) 0) 181#define GSS_C_NO_BUFFER ((gss_buffer_t) 0) 182#define GSS_C_NO_OID ((gss_OID) 0) 183#define GSS_C_NO_OID_SET ((gss_OID_set) 0) 184#define GSS_C_NO_CONTEXT ((gss_ctx_id_t) 0) 185#define GSS_C_NO_CREDENTIAL ((gss_cred_id_t) 0) 186#define GSS_C_NO_CHANNEL_BINDINGS ((gss_channel_bindings_t) 0) 187#define GSS_C_EMPTY_BUFFER {0, NULL} 188 189/* 190 * Some alternate names for a couple of the above 191 * values. These are defined for V1 compatibility. 192 */ 193#define GSS_C_NULL_OID GSS_C_NO_OID 194#define GSS_C_NULL_OID_SET GSS_C_NO_OID_SET 195 196/* 197 * Define the default Quality of Protection for per-message 198 * services. Note that an implementation that offers multiple 199 * levels of QOP may define GSS_C_QOP_DEFAULT to be either zero 200 * (as done here) to mean "default protection", or to a specific 201 * explicit QOP value. However, a value of 0 should always be 202 * interpreted by a GSS-API implementation as a request for the 203 * default protection level. 204 */ 205#define GSS_C_QOP_DEFAULT 0 206 207/* 208 * Expiration time of 2^32-1 seconds means infinite lifetime for a 209 * credential or security context 210 */ 211#define GSS_C_INDEFINITE 0xfffffffful 212 213/* 214 * The implementation must reserve static storage for a 215 * gss_OID_desc object containing the value 216 * {10, (void *)"\x2a\x86\x48\x86\xf7\x12" 217 * "\x01\x02\x01\x01"}, 218 * corresponding to an object-identifier value of 219 * {iso(1) member-body(2) United States(840) mit(113554) 220 * infosys(1) gssapi(2) generic(1) user_name(1)}. The constant 221 * GSS_C_NT_USER_NAME should be initialized to point 222 * to that gss_OID_desc. 223 */ 224extern gss_OID GSS_C_NT_USER_NAME; 225 226/* 227 * The implementation must reserve static storage for a 228 * gss_OID_desc object containing the value 229 * {10, (void *)"\x2a\x86\x48\x86\xf7\x12" 230 * "\x01\x02\x01\x02"}, 231 * corresponding to an object-identifier value of 232 * {iso(1) member-body(2) United States(840) mit(113554) 233 * infosys(1) gssapi(2) generic(1) machine_uid_name(2)}. 234 * The constant GSS_C_NT_MACHINE_UID_NAME should be 235 * initialized to point to that gss_OID_desc. 236 */ 237extern gss_OID GSS_C_NT_MACHINE_UID_NAME; 238 239/* 240 * The implementation must reserve static storage for a 241 * gss_OID_desc object containing the value 242 * {10, (void *)"\x2a\x86\x48\x86\xf7\x12" 243 * "\x01\x02\x01\x03"}, 244 * corresponding to an object-identifier value of 245 * {iso(1) member-body(2) United States(840) mit(113554) 246 * infosys(1) gssapi(2) generic(1) string_uid_name(3)}. 247 * The constant GSS_C_NT_STRING_UID_NAME should be 248 * initialized to point to that gss_OID_desc. 249 */ 250extern gss_OID GSS_C_NT_STRING_UID_NAME; 251 252/* 253 * The implementation must reserve static storage for a 254 * gss_OID_desc object containing the value 255 * {6, (void *)"\x2b\x06\x01\x05\x06\x02"}, 256 * corresponding to an object-identifier value of 257 * {iso(1) org(3) dod(6) internet(1) security(5) 258 * nametypes(6) gss-host-based-services(2)). The constant 259 * GSS_C_NT_HOSTBASED_SERVICE_X should be initialized to point 260 * to that gss_OID_desc. This is a deprecated OID value, and 261 * implementations wishing to support hostbased-service names 262 * should instead use the GSS_C_NT_HOSTBASED_SERVICE OID, 263 * defined below, to identify such names; 264 * GSS_C_NT_HOSTBASED_SERVICE_X should be accepted a synonym 265 * for GSS_C_NT_HOSTBASED_SERVICE when presented as an input 266 * parameter, but should not be emitted by GSS-API 267 * implementations 268 */ 269extern gss_OID GSS_C_NT_HOSTBASED_SERVICE_X; 270 271/* 272 * The implementation must reserve static storage for a 273 * gss_OID_desc object containing the value 274 * {10, (void *)"\x2a\x86\x48\x86\xf7\x12" 275 * "\x01\x02\x01\x04"}, corresponding to an 276 * object-identifier value of {iso(1) member-body(2) 277 * Unites States(840) mit(113554) infosys(1) gssapi(2) 278 * generic(1) service_name(4)}. The constant 279 * GSS_C_NT_HOSTBASED_SERVICE should be initialized 280 * to point to that gss_OID_desc. 281 */ 282extern gss_OID GSS_C_NT_HOSTBASED_SERVICE; 283 284/* 285 * The implementation must reserve static storage for a 286 * gss_OID_desc object containing the value 287 * {6, (void *)"\x2b\x06\01\x05\x06\x03"}, 288 * corresponding to an object identifier value of 289 * {1(iso), 3(org), 6(dod), 1(internet), 5(security), 290 * 6(nametypes), 3(gss-anonymous-name)}. The constant 291 * and GSS_C_NT_ANONYMOUS should be initialized to point 292 * to that gss_OID_desc. 293 */ 294extern gss_OID GSS_C_NT_ANONYMOUS; 295 296 297/* 298 * The implementation must reserve static storage for a 299 * gss_OID_desc object containing the value 300 * {6, (void *)"\x2b\x06\x01\x05\x06\x04"}, 301 * corresponding to an object-identifier value of 302 * {1(iso), 3(org), 6(dod), 1(internet), 5(security), 303 * 6(nametypes), 4(gss-api-exported-name)}. The constant 304 * GSS_C_NT_EXPORT_NAME should be initialized to point 305 * to that gss_OID_desc. 306 */ 307extern gss_OID GSS_C_NT_EXPORT_NAME; 308 309/* 310 * This name form shall be represented by the Object Identifier {iso(1) 311 * member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) 312 * krb5(2) krb5_name(1)}. The recommended symbolic name for this type 313 * is "GSS_KRB5_NT_PRINCIPAL_NAME". 314 */ 315extern gss_OID GSS_KRB5_NT_PRINCIPAL_NAME; 316 317/* 318 * This name form shall be represented by the Object Identifier {iso(1) 319 * member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) 320 * generic(1) user_name(1)}. The recommended symbolic name for this 321 * type is "GSS_KRB5_NT_USER_NAME". 322 */ 323extern gss_OID GSS_KRB5_NT_USER_NAME; 324 325/* 326 * This name form shall be represented by the Object Identifier {iso(1) 327 * member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) 328 * generic(1) machine_uid_name(2)}. The recommended symbolic name for 329 * this type is "GSS_KRB5_NT_MACHINE_UID_NAME". 330 */ 331extern gss_OID GSS_KRB5_NT_MACHINE_UID_NAME; 332 333/* 334 * This name form shall be represented by the Object Identifier {iso(1) 335 * member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) 336 * generic(1) string_uid_name(3)}. The recommended symbolic name for 337 * this type is "GSS_KRB5_NT_STRING_UID_NAME". 338 */ 339extern gss_OID GSS_KRB5_NT_STRING_UID_NAME; 340 341/* Major status codes */ 342 343#define GSS_S_COMPLETE 0 344 345/* 346 * Some "helper" definitions to make the status code macros obvious. 347 */ 348#define GSS_C_CALLING_ERROR_OFFSET 24 349#define GSS_C_ROUTINE_ERROR_OFFSET 16 350#define GSS_C_SUPPLEMENTARY_OFFSET 0 351#define GSS_C_CALLING_ERROR_MASK 0377ul 352#define GSS_C_ROUTINE_ERROR_MASK 0377ul 353#define GSS_C_SUPPLEMENTARY_MASK 0177777ul 354 355/* 356 * The macros that test status codes for error conditions. 357 * Note that the GSS_ERROR() macro has changed slightly from 358 * the V1 GSS-API so that it now evaluates its argument 359 * only once. 360 */ 361#define GSS_CALLING_ERROR(x) \ 362 (x & (GSS_C_CALLING_ERROR_MASK << GSS_C_CALLING_ERROR_OFFSET)) 363#define GSS_ROUTINE_ERROR(x) \ 364 (x & (GSS_C_ROUTINE_ERROR_MASK << GSS_C_ROUTINE_ERROR_OFFSET)) 365#define GSS_SUPPLEMENTARY_INFO(x) \ 366 (x & (GSS_C_SUPPLEMENTARY_MASK << GSS_C_SUPPLEMENTARY_OFFSET)) 367#define GSS_ERROR(x) \ 368 (x & ((GSS_C_CALLING_ERROR_MASK << GSS_C_CALLING_ERROR_OFFSET) | \ 369 (GSS_C_ROUTINE_ERROR_MASK << GSS_C_ROUTINE_ERROR_OFFSET))) 370 371/* 372 * Now the actual status code definitions 373 */ 374 375/* 376 * Calling errors: 377 */ 378#define GSS_S_CALL_INACCESSIBLE_READ \ 379(1ul << GSS_C_CALLING_ERROR_OFFSET) 380#define GSS_S_CALL_INACCESSIBLE_WRITE \ 381(2ul << GSS_C_CALLING_ERROR_OFFSET) 382#define GSS_S_CALL_BAD_STRUCTURE \ 383(3ul << GSS_C_CALLING_ERROR_OFFSET) 384 385/* 386 * Routine errors: 387 */ 388#define GSS_S_BAD_MECH (1ul << GSS_C_ROUTINE_ERROR_OFFSET) 389#define GSS_S_BAD_NAME (2ul << GSS_C_ROUTINE_ERROR_OFFSET) 390#define GSS_S_BAD_NAMETYPE (3ul << GSS_C_ROUTINE_ERROR_OFFSET) 391#define GSS_S_BAD_BINDINGS (4ul << GSS_C_ROUTINE_ERROR_OFFSET) 392#define GSS_S_BAD_STATUS (5ul << GSS_C_ROUTINE_ERROR_OFFSET) 393#define GSS_S_BAD_SIG (6ul << GSS_C_ROUTINE_ERROR_OFFSET) 394#define GSS_S_BAD_MIC GSS_S_BAD_SIG 395#define GSS_S_NO_CRED (7ul << GSS_C_ROUTINE_ERROR_OFFSET) 396#define GSS_S_NO_CONTEXT (8ul << GSS_C_ROUTINE_ERROR_OFFSET) 397#define GSS_S_DEFECTIVE_TOKEN (9ul << GSS_C_ROUTINE_ERROR_OFFSET) 398#define GSS_S_DEFECTIVE_CREDENTIAL (10ul << GSS_C_ROUTINE_ERROR_OFFSET) 399#define GSS_S_CREDENTIALS_EXPIRED (11ul << GSS_C_ROUTINE_ERROR_OFFSET) 400#define GSS_S_CONTEXT_EXPIRED (12ul << GSS_C_ROUTINE_ERROR_OFFSET) 401#define GSS_S_FAILURE (13ul << GSS_C_ROUTINE_ERROR_OFFSET) 402#define GSS_S_BAD_QOP (14ul << GSS_C_ROUTINE_ERROR_OFFSET) 403#define GSS_S_UNAUTHORIZED (15ul << GSS_C_ROUTINE_ERROR_OFFSET) 404#define GSS_S_UNAVAILABLE (16ul << GSS_C_ROUTINE_ERROR_OFFSET) 405#define GSS_S_DUPLICATE_ELEMENT (17ul << GSS_C_ROUTINE_ERROR_OFFSET) 406#define GSS_S_NAME_NOT_MN (18ul << GSS_C_ROUTINE_ERROR_OFFSET) 407 408/* 409 * Supplementary info bits: 410 */ 411#define GSS_S_CONTINUE_NEEDED \ 412 (1ul << (GSS_C_SUPPLEMENTARY_OFFSET + 0)) 413#define GSS_S_DUPLICATE_TOKEN \ 414 (1ul << (GSS_C_SUPPLEMENTARY_OFFSET + 1)) 415#define GSS_S_OLD_TOKEN \ 416 (1ul << (GSS_C_SUPPLEMENTARY_OFFSET + 2)) 417#define GSS_S_UNSEQ_TOKEN \ 418 (1ul << (GSS_C_SUPPLEMENTARY_OFFSET + 3)) 419#define GSS_S_GAP_TOKEN \ 420 (1ul << (GSS_C_SUPPLEMENTARY_OFFSET + 4)) 421 422/* 423 * Finally, function prototypes for the GSS-API routines. 424 */ 425OM_uint32 gss_acquire_cred 426 (OM_uint32 *, /* minor_status */ 427 const gss_name_t, /* desired_name */ 428 OM_uint32, /* time_req */ 429 const gss_OID_set, /* desired_mechs */ 430 gss_cred_usage_t, /* cred_usage */ 431 gss_cred_id_t *, /* output_cred_handle */ 432 gss_OID_set *, /* actual_mechs */ 433 OM_uint32 * /* time_rec */ 434 ); 435 436OM_uint32 gss_release_cred 437 (OM_uint32 *, /* minor_status */ 438 gss_cred_id_t * /* cred_handle */ 439 ); 440 441OM_uint32 gss_init_sec_context 442 (OM_uint32 *, /* minor_status */ 443 const gss_cred_id_t, /* initiator_cred_handle */ 444 gss_ctx_id_t *, /* context_handle */ 445 const gss_name_t, /* target_name */ 446 const gss_OID, /* mech_type */ 447 OM_uint32, /* req_flags */ 448 OM_uint32, /* time_req */ 449 const gss_channel_bindings_t, 450 /* input_chan_bindings */ 451 const gss_buffer_t, /* input_token */ 452 gss_OID *, /* actual_mech_type */ 453 gss_buffer_t, /* output_token */ 454 OM_uint32 *, /* ret_flags */ 455 OM_uint32 * /* time_rec */ 456 ); 457 458OM_uint32 gss_accept_sec_context 459 (OM_uint32 *, /* minor_status */ 460 gss_ctx_id_t *, /* context_handle */ 461 const gss_cred_id_t, /* acceptor_cred_handle */ 462 const gss_buffer_t, /* input_token_buffer */ 463 const gss_channel_bindings_t, 464 /* input_chan_bindings */ 465 gss_name_t *, /* src_name */ 466 gss_OID *, /* mech_type */ 467 gss_buffer_t, /* output_token */ 468 OM_uint32 *, /* ret_flags */ 469 OM_uint32 *, /* time_rec */ 470 gss_cred_id_t * /* delegated_cred_handle */ 471 ); 472 473OM_uint32 gss_process_context_token 474 (OM_uint32 *, /* minor_status */ 475 const gss_ctx_id_t, /* context_handle */ 476 const gss_buffer_t /* token_buffer */ 477 ); 478 479OM_uint32 gss_delete_sec_context 480 (OM_uint32 *, /* minor_status */ 481 gss_ctx_id_t *, /* context_handle */ 482 gss_buffer_t /* output_token */ 483 ); 484 485OM_uint32 gss_context_time 486 (OM_uint32 *, /* minor_status */ 487 const gss_ctx_id_t, /* context_handle */ 488 OM_uint32 * /* time_rec */ 489 ); 490 491OM_uint32 gss_get_mic 492 (OM_uint32 *, /* minor_status */ 493 const gss_ctx_id_t, /* context_handle */ 494 gss_qop_t, /* qop_req */ 495 const gss_buffer_t, /* message_buffer */ 496 gss_buffer_t /* message_token */ 497 ); 498 499OM_uint32 gss_verify_mic 500 (OM_uint32 *, /* minor_status */ 501 const gss_ctx_id_t, /* context_handle */ 502 const gss_buffer_t, /* message_buffer */ 503 const gss_buffer_t, /* token_buffer */ 504 gss_qop_t * /* qop_state */ 505 ); 506 507OM_uint32 gss_wrap 508 (OM_uint32 *, /* minor_status */ 509 const gss_ctx_id_t, /* context_handle */ 510 int, /* conf_req_flag */ 511 gss_qop_t, /* qop_req */ 512 const gss_buffer_t, /* input_message_buffer */ 513 int *, /* conf_state */ 514 gss_buffer_t /* output_message_buffer */ 515 ); 516 517OM_uint32 gss_unwrap 518 (OM_uint32 *, /* minor_status */ 519 const gss_ctx_id_t, /* context_handle */ 520 const gss_buffer_t, /* input_message_buffer */ 521 gss_buffer_t, /* output_message_buffer */ 522 int *, /* conf_state */ 523 gss_qop_t * /* qop_state */ 524 ); 525 526OM_uint32 gss_display_status 527 (OM_uint32 *, /* minor_status */ 528 OM_uint32, /* status_value */ 529 int, /* status_type */ 530 const gss_OID, /* mech_type */ 531 OM_uint32 *, /* message_context */ 532 gss_buffer_t /* status_string */ 533 ); 534 535OM_uint32 gss_indicate_mechs 536 (OM_uint32 *, /* minor_status */ 537 gss_OID_set * /* mech_set */ 538 ); 539 540OM_uint32 gss_compare_name 541 (OM_uint32 *, /* minor_status */ 542 const gss_name_t, /* name1 */ 543 const gss_name_t, /* name2 */ 544 int * /* name_equal */ 545 ); 546 547OM_uint32 gss_display_name 548 (OM_uint32 *, /* minor_status */ 549 const gss_name_t, /* input_name */ 550 gss_buffer_t, /* output_name_buffer */ 551 gss_OID * /* output_name_type */ 552 ); 553 554OM_uint32 gss_import_name 555 (OM_uint32 *, /* minor_status */ 556 const gss_buffer_t, /* input_name_buffer */ 557 const gss_OID, /* input_name_type */ 558 gss_name_t * /* output_name */ 559 ); 560 561OM_uint32 gss_export_name 562 (OM_uint32 *, /* minor_status */ 563 const gss_name_t, /* input_name */ 564 gss_buffer_t /* exported_name */ 565 ); 566 567OM_uint32 gss_release_name 568 (OM_uint32 *, /* minor_status */ 569 gss_name_t * /* input_name */ 570 ); 571 572OM_uint32 gss_release_buffer 573 (OM_uint32 *, /* minor_status */ 574 gss_buffer_t /* buffer */ 575 ); 576 577OM_uint32 gss_release_oid_set 578 (OM_uint32 *, /* minor_status */ 579 gss_OID_set * /* set */ 580 ); 581 582OM_uint32 gss_inquire_cred 583 (OM_uint32 *, /* minor_status */ 584 const gss_cred_id_t, /* cred_handle */ 585 gss_name_t *, /* name */ 586 OM_uint32 *, /* lifetime */ 587 gss_cred_usage_t *, /* cred_usage */ 588 gss_OID_set * /* mechanisms */ 589 ); 590 591OM_uint32 gss_inquire_context ( 592 OM_uint32 *, /* minor_status */ 593 const gss_ctx_id_t, /* context_handle */ 594 gss_name_t *, /* src_name */ 595 gss_name_t *, /* targ_name */ 596 OM_uint32 *, /* lifetime_rec */ 597 gss_OID *, /* mech_type */ 598 OM_uint32 *, /* ctx_flags */ 599 int *, /* locally_initiated */ 600 int * /* open */ 601 ); 602 603OM_uint32 gss_wrap_size_limit ( 604 OM_uint32 *, /* minor_status */ 605 const gss_ctx_id_t, /* context_handle */ 606 int, /* conf_req_flag */ 607 gss_qop_t, /* qop_req */ 608 OM_uint32, /* req_output_size */ 609 OM_uint32 * /* max_input_size */ 610 ); 611 612OM_uint32 gss_add_cred ( 613 OM_uint32 *, /* minor_status */ 614 const gss_cred_id_t, /* input_cred_handle */ 615 const gss_name_t, /* desired_name */ 616 const gss_OID, /* desired_mech */ 617 gss_cred_usage_t, /* cred_usage */ 618 OM_uint32, /* initiator_time_req */ 619 OM_uint32, /* acceptor_time_req */ 620 gss_cred_id_t *, /* output_cred_handle */ 621 gss_OID_set *, /* actual_mechs */ 622 OM_uint32 *, /* initiator_time_rec */ 623 OM_uint32 * /* acceptor_time_rec */ 624 ); 625 626OM_uint32 gss_inquire_cred_by_mech ( 627 OM_uint32 *, /* minor_status */ 628 const gss_cred_id_t, /* cred_handle */ 629 const gss_OID, /* mech_type */ 630 gss_name_t *, /* name */ 631 OM_uint32 *, /* initiator_lifetime */ 632 OM_uint32 *, /* acceptor_lifetime */ 633 gss_cred_usage_t * /* cred_usage */ 634 ); 635 636OM_uint32 gss_export_sec_context ( 637 OM_uint32 *, /* minor_status */ 638 gss_ctx_id_t *, /* context_handle */ 639 gss_buffer_t /* interprocess_token */ 640 ); 641 642OM_uint32 gss_import_sec_context ( 643 OM_uint32 *, /* minor_status */ 644 const gss_buffer_t, /* interprocess_token */ 645 gss_ctx_id_t * /* context_handle */ 646 ); 647 648OM_uint32 gss_create_empty_oid_set ( 649 OM_uint32 *, /* minor_status */ 650 gss_OID_set * /* oid_set */ 651 ); 652 653OM_uint32 gss_add_oid_set_member ( 654 OM_uint32 *, /* minor_status */ 655 const gss_OID, /* member_oid */ 656 gss_OID_set * /* oid_set */ 657 ); 658 659OM_uint32 gss_test_oid_set_member ( 660 OM_uint32 *, /* minor_status */ 661 const gss_OID, /* member */ 662 const gss_OID_set, /* set */ 663 int * /* present */ 664 ); 665 666OM_uint32 gss_inquire_names_for_mech ( 667 OM_uint32 *, /* minor_status */ 668 const gss_OID, /* mechanism */ 669 gss_OID_set * /* name_types */ 670 ); 671 672OM_uint32 gss_inquire_mechs_for_name ( 673 OM_uint32 *, /* minor_status */ 674 const gss_name_t, /* input_name */ 675 gss_OID_set * /* mech_types */ 676 ); 677 678OM_uint32 gss_canonicalize_name ( 679 OM_uint32 *, /* minor_status */ 680 const gss_name_t, /* input_name */ 681 const gss_OID, /* mech_type */ 682 gss_name_t * /* output_name */ 683 ); 684 685OM_uint32 gss_duplicate_name ( 686 OM_uint32 *, /* minor_status */ 687 const gss_name_t, /* src_name */ 688 gss_name_t * /* dest_name */ 689 ); 690 691/* 692 * The following routines are obsolete variants of gss_get_mic, 693 * gss_verify_mic, gss_wrap and gss_unwrap. They should be 694 * provided by GSS-API V2 implementations for backwards 695 * compatibility with V1 applications. Distinct entrypoints 696 * (as opposed to #defines) should be provided, both to allow 697 * GSS-API V1 applications to link against GSS-API V2 implementations, 698 * and to retain the slight parameter type differences between the 699 * obsolete versions of these routines and their current forms. 700 */ 701 702OM_uint32 gss_sign 703 (OM_uint32 *, /* minor_status */ 704 gss_ctx_id_t, /* context_handle */ 705 int, /* qop_req */ 706 gss_buffer_t, /* message_buffer */ 707 gss_buffer_t /* message_token */ 708 ); 709 710 711OM_uint32 gss_verify 712 (OM_uint32 *, /* minor_status */ 713 gss_ctx_id_t, /* context_handle */ 714 gss_buffer_t, /* message_buffer */ 715 gss_buffer_t, /* token_buffer */ 716 int * /* qop_state */ 717 ); 718 719OM_uint32 gss_seal 720 (OM_uint32 *, /* minor_status */ 721 gss_ctx_id_t, /* context_handle */ 722 int, /* conf_req_flag */ 723 int, /* qop_req */ 724 gss_buffer_t, /* input_message_buffer */ 725 int *, /* conf_state */ 726 gss_buffer_t /* output_message_buffer */ 727 ); 728 729 730OM_uint32 gss_unseal 731 (OM_uint32 *, /* minor_status */ 732 gss_ctx_id_t, /* context_handle */ 733 gss_buffer_t, /* input_message_buffer */ 734 gss_buffer_t, /* output_message_buffer */ 735 int *, /* conf_state */ 736 int * /* qop_state */ 737 ); 738 739/* 740 * Other extensions and helper functions. 741 */ 742 743int gss_oid_equal 744 (const gss_OID, /* first OID to compare */ 745 const gss_OID /* second OID to compare */ 746 ); 747 748OM_uint32 gss_release_oid 749 (OM_uint32 *, /* minor status */ 750 gss_OID * /* oid to free */ 751 ); 752 753OM_uint32 gss_decapsulate_token 754 (const gss_buffer_t, /* mechanism independent token */ 755 gss_OID, /* desired mechanism */ 756 gss_buffer_t /* decapsulated mechanism dependant token */ 757 ); 758 759OM_uint32 gss_encapsulate_token 760 (const gss_buffer_t, /* mechanism dependant token */ 761 gss_OID, /* desired mechanism */ 762 gss_buffer_t /* encapsulated mechanism independent token */ 763 ); 764 765OM_uint32 gss_duplicate_oid 766 (OM_uint32 *, /* minor status */ 767 const gss_OID, /* oid to copy */ 768 gss_OID * /* result */ 769 ); 770 771OM_uint32 gss_oid_to_str 772 (OM_uint32 *, /* minor status */ 773 gss_OID, /* oid to convert */ 774 gss_buffer_t /* buffer to contain string */ 775 ); 776 777typedef struct gss_buffer_set_desc_struct { 778 size_t count; 779 gss_buffer_desc *elements; 780} gss_buffer_set_desc, *gss_buffer_set_t; 781 782#define GSS_C_NO_BUFFER_SET ((gss_buffer_set_t) 0) 783 784OM_uint32 gss_create_empty_buffer_set 785 (OM_uint32 *, /* minor status */ 786 gss_buffer_set_t * /* location for new buffer set */ 787 ); 788 789OM_uint32 gss_add_buffer_set_member 790 (OM_uint32 *, /* minor status */ 791 gss_buffer_t, /* buffer to add */ 792 gss_buffer_set_t * /* set to add to */ 793 ); 794 795OM_uint32 gss_release_buffer_set 796 (OM_uint32 *, /* minor status */ 797 gss_buffer_set_t * /* set to release */ 798 ); 799 800OM_uint32 gss_inquire_sec_context_by_oid 801 (OM_uint32 *, /* minor_status */ 802 const gss_ctx_id_t, /* context_handle */ 803 const gss_OID, /* desired_object */ 804 gss_buffer_set_t * /* result */ 805 ); 806 807OM_uint32 gss_inquire_cred_by_oid 808 (OM_uint32 *, /* minor_status */ 809 const gss_cred_id_t, /* cred_handle */ 810 const gss_OID, /* desired_object */ 811 gss_buffer_set_t * /* result */ 812 ); 813 814OM_uint32 gss_set_sec_context_option 815 (OM_uint32 *, /* minor status */ 816 gss_ctx_id_t *, /* context */ 817 const gss_OID, /* option to set */ 818 const gss_buffer_t /* option value */ 819 ); 820 821OM_uint32 gss_set_cred_option 822 (OM_uint32 *, /* minor status */ 823 gss_cred_id_t *, /* cred */ 824 const gss_OID, /* option to set */ 825 const gss_buffer_t /* option value */ 826 ); 827 828OM_uint32 gss_pseudo_random 829 (OM_uint32 *, /* minor status */ 830 gss_ctx_id_t, /* context handle */ 831 int prf_key, /* XXX */ 832 const gss_buffer_t, /* data to seed generator */ 833 ssize_t, /* amount of data required */ 834 gss_buffer_t /* buffer for result */ 835 ); 836 837#endif /* _GSSAPI_GSSAPI_H_ */ 838