source3/librpc/idl/rpc_host.idl

   1 /**
   2  * @file rpc_host.idl
   3  *
   4  * Definitions for communication between samba-dcerpcd and rpc helper
   5  * daemons
   6  */
   7 #include "idl_types.h"
   8
   9 import "named_pipe_auth.idl";
  10 import "dcerpc.idl";
  11
  12 [
  13         pointer_default(unique)
  14 ]
  15
  16 interface rpc_host_msg
  17 {
  18         /**
  19          * @brief MSG_RPC_HOST_NEW_CLIENT: samba-dcerpcd->rpcd
  20          *
  21          * samba-dcerpcd to rpcd msg announcing a new client. This
  22          * will carry a file descriptor representing the new
  23          * connection
  24          */
  25         typedef [public] struct {
  26                 /**
  27                  * @brief The binding the client wants to connect to
  28                  */
  29                 [string,charset(UTF8)] char *binding;
  30
  31                 /**
  32                  * @brief Auth info inherited from SMB
  33                  */
  34                 named_pipe_auth_req_info5 *npa_info5;
  35
  36                 /**
  37                  * @brief Raw bind PDU
  38                  *
  39                  * Already read from the socket by samba-dcerpcd
  40                  */
  41                 DATA_BLOB bind_packet;
  42         } rpc_host_client;
  43
  44         /**
  45          * @brief MSG_RPC_WORKER_STATUS: rpcd->samba-dcerpcd
  46          *
  47          * Once a client has been handed over from samba-dcerpcd to an
  48          * rpcd, samba-dcerpc has no control over this socket
  49          * anymore. So it can't know when the client exits and the
  50          * rpcd helper process has a slot free. Thus whenever a client
  51          * exits, rpcd sends this message up to samba-dcerpc for a
  52          * status update.
  53          */
  54         typedef [flag(NDR_NOALIGN),public] struct {
  55                 /**
  56                  * @brief Which rpc service is this message from
  57                  *
  58                  * samba-dcerpcd will only have the source pid of this
  59                  * message. To avoid a walk through all arrays with
  60                  * all rpcd helpers, give samba-dcerpcd a hint where
  61                  * in its arrays to find the rpcd that sent this
  62                  * message.
  63                  */
  64                 uint8 server_index;
  65
  66                 /**
  67                  * @brief Which of the processes of a helper prog is this from
  68                  */
  69                 uint8 worker_index;
  70
  71                 /**
  72                  * @brief How many clients this process serves right now
  73                  */
  74                 uint32 num_clients;
  75         } rpc_worker_status;
  76 }