librpc/idl/messaging.idl

   1 #include "idl_types.h"
   2
   3 import "server_id.idl";
   4
   5 /*
   6    IDL structures for messaging code
   7 */
   8
   9 [
  10   pointer_default(unique)
  11 ]
  12 interface messaging
  13 {
  14         const int MSG_TYPE_MASK = 0xFFFF;
  15
  16         typedef [v1_enum,public] enum {
  17
  18                 /* general messages */
  19                 MSG_DEBUG                       = 0x0001,
  20                 MSG_PING                        = 0x0002,
  21                 MSG_PONG                        = 0x0003,
  22                 MSG_PROFILE                     = 0x0004,
  23                 MSG_REQ_DEBUGLEVEL              = 0x0005,
  24                 MSG_DEBUGLEVEL                  = 0x0006,
  25                 MSG_REQ_PROFILELEVEL            = 0x0007,
  26                 MSG_PROFILELEVEL                = 0x0008,
  27                 MSG_REQ_POOL_USAGE              = 0x0009,
  28                 MSG_POOL_USAGE                  = 0x000A,
  29
  30                 /* If dmalloc is included, set a steady-state mark */
  31                 MSG_REQ_DMALLOC_MARK            = 0x000B,
  32
  33                 /* If dmalloc is included, dump to the dmalloc log a description of
  34                  * what has changed since the last MARK */
  35                 MSG_REQ_DMALLOC_LOG_CHANGED     = 0x000C,
  36                 MSG_SHUTDOWN                    = 0x000D,
  37
  38                 /* ID_CACHE_FLUSH               = 0x000E, obsoleted */
  39                 ID_CACHE_DELETE                 = 0x000F,
  40                 ID_CACHE_KILL                   = 0x0010,
  41
  42                 /* Changes to smb.conf are really of general interest */
  43                 MSG_SMB_CONF_UPDATED            = 0x0021,
  44
  45                 MSG_PREFORK_CHILD_EVENT         = 0x0031,
  46                 MSG_PREFORK_PARENT_EVENT        = 0x0032,
  47
  48                 MSG_REQ_RINGBUF_LOG             = 0x0033,
  49                 MSG_RINGBUF_LOG                 = 0x0034,
  50
  51                 MSG_DAEMON_READY_FD             = 0x0035,
  52
  53                 /* nmbd messages */
  54                 MSG_FORCE_ELECTION              = 0x0101,
  55                 MSG_WINS_NEW_ENTRY              = 0x0102,
  56                 MSG_SEND_PACKET                 = 0x0103,
  57
  58                 /* printing messages */
  59                 /* MSG_PRINTER_NOTIFY           = 0x2001,  Obsoleted */
  60                 MSG_PRINTER_NOTIFY2             = 0x0202,
  61                 MSG_PRINTER_DRVUPGRADE          = 0x0203,
  62                 MSG_PRINTERDATA_INIT_RESET      = 0x0204,
  63                 MSG_PRINTER_UPDATE              = 0x0205,
  64                 MSG_PRINTER_MOD                 = 0x0206,
  65                 MSG_PRINTER_PCAP                = 0x0207,
  66
  67                 /* smbd messages */
  68                 /* MSG_SMB_CONF_UPDATED         = 0x0301,  Obsoleted */
  69                 MSG_SMB_FORCE_TDIS              = 0x0302,
  70                 /* MSG_SMB_SAM_SYNC             = 0x0303,  Obsoleted */
  71                 /* MSG_SMB_SAM_REPL             = 0x0304,  Obsoleted */
  72                 /* MSG_SMB_UNLOCK               = 0x0305,  Obsoleted */
  73                 MSG_SMB_BREAK_REQUEST           = 0x0306,
  74                 /* MSG_SMB_BREAK_RESPONSE       = 0x0307,  Obsoleted */
  75                 /* MSG_SMB_ASYNC_LEVEL2_BREAK   = 0x0308,  Obsoleted */
  76                 /* MSG_SMB_OPEN_RETRY           = 0x0309,  Obsoleted */
  77                 MSG_SMB_KERNEL_BREAK            = 0x030A,
  78                 MSG_SMB_FILE_RENAME             = 0x030B,
  79                 MSG_SMB_INJECT_FAULT            = 0x030C,
  80                 MSG_SMB_BLOCKING_LOCK_CANCEL    = 0x030D,
  81                 MSG_SMB_NOTIFY                  = 0x030E,
  82                 /* MSG_SMB_STAT_CACHE_DELETE    = 0x030F,  Obsoleted */
  83
  84                 /* Samba4 compatibility */
  85                 MSG_PVFS_NOTIFY                 = 0x0310,
  86
  87                 /* cluster reconfigure events */
  88                 /* MSG_SMB_BRL_VALIDATE         = 0x0311,  Oboleted */
  89
  90                 /*Close a specific file given a share entry. */
  91                 MSG_SMB_CLOSE_FILE              = 0x0313,
  92
  93                 /* Trigger a notify cleanup run */
  94                 MSG_SMB_NOTIFY_CLEANUP          = 0x0314,
  95                 MSG_SMB_SCAVENGER               = 0x0315,
  96
  97                 /* shutdown connection for given client */
  98                 MSG_SMB_KILL_CLIENT_IP          = 0x0316,
  99
 100                 /* Tell number of child processes */
 101                 MSG_SMB_TELL_NUM_CHILDREN       = 0x0317,
 102                 MSG_SMB_NUM_CHILDREN            = 0x0318,
 103
 104                 /* Cancel a notify, directory got deleted */
 105                 MSG_SMB_NOTIFY_CANCEL_DELETED   = 0x0319,
 106
 107                 /* notifyd messages */
 108                 MSG_SMB_NOTIFY_REC_CHANGE       = 0x031A,
 109                 MSG_SMB_NOTIFY_TRIGGER          = 0x031B,
 110                 MSG_SMB_NOTIFY_GET_DB           = 0x031C,
 111                 MSG_SMB_NOTIFY_DB               = 0x031D,
 112                 MSG_SMB_NOTIFY_REC_CHANGES      = 0x031E,
 113                 MSG_SMB_NOTIFY_STARTED          = 0x031F,
 114                 MSG_SMB_SLEEP                   = 0x0320,
 115
 116                 /* smbd message */
 117                 MSG_SMB_FORCE_TDIS_DENIED       = 0x0321,
 118
 119                 /* winbind messages */
 120                 MSG_WINBIND_FINISHED            = 0x0401,
 121                 MSG_WINBIND_FORGET_STATE        = 0x0402,
 122                 MSG_WINBIND_ONLINE              = 0x0403,
 123                 MSG_WINBIND_OFFLINE             = 0x0404,
 124                 MSG_WINBIND_ONLINESTATUS        = 0x0405,
 125
 126                 MSG_WINBIND_VALIDATE_CACHE      = 0x0408,
 127                 MSG_WINBIND_DUMP_DOMAIN_LIST    = 0x0409,
 128                 MSG_WINBIND_IP_DROPPED          = 0x040A,
 129                 MSG_WINBIND_DOMAIN_ONLINE       = 0x040B,
 130                 MSG_WINBIND_DOMAIN_OFFLINE      = 0x040C,
 131                 MSG_WINBIND_RELOAD_TRUSTED_DOMAINS = 0x040D,
 132                 MSG_WINBIND_DISCONNECT_DC       = 0x040E,
 133
 134                 /* event messages */
 135                 /* MSG_DUMP_EVENT_LIST          = 0x0500, Obsoleted */
 136
 137                 /* smbXsrv messages */
 138                 MSG_SMBXSRV_SESSION_CLOSE       = 0x0600,
 139                 MSG_SMBXSRV_CONNECTION_PASS     = 0x0601,
 140                 MSG_SMBXSRV_CONNECTION_PASSED   = 0x0602,
 141                 MSG_SMBXSRV_CONNECTION_DROP     = 0x0603,
 142
 143                 /* source4 and NTVFS smb server messages */
 144                 MSG_BRL_RETRY                   = 0x0700,
 145                 MSG_PVFS_RETRY_OPEN             = 0x0701,
 146                 MSG_IRPC                        = 0x0702,
 147                 MSG_NTVFS_OPLOCK_BREAK          = 0x0703,
 148                 MSG_DREPL_ALLOCATE_RID          = 0x0704,
 149
 150                 /*
 151                  * Audit, Authentication and Authorisation event
 152                  * messages
 153                  */
 154                 MSG_AUTH_LOG                    = 0x0800,
 155                 MSG_DSDB_LOG                    = 0x0801,
 156                 MSG_DSDB_PWD_LOG                = 0x0802,
 157                 MSG_GROUP_LOG                   = 0x0803,
 158
 159                 /* dbwrap messages 4001-4999 (0x0FA0 - 0x1387) */
 160                 /* MSG_DBWRAP_TDB2_CHANGES              = 4001, */
 161                 /* MSG_DBWRAP_G_LOCK_RETRY              = 4002, */
 162                 MSG_DBWRAP_MODIFIED             = 4003,
 163
 164                 MSG_RPC_HOST_NEW_CLIENT         = 4004,
 165                 MSG_RPC_WORKER_STATUS           = 4005,
 166                 MSG_RPC_DUMP_STATUS             = 4006,
 167
 168                 /*
 169                  * source4 allows new messages to be registered at
 170                  * runtime (currently used in python bindings and in
 171                  * smbtorture). Temporary messaging endpoints are
 172                  * allocated above this line
 173                  */
 174                 MSG_TMP_BASE                    = 0xF000
 175         } messaging_type;
 176
 177         /* messaging struct sent across the sockets and stored in the tdb */
 178
 179         typedef [public] struct {
 180                 [skip] messaging_rec *prev;
 181                 [skip] messaging_rec *next;
 182                 uint32 msg_version;
 183                 messaging_type msg_type;
 184                 server_id dest;
 185                 server_id src;
 186                 DATA_BLOB buf;
 187                 uint8 num_fds;
 188                 dlong fds[num_fds];
 189         } messaging_rec;
 190
 191         typedef [public] struct {
 192                 hyper rec_index;
 193                 uint32 num_recs;
 194                 messaging_rec *recs[num_recs];
 195         } messaging_reclog;
 196
 197         /* This allows this well known service name to be referenced in python and C */
 198         const string AUTH_EVENT_NAME  = "auth_event";
 199         const string DSDB_EVENT_NAME = "dsdb_event";
 200         const string DSDB_PWD_EVENT_NAME   = "dsdb_password_event";
 201         const string DSDB_GROUP_EVENT_NAME = "dsdb_group_event";
 202 }