summaryrefslogtreecommitdiffstats
path: root/src/auth/auth-fields.h
blob: 25c91c72e77fa8300f013abd024f8d8746d6201d (plain)
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
#ifndef AUTH_FIELDS_H
#define AUTH_FIELDS_H

struct auth_request;

enum auth_field_flags {
	/* This field is internal to auth process and won't be sent to client */
	AUTH_FIELD_FLAG_HIDDEN	= 0x01,
	/* Changed since last snapshot. Set/cleared automatically. */
	AUTH_FIELD_FLAG_CHANGED	= 0x02
};

struct auth_field {
	const char *key, *value;
	enum auth_field_flags flags;
};
ARRAY_DEFINE_TYPE(auth_field, struct auth_field);

struct auth_fields *auth_fields_init(pool_t pool);
void auth_fields_add(struct auth_fields *fields,
		     const char *key, const char *value,
		     enum auth_field_flags flags) ATTR_NULL(3);
void auth_fields_reset(struct auth_fields *fields);
void auth_fields_remove(struct auth_fields *fields, const char *key);

const char *auth_fields_find(struct auth_fields *fields, const char *key);
bool auth_fields_exists(struct auth_fields *fields, const char *key);

void auth_fields_import(struct auth_fields *fields, const char *str,
			enum auth_field_flags flags);
void auth_fields_import_prefixed(struct auth_fields *fields, const char *prefix,
				 const char *str, enum auth_field_flags flags);
const ARRAY_TYPE(auth_field) *auth_fields_export(struct auth_fields *fields);
/* Append fields where (flag & flags_mask) == flags_result. */
void auth_fields_append(struct auth_fields *fields, string_t *dest,
			enum auth_field_flags flags_mask,
			enum auth_field_flags flags_result);
bool auth_fields_is_empty(struct auth_fields *fields);
/* If the field exists, clear its value (so the exported string will be "key"
   instead of e.g. "key=y"). */
void auth_fields_booleanize(struct auth_fields *fields, const char *key);

/* Remember the current fields. */
void auth_fields_snapshot(struct auth_fields *fields);
/* Rollback to previous snapshot, or clear the fields if there isn't any. */
void auth_fields_rollback(struct auth_fields *fields);

#endif