2 * Copyright (C) 1997-2014 Andre Noll <maan@systemlinux.org>
4 * Licensed under the GPL v2. For licencing details see COPYING.
7 /** \file attribute.c Attribute handling functions. */
22 static struct osl_table
*attribute_table
;
23 static int greatest_att_bitnum
;
25 /** The columns of the attribute table. */
26 enum attribute_table_columns
{
27 /** The bit number (0-63). */
29 /** The name of the attribute. */
31 /** Number of columns in this table. */
35 static int char_compare(const struct osl_object
*obj1
, const struct osl_object
*obj2
)
37 const unsigned char *c1
= (const unsigned char*)obj1
->data
;
38 const unsigned char *c2
= (const unsigned char*)obj2
->data
;
46 static struct osl_column_description att_cols
[] = {
48 .storage_type
= OSL_MAPPED_STORAGE
,
49 .storage_flags
= OSL_RBTREE
| OSL_FIXED_SIZE
| OSL_UNIQUE
,
51 .compare_function
= char_compare
,
55 .storage_type
= OSL_MAPPED_STORAGE
,
56 .storage_flags
= OSL_RBTREE
| OSL_UNIQUE
,
58 .compare_function
= string_compare
,
62 static struct osl_table_description attribute_table_desc
= {
64 .num_columns
= NUM_ATT_COLUMNS
,
66 .column_descriptions
= att_cols
69 static void find_greatest_att_bitnum(void)
74 struct osl_object obj
= {.data
= &c
, .size
= 1};
75 if (osl_get_row(attribute_table
, ATTCOL_BITNUM
, &obj
,
77 greatest_att_bitnum
= c
;
81 PARA_INFO_LOG("no attributes\n");
82 greatest_att_bitnum
= -E_NO_ATTRIBUTES
;
86 * Retrieve the identifier (number) of an attribute.
88 * \param att_name The name of the attribute.
89 * \param bitnum Result pointer.
91 * \return Positive on success, negative on errors.
93 int get_attribute_bitnum_by_name(const char *att_name
, unsigned char *bitnum
)
95 struct osl_object obj
= {.data
= (char *)att_name
,
96 .size
= strlen(att_name
) + 1};
98 int ret
= osl(osl_get_row(attribute_table
, ATTCOL_NAME
, &obj
, &row
));
102 ret
= osl(osl_get_object(attribute_table
, row
, ATTCOL_BITNUM
, &obj
));
105 *bitnum
= *(unsigned char *)obj
.data
;
110 * Flags used by the lsatt command.
112 * \param \sa com_lsatt().
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. */
119 /** Reverse sort order. */
120 LSATT_FLAG_REVERSE
= 4
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. */
131 static int print_attribute(struct osl_table
*table
, struct osl_row
*row
,
132 const char *name
, void *data
)
134 struct lsatt_action_data
*laad
= data
;
135 struct osl_object bitnum_obj
;
138 if (!(laad
->flags
& LSATT_FLAG_LONG
))
139 return para_printf(&laad
->pb
, "%s\n", name
);
140 ret
= osl(osl_get_object(table
, row
, ATTCOL_BITNUM
, &bitnum_obj
));
142 para_printf(&laad
->pb
, "%s: %s\n", name
, para_strerror(-ret
));
145 return para_printf(&laad
->pb
, "%u\t%s\n", *(unsigned char*)bitnum_obj
.data
,
149 static void com_lsatt_callback(int fd
, const struct osl_object
*query
)
151 struct lsatt_action_data laad
= {
152 .flags
= *(unsigned *) query
->data
,
154 .max_size
= shm_get_shmmax(),
155 .private_data
= &(struct afs_max_size_handler_data
) {
159 .max_size_handler
= afs_max_size_handler
163 struct pattern_match_data pmd
= {
164 .table
= attribute_table
,
165 .loop_col_num
= ATTCOL_BITNUM
,
166 .match_col_num
= ATTCOL_NAME
,
167 .patterns
= {.data
= (char *)query
->data
+ sizeof(laad
.flags
),
168 .size
= query
->size
- sizeof(laad
.flags
)},
169 .pm_flags
= PM_NO_PATTERN_MATCHES_EVERYTHING
,
171 .action
= print_attribute
173 if (laad
.flags
& LSATT_FLAG_SORT_BY_ID
)
174 pmd
.loop_col_num
= ATTCOL_NAME
;
175 if (laad
.flags
& LSATT_FLAG_REVERSE
)
176 pmd
.pm_flags
|= PM_REVERSE_LOOP
;
177 for_each_matching_row(&pmd
);
179 pass_buffer_as_shm(fd
, SBD_OUTPUT
, laad
.pb
.buf
, laad
.pb
.offset
);
183 int com_lsatt(struct command_context
*cc
)
186 struct osl_object options
= {.data
= &flags
, .size
= sizeof(flags
)};
189 for (i
= 1; i
< cc
->argc
; i
++) {
190 const char *arg
= cc
->argv
[i
];
193 if (!strcmp(arg
, "--")) {
197 if (!strcmp(arg
, "-i")) {
198 flags
|= LSATT_FLAG_SORT_BY_ID
;
201 if (!strcmp(arg
, "-l")) {
202 flags
|= LSATT_FLAG_LONG
;
205 if (!strcmp(arg
, "-r")) {
206 flags
|= LSATT_FLAG_REVERSE
;
210 ret
= send_option_arg_callback_request(&options
, cc
->argc
- i
, cc
->argv
+ i
,
211 com_lsatt_callback
, afs_cb_result_handler
, cc
);
213 send_strerror(cc
, -ret
);
214 else if (ret
== 0 && cc
->argc
> 1)
215 ret
= send_sb_va(&cc
->scc
, SBD_ERROR_LOG
, "no matches\n");
219 struct addatt_event_data
{
221 unsigned char bitnum
;
225 static void com_addatt_callback(int fd
, const struct osl_object
*query
)
228 int ret
= 1, ret2
= 0;
229 struct para_buffer pb
= {
230 .max_size
= shm_get_shmmax(),
231 .private_data
= &(struct afs_max_size_handler_data
) {
235 .max_size_handler
= afs_max_size_handler
239 for (p
= query
->data
; p
< (char *)query
->data
+ query
->size
; p
+= len
+ 1) {
240 struct osl_object objs
[NUM_ATT_COLUMNS
];
242 unsigned char bitnum
;
243 struct addatt_event_data aed
;
246 if (!len
|| p
[len
- 1] == '-' || p
[len
- 1] == '+') {
247 ret2
= para_printf(&pb
, "invalid attribute name: %s\n", p
);
252 ret
= get_attribute_bitnum_by_name(p
, &bitnum
);
254 ret2
= para_printf(&pb
, "attribute \"%s\" already exists\n", p
);
259 if (ret
!= -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND
)) /* error */
261 objs
[ATTCOL_BITNUM
].size
= 1;
262 /* find smallest unused attribute */
263 for (bitnum
= 0; bitnum
< 64; bitnum
++) {
264 objs
[ATTCOL_BITNUM
].data
= &bitnum
;
265 ret
= osl(osl_get_row(attribute_table
, ATTCOL_BITNUM
,
266 &objs
[ATTCOL_BITNUM
], &row
));
267 if (ret
== -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND
))
268 break; /* this bitnum is unused, use it */
269 if (ret
< 0) /* error */
271 /* this bit is already in use, try next bit */
274 ret
= -E_ATT_TABLE_FULL
;
277 objs
[ATTCOL_NAME
].data
= p
;
278 objs
[ATTCOL_NAME
].size
= len
+ 1;
279 ret
= osl(osl_add_row(attribute_table
, objs
));
284 afs_event(ATTRIBUTE_ADD
, &pb
, &aed
);
285 greatest_att_bitnum
= PARA_MAX(greatest_att_bitnum
, (int)bitnum
);
288 if (ret
< 0 && ret2
>= 0)
289 para_printf(&pb
, "%s: %s\n", p
, para_strerror(-ret
));
291 pass_buffer_as_shm(fd
, SBD_OUTPUT
, pb
.buf
, pb
.offset
);
295 int com_addatt(struct command_context
*cc
)
300 return -E_ATTR_SYNTAX
;
301 ret
= send_standard_callback_request(cc
->argc
- 1, cc
->argv
+ 1,
302 com_addatt_callback
, afs_cb_result_handler
, cc
);
304 send_strerror(cc
, -ret
);
308 static void com_mvatt_callback(int fd
, const struct osl_object
*query
)
310 char *old
= query
->data
;
311 size_t size
= strlen(old
) + 1;
312 char *new = old
+ size
;
313 struct osl_object obj
= {.data
= old
, .size
= size
};
315 struct para_buffer pb
= {
316 .max_size
= shm_get_shmmax(),
317 .private_data
= &(struct afs_max_size_handler_data
) {
321 .max_size_handler
= afs_max_size_handler
,
325 ret
= osl(osl_get_row(attribute_table
, ATTCOL_NAME
, &obj
, &row
));
329 obj
.size
= strlen(new) + 1;
330 ret
= osl(osl_update_object(attribute_table
, row
, ATTCOL_NAME
, &obj
));
333 para_printf(&pb
, "%s\n", para_strerror(-ret
));
335 afs_event(ATTRIBUTE_RENAME
, &pb
, NULL
);
337 pass_buffer_as_shm(fd
, SBD_OUTPUT
, pb
.buf
, pb
.offset
);
341 int com_mvatt(struct command_context
*cc
)
346 return -E_ATTR_SYNTAX
;
347 ret
= send_standard_callback_request(cc
->argc
- 1, cc
->argv
+ 1,
348 com_mvatt_callback
, afs_cb_result_handler
, cc
);
350 send_strerror(cc
, -ret
);
354 /** Data passed to the action handler of com_rmatt(). */
355 struct remove_attribute_action_data
{
356 /** Message buffer. */
357 struct para_buffer pb
;
358 /** Numver of attributes removed. */
360 /** Bitwise "or" of the removed attributes. */
361 uint64_t mask_of_removed_atts
;
364 static int remove_attribute(struct osl_table
*table
, struct osl_row
*row
,
365 const char *name
, void *data
)
367 struct remove_attribute_action_data
*raad
= data
;
369 struct rmatt_event_data red
= {.name
= name
};
371 ret
= get_attribute_bitnum_by_name(name
, &red
.bitnum
);
373 return para_printf(&raad
->pb
, "%s: %s\n", name
, para_strerror(-ret
));
374 ret
= osl(osl_del_row(table
, row
));
376 return para_printf(&raad
->pb
, "%s: %s\n", name
, para_strerror(-ret
));
377 ret
= para_printf(&raad
->pb
, "removed attribute %s\n", name
);
379 raad
->mask_of_removed_atts
|= (1 << red
.bitnum
);
380 afs_event(ATTRIBUTE_REMOVE
, &raad
->pb
, &red
);
384 static void com_rmatt_callback(int fd
, const struct osl_object
*query
)
386 struct remove_attribute_action_data raad
= {
389 .max_size
= shm_get_shmmax(),
390 .private_data
= &(struct afs_max_size_handler_data
) {
394 .max_size_handler
= afs_max_size_handler
,
398 struct pattern_match_data pmd
= {
399 .table
= attribute_table
,
401 .loop_col_num
= ATTCOL_BITNUM
,
402 .match_col_num
= ATTCOL_NAME
,
404 .action
= remove_attribute
406 ret
= for_each_matching_row(&pmd
);
408 ret2
= para_printf(&raad
.pb
, "%s\n", para_strerror(-ret
));
409 else if (!raad
.num_removed
)
410 ret2
= para_printf(&raad
.pb
, "no match -- nothing removed\n");
411 if (ret2
>= 0 && raad
.pb
.offset
)
412 pass_buffer_as_shm(fd
, SBD_OUTPUT
, raad
.pb
.buf
, raad
.pb
.offset
);
416 int com_rmatt(struct command_context
*cc
)
421 return -E_ATTR_SYNTAX
;
422 ret
= send_standard_callback_request(cc
->argc
- 1, cc
->argv
+ 1,
423 com_rmatt_callback
, afs_cb_result_handler
, cc
);
425 send_strerror(cc
, -ret
);
430 * Return a binary representation of the given attribute value.
432 * \param atts Pointer to the attribute value.
435 * This function prints a string of at most 64 characters plus the terminating
436 * \p NULL character into \a buf which must be provided by the caller and at
437 * least 65 bytes long. The "x" character is used for set attributes and "-" is
438 * used for unset attributes.
440 * In practice, not all 64 attributes are defined. In this case, the function
441 * only prints \a N + 1 charaters where \a N is the greatest id of a defined
444 void get_attribute_bitmap(const uint64_t *atts
, char *buf
)
447 const uint64_t one
= 1;
449 for (i
= 0; i
<= greatest_att_bitnum
; i
++)
450 buf
[greatest_att_bitnum
- i
] = (*atts
& (one
<< i
))? 'x' : '-';
455 * Get a string containing the set attributes in text form.
457 * \param atts The attribute bitmap.
458 * \param delim The delimiter to separate matching attribute names.
459 * \param text Result pointer.
461 * \return Positive on success, negative on errors. If no attributes have
462 * been defined, \a *text is NULL.
464 int get_attribute_text(uint64_t *atts
, const char *delim
, char **text
)
467 const uint64_t one
= 1;
470 if (greatest_att_bitnum
< 0) { /* no attributes available */
471 *text
= para_strdup("(no attributes available)");
474 for (i
= 0; i
<= greatest_att_bitnum
; i
++) {
475 unsigned char bn
= i
;
476 struct osl_object obj
= {.data
= &bn
, .size
= 1};
479 if (!(*atts
& (one
<< i
)))
481 ret
= osl(osl_get_row(attribute_table
, ATTCOL_BITNUM
, &obj
, &row
));
484 ret
= osl(osl_get_object(attribute_table
, row
, ATTCOL_NAME
, &obj
));
488 char *tmp
= make_message("%s%s%s", *text
, delim
, (char *)obj
.data
);
492 *text
= para_strdup(obj
.data
);
494 if (!*text
) /* no attributes set */
495 *text
= para_strdup("");
503 * Close the attribute table.
505 * \sa osl_close_table().
507 static void attribute_close(void)
509 osl_close_table(attribute_table
, OSL_MARK_CLEAN
);
510 attribute_table
= NULL
;
514 * Open the attribute table.
516 * \param dir The database directory.
518 * \return Positive on success, negative on errors.
520 * \sa osl_open_table().
522 static int attribute_open(const char *dir
)
526 attribute_table_desc
.dir
= dir
;
527 ret
= osl(osl_open_table(&attribute_table_desc
, &attribute_table
));
528 greatest_att_bitnum
= -1; /* no atts available */
530 find_greatest_att_bitnum();
533 attribute_table
= NULL
;
534 if (ret
>= 0 || ret
== -OSL_ERRNO_TO_PARA_ERROR(E_OSL_NOENT
))
539 static int attribute_create(const char *dir
)
541 attribute_table_desc
.dir
= dir
;
542 return osl(osl_create_table(&attribute_table_desc
));
546 * Initialize the attribute table structure.
548 * \param t The table structure to initialize.
550 void attribute_init(struct afs_table
*t
)
552 t
->open
= attribute_open
;
553 t
->close
= attribute_close
;
554 t
->create
= attribute_create
;