sesearch(1)                                                                                                          sesearch(1)



NAME
       sesearch - SELinux policy query tool

SYNOPSIS
       sesearch [OPTIONS] RULE_TYPE [RULE_TYPE ...] [EXPRESSION] [POLICY ...]

DESCRIPTION
       sesearch allows the user to search the rules in a SELinux policy.

POLICY
       sesearch supports loading a SELinux policy in one of four formats.

       source A single text file containing policy source for versions 12 through 21. This file is usually named policy.conf.

       binary A  single file containing a monolithic kernel binary policy for versions 15 through 21. This file is usually named
              by version - for example, policy.20.

       modular
              A list of policy packages each containing a loadable policy module. The first module listed must be a base module.

       policy list
              A single text file containing all the information needed to load a policy, usually exported by  SETools  graphical
              utilities.

       If  no  policy  file is provided, sesearch will search for the system default policy: checking first for a source policy,
       next for a binary policy matching the running kernel's preferred version, and finally for the highest version that can be
       found.   In  the  latter  case,  the  policy  will be downgraded to match the running system.  If no policy can be found,
       sesearch will print an error message and exit.

RULE TYPE OPTIONS
       sesearch is capable of searching multiple types of rules. At least one of the following must be provided to  specify  the
       desired type(s) of rules to search.

       -A, --allow
              Search for allow rules.

       --neverallow
              Search for neverallow rules.

       --auditallow
              Search for auditallow rules.

       --dontaudit
              Search for dontaudit rules.

       -T, --type
              Search for type_transition, type_member, and type_change rules.

       --role_allow
              Search for role allow rules.

       --role_trans
              Search for role_transition rules.

       --range_trans
              Search for range_transition rules.

       --all  Search all rule types.

EXPRESSIONS
       The  user  may specify an expression containing values for a given field(s) in a rule.  Only those fields applicable to a
       given rule type will be used; all other fields will be ignored.  (For example, type_transition rules will ignore the per-
       missions  field.)  If no expression is specified or if none of the specified fields apply to a given rule type, all rules
       of that type are considered to match the expression.

       -s NAME, --source=NAME
              Find rules with type/attribute NAME as their source.

       -t NAME, --target=NAME
              Find rules with type/attribute NAME as their target.

       --role_source=NAME
              Find rules with role NAME as their source.

       --role_target=NAME
              Find rules with role NAME as their target.

       -c NAME, --class=NAME
              Find rules with class NAME as their object class.

       -p P1[,P2,...] --perm=P1[,P2...]
              Find rules with at least one of the specified permissions.  Multiple permissions may be specified as a comma sepa-
              rated list; it is recommended that this list be quoted for shells that interpret comma as a special character.

       -b NAME, --bool=NAME
              Find conditional rules with NAME in their conditional expression.  This option will include rules in both the true
              and false lists of the conditional.

OPTIONS
       The following additional options exist to modify how the search is performed and the amount of  information  printed  for
       each result.

       -d, --direct
              Normally  rules are matched using the type given or any of that type's attributes (or an attribute's types).  This
              "indirect" matching also considers types used in complemented sets, the special set "*", and  the  special  target
              "self".   When  the  direct flag is given, matching is done literally.  The rule must explicitly contain the given
              type (or attribute) for it to be returned.

       -R, --regex
              Use regular expressions to match symbol names.  By default only exact string matches will be considered.

       -n, --linenum
              Print the line number for each rule.  This option is ignored if using the --semantic option or if line numbers are
              not available for the given policy.

       -S, --semantic
              Search  rules semantically instead of syntactically. This option is implied for policies for which syntactic rules
              are not available.

       -C, --show_cond
              Print the conditional expression and state for all conditional rules found.  This option has no effect on uncondi-
              tional rules.

       -h, --help
              Print help information and exit.

       -V, --version
              Print version information and exit.

AUTHOR
       This manual page was written by Jeremy A. Mowery <jmoweryATtresys.com>.

COPYRIGHT
       Copyright(C) 2003-2008 Tresys Technology, LLC

BUGS
       Please report bugs via an email to setools-bugsATtresys.com.

SEE ALSO
       seinfo(1), apol(1)



                                                                                                                     sesearch(1)