include/minix/ds.h

   1 /* Prototypes and definitions for DS interface. */
   2
   3 #ifndef _MINIX_DS_H
   4 #define _MINIX_DS_H
   5
   6 #include <sys/types.h>
   7 #include <minix/endpoint.h>
   8
   9 /* Flags. */
  10 #define DSF_IN_USE              0x001   /* entry is in use */
  11 #define DSF_PRIV_RETRIEVE       0x002   /* only owner can retrieve */
  12 #define DSF_PRIV_OVERWRITE      0x004   /* only owner can overwrite */
  13 #define DSF_PRIV_SNAPSHOT       0x004   /* only owner can take a snapshot */
  14 #define DSF_PRIV_SUBSCRIBE      0x008   /* only owner can subscribe */
  15 #define DSF_TYPE_U32            0x010   /* u32 data type */
  16 #define DSF_TYPE_STR            0x020   /* string data type */
  17 #define DSF_TYPE_MEM            0x040   /* memory range data type */
  18 #define DSF_TYPE_LABEL          0x100   /* label data type */
  19
  20 #define DSF_MASK_TYPE           0xFF0   /* mask for type flags. */
  21 #define DSF_MASK_INTERNAL       0xFFF   /* mask for internal flags. */
  22
  23 #define DSF_OVERWRITE           0x01000 /* overwrite if entry exists */
  24 #define DSF_INITIAL             0x02000 /* check subscriptions immediately */
  25
  26 /* DS constants. */
  27 #define DS_MAX_KEYLEN 80        /* Max length of a key, including '\0'. */
  28
  29 /* DS events. */
  30 #define DS_DRIVER_UP            1
  31
  32 /* ds.c */
  33
  34 /* U32 */
  35 int ds_publish_u32(const char *name, u32_t val, int flags);
  36 int ds_retrieve_u32(const char *name, u32_t *val);
  37 int ds_delete_u32(const char *ds_name);
  38
  39 /* STRING */
  40 int ds_publish_str(const char *name, char *val, int flags);
  41 int ds_retrieve_str(const char *name, char *val, size_t len);
  42 int ds_delete_str(const char *ds_name);
  43
  44 /* MEM */
  45 int ds_publish_mem(const char *ds_name, void *vaddr, size_t length, int
  46         flags);
  47 int ds_retrieve_mem(const char *ds_name, char *vaddr, size_t *length);
  48 int ds_delete_mem(const char *ds_name);
  49
  50 /* MAP */
  51 int ds_publish_map(const char *ds_name, void *vaddr, size_t length, int
  52         flags);
  53 int ds_snapshot_map(const char *ds_name, int *nr_snapshot);
  54 int ds_retrieve_map(const char *ds_name, char *vaddr, size_t *length,
  55         int nr_snapshot, int flags);
  56 int ds_delete_map(const char *ds_name);
  57
  58 /* LABEL */
  59 int ds_publish_label(const char *ds_name, endpoint_t endpoint, int
  60         flags);
  61 int ds_retrieve_label_name(char *ds_name, endpoint_t endpoint);
  62 int ds_retrieve_label_endpt(const char *ds_name, endpoint_t *endpoint);
  63 int ds_delete_label(const char *ds_name);
  64
  65 /* Subscribe and check. */
  66 int ds_subscribe(const char *regex, int flags);
  67 int ds_check(char *ds_name, int *type, endpoint_t *owner_e);
  68
  69 #endif /* _MINIX_DS_H */
  70