blob.c

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