1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
/*
* Copyright (C) 2011 Codethink Ltd.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License Version 2 as
* published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef _LIBTBD_XATTRS_H
#define _LIBTBD_XATTRS_H
#include <stddef.h>
/* structure for names data */
typedef struct tbd_xattrs_names {
char const *begin;
char const *end;
} tbd_xattrs_names_t;
/* gets a list of the names of the file referenced by path */
extern int tbd_xattrs_names(char const *path, tbd_xattrs_names_t *names_out);
/* frees up the INTERNAL resources of the list, doesn't free the list itself */
extern void tbd_xattrs_names_free(tbd_xattrs_names_t *names);
/* calls f with every name in the list */
extern int tbd_xattrs_names_each(tbd_xattrs_names_t const *names,
int (*f)(char const *name, void *ud),
void *ud);
/* gets how many different attributes there are in the list */
extern int tbd_xattrs_names_count(tbd_xattrs_names_t const *names, int *count);
/* puts the value of the attribute called name into *buf with size *bufsize
* if *buf is NULL or *bufsize is 0 then memory will be allocated for it
* if *buf was too small it will be reallocated
* if it is successful, *buf will contain *valsize bytes of data
*/
extern int tbd_xattrs_get(char const *path, char const* name, void **buf,
size_t *bufsize, size_t *valsize);
/* removes all attributes of the file referenced by path */
extern int tbd_xattrs_removeall(char const *path);
/* calls f for every attribute:value pair in the list */
typedef int (*tbd_xattrs_pairs_callback_t)(char const *name, void const *data,
size_t size, void *ud);
extern int tbd_xattrs_pairs(tbd_xattrs_names_t const *names, char const *path,
tbd_xattrs_pairs_callback_t f, void *ud);
#endif
|