crypto/external/bsd/heimdal/dist/lib/ipc/heim-ipc.h

   1 /*      $NetBSD: heim-ipc.h,v 1.1.1.1 2011/04/13 18:15:28 elric Exp $   */
   2
   3 /*
   4  * Copyright (c) 2009 Kungliga Tekniska Högskolan
   5  * (Royal Institute of Technology, Stockholm, Sweden).
   6  * All rights reserved.
   7  *
   8  * Portions Copyright (c) 2009 Apple Inc. All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions
  12  * are met:
  13  *
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions and the following disclaimer.
  16  *
  17  * 2. Redistributions in binary form must reproduce the above copyright
  18  *    notice, this list of conditions and the following disclaimer in the
  19  *    documentation and/or other materials provided with the distribution.
  20  *
  21  * 3. Neither the name of the Institute nor the names of its contributors
  22  *    may be used to endorse or promote products derived from this software
  23  *    without specific prior written permission.
  24  *
  25  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
  26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  27  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  28  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
  29  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  30  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  31  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  32  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  33  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  34  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  35  * SUCH DAMAGE.
  36  */
  37
  38 #include <krb5/asn1-common.h>
  39
  40 typedef struct heim_ipc *heim_ipc;
  41 typedef struct heim_sipc *heim_sipc;
  42 typedef struct heim_icred *heim_icred;
  43 typedef struct heim_isemaphore *heim_isemaphore;
  44 typedef struct heim_octet_string heim_idata;
  45 typedef struct heim_sipc_call *heim_sipc_call;
  46
  47 /* common */
  48
  49 void
  50 heim_ipc_free_cred(heim_icred);
  51
  52 uid_t
  53 heim_ipc_cred_get_uid(heim_icred);
  54
  55 gid_t
  56 heim_ipc_cred_get_gid(heim_icred);
  57
  58 pid_t
  59 heim_ipc_cred_get_pid(heim_icred);
  60
  61 pid_t
  62 heim_ipc_cred_get_session(heim_icred);
  63
  64 void
  65 heim_ipc_main(void);
  66
  67 heim_isemaphore
  68 heim_ipc_semaphore_create(long);
  69
  70 long
  71 heim_ipc_semaphore_wait(heim_isemaphore, time_t);
  72
  73 long
  74 heim_ipc_semaphore_signal(heim_isemaphore);
  75
  76 void
  77 heim_ipc_semaphore_release(heim_isemaphore);
  78
  79 #define HEIM_IPC_WAIT_FOREVER ((time_t)-1)
  80
  81 void
  82 heim_ipc_free_data(heim_idata *);
  83
  84 /* client */
  85
  86 int
  87 heim_ipc_init_context(const char *, heim_ipc *);
  88
  89 void
  90 heim_ipc_free_context(heim_ipc);
  91
  92 int
  93 heim_ipc_call(heim_ipc, const heim_idata *, heim_idata *, heim_icred *);
  94
  95 int
  96 heim_ipc_async(heim_ipc, const heim_idata *, void *, void (*func)(void *, int, heim_idata *, heim_icred));
  97
  98 /* server */
  99
 100 #define HEIM_SIPC_TYPE_IPC              1
 101 #define HEIM_SIPC_TYPE_UINT32           2
 102 #define HEIM_SIPC_TYPE_HTTP             4
 103
 104 typedef void
 105 (*heim_ipc_complete)(heim_sipc_call, int, heim_idata *);
 106
 107 typedef void
 108 (*heim_ipc_callback)(void *, const heim_idata *,
 109                      const heim_icred, heim_ipc_complete, heim_sipc_call);
 110
 111
 112 int
 113 heim_sipc_launchd_mach_init(const char *, heim_ipc_callback,
 114                             void *, heim_sipc *);
 115
 116 int
 117 heim_sipc_stream_listener(int, int, heim_ipc_callback,
 118                           void *, heim_sipc *);
 119
 120 int
 121 heim_sipc_service_unix(const char *, heim_ipc_callback,
 122                        void *, heim_sipc *);
 123
 124
 125 void
 126 heim_sipc_timeout(time_t);
 127
 128 void
 129 heim_sipc_set_timeout_handler(void (*)(void));
 130
 131 void
 132 heim_sipc_free_context(heim_sipc);