summaryrefslogtreecommitdiffstats
path: root/lib/python2.7/site-packages/setools/rolequery.py
diff options
context:
space:
mode:
Diffstat (limited to 'lib/python2.7/site-packages/setools/rolequery.py')
-rw-r--r--lib/python2.7/site-packages/setools/rolequery.py77
1 files changed, 77 insertions, 0 deletions
diff --git a/lib/python2.7/site-packages/setools/rolequery.py b/lib/python2.7/site-packages/setools/rolequery.py
new file mode 100644
index 0000000..e95dfa6
--- /dev/null
+++ b/lib/python2.7/site-packages/setools/rolequery.py
@@ -0,0 +1,77 @@
+# Copyright 2014-2015, Tresys Technology, LLC
+#
+# This file is part of SETools.
+#
+# SETools is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as
+# published by the Free Software Foundation, either version 2.1 of
+# the License, or (at your option) any later version.
+#
+# SETools 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with SETools. If not, see
+# <http://www.gnu.org/licenses/>.
+#
+import logging
+import re
+
+from . import compquery
+from .descriptors import CriteriaSetDescriptor
+
+
+class RoleQuery(compquery.ComponentQuery):
+
+ """
+ Query SELinux policy roles.
+
+ Parameter:
+ policy The policy to query.
+
+ Keyword Parameters/Class attributes:
+ name The role name to match.
+ name_regex If true, regular expression matching
+ will be used on the role names.
+ types The type to match.
+ types_equal If true, only roles with type sets
+ that are equal to the criteria will
+ match. Otherwise, any intersection
+ will match.
+ types_regex If true, regular expression matching
+ will be used on the type names instead
+ of set logic.
+ """
+
+ types = CriteriaSetDescriptor("types_regex", "lookup_type")
+ types_equal = False
+ types_regex = False
+
+ def results(self):
+ """Generator which yields all matching roles."""
+ self.log.info("Generating results from {0.policy}".format(self))
+ self.log.debug("Name: {0.name!r}, regex: {0.name_regex}".format(self))
+ self.log.debug("Types: {0.types!r}, regex: {0.types_regex}, "
+ "eq: {0.types_equal}".format(self))
+
+ for r in self.policy.roles():
+ if r == "object_r":
+ # all types are implicitly added to object_r by the compiler.
+ # technically it is incorrect to skip it, but policy writers
+ # and analysts don't expect to see it in results, and it
+ # will confuse, especially for set equality type queries.
+ continue
+
+ if not self._match_name(r):
+ continue
+
+ if self.types and not self._match_regex_or_set(
+ set(r.types()),
+ self.types,
+ self.types_equal,
+ self.types_regex):
+ continue
+
+ yield r