tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/*
2 * AppArmor security module
3 *
4 * This file contains AppArmor policy loading interface function definitions.
5 *
6 * Copyright (C) 1998-2008 Novell/SUSE
7 * Copyright 2009-2010 Canonical Ltd.
8 *
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License as
11 * published by the Free Software Foundation, version 2 of the
12 * License.
13 */
14
15#ifndef __POLICY_INTERFACE_H
16#define __POLICY_INTERFACE_H
17
18#include <linux/list.h>
19#include <linux/kref.h>
20#include <linux/dcache.h>
21#include <linux/workqueue.h>
22
23struct aa_load_ent {
24 struct list_head list;
25 struct aa_profile *new;
26 struct aa_profile *old;
27 struct aa_profile *rename;
28 const char *ns_name;
29};
30
31void aa_load_ent_free(struct aa_load_ent *ent);
32struct aa_load_ent *aa_load_ent_alloc(void);
33
34#define PACKED_FLAG_HAT 1
35
36#define PACKED_MODE_ENFORCE 0
37#define PACKED_MODE_COMPLAIN 1
38#define PACKED_MODE_KILL 2
39#define PACKED_MODE_UNCONFINED 3
40
41struct aa_ns;
42
43enum {
44 AAFS_LOADDATA_ABI = 0,
45 AAFS_LOADDATA_REVISION,
46 AAFS_LOADDATA_HASH,
47 AAFS_LOADDATA_DATA,
48 AAFS_LOADDATA_DIR, /* must be last actual entry */
49 AAFS_LOADDATA_NDENTS /* count of entries */
50};
51
52/*
53 * struct aa_loaddata - buffer of policy raw_data set
54 *
55 * there is no loaddata ref for being on ns list, nor a ref from
56 * d_inode(@dentry) when grab a ref from these, @ns->lock must be held
57 * && __aa_get_loaddata() needs to be used, and the return value
58 * checked, if NULL the loaddata is already being reaped and should be
59 * considered dead.
60 */
61struct aa_loaddata {
62 struct kref count;
63 struct list_head list;
64 struct work_struct work;
65 struct dentry *dents[AAFS_LOADDATA_NDENTS];
66 struct aa_ns *ns;
67 char *name;
68 size_t size;
69 long revision; /* the ns policy revision this caused */
70 int abi;
71 unsigned char *hash;
72
73 char *data;
74};
75
76int aa_unpack(struct aa_loaddata *udata, struct list_head *lh, const char **ns);
77
78/**
79 * __aa_get_loaddata - get a reference count to uncounted data reference
80 * @data: reference to get a count on
81 *
82 * Returns: pointer to reference OR NULL if race is lost and reference is
83 * being repeated.
84 * Requires: @data->ns->lock held, and the return code MUST be checked
85 *
86 * Use only from inode->i_private and @data->list found references
87 */
88static inline struct aa_loaddata *
89__aa_get_loaddata(struct aa_loaddata *data)
90{
91 if (data && kref_get_unless_zero(&(data->count)))
92 return data;
93
94 return NULL;
95}
96
97/**
98 * aa_get_loaddata - get a reference count from a counted data reference
99 * @data: reference to get a count on
100 *
101 * Returns: point to reference
102 * Requires: @data to have a valid reference count on it. It is a bug
103 * if the race to reap can be encountered when it is used.
104 */
105static inline struct aa_loaddata *
106aa_get_loaddata(struct aa_loaddata *data)
107{
108 struct aa_loaddata *tmp = __aa_get_loaddata(data);
109
110 AA_BUG(data && !tmp);
111
112 return tmp;
113}
114
115void __aa_loaddata_update(struct aa_loaddata *data, long revision);
116bool aa_rawdata_eq(struct aa_loaddata *l, struct aa_loaddata *r);
117void aa_loaddata_kref(struct kref *kref);
118struct aa_loaddata *aa_loaddata_alloc(size_t size);
119static inline void aa_put_loaddata(struct aa_loaddata *data)
120{
121 if (data)
122 kref_put(&data->count, aa_loaddata_kref);
123}
124
125#endif /* __POLICY_INTERFACE_H */