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 <minix/types.h>
   7
   8 /* Flags. */
   9 #define DSF_IN_USE              0x001   /* entry is in use */
  10 #define DSF_PRIV_RETRIEVE       0x002   /* only owner can retrieve */
  11 #define DSF_PRIV_OVERWRITE      0x004   /* only owner can overwrite */
  12 #define DSF_PRIV_SNAPSHOT       0x004   /* only owner can take a snapshot */
  13 #define DSF_PRIV_SUBSCRIBE      0x008   /* only owner can subscribe */
  14 #define DSF_TYPE_U32            0x010   /* u32 data type */
  15 #define DSF_TYPE_STR            0x020   /* string data type */
  16 #define DSF_TYPE_MEM            0x040   /* memory range data type */
  17 #define DSF_TYPE_MAP            0x080   /* mapped 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 #define DSMF_MAP_MAPPED         0x10000 /* map mapped memory range */
  27 #define DSMF_COPY_MAPPED        0x20000 /* copy mapped memory range */
  28 #define DSMF_COPY_SNAPSHOT      0x40000 /* copy snapshot */
  29
  30 /* DS constants. */
  31 #define DS_MAX_KEYLEN 80        /* Max length of a key, including '\0'. */
  32
  33 /* ds.c */
  34
  35 /* U32 */
  36 _PROTOTYPE( int ds_publish_u32, (const char *name, u32_t val, int flags));
  37 _PROTOTYPE( int ds_retrieve_u32, (const char *name, u32_t *val));
  38 _PROTOTYPE( int ds_delete_u32, (const char *ds_name));
  39
  40 /* STRING */
  41 _PROTOTYPE( int ds_publish_str, (const char *name, char *val, int flags));
  42 _PROTOTYPE( int ds_retrieve_str, (const char *name, char *val, size_t len));
  43 _PROTOTYPE( int ds_delete_str, (const char *ds_name));
  44
  45 /* MEM */
  46 _PROTOTYPE( int ds_publish_mem, (const char *ds_name, void *vaddr,
  47                 size_t length, int flags));
  48 _PROTOTYPE( int ds_retrieve_mem, (const char *ds_name, char *vaddr,
  49                 size_t *length));
  50 _PROTOTYPE( int ds_delete_mem, (const char *ds_name));
  51
  52 /* MAP */
  53 _PROTOTYPE( int ds_publish_map, (const char *ds_name, void *vaddr,
  54                 size_t length, int flags));
  55 _PROTOTYPE( int ds_snapshot_map, (const char *ds_name, int *nr_snapshot));
  56 _PROTOTYPE( int ds_retrieve_map, (const char *ds_name, char *vaddr,
  57                 size_t *length, int nr_snapshot, int flags));
  58 _PROTOTYPE( int ds_delete_map, (const char *ds_name));
  59
  60 /* LABEL */
  61 _PROTOTYPE( int ds_publish_label, (const char *ds_name, u32_t value,int flags));
  62 _PROTOTYPE( int ds_retrieve_label_name, (char *ds_name, u32_t num));
  63 _PROTOTYPE( int ds_retrieve_label_num, (const char *ds_name, u32_t *value));
  64 _PROTOTYPE( int ds_delete_label, (const char *ds_name));
  65
  66 /* Subscribe and check. */
  67 _PROTOTYPE( int ds_subscribe, (const char *regex, int flags));
  68 _PROTOTYPE( int ds_check, (char *ds_name, int *type));
  69
  70 #endif /* _MINIX_DS_H */
  71