blob.c

   1 /*
   2  * Copyright (C) 2007-2013 Andre Noll <maan@systemlinux.org>
   3  *
   4  * Licensed under the GPL v2. For licencing details see COPYING.
   5  */
   6
   7 /** \file blob.c Macros and functions for blob handling. */
   8
   9 #include <regex.h>
  10 #include <fnmatch.h>
  11 #include <osl.h>
  12
  13 #include "para.h"
  14 #include "error.h"
  15 #include "crypt.h"
  16 #include "string.h"
  17 #include "afh.h"
  18 #include "afs.h"
  19 #include "ipc.h"
  20 #include "portable_io.h"
  21 #include "sideband.h"
  22 #include "command.h"
  23
  24 /**
  25  * Compare two osl objects pointing to unsigned integers of 32 bit size.
  26  *
  27  * \param obj1 Pointer to the first integer.
  28  * \param obj2 Pointer to the second integer.
  29  *
  30  * \return The values required for an osl compare function.
  31  *
  32  * \sa osl_compare_func, osl_hash_compare().
  33  */
  34 static int uint32_compare(const struct osl_object *obj1, const struct osl_object *obj2)
  35 {
  36         uint32_t d1 = read_u32((const char *)obj1->data);
  37         uint32_t d2 = read_u32((const char *)obj2->data);
  38
  39         if (d1 < d2)
  40                 return 1;
  41         if (d1 > d2)
  42                 return -1;
  43         return 0;
  44 }
  45
  46 static struct osl_column_description blob_cols[] = {
  47         [BLOBCOL_ID] = {
  48                 .storage_type = OSL_MAPPED_STORAGE,
  49                 .storage_flags = OSL_RBTREE | OSL_UNIQUE | OSL_FIXED_SIZE,
  50                 .name = "id",
  51                 .data_size = 4,
  52                 .compare_function = uint32_compare
  53         },
  54         [BLOBCOL_NAME] = {
  55                 .storage_type = OSL_MAPPED_STORAGE,
  56                 .storage_flags = OSL_RBTREE | OSL_UNIQUE,
  57                 .name = "name",
  58                 .compare_function = string_compare
  59         },
  60         [BLOBCOL_DEF] = {
  61                 .storage_type = OSL_DISK_STORAGE,
  62                 .storage_flags = 0,
  63                 .name = "definition"
  64         }
  65 };
  66
  67 /** Define an osl table description for a blob table. */
  68 #define DEFINE_BLOB_TABLE_DESC(table_name) \
  69         struct osl_table_description table_name ## _table_desc = { \
  70                 .name = #table_name, \
  71                 .num_columns = NUM_BLOB_COLUMNS, \
  72                 .flags = OSL_LARGE_TABLE, \
  73                 .column_descriptions = blob_cols \
  74         };
  75
  76 /** Define a pointer to an osl blob table with a canonical name. */
  77 #define DEFINE_BLOB_TABLE_PTR(table_name) struct osl_table *table_name ## _table;
  78
  79
  80 /** Define a blob table. */
  81 #define INIT_BLOB_TABLE(table_name) \
  82         DEFINE_BLOB_TABLE_DESC(table_name); \
  83         DEFINE_BLOB_TABLE_PTR(table_name);
  84
  85 /* doxygen isn't smart enough to recognize these */
  86 /** \cond blob_table */
  87 INIT_BLOB_TABLE(lyrics);
  88 INIT_BLOB_TABLE(images);
  89 INIT_BLOB_TABLE(moods);
  90 INIT_BLOB_TABLE(playlists);
  91 /** \endcond blob_table */
  92
  93 /** Flags that may be passed to the \p ls functions of each blob  type. */
  94 enum blob_ls_flags {
  95         /** List both id and name. */
  96         BLOB_LS_FLAG_LONG = 1,
  97         /** Reverse sort order. */
  98         BLOB_LS_FLAG_REVERSE = 2,
  99         /** Sort by id instead of name. */
 100         BLOB_LS_FLAG_SORT_BY_ID = 4,
 101 };
 102
 103 /** Structure passed to the \p print_blob function. */
 104 struct lsblob_action_data {
 105         /** The flags given at the command line. */
 106         uint32_t flags;
 107         /** Message buffer. */
 108         struct para_buffer pb;
 109 };
 110
 111 static int print_blob(struct osl_table *table, struct osl_row *row,
 112                 const char *name, void *data)
 113 {
 114         struct lsblob_action_data *lbad = data;
 115         struct osl_object obj;
 116         uint32_t id;
 117         int ret;
 118
 119         if (!(lbad->flags & BLOB_LS_FLAG_LONG))
 120                 return para_printf(&lbad->pb, "%s\n", name);
 121         ret = osl(osl_get_object(table, row, BLOBCOL_ID, &obj));
 122         if (ret < 0) {
 123                 para_printf(&lbad->pb, "%s: %s\n", name, para_strerror(-ret));
 124                 return ret;
 125         }
 126         id = *(uint32_t *)obj.data;
 127         return para_printf(&lbad->pb, "%u\t%s\n", id, name);
 128 }
 129
 130 static void com_lsblob_callback(struct osl_table *table,
 131                 int fd, const struct osl_object *query)
 132 {
 133         struct lsblob_action_data lbad = {
 134                 .flags = *(uint32_t *)query->data,
 135                 .pb = {
 136                         .max_size = shm_get_shmmax(),
 137                         .private_data = &(struct afs_max_size_handler_data) {
 138                                 .fd = fd,
 139                                 .band = SBD_OUTPUT
 140                         },
 141                         .max_size_handler = afs_max_size_handler,
 142                 }
 143         };
 144         struct pattern_match_data pmd = {
 145                 .table = table,
 146                 .patterns = {.data = (char *)query->data + sizeof(uint32_t),
 147                         .size = query->size - sizeof(uint32_t)},
 148                 .pm_flags = PM_NO_PATTERN_MATCHES_EVERYTHING | PM_SKIP_EMPTY_NAME,
 149                 .match_col_num = BLOBCOL_NAME,
 150                 .data = &lbad,
 151                 .action = print_blob,
 152         };
 153         int ret;
 154
 155         if (lbad.flags & BLOB_LS_FLAG_REVERSE)
 156                 pmd.pm_flags |= PM_REVERSE_LOOP;
 157         if (!(lbad.flags & BLOB_LS_FLAG_SORT_BY_ID))
 158                 pmd.loop_col_num = BLOBCOL_NAME;
 159         else
 160                 pmd.loop_col_num = BLOBCOL_ID;
 161         ret = for_each_matching_row(&pmd);
 162         if (ret < 0)
 163                 para_printf(&lbad.pb, "%s\n", para_strerror(-ret));
 164         else if (pmd.num_matches == 0 && pmd.patterns.size > 0)
 165                 para_printf(&lbad.pb, "no matches\n");
 166         if (lbad.pb.offset)
 167                 pass_buffer_as_shm(fd, SBD_OUTPUT, lbad.pb.buf, lbad.pb.offset);
 168         free(lbad.pb.buf);
 169 }
 170
 171 static int com_lsblob(callback_function *f, struct command_context *cc)
 172 {
 173         uint32_t flags = 0;
 174         struct osl_object options = {.data = &flags, .size = sizeof(flags)};
 175         int i;
 176
 177         for (i = 1; i < cc->argc; i++) {
 178                 const char *arg = cc->argv[i];
 179                 if (arg[0] != '-')
 180                         break;
 181                 if (!strcmp(arg, "--")) {
 182                         i++;
 183                         break;
 184                 }
 185                 if (!strcmp(arg, "-l")) {
 186                         flags |= BLOB_LS_FLAG_LONG;
 187                         continue;
 188                 }
 189                 if (!strcmp(arg, "-i")) {
 190                         flags |= BLOB_LS_FLAG_SORT_BY_ID;
 191                         continue;
 192                 }
 193                 if (!strcmp(arg, "-r")) {
 194                         flags |= BLOB_LS_FLAG_REVERSE;
 195                         continue;
 196                 }
 197                 break;
 198         }
 199 //      if (argc > i)
 200 //              return -E_BLOB_SYNTAX;
 201         return send_option_arg_callback_request(&options, cc->argc - i,
 202                 cc->argv + i, f, afs_cb_result_handler, cc);
 203 }
 204
 205 static int cat_blob(struct osl_table *table, struct osl_row *row,
 206                 __a_unused const char *name, void *data)
 207 {
 208         int ret = 0, ret2, fd = *(int *)data;
 209         struct osl_object obj;
 210
 211         ret = osl(osl_open_disk_object(table, row, BLOBCOL_DEF, &obj));
 212         if (ret < 0)
 213                 return (ret == osl(-E_OSL_EMPTY))? 0 : ret;
 214         assert(obj.size > 0);
 215         ret = pass_buffer_as_shm(fd, SBD_OUTPUT, obj.data, obj.size);
 216         ret2 = osl(osl_close_disk_object(&obj));
 217         return (ret < 0)? ret : ret2;
 218 }
 219
 220 static void com_catblob_callback(struct osl_table *table, int fd,
 221                 const struct osl_object *query)
 222 {
 223         struct pattern_match_data pmd = {
 224                 .table = table,
 225                 .patterns = *query,
 226                 .loop_col_num = BLOBCOL_NAME,
 227                 .match_col_num = BLOBCOL_NAME,
 228                 .pm_flags = PM_SKIP_EMPTY_NAME,
 229                 .data = &fd,
 230                 .action = cat_blob
 231         };
 232         for_each_matching_row(&pmd);
 233         if (pmd.num_matches == 0) {
 234                 char err_msg[] = "no matches\n";
 235                 pass_buffer_as_shm(fd, SBD_OUTPUT, err_msg, sizeof(err_msg));
 236         }
 237 }
 238
 239 static int com_catblob(callback_function *f, struct command_context *cc)
 240 {
 241         if (cc->argc < 2)
 242                 return -E_BLOB_SYNTAX;
 243         return send_standard_callback_request(cc->argc - 1, cc->argv + 1, f,
 244                 afs_cb_result_handler, cc);
 245 }
 246
 247 /** Used for removing rows from a blob table. */
 248 struct rmblob_data {
 249         /** Message buffer. */
 250         struct para_buffer pb;
 251 };
 252
 253 static int remove_blob(struct osl_table *table, struct osl_row *row,
 254                 const char *name, void *data)
 255 {
 256         struct rmblob_data *rmbd = data;
 257         int ret = osl(osl_del_row(table, row));
 258         if (ret < 0) {
 259                 para_printf(&rmbd->pb, "%s: %s\n", name, para_strerror(-ret));
 260                 return ret;
 261         }
 262         return 1;
 263 }
 264
 265 static void com_rmblob_callback(struct osl_table *table, int fd,
 266                 const struct osl_object *query)
 267 {
 268         int ret, ret2 = 0;
 269         struct rmblob_data rmbd = {
 270                 .pb = {
 271                         .max_size = shm_get_shmmax(),
 272                         .private_data = &(struct afs_max_size_handler_data) {
 273                                 .fd = fd,
 274                                 .band = SBD_OUTPUT
 275                         },
 276                         .max_size_handler = afs_max_size_handler,
 277                 }
 278         };
 279         struct pattern_match_data pmd = {
 280                 .table = table,
 281                 .patterns = *query,
 282                 .loop_col_num = BLOBCOL_NAME,
 283                 .match_col_num = BLOBCOL_NAME,
 284                 .pm_flags = PM_SKIP_EMPTY_NAME,
 285                 .data = &rmbd,
 286                 .action = remove_blob
 287         };
 288         ret = for_each_matching_row(&pmd);
 289         if (ret < 0) {
 290                 ret2 = para_printf(&rmbd.pb, "%s\n", para_strerror(-ret));
 291                 if (ret2 < 0)
 292                         goto out;
 293         }
 294         if (pmd.num_matches == 0)
 295                 ret2 = para_printf(&rmbd.pb, "no matches, nothing removed\n");
 296         else {
 297                 ret2 = para_printf(&rmbd.pb, "removed %d blobs\n", pmd.num_matches);
 298                 afs_event(BLOB_REMOVE, NULL, table);
 299         }
 300 out:
 301         if (ret2 >= 0 && rmbd.pb.offset)
 302                 pass_buffer_as_shm(fd, SBD_OUTPUT, rmbd.pb.buf, rmbd.pb.offset);
 303         free(rmbd.pb.buf);
 304 }
 305
 306 static int com_rmblob(callback_function *f, struct command_context *cc)
 307 {
 308         if (cc->argc < 2)
 309                 return -E_MOOD_SYNTAX;
 310         return send_option_arg_callback_request(NULL, cc->argc - 1, cc->argv + 1, f,
 311                 afs_cb_result_handler, cc);
 312 }
 313
 314 static void com_addblob_callback(struct osl_table *table, __a_unused int fd,
 315                 const struct osl_object *query)
 316 {
 317         struct osl_object objs[NUM_BLOB_COLUMNS];
 318         char *name = query->data;
 319         size_t name_len = strlen(name) + 1;
 320         uint32_t id;
 321         unsigned num_rows;
 322         int ret;
 323
 324         ret = osl(osl_get_num_rows(table, &num_rows));
 325         if (ret < 0)
 326                 goto out;
 327         if (!num_rows) { /* this is the first entry ever added */
 328                 /* insert dummy row containing the id */
 329                 id = 2; /* this entry will be entry #1, so 2 is the next */
 330                 objs[BLOBCOL_ID].data = &id;
 331                 objs[BLOBCOL_ID].size = sizeof(id);
 332                 objs[BLOBCOL_NAME].data = "";
 333                 objs[BLOBCOL_NAME].size = 1;
 334                 objs[BLOBCOL_DEF].data = "";
 335                 objs[BLOBCOL_DEF].size = 1;
 336                 ret = osl(osl_add_row(table, objs));
 337                 if (ret < 0)
 338                         goto out;
 339         } else {
 340                 /* check if name already exists */
 341                 struct osl_row *row;
 342                 struct osl_object obj = {.data = name, .size = name_len};
 343                 ret = osl(osl_get_row(table, BLOBCOL_NAME, &obj, &row));
 344                 if (ret < 0 && ret != -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND))
 345                         goto out;
 346                 if (ret >= 0) { /* we already have a blob with this name */
 347                         obj.data = name + name_len;
 348                         obj.size = query->size - name_len;
 349                         ret = osl(osl_update_object(table, row, BLOBCOL_DEF, &obj));
 350                         goto out;
 351                 }
 352                 /* new blob, get id of the dummy row and increment it */
 353                 obj.data = "";
 354                 obj.size = 1;
 355                 ret = osl(osl_get_row(table, BLOBCOL_NAME, &obj, &row));
 356                 if (ret < 0)
 357                         goto out;
 358                 ret = osl(osl_get_object(table, row, BLOBCOL_ID, &obj));
 359                 if (ret < 0)
 360                         goto out;
 361                 id = *(uint32_t *)obj.data + 1;
 362                 obj.data = &id;
 363                 ret = osl(osl_update_object(table, row, BLOBCOL_ID, &obj));
 364                 if (ret < 0)
 365                         goto out;
 366         }
 367         id--;
 368         objs[BLOBCOL_ID].data = &id;
 369         objs[BLOBCOL_ID].size = sizeof(id);
 370         objs[BLOBCOL_NAME].data = name;
 371         objs[BLOBCOL_NAME].size = name_len;
 372         objs[BLOBCOL_DEF].data = name + name_len;
 373         objs[BLOBCOL_DEF].size = query->size - name_len;
 374         ret = osl(osl_add_row(table, objs));
 375         if (ret < 0)
 376                 goto out;
 377         afs_event(BLOB_ADD, NULL, table);
 378 out:
 379         if (ret < 0)
 380                 PARA_NOTICE_LOG("%s\n", para_strerror(-ret));
 381 }
 382
 383 /*
 384  * write input from fd to dynamically allocated buffer,
 385  * but maximal max_size byte.
 386  */
 387 static int fd2buf(struct stream_cipher_context *scc, unsigned max_size, struct osl_object *obj)
 388 {
 389         const size_t chunk_size = 1024;
 390         size_t size = 2048, received = 0;
 391         int ret;
 392         char *buf = para_malloc(size);
 393
 394         for (;;) {
 395                 ret = sc_recv_bin_buffer(scc, buf + received, chunk_size);
 396                 if (ret <= 0)
 397                         break;
 398                 received += ret;
 399                 if (received + chunk_size >= size) {
 400                         size *= 2;
 401                         ret = -E_INPUT_TOO_LARGE;
 402                         if (size > max_size)
 403                                 break;
 404                         buf = para_realloc(buf, size);
 405                 }
 406         }
 407         obj->data = buf;
 408         obj->size = received;
 409         if (ret < 0)
 410                 free(buf);
 411         return ret;
 412 }
 413
 414 /*
 415  * Read data from a file descriptor, and send it to the afs process.
 416  *
 417  * \param scc crypt context containing the file descriptor to read data from.
 418  * \param arg_obj Pointer to the arguments to \a f.
 419  * \param f The callback function.
 420  * \param max_len Don't read more than that many bytes from stdin.
 421  * \param result_handler See \ref send_callback_request.
 422  * \param private_result_data See \ref send_callback_request.
 423  *
 424  * This function is used by commands that wish to let para_server store
 425  * arbitrary data specified by the user (for instance the add_blob family of
 426  * commands). First, at most \a max_len bytes are read and decrypted from the
 427  * file descriptor given by \a scc. The result is concatenated with the buffer
 428  * given by \a arg_obj, and the combined buffer is made available to the afs
 429  * process via the callback method. See \ref send_callback_request for details.
 430  *
 431  * \return Negative on errors, the return value of the underlying call to
 432  * send_callback_request() otherwise.
 433  */
 434 static int stdin_command(struct command_context *cc, struct osl_object *arg_obj,
 435                 callback_function *f, unsigned max_len,
 436                 callback_result_handler *result_handler,
 437                 void *private_result_data)
 438 {
 439         struct osl_object query, stdin_obj;
 440         int ret;
 441
 442         if (cc->use_sideband)
 443                 ret = send_sb(&cc->scc, NULL, 0, SBD_AWAITING_DATA, false);
 444         else
 445                 ret = sc_send_buffer(&cc->scc, AWAITING_DATA_MSG);
 446         if (ret < 0)
 447                 return ret;
 448         ret = fd2buf(&cc->scc, max_len, &stdin_obj);
 449         if (ret < 0)
 450                 return ret;
 451         query.size = arg_obj->size + stdin_obj.size;
 452         query.data = para_malloc(query.size);
 453         memcpy(query.data, arg_obj->data, arg_obj->size);
 454         memcpy((char *)query.data + arg_obj->size, stdin_obj.data, stdin_obj.size);
 455         free(stdin_obj.data);
 456         ret = send_callback_request(f, &query, result_handler, private_result_data);
 457         free(query.data);
 458         return ret;
 459 }
 460
 461 static int com_addblob(callback_function *f, struct command_context *cc)
 462 {
 463         struct osl_object arg_obj;
 464
 465         if (cc->argc != 2)
 466                 return -E_BLOB_SYNTAX;
 467         if (!*cc->argv[1]) /* empty name is reserved for the dummy row */
 468                 return -E_BLOB_SYNTAX;
 469         arg_obj.size = strlen(cc->argv[1]) + 1;
 470         arg_obj.data = (char *)cc->argv[1];
 471         return stdin_command(cc, &arg_obj, f, 10 * 1024 * 1024, NULL, NULL);
 472 }
 473
 474 /* FIXME: Print output to client, not to log file */
 475 static void com_mvblob_callback(struct osl_table *table, __a_unused int fd,
 476                 const struct osl_object *query)
 477 {
 478         char *src = (char *) query->data;
 479         struct osl_object obj = {.data = src, .size = strlen(src) + 1};
 480         char *dest = src + obj.size;
 481         struct osl_row *row;
 482         int ret = osl(osl_get_row(table, BLOBCOL_NAME, &obj, &row));
 483
 484         if (ret < 0)
 485                 goto out;
 486         obj.data = dest;
 487         obj.size = strlen(dest) + 1;
 488         ret = osl(osl_update_object(table, row, BLOBCOL_NAME, &obj));
 489         if (ret < 0)
 490                 goto out;
 491         afs_event(BLOB_RENAME, NULL, table);
 492 out:
 493         if (ret < 0)
 494                 PARA_NOTICE_LOG("%s\n", para_strerror(-ret));
 495 }
 496
 497 static int com_mvblob(callback_function *f, struct command_context *cc)
 498 {
 499         if (cc->argc != 3)
 500                 return -E_MOOD_SYNTAX;
 501         return send_option_arg_callback_request(NULL, cc->argc - 1,
 502                 cc->argv + 1, f, NULL, NULL);
 503 }
 504
 505 #define DEFINE_BLOB_COMMAND(cmd_name, table_name, cmd_prefix) \
 506         static void com_ ## cmd_name ## cmd_prefix ## _callback(int fd, const struct osl_object *query) \
 507         { \
 508                 return com_ ## cmd_name ## blob_callback(table_name ## _table, fd, query); \
 509         } \
 510         int com_ ## cmd_name ## cmd_prefix(struct command_context *cc) \
 511         { \
 512                 return com_ ## cmd_name ## blob(com_ ## cmd_name ## cmd_prefix ## _callback, cc); \
 513         }
 514
 515 static int blob_get_name_by_id(struct osl_table *table, uint32_t id,
 516                 char **name)
 517 {
 518         struct osl_row *row;
 519         struct osl_object obj = {.data = &id, .size = sizeof(id)};
 520         int ret;
 521
 522         *name = NULL;
 523         if (!id)
 524                 return 1;
 525         ret = osl(osl_get_row(table, BLOBCOL_ID, &obj, &row));
 526         if (ret < 0)
 527                 return ret;
 528         ret = osl(osl_get_object(table, row, BLOBCOL_NAME, &obj));
 529         if (ret < 0)
 530                 return ret;
 531         *name = (char *)obj.data;
 532         return 1;
 533 }
 534
 535 /** Define the \p get_name_by_id function for this blob type. */
 536 #define DEFINE_GET_NAME_BY_ID(table_name, cmd_prefix) \
 537         int cmd_prefix ## _get_name_by_id(uint32_t id, char **name) \
 538         { \
 539                 return blob_get_name_by_id(table_name ## _table, id, name); \
 540         }
 541
 542
 543 static int blob_get_def_by_name(struct osl_table *table, char *name,
 544                 struct osl_object *def)
 545 {
 546         struct osl_row *row;
 547         struct osl_object obj = {.data = name, .size = strlen(name) + 1};
 548         int ret;
 549
 550         def->data = NULL;
 551         if (!*name)
 552                 return 1;
 553         ret = osl(osl_get_row(table, BLOBCOL_NAME, &obj, &row));
 554         if (ret < 0)
 555                 return ret;
 556         return osl(osl_open_disk_object(table, row, BLOBCOL_DEF, def));
 557 }
 558
 559 /** Define the \p get_def_by_id function for this blob type. */
 560 #define DEFINE_GET_DEF_BY_NAME(table_name, cmd_prefix) \
 561         int cmd_prefix ## _get_def_by_name(char *name, struct osl_object *def) \
 562         { \
 563                 return blob_get_def_by_name(table_name ## _table, name, def); \
 564         }
 565
 566 static int blob_get_def_by_id(struct osl_table *table, uint32_t id,
 567                 struct osl_object *def)
 568 {
 569         struct osl_row *row;
 570         struct osl_object obj = {.data = &id, .size = sizeof(id)};
 571         int ret;
 572
 573         def->data = NULL;
 574         if (!id)
 575                 return 1;
 576         ret = osl(osl_get_row(table, BLOBCOL_ID, &obj, &row));
 577         if (ret < 0)
 578                 return ret;
 579         return osl(osl_open_disk_object(table, row, BLOBCOL_DEF, def));
 580 }
 581
 582 /** Define the \p get_def_by_id function for this blob type. */
 583 #define DEFINE_GET_DEF_BY_ID(table_name, cmd_prefix) \
 584         int cmd_prefix ## _get_def_by_id(uint32_t id, struct osl_object *def) \
 585         { \
 586                 return blob_get_def_by_id(table_name ## _table, id, def); \
 587         }
 588
 589 static int blob_get_name_and_def_by_row(struct osl_table *table,
 590                 const struct osl_row *row, char **name, struct osl_object *def)
 591 {
 592         struct osl_object obj;
 593         int ret = osl(osl_get_object(table, row, BLOBCOL_NAME, &obj));
 594         if (ret < 0)
 595                 return ret;
 596         *name = obj.data;
 597         return osl(osl_open_disk_object(table, row, BLOBCOL_DEF, def));
 598 }
 599 /** Define the \p get_name_and_def_by_row function for this blob type. */
 600 #define DEFINE_GET_NAME_AND_DEF_BY_ROW(table_name, cmd_prefix) \
 601         int cmd_prefix ## _get_name_and_def_by_row(const struct osl_row *row, \
 602                 char **name, struct osl_object *def) \
 603         { \
 604                 return blob_get_name_and_def_by_row(table_name ## _table, \
 605                         row, name, def); \
 606         }
 607
 608 /** Define the \p close function for this blob type. */
 609 #define DEFINE_BLOB_CLOSE(table_name) \
 610         static void table_name ## _close(void) \
 611         { \
 612                 osl_close_table(table_name ## _table, OSL_MARK_CLEAN); \
 613                 table_name ## _table = NULL; \
 614         }
 615
 616 /** Define the \p create function for this blob type. */
 617 #define DEFINE_BLOB_CREATE(table_name) \
 618         static int table_name ## _create(const char *dir) \
 619         { \
 620                 table_name ## _table_desc.dir = dir; \
 621                 return osl(osl_create_table(&table_name ## _table_desc)); \
 622         }
 623
 624 static int blob_open(struct osl_table **table,
 625                 struct osl_table_description *desc,
 626                 const char *dir)
 627 {
 628         int ret;
 629         desc->dir = dir;
 630         ret = osl(osl_open_table(desc, table));
 631         if (ret >= 0)
 632                 return ret;
 633         *table = NULL;
 634         if (ret >= 0 || ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_NOENT))
 635                 return 1;
 636         return ret;
 637 }
 638
 639 #define DEFINE_BLOB_OPEN(table_name) \
 640         static int table_name ## _open(const char *dir) \
 641         { \
 642                 return blob_open(&table_name ## _table, \
 643                         &table_name ## _table_desc, dir); \
 644         }
 645
 646
 647 /** Define the \p init function for this blob type. */
 648 #define DEFINE_BLOB_INIT(table_name) \
 649         void table_name ## _init(struct afs_table *t) \
 650         { \
 651                 t->open = table_name ## _open; \
 652                 t->close = table_name ## _close; \
 653                 t->create = table_name ## _create;\
 654                 t->event_handler = table_name ##_event_handler; \
 655                 table_name ## _table = NULL; \
 656         }
 657
 658
 659 /** Define all functions for this blob type. */
 660 #define DEFINE_BLOB_FUNCTIONS(table_name, cmd_prefix) \
 661         DEFINE_BLOB_OPEN(table_name) \
 662         DEFINE_BLOB_CLOSE(table_name) \
 663         DEFINE_BLOB_CREATE(table_name) \
 664         DEFINE_BLOB_INIT(table_name) \
 665         DEFINE_BLOB_COMMAND(ls, table_name, cmd_prefix) \
 666         DEFINE_BLOB_COMMAND(cat, table_name, cmd_prefix) \
 667         DEFINE_BLOB_COMMAND(add, table_name, cmd_prefix) \
 668         DEFINE_BLOB_COMMAND(rm, table_name, cmd_prefix) \
 669         DEFINE_BLOB_COMMAND(mv, table_name, cmd_prefix) \
 670         DEFINE_GET_NAME_BY_ID(table_name, cmd_prefix); \
 671         DEFINE_GET_DEF_BY_ID(table_name, cmd_prefix); \
 672         DEFINE_GET_DEF_BY_NAME(table_name, cmd_prefix); \
 673         DEFINE_GET_NAME_AND_DEF_BY_ROW(table_name, cmd_prefix); \
 674
 675 /* doxygen isn't smart enough to recognize these */
 676 /** \cond blob_function */
 677 DEFINE_BLOB_FUNCTIONS(lyrics, lyr);
 678 DEFINE_BLOB_FUNCTIONS(images, img);
 679 DEFINE_BLOB_FUNCTIONS(moods, mood);
 680 DEFINE_BLOB_FUNCTIONS(playlists, pl);
 681 /** \endcond blob_function */