1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-27 03:21:53 +03:00
samba-mirror/source3/librpc/idl/messaging.idl

135 lines
3.4 KiB
Plaintext
Raw Normal View History

#include "idl_types.h"
import "server_id.idl";
/*
IDL structures for messaging code
*/
[
pointer_default(unique)
]
interface messaging
{
const int MSG_TYPE_MASK = 0xFFFF;
typedef [v1_enum,public] enum {
/* general messages */
MSG_DEBUG = 0x0001,
MSG_PING = 0x0002,
MSG_PONG = 0x0003,
MSG_PROFILE = 0x0004,
MSG_REQ_DEBUGLEVEL = 0x0005,
MSG_DEBUGLEVEL = 0x0006,
MSG_REQ_PROFILELEVEL = 0x0007,
MSG_PROFILELEVEL = 0x0008,
MSG_REQ_POOL_USAGE = 0x0009,
MSG_POOL_USAGE = 0x000A,
/* If dmalloc is included, set a steady-state mark */
MSG_REQ_DMALLOC_MARK = 0x000B,
/* If dmalloc is included, dump to the dmalloc log a description of
* what has changed since the last MARK */
MSG_REQ_DMALLOC_LOG_CHANGED = 0x000C,
MSG_SHUTDOWN = 0x000D,
MSG_IDMAP_FLUSH = 0x000E,
MSG_IDMAP_DELETE = 0x000F,
MSG_IDMAP_KILL = 0x0010,
/* Changes to smb.conf are really of general interest */
MSG_SMB_CONF_UPDATED = 0x0021,
/* nmbd messages */
MSG_FORCE_ELECTION = 0x0101,
MSG_WINS_NEW_ENTRY = 0x0102,
MSG_SEND_PACKET = 0x0103,
/* printing messages */
/* MSG_PRINTER_NOTIFY = 0x2001, Obsoleted */
MSG_PRINTER_NOTIFY2 = 0x0202,
MSG_PRINTER_DRVUPGRADE = 0x0203,
MSG_PRINTERDATA_INIT_RESET = 0x0204,
MSG_PRINTER_UPDATE = 0x0205,
MSG_PRINTER_MOD = 0x0206,
s3-printing: Initiate pcap reload from parent smbd Since commit 7022554, smbds share a printcap cache (printer_list.tdb), therefore ordering of events between smbd processes is important when updating printcap cache information. Consider the following two process example: 1) smbd1 receives HUP or printcap cache time expiry 2) smbd1 checks whether pcap needs refresh, it does 3) smbd1 marks pcap as refreshed 4) smbd1 forks child1 to obtain cups printer info 5) smbd2 receives HUP or printcap cache time expiry 6) smbd2 checks whether pcap needs refresh, it does not (due to step 3) 7) smbd2 reloads printer shares prior to child1 completion (stale pcap) 8) child1 completion, pcap cache (printer_list.tdb) is updated by smbd1 9) smbd1 reloads printer shares based on new pcap information In this case both smbd1 and smbd2 are reliant on the pcap update performed on child1 completion. The prior commit "reload shares after pcap cache fill" ensures that smbd1 only reloads printer shares following pcap update, however smbd2 continues to present shares based on stale pcap data. This commit addresses the above problem by driving pcap cache and printer share updates from the parent smbd process. 1) smbd0 (parent) receives a HUP or printcap cache time expiry 2) smbd0 forks child0 to obtain cups printer info 3) child0 completion, pcap cache (printer_list.tdb) is updated by smbd0 4) smbd0 reloads printer shares 5) smbd0 notifies child smbds of pcap update via message_send_all() 6) child smbds read fresh pcap data and reload printer shares This architecture has the additional advantage that only a single process (the parent smbd) requests printer information from the printcap backend. Use time_mono in housekeeping functions As suggested by Björn Jacke.
2010-12-23 14:14:21 +03:00
MSG_PRINTER_PCAP = 0x0207,
/* smbd messages */
/* MSG_SMB_CONF_UPDATED = 0x0301, Obsoleted */
MSG_SMB_FORCE_TDIS = 0x0302,
MSG_SMB_SAM_SYNC = 0x0303,
MSG_SMB_SAM_REPL = 0x0304,
MSG_SMB_UNLOCK = 0x0305,
MSG_SMB_BREAK_REQUEST = 0x0306,
MSG_SMB_BREAK_RESPONSE = 0x0307,
MSG_SMB_ASYNC_LEVEL2_BREAK = 0x0308,
MSG_SMB_OPEN_RETRY = 0x0309,
MSG_SMB_KERNEL_BREAK = 0x030A,
MSG_SMB_FILE_RENAME = 0x030B,
MSG_SMB_INJECT_FAULT = 0x030C,
MSG_SMB_BLOCKING_LOCK_CANCEL = 0x030D,
MSG_SMB_NOTIFY = 0x030E,
MSG_SMB_STAT_CACHE_DELETE = 0x030F,
/* Samba4 compatibility */
MSG_PVFS_NOTIFY = 0x0310,
/* cluster reconfigure events */
MSG_SMB_BRL_VALIDATE = 0x0311,
/*Close a specific file given a share entry. */
MSG_SMB_CLOSE_FILE = 0x0313,
/* winbind messages */
MSG_WINBIND_FINISHED = 0x0401,
MSG_WINBIND_FORGET_STATE = 0x0402,
MSG_WINBIND_ONLINE = 0x0403,
MSG_WINBIND_OFFLINE = 0x0404,
MSG_WINBIND_ONLINESTATUS = 0x0405,
MSG_WINBIND_TRY_TO_GO_ONLINE = 0x0406,
MSG_WINBIND_FAILED_TO_GO_ONLINE = 0x0407,
MSG_WINBIND_VALIDATE_CACHE = 0x0408,
MSG_WINBIND_DUMP_DOMAIN_LIST = 0x0409,
MSG_WINBIND_IP_DROPPED = 0x040A,
/* event messages */
MSG_DUMP_EVENT_LIST = 0x0500,
/* dbwrap messages 4001-4999 (0x0FA0 - 0x1387) */
MSG_DBWRAP_TDB2_CHANGES = 4001,
MSG_DBWRAP_G_LOCK_RETRY = 4002
} messaging_type;
/* messaging struct sent across the sockets and stored in the tdb */
typedef [public] struct {
uint32 msg_version;
messaging_type msg_type;
server_id dest;
server_id src;
DATA_BLOB buf;
} messaging_rec;
typedef [public] struct {
uint32 num_messages;
messaging_rec messages[num_messages];
} messaging_array;
/*
* struct used for change notify messages
* in the dbwrap_tdb2 code
*/
typedef [public] struct {
[charset(DOS),value("TDB2")] uint8 magic_string[4];
[value(1)] uint32 magic_version;
[charset(UTF8),string] uint8 name[];
uint32 old_seqnum;
uint32 new_seqnum;
uint32 num_changes;
uint32 num_keys;
DATA_BLOB keys[num_keys];
} dbwrap_tdb2_changes;
}