attribute.c

   1 /*
   2  * Copyright (C) 1997 Andre Noll <maan@tuebingen.mpg.de>
   3  *
   4  * Licensed under the GPL v2. For licencing details see COPYING.
   5  */
   6
   7 /** \file attribute.c Attribute handling functions. */
   8
   9 #include <regex.h>
  10 #include <osl.h>
  11
  12 #include "para.h"
  13 #include "error.h"
  14 #include "crypt.h"
  15 #include "string.h"
  16 #include "afh.h"
  17 #include "afs.h"
  18 #include "ipc.h"
  19 #include "sideband.h"
  20 #include "command.h"
  21
  22 static struct osl_table *attribute_table;
  23 static int greatest_att_bitnum;
  24
  25 /** The columns of the attribute table. */
  26 enum attribute_table_columns {
  27         /** The bit number (0-63). */
  28         ATTCOL_BITNUM,
  29         /** The name of the attribute. */
  30         ATTCOL_NAME,
  31         /** Number of columns in this table. */
  32         NUM_ATT_COLUMNS
  33 };
  34
  35 static int char_compare(const struct osl_object *obj1, const struct osl_object *obj2)
  36 {
  37         const unsigned char *c1 = (const unsigned char*)obj1->data;
  38         const unsigned char *c2 = (const unsigned char*)obj2->data;
  39         if (*c1 > *c2)
  40                 return 1;
  41         if (*c1 < *c2)
  42                 return -1;
  43         return 0;
  44 }
  45
  46 static struct osl_column_description att_cols[] = {
  47         [ATTCOL_BITNUM] = {
  48                 .storage_type = OSL_MAPPED_STORAGE,
  49                 .storage_flags = OSL_RBTREE | OSL_FIXED_SIZE | OSL_UNIQUE,
  50                 .name = "bitnum",
  51                 .compare_function = char_compare,
  52                 .data_size = 1
  53         },
  54         [ATTCOL_NAME] = {
  55                 .storage_type = OSL_MAPPED_STORAGE,
  56                 .storage_flags = OSL_RBTREE | OSL_UNIQUE,
  57                 .name = "name",
  58                 .compare_function = string_compare,
  59         }
  60 };
  61
  62 static struct osl_table_description attribute_table_desc = {
  63         .name = "attributes",
  64         .num_columns = NUM_ATT_COLUMNS,
  65         .flags = 0,
  66         .column_descriptions = att_cols
  67 };
  68
  69 static void find_greatest_att_bitnum(void)
  70 {
  71         unsigned char c = 63;
  72         do {
  73                 struct osl_row *row;
  74                 struct osl_object obj = {.data = &c, .size = 1};
  75                 if (osl_get_row(attribute_table, ATTCOL_BITNUM, &obj,
  76                                 &row) >= 0) {
  77                         greatest_att_bitnum = c;
  78                         return;
  79                 }
  80         } while (c--);
  81         PARA_INFO_LOG("no attributes\n");
  82         greatest_att_bitnum = -E_NO_ATTRIBUTES;
  83 }
  84
  85 /**
  86  * Retrieve the identifier (number) of an attribute.
  87  *
  88  * \param att_name The name of the attribute.
  89  * \param bitnum Result pointer.
  90  *
  91  * \return Positive on success, negative on errors.
  92  */
  93 int get_attribute_bitnum_by_name(const char *att_name, unsigned char *bitnum)
  94 {
  95         struct osl_object obj = {.data = (char *)att_name,
  96                 .size = strlen(att_name) + 1};
  97         struct osl_row *row;
  98         int ret = osl(osl_get_row(attribute_table, ATTCOL_NAME, &obj, &row));
  99
 100         if (ret < 0)
 101                 return ret;
 102         ret = osl(osl_get_object(attribute_table, row, ATTCOL_BITNUM, &obj));
 103         if (ret < 0)
 104                 return ret;
 105         *bitnum = *(unsigned char *)obj.data;
 106         return 1;
 107 }
 108
 109 /**
 110  * Flags used by the lsatt command.
 111  *
 112  * \param \sa com_lsatt().
 113  */
 114 enum lsatt_flags {
 115         /** Whether "-a" was given for the lsatt command. */
 116         LSATT_FLAG_SORT_BY_ID = 1,
 117         /** Whether "-l" was given for the lsatt command. */
 118         LSATT_FLAG_LONG = 2,
 119         /** Reverse sort order. */
 120         LSATT_FLAG_REVERSE = 4
 121 };
 122
 123 /** Data passed to the action function of lsatt */
 124 struct lsatt_action_data {
 125         /** The result buffer. */
 126         struct para_buffer pb;
 127         /** The given flags for the lsatt command. */
 128         unsigned flags;
 129 };
 130
 131 static int print_attribute(struct osl_table *table, struct osl_row *row,
 132                 const char *name, void *data)
 133 {
 134         struct lsatt_action_data *laad = data;
 135         struct osl_object bitnum_obj;
 136         int ret;
 137
 138         if (!(laad->flags & LSATT_FLAG_LONG)) {
 139                 para_printf(&laad->pb, "%s\n", name);
 140                 return 1;
 141         }
 142         ret = osl(osl_get_object(table, row, ATTCOL_BITNUM, &bitnum_obj));
 143         if (ret < 0) {
 144                 para_printf(&laad->pb, "%s: %s\n", name, para_strerror(-ret));
 145                 return ret;
 146         }
 147         para_printf(&laad->pb, "%u\t%s\n", *(unsigned char*)bitnum_obj.data,
 148                 name);
 149         return 1;
 150 }
 151
 152 static void com_lsatt_callback(int fd, const struct osl_object *query)
 153 {
 154         struct lsatt_action_data laad = {
 155                 .flags = *(unsigned *) query->data,
 156                 .pb = {
 157                         .max_size = shm_get_shmmax(),
 158                         .private_data = &(struct afs_max_size_handler_data) {
 159                                 .fd = fd,
 160                                 .band = SBD_OUTPUT
 161                         },
 162                         .max_size_handler = afs_max_size_handler
 163                 }
 164
 165         };
 166         struct pattern_match_data pmd = {
 167                 .table = attribute_table,
 168                 .loop_col_num = ATTCOL_BITNUM,
 169                 .match_col_num = ATTCOL_NAME,
 170                 .patterns = {.data = (char *)query->data + sizeof(laad.flags),
 171                         .size = query->size - sizeof(laad.flags)},
 172                 .pm_flags = PM_NO_PATTERN_MATCHES_EVERYTHING,
 173                 .data = &laad,
 174                 .action = print_attribute
 175         };
 176         if (laad.flags & LSATT_FLAG_SORT_BY_ID)
 177                 pmd.loop_col_num = ATTCOL_NAME;
 178         if (laad.flags & LSATT_FLAG_REVERSE)
 179                 pmd.pm_flags |= PM_REVERSE_LOOP;
 180         for_each_matching_row(&pmd);
 181         if (laad.pb.offset)
 182                 pass_buffer_as_shm(fd, SBD_OUTPUT, laad.pb.buf, laad.pb.offset);
 183         free(laad.pb.buf);
 184 }
 185
 186 int com_lsatt(struct command_context *cc)
 187 {
 188         unsigned flags = 0;
 189         struct osl_object options = {.data = &flags, .size = sizeof(flags)};
 190         int ret, i;
 191
 192         for (i = 1; i < cc->argc; i++) {
 193                 const char *arg = cc->argv[i];
 194                 if (arg[0] != '-')
 195                         break;
 196                 if (!strcmp(arg, "--")) {
 197                         i++;
 198                         break;
 199                 }
 200                 if (!strcmp(arg, "-i")) {
 201                         flags |= LSATT_FLAG_SORT_BY_ID;
 202                         continue;
 203                 }
 204                 if (!strcmp(arg, "-l")) {
 205                         flags |= LSATT_FLAG_LONG;
 206                         continue;
 207                 }
 208                 if (!strcmp(arg, "-r")) {
 209                         flags |= LSATT_FLAG_REVERSE;
 210                         continue;
 211                 }
 212         }
 213         ret = send_option_arg_callback_request(&options, cc->argc - i, cc->argv + i,
 214                 com_lsatt_callback, afs_cb_result_handler, cc);
 215         if (ret < 0)
 216                 send_strerror(cc, -ret);
 217         else if (ret == 0 && cc->argc > 1)
 218                 ret = send_sb_va(&cc->scc, SBD_ERROR_LOG, "no matches\n");
 219         return ret;
 220 }
 221
 222 struct addatt_event_data {
 223         const char *name;
 224         unsigned char bitnum;
 225 };
 226
 227
 228 static void com_addatt_callback(int fd, const struct osl_object *query)
 229 {
 230         char *p;
 231         int ret = 1;
 232         struct para_buffer pb = {
 233                 .max_size = shm_get_shmmax(),
 234                 .private_data = &(struct afs_max_size_handler_data) {
 235                         .fd = fd,
 236                         .band = SBD_OUTPUT
 237                 },
 238                 .max_size_handler = afs_max_size_handler
 239         };
 240         size_t len;
 241
 242         for (p = query->data; p < (char *)query->data + query->size; p += len + 1) {
 243                 struct osl_object objs[NUM_ATT_COLUMNS];
 244                 struct osl_row *row;
 245                 unsigned char bitnum;
 246                 struct addatt_event_data aed;
 247
 248                 len = strlen(p);
 249                 if (!len || p[len - 1] == '-' || p[len - 1] == '+') {
 250                         para_printf(&pb, "invalid attribute name: %s\n", p);
 251                         continue;
 252                 }
 253                 ret = get_attribute_bitnum_by_name(p, &bitnum);
 254                 if (ret >= 0) {
 255                         para_printf(&pb, "attribute \"%s\" already exists\n", p);
 256                         continue;
 257                 }
 258                 if (ret != -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND)) /* error */
 259                         goto out;
 260                 objs[ATTCOL_BITNUM].size = 1;
 261                 /* find smallest unused attribute */
 262                 for (bitnum = 0; bitnum < 64; bitnum++) {
 263                         objs[ATTCOL_BITNUM].data = &bitnum;
 264                         ret = osl(osl_get_row(attribute_table, ATTCOL_BITNUM,
 265                                 &objs[ATTCOL_BITNUM], &row));
 266                         if (ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND))
 267                                 break; /* this bitnum is unused, use it */
 268                         if (ret < 0) /* error */
 269                                 goto out;
 270                         /* this bit is already in use, try next bit */
 271                 }
 272                 if (bitnum == 64) {
 273                         ret = -E_ATT_TABLE_FULL;
 274                         goto out;
 275                 }
 276                 objs[ATTCOL_NAME].data = p;
 277                 objs[ATTCOL_NAME].size = len + 1;
 278                 ret = osl(osl_add_row(attribute_table, objs));
 279                 if (ret < 0)
 280                         goto out;
 281                 aed.name = p;
 282                 aed.bitnum = bitnum;
 283                 afs_event(ATTRIBUTE_ADD, &pb, &aed);
 284                 greatest_att_bitnum = PARA_MAX(greatest_att_bitnum, (int)bitnum);
 285         }
 286 out:
 287         if (ret < 0)
 288                 para_printf(&pb, "%s: %s\n", p, para_strerror(-ret));
 289         if (pb.offset)
 290                 pass_buffer_as_shm(fd, SBD_OUTPUT, pb.buf, pb.offset);
 291         free(pb.buf);
 292 }
 293
 294 int com_addatt(struct command_context *cc)
 295 {
 296         int ret;
 297
 298         if (cc->argc < 2)
 299                 return -E_ATTR_SYNTAX;
 300         ret = send_standard_callback_request(cc->argc - 1, cc->argv + 1,
 301                 com_addatt_callback, afs_cb_result_handler, cc);
 302         if (ret < 0)
 303                 send_strerror(cc, -ret);
 304         return ret;
 305 }
 306
 307 static void com_mvatt_callback(int fd, const struct osl_object *query)
 308 {
 309         char *old = query->data;
 310         size_t size = strlen(old) + 1;
 311         char *new = old + size;
 312         struct osl_object obj = {.data = old, .size = size};
 313         struct osl_row *row;
 314         struct para_buffer pb = {
 315                 .max_size = shm_get_shmmax(),
 316                 .private_data = &(struct afs_max_size_handler_data) {
 317                         .fd = fd,
 318                         .band = SBD_OUTPUT
 319                 },
 320                 .max_size_handler = afs_max_size_handler,
 321         };
 322         int ret;
 323
 324         ret = osl(osl_get_row(attribute_table, ATTCOL_NAME, &obj, &row));
 325         if (ret < 0)
 326                 goto out;
 327         obj.data = new;
 328         obj.size = strlen(new) + 1;
 329         ret = osl(osl_update_object(attribute_table, row, ATTCOL_NAME, &obj));
 330 out:
 331         if (ret < 0)
 332                 para_printf(&pb, "%s\n", para_strerror(-ret));
 333         else
 334                 afs_event(ATTRIBUTE_RENAME, &pb, NULL);
 335         if (pb.offset)
 336                 pass_buffer_as_shm(fd, SBD_OUTPUT, pb.buf, pb.offset);
 337         free(pb.buf);
 338 }
 339
 340 int com_mvatt(struct command_context *cc)
 341 {
 342         int ret;
 343
 344         if (cc->argc != 3)
 345                 return -E_ATTR_SYNTAX;
 346         ret = send_standard_callback_request(cc->argc - 1, cc->argv + 1,
 347                 com_mvatt_callback, afs_cb_result_handler, cc);
 348         if (ret < 0)
 349                 send_strerror(cc, -ret);
 350         return ret;
 351 }
 352
 353 /** Data passed to the action handler of com_rmatt(). */
 354 struct remove_attribute_action_data {
 355         /** Message buffer. */
 356         struct para_buffer pb;
 357         /** Number of attributes removed. */
 358         int num_removed;
 359         /** Bitwise "or" of the removed attributes. */
 360         uint64_t mask_of_removed_atts;
 361 };
 362
 363 /* returns succcess even on errors to keep the loop going */
 364 static int remove_attribute(struct osl_table *table, struct osl_row *row,
 365                 const char *name, void *data)
 366 {
 367         struct remove_attribute_action_data *raad = data;
 368         int ret;
 369         struct rmatt_event_data red = {.name = name};
 370
 371         ret = get_attribute_bitnum_by_name(name, &red.bitnum);
 372         if (ret < 0) {
 373                 para_printf(&raad->pb, "%s: %s\n", name, para_strerror(-ret));
 374                 return 0;
 375         }
 376         ret = osl(osl_del_row(table, row));
 377         if (ret < 0) {
 378                 para_printf(&raad->pb, "%s: %s\n", name, para_strerror(-ret));
 379                 return 0;
 380         }
 381         para_printf(&raad->pb, "removed attribute %s\n", name);
 382         raad->num_removed++;
 383         raad->mask_of_removed_atts |= (1 << red.bitnum);
 384         afs_event(ATTRIBUTE_REMOVE, &raad->pb, &red);
 385         return 1;
 386 }
 387
 388 static void com_rmatt_callback(int fd, const struct osl_object *query)
 389 {
 390         struct remove_attribute_action_data raad = {
 391                 .num_removed = 0,
 392                 .pb = {
 393                         .max_size = shm_get_shmmax(),
 394                         .private_data = &(struct afs_max_size_handler_data) {
 395                                 .fd = fd,
 396                                 .band = SBD_OUTPUT
 397                         },
 398                         .max_size_handler = afs_max_size_handler,
 399                 }
 400         };
 401         int ret;
 402         struct pattern_match_data pmd = {
 403                 .table = attribute_table,
 404                 .patterns = *query,
 405                 .loop_col_num = ATTCOL_BITNUM,
 406                 .match_col_num = ATTCOL_NAME,
 407                 .data = &raad,
 408                 .action = remove_attribute
 409         };
 410         ret = for_each_matching_row(&pmd);
 411         if (ret < 0)
 412                 para_printf(&raad.pb, "%s\n", para_strerror(-ret));
 413         else if (!raad.num_removed)
 414                 para_printf(&raad.pb, "no match -- nothing removed\n");
 415         if (raad.pb.offset)
 416                 pass_buffer_as_shm(fd, SBD_OUTPUT, raad.pb.buf, raad.pb.offset);
 417         free(raad.pb.buf);
 418 }
 419
 420 int com_rmatt(struct command_context *cc)
 421 {
 422         int ret;
 423
 424         if (cc->argc < 2)
 425                 return -E_ATTR_SYNTAX;
 426         ret = send_standard_callback_request(cc->argc - 1, cc->argv + 1,
 427                 com_rmatt_callback, afs_cb_result_handler, cc);
 428         if (ret < 0)
 429                 send_strerror(cc, -ret);
 430         return ret;
 431 }
 432
 433 /**
 434  * Return a binary representation of the given attribute value.
 435  *
 436  * \param atts Pointer to the attribute value.
 437  * \param buf Result.
 438  *
 439  * This function prints a string of at most 64 characters plus the terminating
 440  * \p NULL character into \a buf which must be provided by the caller and at
 441  * least 65 bytes long. The "x" character is used for set attributes and "-" is
 442  * used for unset attributes.
 443  *
 444  * In practice, not all 64 attributes are defined. In this case, the function
 445  * only prints \a N + 1 characters where \a N is the greatest id of a defined
 446  * attribute.
 447  */
 448 void get_attribute_bitmap(const uint64_t *atts, char *buf)
 449 {
 450         int i;
 451         const uint64_t one = 1;
 452
 453         for (i = 0; i <= greatest_att_bitnum; i++)
 454                 buf[greatest_att_bitnum - i] = (*atts & (one << i))? 'x' : '-';
 455         buf[i] = '\0';
 456 }
 457
 458 /**
 459  * Get a string containing the set attributes in text form.
 460  *
 461  * \param atts The attribute bitmap.
 462  * \param delim The delimiter to separate matching attribute names.
 463  * \param text Result pointer.
 464  *
 465  * \return Positive on success, negative on errors. If no attributes have
 466  * been defined, \a *text is NULL.
 467  */
 468 int get_attribute_text(uint64_t *atts, const char *delim, char **text)
 469 {
 470         int i, ret;
 471         const uint64_t one = 1;
 472
 473         *text = NULL;
 474         if (greatest_att_bitnum < 0) { /* no attributes available */
 475                 *text = para_strdup("(no attributes available)");
 476                 return 1;
 477         }
 478         for (i = 0; i <= greatest_att_bitnum; i++) {
 479                 unsigned char bn = i;
 480                 struct osl_object obj = {.data = &bn, .size = 1};
 481                 struct osl_row *row;
 482
 483                 if (!(*atts & (one << i)))
 484                         continue;
 485                 ret = osl(osl_get_row(attribute_table, ATTCOL_BITNUM, &obj, &row));
 486                 if (ret < 0)
 487                         goto err;
 488                 ret = osl(osl_get_object(attribute_table, row, ATTCOL_NAME, &obj));
 489                 if (ret < 0)
 490                         goto err;
 491                 if (*text) {
 492                         char *tmp = make_message("%s%s%s", *text, delim, (char *)obj.data);
 493                         free(*text);
 494                         *text = tmp;
 495                 } else
 496                         *text = para_strdup(obj.data);
 497         }
 498         if (!*text) /* no attributes set */
 499                 *text = para_strdup("");
 500         return 1;
 501 err:
 502         free(*text);
 503         return ret;
 504 }
 505
 506 /**
 507  * Close the attribute table.
 508  *
 509  * \sa osl_close_table().
 510  */
 511 static void attribute_close(void)
 512 {
 513         osl_close_table(attribute_table, OSL_MARK_CLEAN);
 514         attribute_table = NULL;
 515 }
 516
 517 /**
 518  * Open the attribute table.
 519  *
 520  * \param dir The database directory.
 521  *
 522  * \return Positive on success, negative on errors.
 523  *
 524  * \sa osl_open_table().
 525  */
 526 static int attribute_open(const char *dir)
 527 {
 528         int ret;
 529
 530         attribute_table_desc.dir = dir;
 531         ret = osl(osl_open_table(&attribute_table_desc, &attribute_table));
 532         greatest_att_bitnum = -1; /* no atts available */
 533         if (ret >= 0) {
 534                 find_greatest_att_bitnum();
 535                 return ret;
 536         }
 537         attribute_table = NULL;
 538         if (ret >= 0 || ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_NOENT))
 539                 return 1;
 540         return ret;
 541 }
 542
 543 static int attribute_create(const char *dir)
 544 {
 545         attribute_table_desc.dir = dir;
 546         return osl(osl_create_table(&attribute_table_desc));
 547 }
 548
 549 /**
 550  * Initialize the attribute table structure.
 551  *
 552  * \param t The table structure to initialize.
 553  */
 554 void attribute_init(struct afs_table *t)
 555 {
 556         t->open = attribute_open;
 557         t->close = attribute_close;
 558         t->create = attribute_create;
 559 }