1 #ifndef NETDATA_REGISTRY_PERSON_H
2 #define NETDATA_REGISTRY_PERSON_H
4 #include "registry_internals.h"
6 // ----------------------------------------------------------------------------
9 // for each PERSON-URL pair we keep this
10 struct registry_person_url {
11 avl avl; // binary tree node
13 REGISTRY_URL *url; // de-duplicated URL
14 REGISTRY_MACHINE *machine; // link the MACHINE of this URL
18 uint32_t first_t; // the first time we saw this
19 uint32_t last_t; // the last time we saw this
20 uint32_t usages; // how many times this has been accessed
22 char machine_name[1]; // the name of the machine, as known by the user
23 // dynamically allocated to fit properly
25 typedef struct registry_person_url REGISTRY_PERSON_URL;
28 struct registry_person {
29 char guid[GUID_LEN + 1]; // the person GUID
31 avl_tree person_urls; // dictionary of PERSON_URLs
33 uint32_t first_t; // the first time we saw this
34 uint32_t last_t; // the last time we saw this
35 uint32_t usages; // how many times this has been accessed
40 typedef struct registry_person REGISTRY_PERSON;
43 extern REGISTRY_PERSON_URL *registry_person_url_index_find(REGISTRY_PERSON *p, const char *url);
44 extern REGISTRY_PERSON_URL *registry_person_url_index_add(REGISTRY_PERSON *p, REGISTRY_PERSON_URL *pu) NEVERNULL WARNUNUSED;
45 extern REGISTRY_PERSON_URL *registry_person_url_index_del(REGISTRY_PERSON *p, REGISTRY_PERSON_URL *pu) WARNUNUSED;
47 extern REGISTRY_PERSON_URL *registry_person_url_allocate(REGISTRY_PERSON *p, REGISTRY_MACHINE *m, REGISTRY_URL *u, char *name, size_t namelen, time_t when);
48 extern REGISTRY_PERSON_URL *registry_person_url_reallocate(REGISTRY_PERSON *p, REGISTRY_MACHINE *m, REGISTRY_URL *u, char *name, size_t namelen, time_t when, REGISTRY_PERSON_URL *pu);
51 extern REGISTRY_PERSON *registry_person_find(const char *person_guid);
52 extern REGISTRY_PERSON *registry_person_allocate(const char *person_guid, time_t when);
53 extern REGISTRY_PERSON *registry_person_get(const char *person_guid, time_t when);
54 extern void registry_person_del(REGISTRY_PERSON *p);
56 // LINKING PERSON -> PERSON_URL
57 extern REGISTRY_PERSON_URL *registry_person_link_to_url(REGISTRY_PERSON *p, REGISTRY_MACHINE *m, REGISTRY_URL *u, char *name, size_t namelen, time_t when);
58 extern void registry_person_unlink_from_url(REGISTRY_PERSON *p, REGISTRY_PERSON_URL *pu);
60 #endif //NETDATA_REGISTRY_PERSON_H