From 21f11b304ce2e76c62fc0db32874c6d3033fe39a Mon Sep 17 00:00:00 2001 From: Vit Mojzis Date: Jun 23 2023 09:20:28 +0000 Subject: policycoreutils-3.5-5 - python/sepolicy: Fix spec file dependencies - python/sepolicy: Fix template for confined user policy modules - Improve man pages and add examples Signed-off-by: Vit Mojzis --- diff --git a/0006-python-chcat-Improve-man-pages.patch b/0006-python-chcat-Improve-man-pages.patch new file mode 100644 index 0000000..4672bf8 --- /dev/null +++ b/0006-python-chcat-Improve-man-pages.patch @@ -0,0 +1,74 @@ +From 6c3527eeada62cbec8f58eb1aa55b76bb0e6018d Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Thu, 4 May 2023 14:04:47 +0200 +Subject: [PATCH] python/chcat: Improve man pages + +- Explain applying range/list of categories +- "-d" removes all categories of given file/user +- Add examples + +Signed-off-by: Vit Mojzis +Acked-by: James Carter +--- + python/chcat/chcat.8 | 23 ++++++++++++++++------- + 1 file changed, 16 insertions(+), 7 deletions(-) + +diff --git a/python/chcat/chcat.8 b/python/chcat/chcat.8 +index d095a255..3e1f7ca2 100644 +--- a/python/chcat/chcat.8 ++++ b/python/chcat/chcat.8 +@@ -1,6 +1,6 @@ + .TH CHCAT "8" "September 2005" "chcat" "User Commands" + .SH NAME +-chcat \- change file SELinux security category ++chcat \- change SELinux security categories of files/users + .SH SYNOPSIS + .B chcat + \fIcategory file\fR... +@@ -25,23 +25,33 @@ chcat \- change file SELinux security category + .br + .SH DESCRIPTION + .PP +-Change/Remove the security \fIcategory\fR for each \fIfile\fR or \fIuser\fR. +-.PP +-Use +/- to add/remove categories from a \fIfile\fR or \fIuser\fR. ++Use +/- to add/remove categories from a \fIfile\fR or \fIuser\fR (only a single category can be specified at a time). Or specify the desired list/range of categories to be applied (replacing the existing categories). + .PP + .B + Note: +-When removing a category you must specify '\-\-' on the command line before using the \-Category syntax. This tells the command that you have finished entering options and are now specifying a category name instead. ++When removing a category you must specify '\-\-' on the command line before using the \-Category syntax. This tells the command that you have finished entering options and are now specifying a category name instead. + + .TP + \fB\-d\fR +-delete the category from each FILE/USER. ++delete all categories from given FILE/USER. + .TP + \fB\-L\fR + list available categories. + .TP + \fB\-l\fR + Tells chcat to operate on users instead of files. ++ ++.SH EXAMPLE ++.nf ++Replace categories of user "test" with c0.c6 ++# chcat -l c0.c6 test ++Add category c1023 to user "test" ++# chcat -l +c1023 test ++Remove category c5 from file "file" ++# chcat -- -c5 file ++Remove all categories from file "file" ++# chcat -d file ++ + .SH "SEE ALSO" + .TP + chcon(1), selinux(8), semanage(8) +@@ -52,4 +62,3 @@ When operating on files this script wraps the chcon command. + /etc/selinux/{SELINUXTYPE}/setrans.conf + .br + /etc/selinux/{SELINUXTYPE}/seusers +- +-- +2.40.0 + diff --git a/0007-python-audit2allow-Add-missing-options-to-man-page.patch b/0007-python-audit2allow-Add-missing-options-to-man-page.patch new file mode 100644 index 0000000..3c657b7 --- /dev/null +++ b/0007-python-audit2allow-Add-missing-options-to-man-page.patch @@ -0,0 +1,79 @@ +From 11325baab31cec170e01c2548d09e540d6a2e67a Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Thu, 4 May 2023 14:04:48 +0200 +Subject: [PATCH] python/audit2allow: Add missing options to man page + +Signed-off-by: Vit Mojzis +--- + python/audit2allow/audit2allow.1 | 24 +++++++++++++++++++----- + 1 file changed, 19 insertions(+), 5 deletions(-) + +diff --git a/python/audit2allow/audit2allow.1 b/python/audit2allow/audit2allow.1 +index 04ec3239..c31021d3 100644 +--- a/python/audit2allow/audit2allow.1 ++++ b/python/audit2allow/audit2allow.1 +@@ -40,10 +40,10 @@ + Read input from audit and message log, conflicts with \-i + .TP + .B "\-b" | "\-\-boot" +-Read input from audit messages since last boot conflicts with \-i ++Read input from audit messages since last boot, conflicts with \-i + .TP + .B "\-d" | "\-\-dmesg" +-Read input from output of ++Read input from output of + .I /bin/dmesg. + Note that all audit messages are not available via dmesg when + auditd is running; use "ausearch \-m avc | audit2allow" or "\-a" instead. +@@ -51,15 +51,22 @@ auditd is running; use "ausearch \-m avc | audit2allow" or "\-a" instead. + .B "\-D" | "\-\-dontaudit" + Generate dontaudit rules (Default: allow) + .TP ++.B "\-e" | "\-\-explain" ++Fully explain generated output ++.TP + .B "\-h" | "\-\-help" + Print a short usage message + .TP + .B "\-i " | "\-\-input " +-read input from ++Read input from + .I + .TP ++.B "\-\-interface-info=" ++Read interface information from ++.I ++.TP + .B "\-l" | "\-\-lastreload" +-read input only after last policy reload ++Read input only after last policy reload + .TP + .B "\-m " | "\-\-module " + Generate module/require output +@@ -70,8 +77,12 @@ Generate loadable module package, conflicts with \-o + .B "\-p " | "\-\-policy " + Policy file to use for analysis + .TP ++.B "\-\-perm-map " ++Read permission map from ++.I ++.TP + .B "\-o " | "\-\-output " +-append output to ++Append output to + .I + .TP + .B "\-r" | "\-\-requires" +@@ -85,6 +96,9 @@ This is the default behavior. + Generate reference policy using installed macros. + This attempts to match denials against interfaces and may be inaccurate. + .TP ++.B "\-t " | "\-\-type=" ++Only process messages with a type that matches this regex ++.TP + .B "\-x" | "\-\-xperms" + Generate extended permission access vector rules + .TP +-- +2.40.0 + diff --git a/0008-python-semanage-Improve-man-pages.patch b/0008-python-semanage-Improve-man-pages.patch new file mode 100644 index 0000000..653e06e --- /dev/null +++ b/0008-python-semanage-Improve-man-pages.patch @@ -0,0 +1,464 @@ +From fe6d5bd9a3043beb4c65b13d675f32bac2bbdaeb Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Thu, 4 May 2023 14:04:49 +0200 +Subject: [PATCH] python/semanage: Improve man pages + +- Add missing options +- Add more examples +- Note special cases + +Signed-off-by: Vit Mojzis +--- + python/semanage/semanage-boolean.8 | 9 ++++++--- + python/semanage/semanage-dontaudit.8 | 8 +++++--- + python/semanage/semanage-export.8 | 10 +++++++++- + python/semanage/semanage-fcontext.8 | 17 +++++++++++------ + python/semanage/semanage-ibendport.8 | 6 ++++-- + python/semanage/semanage-ibpkey.8 | 6 ++++-- + python/semanage/semanage-import.8 | 10 +++++++++- + python/semanage/semanage-interface.8 | 8 ++++++-- + python/semanage/semanage-login.8 | 14 ++++++++------ + python/semanage/semanage-module.8 | 15 ++++++++++----- + python/semanage/semanage-node.8 | 16 +++++++++++++--- + python/semanage/semanage-permissive.8 | 8 +++++--- + python/semanage/semanage-port.8 | 10 ++++++---- + python/semanage/semanage-user.8 | 8 +++++--- + 14 files changed, 101 insertions(+), 44 deletions(-) + +diff --git a/python/semanage/semanage-boolean.8 b/python/semanage/semanage-boolean.8 +index 1282d106..3b664023 100644 +--- a/python/semanage/semanage-boolean.8 ++++ b/python/semanage/semanage-boolean.8 +@@ -7,11 +7,14 @@ semanage\-boolean \- SELinux Policy Management boolean tool + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage boolean command controls the settings of booleans in SELinux policy. booleans are if\-then\-else rules written in SELinux Policy. They can be used to customize the way that SELinux Policy rules effect a confined domain. ++from policy sources. ++.B semanage boolean ++command controls the settings of booleans in SELinux policy. Booleans are if\-then\-else rules written in SELinux Policy. They can be used to customize the way that SELinux Policy rules effect a confined domain. ++ + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +@@ -45,7 +48,7 @@ Disable the boolean + + .SH EXAMPLE + .nf +-Turn on the apache can send mail boolean ++Turn on the "apache can send mail" boolean (persistent version of #setsebool httpd_can_sendmail on) + # semanage boolean \-m \-\-on httpd_can_sendmail + + List customized booleans +diff --git a/python/semanage/semanage-dontaudit.8 b/python/semanage/semanage-dontaudit.8 +index 81accc6f..51d1f4b6 100644 +--- a/python/semanage/semanage-dontaudit.8 ++++ b/python/semanage/semanage-dontaudit.8 +@@ -7,13 +7,15 @@ + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage dontaudit toggles whether or not dontaudit rules will be in the policy. Policy writers use dontaudit rules to cause +-confined applications to use alternative paths. Dontaudit rules are denied but not reported in the logs. Some times dontaudit rules can cause bugs in applications but policy writers will not realize it since the AVC is not audited. Turning off dontaudit rules with this command to see if the kernel is blocking an access. ++from policy sources. ++.B semanage dontaudit ++toggles whether or not dontaudit rules will be in the policy. Policy writers use dontaudit rules to cause ++confined applications to use alternative paths. Dontaudit rules are denied but not reported in the logs. Sometimes dontaudit rules can cause bugs in applications but policy writers will not realize it since the AVC is not audited. Turn off dontaudit rules with this command to see if the kernel is blocking an access. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-S STORE, \-\-store STORE + Select an alternate SELinux Policy Store to manage +diff --git a/python/semanage/semanage-export.8 b/python/semanage/semanage-export.8 +index d422683b..51984793 100644 +--- a/python/semanage/semanage-export.8 ++++ b/python/semanage/semanage-export.8 +@@ -7,7 +7,15 @@ + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage import and export can be used to extract the SELinux modifications from one machine and apply them to another. You can put a whole group of semanage commands within a file and apply them to a machine in a single transaction. ++from policy sources. ++.B semanage import ++and ++.B export ++can be used to extract the SELinux modifications from one machine and apply them to another. Please note that this will remove all current semanage customizations on the second machine as the command list generated using ++.B semanage export ++start with ++.I -D ++for all semanage sub-commands. You can put a whole group of semanage commands within a file and apply them to a machine in a single transaction. + + .SH "OPTIONS" + .TP +diff --git a/python/semanage/semanage-fcontext.8 b/python/semanage/semanage-fcontext.8 +index 1ebf085f..3e327d88 100644 +--- a/python/semanage/semanage-fcontext.8 ++++ b/python/semanage/semanage-fcontext.8 +@@ -8,8 +8,10 @@ semanage\-fcontext \- SELinux Policy Management file context tool + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage fcontext is used to manage the default +-file system labeling on an SELinux system. This command maps file paths using regular expressions to SELinux labels. ++from policy sources. ++.B semanage fcontext ++is used to manage the default file system labeling on an SELinux system. ++This command maps file paths using regular expressions to SELinux labels. + + FILE_SPEC may contain either a fully qualified path, + or a Perl compatible regular expression (PCRE), +@@ -32,7 +34,7 @@ to avoid unintentionally impacting other parts of the filesystem. + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +@@ -82,12 +84,13 @@ MLS/MCS Security Range (MLS/MCS Systems only) SELinux Range for SELinux login ma + + .SH EXAMPLE + .nf +-.I remember to run restorecon after you set the file context +-Add file-context for everything under /web ++.I Remember to run restorecon after you set the file context ++Add file-context httpd_sys_content_t for everything under /web + # semanage fcontext \-a \-t httpd_sys_content_t "/web(/.*)?" + # restorecon \-R \-v /web + + Substitute /home1 with /home when setting file context ++i.e. label everything under /home1 the same way /home is labeled + # semanage fcontext \-a \-e /home /home1 + # restorecon \-R \-v /home1 + +@@ -99,7 +102,9 @@ execute the following commands. + + .SH "SEE ALSO" + .BR selinux (8), +-.BR semanage (8) ++.BR semanage (8), ++.BR restorecon (8), ++.BR selabel_file (5) + + .SH "AUTHOR" + This man page was written by Daniel Walsh +diff --git a/python/semanage/semanage-ibendport.8 b/python/semanage/semanage-ibendport.8 +index 0a29eae1..53fe4ee8 100644 +--- a/python/semanage/semanage-ibendport.8 ++++ b/python/semanage/semanage-ibendport.8 +@@ -5,12 +5,14 @@ + .B semanage ibendport [\-h] [\-n] [\-N] [\-S STORE] [ \-\-add \-t TYPE \-z IBDEV_NAME \-r RANGE port | \-\-delete \-z IBDEV_NAME port | \-\-deleteall | \-\-extract | \-\-list [\-C] | \-\-modify \-t TYPE \-z IBDEV_NAME \-r RANGE port ] + + .SH "DESCRIPTION" +-semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. semanage ibendport controls the ibendport number to ibendport type definitions. ++semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. ++.B semanage ibendport ++controls the ibendport number to ibendport type definitions. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +diff --git a/python/semanage/semanage-ibpkey.8 b/python/semanage/semanage-ibpkey.8 +index 51f455ab..6cc5e02f 100644 +--- a/python/semanage/semanage-ibpkey.8 ++++ b/python/semanage/semanage-ibpkey.8 +@@ -5,12 +5,14 @@ + .B semanage ibpkey [\-h] [\-n] [\-N] [\-S STORE] [ \-\-add \-t TYPE \-x SUBNET_PREFIX \-r RANGE ibpkey_name | ibpkey_range | \-\-delete \-x SUBNET_PREFIX ibpkey_name | ibpkey_range | \-\-deleteall | \-\-extract | \-\-list [\-C] | \-\-modify \-t TYPE \-x SUBNET_PREFIX \-r RANGE ibpkey_name | ibpkey_range ] + + .SH "DESCRIPTION" +-semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. semanage ibpkey controls the ibpkey number to ibpkey type definitions. ++semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. ++.B semanage ibpkey ++controls the ibpkey number to ibpkey type definitions. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +diff --git a/python/semanage/semanage-import.8 b/python/semanage/semanage-import.8 +index 4a9b3e76..041e9ab0 100644 +--- a/python/semanage/semanage-import.8 ++++ b/python/semanage/semanage-import.8 +@@ -7,7 +7,15 @@ + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage import and export can be used to extract the SELinux modifications from one machine and apply them to another. You can put a whole group of semanage commands within a file and apply them to a machine in a single transaction. ++from policy sources. ++.B semanage import ++and ++.B export ++can be used to extract the SELinux modifications from one machine and apply them to another. Please note that this will remove all current semanage customizations on the second machine as the command list generated using ++.B semanage export ++start with ++.I -D ++for all semanage sub-commands. You can put a whole group of semanage commands within a file and apply them to a machine in a single transaction. + + .SH "OPTIONS" + .TP +diff --git a/python/semanage/semanage-interface.8 b/python/semanage/semanage-interface.8 +index d9d526dc..080db70b 100644 +--- a/python/semanage/semanage-interface.8 ++++ b/python/semanage/semanage-interface.8 +@@ -7,12 +7,14 @@ + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage interface controls the labels assigned to network interfaces. ++from policy sources. ++.B semanage interface ++controls the labels assigned to network interfaces. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +@@ -54,6 +56,8 @@ MLS/MCS Security Range (MLS/MCS Systems only) SELinux Range for SELinux login ma + .nf + list all interface definitions + # semanage interface \-l ++Assign type netif_t and MLS/MCS range s0:c0.c1023 to interface eth0 ++# semanage interface \-a \-t netif_t \-r s0:c0.c1023 eth0 + + .SH "SEE ALSO" + .BR selinux (8), +diff --git a/python/semanage/semanage-login.8 b/python/semanage/semanage-login.8 +index f451bdc6..9076a1ed 100644 +--- a/python/semanage/semanage-login.8 ++++ b/python/semanage/semanage-login.8 +@@ -7,12 +7,14 @@ + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage login controls the mapping between a Linux User and the SELinux User. It can be used to turn on confined users. For example you could define that a particular user or group of users will login to a system as the user_u user. Prefix the group name with a '%' sign to indicate a group name. ++from policy sources. ++.B semanage login ++controls the mapping between a Linux User and the SELinux User. It can be used to turn on confined users. For example you could define that a particular user or group of users will login to a system as the user_u user. Prefix the group name with a '%' sign to indicate a group name. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +@@ -52,11 +54,11 @@ MLS/MCS Security Range (MLS/MCS Systems only) SELinux Range for SELinux login ma + + .SH EXAMPLE + .nf +-Modify the default user on the system to the guest_u user ++Set the default SELinux user on the system to guest_u + # semanage login \-m \-s guest_u __default__ +-Assign gijoe user on an MLS machine a range and to the staff_u user +-# semanage login \-a \-s staff_u \-rSystemLow-Secret gijoe +-Assign all users in the engineering group to the staff_u user ++Map user gijoe to SELinux user staff_u and assign MLS range SystemLow\-Secret ++# semanage login \-a \-s staff_u \-rSystemLow\-Secret gijoe ++Map all users in the engineering group to SELinux user staff_u + # semanage login \-a \-s staff_u %engineering + + .SH "SEE ALSO" +diff --git a/python/semanage/semanage-module.8 b/python/semanage/semanage-module.8 +index e0057167..6913b0cd 100644 +--- a/python/semanage/semanage-module.8 ++++ b/python/semanage/semanage-module.8 +@@ -5,12 +5,14 @@ + .B semanage module [\-h] [\-n] [\-N] [\-S STORE] (\-a | \-r | \-e | \-d | \-\-extract | \-\-list [\-C] | \-\-deleteall) [module_name] + + .SH "DESCRIPTION" +-semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. semanage module installs, removes, disables SELinux Policy modules. ++semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. ++.B semanage module ++installs, removes, disables, or enables SELinux Policy modules. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +@@ -22,11 +24,14 @@ Do not reload policy after commit + Select an alternate SELinux Policy Store to manage + .TP + .I \-a, \-\-add +-Install specified module ++Install specified module. Accepts both binary policy files (.pp) and CIL source files + .TP + .I \-r, \-\-remove + Remove specified module + .TP ++.I \-D, \-\-deleteall ++Remove all local customizations related to modules ++.TP + .I \-d \-\-disable + Disable specified module + .TP +@@ -48,8 +53,8 @@ List all modules + # semanage module \-l + Disable unconfined module + # semanage module \-\-disable unconfined +-Install custom apache policy module +-# semanage module \-a myapache ++Install custom apache policy module (same as #semodule -i myapache.pp) ++# semanage module \-a myapache.pp + + .SH "SEE ALSO" + .BR selinux (8), +diff --git a/python/semanage/semanage-node.8 b/python/semanage/semanage-node.8 +index a0098221..c78d6c3e 100644 +--- a/python/semanage/semanage-node.8 ++++ b/python/semanage/semanage-node.8 +@@ -7,12 +7,14 @@ + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage controls the ipaddress to node type definitions. ++from policy sources. ++.B semanage node ++controls the IP address to node type definitions. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +@@ -54,5 +56,13 @@ SELinux type for the object + MLS/MCS Security Range (MLS/MCS Systems only) SELinux Range for SELinux login mapping defaults to the SELinux user record range. SELinux Range for SELinux user defaults to s0. + .TP + .I \-p PROTO, \-\-proto PROTO +- + Protocol for the specified port (tcp|udp) or internet protocol version for the specified node (ipv4|ipv6). ++ ++.SH "EXAMPLE" ++.nf ++Apply type node_t to ipv4 node 127.0.0.2 ++# semanage node \-a \-t node_t \-p ipv4 \-M 255.255.255.255 127.0.0.2 ++ ++.SH "SEE ALSO" ++.BR selinux (8), ++.BR semanage (8) +diff --git a/python/semanage/semanage-permissive.8 b/python/semanage/semanage-permissive.8 +index 5c3364fa..0414a850 100644 +--- a/python/semanage/semanage-permissive.8 ++++ b/python/semanage/semanage-permissive.8 +@@ -5,12 +5,14 @@ + .B semanage permissive [\-h] [\-n] [\-N] [\-S STORE] (\-\-add TYPE | \-\-delete TYPE | \-\-deleteall | \-\-extract | \-\-list) + + .SH "DESCRIPTION" +-semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. semanage permissive adds or removes a SELinux Policy permissive module. ++semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. ++.B semanage permissive ++adds or removes a SELinux Policy permissive module. Please note that this command can make any domain permissive, but can only remove the permissive property from domains where it was added by semanage permissive ("semanage permissive -d" can only be used on types listed as "Customized Permissive Types" by "semanage permissive -l"). + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-a, \-\-add + Add a record of the specified object type +@@ -38,7 +40,7 @@ Select an alternate SELinux Policy Store to manage + + .SH EXAMPLE + .nf +-List all permissive modules ++List all permissive domains ("Builtin Permissive Types" where set by the system policy, or a custom policy module) + # semanage permissive \-l + Make httpd_t (Web Server) a permissive domain + # semanage permissive \-a httpd_t +diff --git a/python/semanage/semanage-port.8 b/python/semanage/semanage-port.8 +index 12ec14c2..c6048660 100644 +--- a/python/semanage/semanage-port.8 ++++ b/python/semanage/semanage-port.8 +@@ -5,12 +5,14 @@ + .B semanage port [\-h] [\-n] [\-N] [\-S STORE] [ \-\-add \-t TYPE \-p PROTOCOL \-r RANGE port_name | port_range | \-\-delete \-p PROTOCOL port_name | port_range | \-\-deleteall | \-\-extract | \-\-list [\-C] | \-\-modify \-t TYPE \-p PROTOCOL \-r RANGE port_name | port_range ] + + .SH "DESCRIPTION" +-semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. semanage port controls the port number to port type definitions. ++semanage is used to configure certain elements of SELinux policy without requiring modification to or recompilation from policy sources. ++.B semanage port ++controls the port number to port type definitions. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +@@ -55,9 +57,9 @@ Protocol for the specified port (tcp|udp|dccp|sctp) or internet protocol version + .nf + List all port definitions + # semanage port \-l +-Allow Apache to listen on tcp port 81 ++Allow Apache to listen on tcp port 81 (i.e. assign tcp port 81 label http_port_t, which apache is allowed to listen on) + # semanage port \-a \-t http_port_t \-p tcp 81 +-Allow sshd to listen on tcp port 8991 ++Allow sshd to listen on tcp port 8991 (i.e. assign tcp port 8991 label ssh_port_t, which sshd is allowed to listen on) + # semanage port \-a \-t ssh_port_t \-p tcp 8991 + + .SH "SEE ALSO" +diff --git a/python/semanage/semanage-user.8 b/python/semanage/semanage-user.8 +index 23fec698..50d50bea 100644 +--- a/python/semanage/semanage-user.8 ++++ b/python/semanage/semanage-user.8 +@@ -7,12 +7,14 @@ + .SH "DESCRIPTION" + semanage is used to configure certain elements of + SELinux policy without requiring modification to or recompilation +-from policy sources. semanage user controls the mapping between an SELinux User and the roles and MLS/MCS levels. ++from policy sources. ++.B semanage user ++controls the mapping between an SELinux User and the roles and MLS/MCS levels. + + .SH "OPTIONS" + .TP + .I \-h, \-\-help +-show this help message and exit ++Show this help message and exit + .TP + .I \-n, \-\-noheading + Do not print heading when listing the specified object type +@@ -59,7 +61,7 @@ List SELinux users + # semanage user \-l + Modify groups for staff_u user + # semanage user \-m \-R "system_r unconfined_r staff_r" staff_u +-Add level for TopSecret Users ++Assign user topsecret_u role staff_r and range s0\-TopSecret + # semanage user \-a \-R "staff_r" \-rs0\-TopSecret topsecret_u + + .SH "SEE ALSO" +-- +2.40.0 + diff --git a/0009-python-audit2allow-Remove-unused-debug-option.patch b/0009-python-audit2allow-Remove-unused-debug-option.patch new file mode 100644 index 0000000..811cabf --- /dev/null +++ b/0009-python-audit2allow-Remove-unused-debug-option.patch @@ -0,0 +1,29 @@ +From 10fb1da179ab377db96697e79ac45bfdcd251989 Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Thu, 4 May 2023 14:04:50 +0200 +Subject: [PATCH] python/audit2allow: Remove unused "debug" option + +The option is not referenced anywhere in the code and I couldn't figure +out its purpose from the description. + +Signed-off-by: Vit Mojzis +--- + python/audit2allow/audit2allow | 2 -- + 1 file changed, 2 deletions(-) + +diff --git a/python/audit2allow/audit2allow b/python/audit2allow/audit2allow +index eafeea88..5587a2db 100644 +--- a/python/audit2allow/audit2allow ++++ b/python/audit2allow/audit2allow +@@ -88,8 +88,6 @@ class AuditToPolicy: + parser.add_option("--interface-info", dest="interface_info", help="file name of interface information") + parser.add_option("-x", "--xperms", action="store_true", dest="xperms", + default=False, help="generate extended permission rules") +- parser.add_option("--debug", dest="debug", action="store_true", default=False, +- help="leave generated modules for -M") + parser.add_option("-w", "--why", dest="audit2why", action="store_true", default=(os.path.basename(sys.argv[0]) == "audit2why"), + help="Translates SELinux audit messages into a description of why the access was denied") + +-- +2.40.0 + diff --git a/0010-policycoreutils-Add-examples-to-man-pages.patch b/0010-policycoreutils-Add-examples-to-man-pages.patch new file mode 100644 index 0000000..4aead05 --- /dev/null +++ b/0010-policycoreutils-Add-examples-to-man-pages.patch @@ -0,0 +1,308 @@ +From 10cfbd2825e12efdc0faa872987d5987e02e7eae Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Thu, 1 Jun 2023 16:39:11 +0200 +Subject: [PATCH] policycoreutils: Add examples to man pages + +While at it, remove trailing whitespaces. + +Signed-off-by: Vit Mojzis +Acked-by: Petr Lautrbach +--- + policycoreutils/scripts/fixfiles.8 | 34 +++++++++++++-------- + policycoreutils/secon/secon.1 | 12 ++++++-- + policycoreutils/semodule/semodule.8 | 14 ++++----- + policycoreutils/setfiles/restorecon.8 | 9 ++++++ + policycoreutils/setfiles/restorecon_xattr.8 | 7 +++++ + policycoreutils/setfiles/setfiles.8 | 9 ++++++ + policycoreutils/setsebool/setsebool.8 | 16 +++++++--- + 7 files changed, 74 insertions(+), 27 deletions(-) + +diff --git a/policycoreutils/scripts/fixfiles.8 b/policycoreutils/scripts/fixfiles.8 +index 9a317d91..928b8200 100644 +--- a/policycoreutils/scripts/fixfiles.8 ++++ b/policycoreutils/scripts/fixfiles.8 +@@ -14,7 +14,7 @@ fixfiles \- fix file SELinux security contexts. + .B fixfiles + .I [\-v] [\-F] [\-B | \-N time ] [\-T nthreads] { check | restore | verify } + +-.B fixfiles ++.B fixfiles + .I [\-v] [\-F] [\-T nthreads] \-R rpmpackagename[,rpmpackagename...] { check | restore | verify } + + .B fixfiles +@@ -31,7 +31,7 @@ This manual page describes the + script. + .P + This script is primarily used to correct the security context +-database (extended attributes) on filesystems. ++database (extended attributes) on filesystems. + .P + It can also be run at any time to relabel when adding support for + new policy, or just check whether the file contexts are all +@@ -41,29 +41,29 @@ option. You can use the \-R flag to use rpmpackages as an alternative. + The file /etc/selinux/fixfiles_exclude_dirs can contain a list of directories + excluded from relabeling. + .P +-.B fixfiles onboot ++.B fixfiles onboot + will setup the machine to relabel on the next reboot. + + .SH "OPTIONS" +-.TP ++.TP + .B \-B + If specified with onboot, this fixfiles will record the current date in the /.autorelabel file, so that it can be used later to speed up labeling. If used with restore, the restore will only affect files that were modified today. + .TP + .B \-F + Force reset of context to match file_context for customizable files + +-.TP ++.TP + .B \-f + Clear /tmp directory with out prompt for removal. + +-.TP ++.TP + .B \-R rpmpackagename[,rpmpackagename...] + Use the rpm database to discover all files within the specified packages and restore the file contexts. + .TP + .B \-C PREVIOUS_FILECONTEXT + Run a diff on the PREVIOUS_FILECONTEXT file to the currently installed one, and restore the context of all affected files. + +-.TP ++.TP + .B \-N time + Only act on files created after the specified date. Date must be specified in + "YYYY\-MM\-DD HH:MM" format. Date field will be passed to find \-\-newermt command. +@@ -83,19 +83,28 @@ Use parallel relabeling, see + + .SH "ARGUMENTS" + One of: +-.TP ++.TP + .B check | verify + print any incorrect file context labels, showing old and new context, but do not change them. +-.TP ++.TP + .B restore + change any incorrect file context labels. +-.TP ++.TP + .B relabel + Prompt for removal of contents of /tmp directory and then change any incorrect file context labels to match the install file_contexts file. +-.TP +-.B [[dir/file] ... ] ++.TP ++.B [[dir/file] ... ] + List of files or directories trees that you wish to check file context on. + ++.SH EXAMPLE ++.nf ++Relabel the whole filesystem, except paths listed in /etc/selinux/fixfiles_exclude_dirs ++# fixfiles relabel ++Schedule the machine to relabel on the next boot and force relabeling of customizable types ++# fixfiles -F onboot ++Check labeling of all files from the samba package (while not changing any labels) ++# fixfiles -R samba check ++ + .SH "AUTHOR" + This man page was written by Richard Hally . + The script was written by Dan Walsh +@@ -103,4 +112,3 @@ The script was written by Dan Walsh + .SH "SEE ALSO" + .BR setfiles (8), + .BR restorecon (8) +- +diff --git a/policycoreutils/secon/secon.1 b/policycoreutils/secon/secon.1 +index 501b5cb8..c0e8b05a 100644 +--- a/policycoreutils/secon/secon.1 ++++ b/policycoreutils/secon/secon.1 +@@ -107,16 +107,24 @@ then the context will be read from stdin. + .br + If there is no argument, + .B secon +-will try reading a context from stdin, if that is not a tty, otherwise ++will try reading a context from stdin, if that is not a tty, otherwise + .B secon + will act as though \fB\-\-self\fR had been passed. + .PP + If none of \fB\-\-user\fR, \fB\-\-role\fR, \fB\-\-type\fR, \fB\-\-level\fR or + \fB\-\-mls\-range\fR is passed. + Then all of them will be output. ++ ++.SH EXAMPLE ++.nf ++Show SElinux context of the init process ++# secon --pid 1 ++Parse the type portion of given security context ++# secon -t system_u:object_r:httpd_sys_rw_content_t:s0 ++ + .PP + .SH SEE ALSO + .BR chcon (1) + .SH AUTHORS + .nf +-James Antill (james.antill@redhat.com) ++James Antill (james.antill@redhat.com) +diff --git a/policycoreutils/semodule/semodule.8 b/policycoreutils/semodule/semodule.8 +index c56e580f..01757b00 100644 +--- a/policycoreutils/semodule/semodule.8 ++++ b/policycoreutils/semodule/semodule.8 +@@ -1,5 +1,5 @@ + .TH SEMODULE "8" "Nov 2005" "Security Enhanced Linux" NSA +-.SH NAME ++.SH NAME + semodule \- Manage SELinux policy modules. + + .SH SYNOPSIS +@@ -8,7 +8,7 @@ semodule \- Manage SELinux policy modules. + .SH DESCRIPTION + .PP + semodule is the tool used to manage SELinux policy modules, +-including installing, upgrading, listing and removing modules. ++including installing, upgrading, listing and removing modules. + semodule may also be used to force a rebuild of policy from the + module store and/or to force a reload of policy without performing + any other transaction. semodule acts on module packages created +@@ -39,7 +39,7 @@ install/replace a module package + .B \-u,\-\-upgrade=MODULE_PKG + deprecated, alias for --install + .TP +-.B \-b,\-\-base=MODULE_PKG ++.B \-b,\-\-base=MODULE_PKG + deprecated, alias for --install + .TP + .B \-r,\-\-remove=MODULE_NAME +@@ -77,7 +77,7 @@ name of the store to operate on + .B \-n,\-\-noreload,\-N + do not reload policy after commit + .TP +-.B \-h,\-\-help ++.B \-h,\-\-help + prints help message and quit + .TP + .B \-P,\-\-preserve_tunables +@@ -92,7 +92,7 @@ Use an alternate path for the policy root + .B \-S,\-\-store-path + Use an alternate path for the policy store root + .TP +-.B \-v,\-\-verbose ++.B \-v,\-\-verbose + be verbose + .TP + .B \-c,\-\-cil +@@ -131,8 +131,6 @@ $ semodule \-B + $ semodule \-d alsa + # Install a module at a specific priority. + $ semodule \-X 100 \-i alsa.pp +-# List all modules. +-$ semodule \-\-list=full + # Set an alternate path for the policy root + $ semodule \-B \-p "/tmp" + # Set an alternate path for the policy store root +@@ -143,6 +141,8 @@ $ semodule \-X 400 \-\-hll \-E puppet \-\-cil \-E wireshark + # Check whether a module in "localmodule.pp" file is same as installed module "localmodule" + $ /usr/libexec/selinux/hll/pp localmodule.pp | sha256sum + $ semodule -l -m | grep localmodule ++# Translate binary module file into CIL (useful for debugging installation errors) ++$ /usr/libexec/selinux/hll/pp alsa.pp > alsa.cil + .fi + + .SH SEE ALSO +diff --git a/policycoreutils/setfiles/restorecon.8 b/policycoreutils/setfiles/restorecon.8 +index dbd55ce7..6160aced 100644 +--- a/policycoreutils/setfiles/restorecon.8 ++++ b/policycoreutils/setfiles/restorecon.8 +@@ -224,6 +224,15 @@ and provided the + option is NOT set and recursive mode is set, files will be relabeled as + required with the digests then being updated provided there are no errors. + ++.SH EXAMPLE ++.nf ++Fix labeling of /var/www/ including all sub-directories and list all context changes ++# restorecon -rv /var/www/ ++List mislabeled files in user home directory and what the correct label should be ++# restorecon -nvr ~ ++Fix labeling of files listed in file_list file, ignoring any that do not exist ++# restorecon -vif file_list ++ + .SH "AUTHOR" + This man page was written by Dan Walsh . + Some of the content of this man page was taken from the setfiles +diff --git a/policycoreutils/setfiles/restorecon_xattr.8 b/policycoreutils/setfiles/restorecon_xattr.8 +index 4b1ce304..09bfd8c4 100644 +--- a/policycoreutils/setfiles/restorecon_xattr.8 ++++ b/policycoreutils/setfiles/restorecon_xattr.8 +@@ -112,6 +112,13 @@ If the option is not specified, then the default file_contexts will be used. + .br + the pathname of the directory tree to be searched. + ++.SH EXAMPLE ++.nf ++List all paths that where assigned a checksum by "restorecon/setfiles -D" ++# restorecon_xattr -r / ++Remove all non-matching checksums ++# restorecon_xattr -rd / ++ + .SH "SEE ALSO" + .BR restorecon (8), + .BR setfiles (8) +diff --git a/policycoreutils/setfiles/setfiles.8 b/policycoreutils/setfiles/setfiles.8 +index 36fe6b36..6071d9ba 100644 +--- a/policycoreutils/setfiles/setfiles.8 ++++ b/policycoreutils/setfiles/setfiles.8 +@@ -289,6 +289,15 @@ and provided the + option is NOT set, files will be relabeled as required with the digests then + being updated provided there are no errors. + ++.SH EXAMPLE ++.nf ++Fix labeling of /var/www/ including all sub-directories, using targeted policy file context definitions and list all context changes ++# setfiles -v /etc/selinux/targeted/contexts/files/file_contexts /var/www/ ++List mislabeled files in user home directory and what the label should be based on targeted policy file context definitions ++# setfiles -nv /etc/selinux/targeted/contexts/files/file_contexts ~ ++Fix labeling of files listed in file_list file, ignoring any that do not exist ++# setfiles -vif file_list /etc/selinux/targeted/contexts/files/file_contexts ++ + .SH "AUTHOR" + This man page was written by Russell Coker . + The program was written by Stephen Smalley +diff --git a/policycoreutils/setsebool/setsebool.8 b/policycoreutils/setsebool/setsebool.8 +index 52936f5a..f54664fb 100644 +--- a/policycoreutils/setsebool/setsebool.8 ++++ b/policycoreutils/setsebool/setsebool.8 +@@ -7,13 +7,13 @@ setsebool \- set SELinux boolean value + .I "[ \-PNV ] boolean value | bool1=val1 bool2=val2 ..." + + .SH "DESCRIPTION" +-.B setsebool +-sets the current state of a particular SELinux boolean or a list of booleans +-to a given value. The value may be 1 or true or on to enable the boolean, or 0 or false or off to disable it. ++.B setsebool ++sets the current state of a particular SELinux boolean or a list of booleans ++to a given value. The value may be 1 or true or on to enable the boolean, or 0 or false or off to disable it. + + Without the \-P option, only the current boolean value is +-affected; the boot-time default settings +-are not changed. ++affected; the boot-time default settings ++are not changed. + + If the \-P option is given, all pending values are written to + the policy file on disk. So they will be persistent across reboots. +@@ -22,6 +22,12 @@ If the \-N option is given, the policy on disk is not reloaded into the kernel. + + If the \-V option is given, verbose error messages will be printed from semanage libraries. + ++.SH EXAMPLE ++.nf ++Enable container_use_devices boolean (will return to persistent value after reboot) ++# setsebool container_use_devices 1 ++Persistently enable samba_create_home_dirs and samba_enable_home_dirs booleans ++# setsebool -P samba_create_home_dirs=on samba_enable_home_dirs=on + + .SH AUTHOR + This manual page was written by Dan Walsh . +-- +2.40.0 + diff --git a/0011-python-sepolicy-Improve-man-pages.patch b/0011-python-sepolicy-Improve-man-pages.patch new file mode 100644 index 0000000..4620b3e --- /dev/null +++ b/0011-python-sepolicy-Improve-man-pages.patch @@ -0,0 +1,390 @@ +From 835b208cad02557cf99c3ab7289ca511b8bfa91e Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Thu, 1 Jun 2023 16:39:12 +0200 +Subject: [PATCH] python/sepolicy: Improve man pages + +- Add missing options +- Add examples +- Emphasize keywords +- Remove trailing whitespaces + +Signed-off-by: Vit Mojzis +Acked-by: Petr Lautrbach +--- + python/sepolicy/sepolicy-booleans.8 | 15 +++++++++--- + python/sepolicy/sepolicy-communicate.8 | 14 ++++++++--- + python/sepolicy/sepolicy-generate.8 | 34 ++++++++++++-------------- + python/sepolicy/sepolicy-gui.8 | 4 +-- + python/sepolicy/sepolicy-interface.8 | 18 +++++++++++--- + python/sepolicy/sepolicy-manpage.8 | 25 ++++++++++++++----- + python/sepolicy/sepolicy-network.8 | 17 ++++++------- + python/sepolicy/sepolicy-transition.8 | 19 +++++++++----- + 8 files changed, 96 insertions(+), 50 deletions(-) + +diff --git a/python/sepolicy/sepolicy-booleans.8 b/python/sepolicy/sepolicy-booleans.8 +index f8d8b56d..7f4b18e7 100644 +--- a/python/sepolicy/sepolicy-booleans.8 ++++ b/python/sepolicy/sepolicy-booleans.8 +@@ -8,12 +8,16 @@ sepolicy-booleans \- Query SELinux Policy to see description of booleans + .B sepolicy booleans [\-h] [ \-a | \-b booleanname ... ] + + .SH "DESCRIPTION" +-sepolicy booleans will show all booleans and their descriptions, or you can +-choose individual booleans to display ++.B sepolicy booleans ++will show all booleans and their descriptions, or you can ++choose individual booleans to display. ++Please make sure that selinux-policy-devel is present in your system since it contains boolean descriptions extracted from the policy source code. Otherwise ++.B sepolicy booleans ++will only show descriptions generated based on boolean names. + + .SH "OPTIONS" + .TP +-.I \-h, \-\-help ++.I \-h, \-\-help + Display help message + .TP + .I \-a, \-\-all +@@ -22,6 +26,11 @@ Display all boolean descriptions + .I \-b, \-\-boolean + boolean to get description + ++.SH EXAMPLE ++.nf ++List descriptions of samba_create_home_dirs and samba_enable_home_dirs booleans ++# sepolicy booleans -b samba_create_home_dirs samba_enable_home_dirs ++ + .SH "AUTHOR" + This man page was written by Daniel Walsh + +diff --git a/python/sepolicy/sepolicy-communicate.8 b/python/sepolicy/sepolicy-communicate.8 +index 050aa475..5ecf6eff 100644 +--- a/python/sepolicy/sepolicy-communicate.8 ++++ b/python/sepolicy/sepolicy-communicate.8 +@@ -8,7 +8,9 @@ sepolicy-communicate \- Generate a report showing if two SELinux Policy Domains + .B sepolicy communicate [\-h] \-s SOURCE \-t TARGET [\-c TCLASS] [\-S SOURCEACCESS] [\-T TARGETACCESS] + + .SH "DESCRIPTION" +-Use sepolicy communicate to examine SELinux Policy to if a source SELinux Domain can communicate with a target SELinux Domain. ++Use ++.B sepolicy communicate ++to examine SELinux Policy and determine if a source SELinux Domain can communicate with a target SELinux Domain. + The default command looks to see if there are any file types that the source domain can write, which the target domain can read. + + .SH "OPTIONS" +@@ -16,7 +18,7 @@ The default command looks to see if there are any file types that the source dom + .I \-c, \-\-class + Specify the SELinux class which the source domain will attempt to communicate with the target domain. (Default file) + .TP +-.I \-h, \-\-help ++.I \-h, \-\-help + Display help message + .TP + .I \-s, \-\-source +@@ -31,9 +33,15 @@ Specify the target SELinux domain type. + .I \-T, \-\-targetaccess + Specify the list of accesses used by the target SELinux domain type to receive communications from the source domain. Default Open, Read. + ++.SH EXAMPLE ++.nf ++List types that can be used to communicate between samba daemon and apache server ++# sepolicy communicate -s httpd_t -t smbd_t ++Consider a type to be accessible by the source domain when it can be opened and appended to (as opposed to opened and written to) ++# sepolicy communicate -s httpd_t -t smbd_t -S open,append ++ + .SH "AUTHOR" + This man page was written by Daniel Walsh + + .SH "SEE ALSO" + sepolicy(8), selinux(8) +- +diff --git a/python/sepolicy/sepolicy-generate.8 b/python/sepolicy/sepolicy-generate.8 +index 0c5f998f..72d0e8e4 100644 +--- a/python/sepolicy/sepolicy-generate.8 ++++ b/python/sepolicy/sepolicy-generate.8 +@@ -57,32 +57,29 @@ path. \fBsepolicy generate\fP will use the rpm payload of the + application along with \fBnm \-D APPLICATION\fP to help it generate + types and policy rules for your policy files. + +-.B Type Enforcing File NAME.te ++.B NAME.te + .br +-This file can be used to define all the types rules for a particular domain. ++This file can be used to define all the types enforcement rules for a particular domain. + + .I Note: +-Policy generated by \fBsepolicy generate\fP will automatically add a permissive DOMAIN to your te file. When you are satisfied that your policy works, you need to remove the permissive line from the te file to run your domain in enforcing mode. ++Policy generated by \fBsepolicy generate\fP will automatically add a \fIpermissive DOMAIN\fP to your \fB.te\fP file. When you are satisfied that your policy works, you need to remove the permissive line from the \fB.te\fP file to run your domain in enforcing mode. + +-.B Interface File NAME.if ++.B NAME.if + .br +-This file defines the interfaces for the types generated in the te file, which can be used by other policy domains. ++This file defines the interfaces for the types generated in the \fB.te\fP file, which can be used by other policy domains. + +-.B File Context NAME.fc ++.B NAME.fc + .br +-This file defines the default file context for the system, it takes the file types created in the te file and associates ++This file defines the default file context for the system, it takes the file types created in the \fB.te\fP file and associates + file paths to the types. Tools like restorecon and RPM will use these paths to put down labels. + +-.B RPM Spec File NAME_selinux.spec ++.B NAME_selinux.spec + .br +-This file is an RPM SPEC file that can be used to install the SELinux policy on to machines and setup the labeling. The spec file also installs the interface file and a man page describing the policy. You can use \fBsepolicy manpage \-d NAME\fP to generate the man page. ++This file is an RPM SPEC file that can be used to install the SELinux policy on to machines and setup the labeling. The spec file also installs the interface file and a man page describing the policy. You can use \fBsepolicy manpage \-d NAME\fP to generate the man page. + +-.B Shell File NAME.sh ++.B NAME.sh + .br +-This is a helper shell script to compile, install and fix the labeling on your test system. It will also generate a man page based on the installed policy, and +-compile and build an RPM suitable to be installed on other machines +- +-If a generate is possible, this tool will print out all generate paths from the source domain to the target domain ++This is a helper shell script to compile, install and fix the labeling on your test system. It will also generate a man page based on the installed policy, and compile and build an RPM suitable to be installed on other machines. + + .SH "OPTIONS" + .TP +@@ -97,10 +94,11 @@ Specify alternate name of policy. The policy will default to the executable or n + .TP + .I \-p, \-\-path + Specify the directory to store the created policy files. (Default to current working directory ) ++.TP + optional arguments: + .TP + .I \-r, \-\-role +-Enter role(s) to which this admin user will transition. ++Enter role(s) to which this admin user will transition + .TP + .I \-t, \-\-type + Enter type(s) for which you will generate new definition and rule(s) +@@ -109,12 +107,12 @@ Enter type(s) for which you will generate new definition and rule(s) + SELinux user(s) which will transition to this domain + .TP + .I \-w, \-\-writepath +-Path(s) which the confined processes need to write ++Path(s) which the confined processes need to write to + .TP + .I \-a, \-\-admin + Domain(s) which the confined admin will administrate + .TP +-.I \-\-admin_user ++.I \-\-admin_user + Generate Policy for Administrator Login User Role + .TP + .I \-\-application +@@ -142,7 +140,7 @@ Generate Policy for Internet Services Daemon + Generate Policy for Standard Init Daemon (Default) + .TP + .I \-\-newtype +-Generate new policy for new types to add to an existing policy. ++Generate new policy for new types to add to an existing policy + .TP + .I \-\-sandbox + Generate Policy for Sandbox +diff --git a/python/sepolicy/sepolicy-gui.8 b/python/sepolicy/sepolicy-gui.8 +index ed744cdb..65b69fab 100644 +--- a/python/sepolicy/sepolicy-gui.8 ++++ b/python/sepolicy/sepolicy-gui.8 +@@ -11,7 +11,7 @@ Common options + .br + + .SH "DESCRIPTION" +-Use \fBsepolicy gui\fP to run a the graphical user interface, which ++Use \fBsepolicy gui\fP to run the graphical user interface, which + allows you to explore how SELinux confines different process domains. + + .SH "OPTIONS" +@@ -20,7 +20,7 @@ allows you to explore how SELinux confines different process domains. + Display help message + .TP + .I \-d, \-\-domain +-Initialize gui to the selected domain. ++Initialize gui to the selected domain + + .SH "AUTHOR" + This man page was written by Daniel Walsh +diff --git a/python/sepolicy/sepolicy-interface.8 b/python/sepolicy/sepolicy-interface.8 +index 3e74ea62..a70a9306 100644 +--- a/python/sepolicy/sepolicy-interface.8 ++++ b/python/sepolicy/sepolicy-interface.8 +@@ -5,10 +5,10 @@ sepolicy-interface \- Print interface information based on the installed SELinux + .SH "SYNOPSIS" + + .br +-.B sepolicy interface [\-h] [\-c] [\-v] [\-a | \-u | \-l | \-i INTERFACE [INTERFACE ... ]] ++.B sepolicy interface [\-h] [\-c] [\-v] [\-f FILE] [\-a | \-u | \-l | \-i INTERFACE [INTERFACE ... ]] + + .SH "DESCRIPTION" +-Use sepolicy interface to print interfaces information based on SELinux Policy. ++Use \fBsepolicy interface\fP to print interface information based on SELinux Policy. + + .SH "OPTIONS" + .TP +@@ -18,7 +18,7 @@ List all domains with admin interface + .I \-c, \-\-compile + Test compile of interfaces + .TP +-.I \-h, \-\-help ++.I \-h, \-\-help + Display help message + .TP + .I \-i, \-\-interface +@@ -32,6 +32,18 @@ List all domains with SELinux user role interface + .TP + .I \-v, \-\-verbose + Display extended information about the interface including parameters and description if available. ++.TP ++.I \-f, \-\-file ++Interface file to be explored ++ ++.SH EXAMPLE ++.nf ++Show description of given interface ++# sepolicy interface -vi samba_rw_config ++List interfaces in given interface file and show their description ++# sepolicy interface -f my_policy.if -lv ++Run compile test for all interfaces in given file ++# sepolicy interface -f my_policy.if -lc + + .SH "AUTHOR" + This man page was written by Daniel Walsh +diff --git a/python/sepolicy/sepolicy-manpage.8 b/python/sepolicy/sepolicy-manpage.8 +index c05c9430..4991f645 100644 +--- a/python/sepolicy/sepolicy-manpage.8 ++++ b/python/sepolicy/sepolicy-manpage.8 +@@ -8,27 +8,40 @@ sepolicy-manpage \- Generate a man page based on the installed SELinux Policy + .B sepolicy manpage [\-w] [\-h] [\-p PATH ] [\-r ROOTDIR ] [\-a | \-d ] + + .SH "DESCRIPTION" +-Use sepolicy manpage to generate manpages based on SELinux Policy. ++Use \fBsepolicy manpage\fP to generate manpages based on SELinux Policy. + + .SH "OPTIONS" + .TP +-.I \-a, \-\-all ++.I \-a, \-\-all + Generate Man Pages for All Domains + .TP +-.I \-d, \-\-domain ++.I \-d, \-\-domain + Generate a Man Page for the specified domain. (Supports multiple commands) + .TP +-.I \-h, \-\-help ++.I \-h, \-\-help + Display help message + .TP ++.I \-o, \-\-os ++Specify the name of the OS to be used in the man page (only affects HTML man pages) ++.TP + .I \-p, \-\-path + Specify the directory to store the created man pages. (Default to /tmp) + .TP + .I \-r, \-\-root +-Specify alternate root directory to generate man pages from. (Default to /) ++Specify alternative root directory to generate man pages from. (Default to /) ++.TP ++.I \-\-source_files ++Use file_contexts and policy.xml files from the specified root directory (the alternative root needs to include both files) + .TP + .I \-w, \-\-web +-Generate an additional HTML man pages for the specified domain(s). ++Generate an additional HTML man pages for the specified domain(s) ++ ++.SH EXAMPLE ++.nf ++Generate man pages for all available domains ++# sepolicy manpage -a ++Generate an HTML man page for domain alsa_t, setting the OS name to "My_distro" ++# sepolicy manpage -o My_distro -d alsa_t -w + + .SH "AUTHOR" + This man page was written by Daniel Walsh +diff --git a/python/sepolicy/sepolicy-network.8 b/python/sepolicy/sepolicy-network.8 +index dcddec75..6faf60ab 100644 +--- a/python/sepolicy/sepolicy-network.8 ++++ b/python/sepolicy/sepolicy-network.8 +@@ -8,27 +8,27 @@ sepolicy-network \- Examine the SELinux Policy and generate a network report + .B sepolicy network [\-h] (\-l | \-a application [application ...] | \-p PORT [PORT ...] | \-t TYPE [TYPE ...] | \-d DOMAIN [DOMAIN ...]) + + .SH "DESCRIPTION" +-Use sepolicy network to examine SELinux Policy and generate network reports. ++Use \fBsepolicy network\fP to examine SELinux Policy and generate network reports. + + .SH "OPTIONS" + .TP + .I \-a, \-\-application +-Generate a report listing the ports to which the specified init application is allowed to connect and or bind. ++Generate a report listing the ports to which the specified init application is allowed to connect and or bind + .TP +-.I \-d, \-\-domain +-Generate a report listing the ports to which the specified domain is allowed to connect and or bind. ++.I \-d, \-\-domain ++Generate a report listing the ports to which the specified domain is allowed to connect and or bind + .TP +-.I \-l, \-\-list ++.I \-l, \-\-list + List all Network Port Types defined in SELinux Policy + .TP +-.I \-h, \-\-help ++.I \-h, \-\-help + Display help message + .TP + .I \-t, \-\-type +-Generate a report listing the port numbers associate with the specified SELinux port type. ++Generate a report listing the port numbers associate with the specified SELinux port type + .TP + .I \-p, \-\-port +-Generate a report listing the SELinux port types associate with the specified port number. ++Generate a report listing the SELinux port types associate with the specified port number + + .SH "EXAMPLES" + +@@ -88,4 +88,3 @@ This man page was written by Daniel Walsh + + .SH "SEE ALSO" + sepolicy(8), selinux(8), semanage(8) +- +diff --git a/python/sepolicy/sepolicy-transition.8 b/python/sepolicy/sepolicy-transition.8 +index 897f0c4c..9f9ff5a5 100644 +--- a/python/sepolicy/sepolicy-transition.8 ++++ b/python/sepolicy/sepolicy-transition.8 +@@ -11,21 +11,28 @@ sepolicy-transition \- Examine the SELinux Policy and generate a process transit + .B sepolicy transition [\-h] \-s SOURCE \-t TARGET + + .SH "DESCRIPTION" +-sepolicy transition will show all domains that a give SELinux source domain can transition to, including the entrypoint. ++\fBsepolicy transition\fP will show all domains that a given SELinux source domain can transition to, including the entrypoint. + +-If a target domain is given, sepolicy transition will examine policy for all transition paths from the source domain to the target domain, and will list the +-paths. If a transition is possible, this tool will print out all transition paths from the source domain to the target domain ++If a target domain is given, sepolicy transition will examine policy for all transition paths from the source domain to the target domain, and will list the ++paths. + + .SH "OPTIONS" + .TP +-.I \-h, \-\-help ++.I \-h, \-\-help + Display help message + .TP + .I \-s, \-\-source +-Specify the source SELinux domain type. ++Specify the source SELinux domain type + .TP + .I \-t, \-\-target +-Specify the target SELinux domain type. ++Specify the target SELinux domain type ++ ++.SH EXAMPLE ++.nf ++List all domain transition paths from init_t to httpd_t ++# sepolicy transition -s init_t -t httpd_t ++List all transitions available from samba domain, including entry points and booleans controlling each transition ++# sepolicy transition -s smbd_t + + .SH "AUTHOR" + This man page was written by Daniel Walsh +-- +2.40.0 + diff --git a/0012-sandbox-Add-examples-to-man-pages.patch b/0012-sandbox-Add-examples-to-man-pages.patch new file mode 100644 index 0000000..28c0e64 --- /dev/null +++ b/0012-sandbox-Add-examples-to-man-pages.patch @@ -0,0 +1,128 @@ +From 0beb84506b86844374d43db32180a4ea17aeb825 Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Thu, 1 Jun 2023 16:39:13 +0200 +Subject: [PATCH] sandbox: Add examples to man pages + +While at it, remove trailing whitespaces. + +Signed-off-by: Vit Mojzis +Acked-by: Petr Lautrbach +--- + sandbox/sandbox.8 | 28 ++++++++++++++++++---------- + sandbox/seunshare.8 | 21 ++++++++++++++------- + 2 files changed, 32 insertions(+), 17 deletions(-) + +diff --git a/sandbox/sandbox.8 b/sandbox/sandbox.8 +index 775e4b23..1c187019 100644 +--- a/sandbox/sandbox.8 ++++ b/sandbox/sandbox.8 +@@ -11,12 +11,12 @@ sandbox \- Run cmd under an SELinux sandbox + .br + .SH DESCRIPTION + .PP +-Run the +-.I cmd ++Run the ++.I cmd + application within a tightly confined SELinux domain. The default sandbox domain only allows applications the ability to read and write stdin, stdout and any other file descriptors handed to it. It is not allowed to open any other files. The \-M option will mount an alternate homedir and tmpdir to be used by the sandbox. + +-If you have the +-.I policycoreutils-sandbox ++If you have the ++.I policycoreutils-sandbox + package installed, you can use the \-X option and the \-M option. + .B sandbox \-X + allows you to run X applications within a sandbox. These applications will start up their own X Server and create a temporary home directory and /tmp. The default SELinux policy does not allow any capabilities or network access. It also prevents all access to the users other processes and files. Files specified on the command that are in the home directory or /tmp will be copied into the sandbox directories. +@@ -78,27 +78,35 @@ Run a full desktop session, Requires level, and home and tmpdir. + Specifies the windowsize when creating an X based Sandbox. The default windowsize is 1000x700. + .TP + \fB\-W\fR \fB\-\-windowmanager\fR +-Select alternative window manager to run within ++Select alternative window manager to run within + .B sandbox \-X. + Default to /usr/bin/matchbox-window-manager. + .TP +-\fB\-X\fR ++\fB\-X\fR + Create an X based Sandbox for gui apps, temporary files for + $HOME and /tmp, secondary Xserver, defaults to sandbox_x_t + .TP + \fB\-d\fR \fB\-\-dpi\fR + Set the DPI value for the sandbox X Server. Defaults to the current X Sever DPI. + .TP +-\fB\-C\fR \fB\-\-capabilities\fR Use capabilities within the +-sandbox. By default applications executed within the sandbox will not +-be allowed to use capabilities (setuid apps), with the \-C flag, you +-can use programs requiring capabilities. ++\fB\-C\fR \fB\-\-capabilities\fR ++Use capabilities within the sandbox. By default applications executed within the sandbox will not be allowed to use capabilities (setuid apps), with the \-C flag, you can use programs requiring capabilities. + .PP + .SH "SEE ALSO" + .TP + runcon(1), seunshare(8), selinux(8) + .PP + ++.SH EXAMPLE ++.nf ++Run a graphical application inside the sandbox ++# sandbox -X evince ++Run a graphical application that requires the use of network ++# sandbox ‑X ‑t sandbox_web_t firefox ++Preserve data from one session to the next ++# mkdir -p ~/sandbox/home ~/sandbox/tmp ++# sandbox -H ~/sandbox/home -T ~/sandbox/tmp -X libreoffice --writer ++ + .SH AUTHOR + This manual page was written by + .I Dan Walsh +diff --git a/sandbox/seunshare.8 b/sandbox/seunshare.8 +index 09cf7fea..5339a3b1 100644 +--- a/sandbox/seunshare.8 ++++ b/sandbox/seunshare.8 +@@ -9,29 +9,36 @@ seunshare \- Run cmd with alternate homedir, tmpdir and/or SELinux context + .PP + Run the + .I executable +-within the specified context, using the alternate home directory and /tmp directory. The seunshare command unshares from the default namespace, then mounts the specified homedir and tmpdir over the default homedir and /tmp. Finally it tells the kernel to execute the application under the specified SELinux context. ++within the specified context, using custom home directory and /tmp directory. The seunshare command unshares from the default namespace, then mounts the specified homedir and tmpdir over the default homedir and /tmp. Finally it tells the kernel to execute the application under the specified SELinux context. + + .TP + \fB\-h homedir\fR +-Alternate homedir to be used by the application. Homedir must be owned by the user. ++Alternate homedir to be used by the application. Homedir must be owned by the user + .TP + \fB\-t\ tmpdir +-Use alternate temporary directory to mount on /tmp. tmpdir must be owned by the user. ++Use alternate temporary directory to mount on /tmp. tmpdir must be owned by the user + .TP + \fB\-r\ runuserdir +-Use alternate temporary directory to mount on XDG_RUNTIME_DIR (/run/user/$UID). runuserdir must be owned by the user. ++Use alternate temporary directory to mount on XDG_RUNTIME_DIR (/run/user/$UID). runuserdir must be owned by the user + .TP + \fB\-C --capabilities\fR +-Allow apps executed within the namespace to use capabilities. Default is no capabilities. ++Allow apps executed within the namespace to use capabilities. Default is no capabilities + .TP + \fB\-k --kill\fR +-Kill all processes with matching MCS level. ++Kill all processes with matching MCS level + .TP + \fB\-Z\ context +-Use alternate SELinux context while running the executable. ++Use alternate SELinux context while running the executable + .TP + \fB\-v\fR + Verbose output ++ ++.SH EXAMPLE ++.nf ++Run bash with temporary /home and /tmp directory ++# USERHOMEDIR=`mktemp -d /tmp/home.XXXXXX`; USERTEMPDIR=`mktemp -d /tmp/temp.XXXXXX` ++# seunshare -v -h ${USERHOMEDIR} -t ${USERTEMPDIR} -- /bin/bash ++ + .SH "SEE ALSO" + .TP + runcon(1), sandbox(8), selinux(8) +-- +2.40.0 + diff --git a/0013-python-sepolicy-Fix-template-for-confined-user-polic.patch b/0013-python-sepolicy-Fix-template-for-confined-user-polic.patch new file mode 100644 index 0000000..b2271a2 --- /dev/null +++ b/0013-python-sepolicy-Fix-template-for-confined-user-polic.patch @@ -0,0 +1,93 @@ +From 73fd4231024f6241af6263ba74b70459bf9611f1 Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Thu, 1 Jun 2023 18:34:30 +0200 +Subject: [PATCH] python/sepolicy: Fix template for confined user policy + modules + +The following commit +https://github.com/SELinuxProject/refpolicy/commit/330b0fc3331d3b836691464734c96f3da3044490 +changed the userdom_base_user_template, which now requires a role +corresponding to the user being created to be defined outside of the +template. +Similar change was also done to fedora-selinux/selinux-policy +https://github.com/fedora-selinux/selinux-policy/commit/e1e216b25df1bdb4eb7dbb8f73f32927ad6f3d1f + +Although I believe the template should define the role (just as it +defines the new user), that will require extensive changes to refpolicy. +In the meantime the role needs to be defined separately. + +Fixes: + # sepolicy generate --term_user -n newuser + Created the following files: + /root/a/test/newuser.te # Type Enforcement file + /root/a/test/newuser.if # Interface file + /root/a/test/newuser.fc # File Contexts file + /root/a/test/newuser_selinux.spec # Spec file + /root/a/test/newuser.sh # Setup Script + + # ./newuser.sh + Building and Loading Policy + + make -f /usr/share/selinux/devel/Makefile newuser.pp + Compiling targeted newuser module + Creating targeted newuser.pp policy package + rm tmp/newuser.mod tmp/newuser.mod.fc + + /usr/sbin/semodule -i newuser.pp + Failed to resolve roleattributeset statement at /var/lib/selinux/targeted/tmp/modules/400/newuser/cil:8 + Failed to resolve AST + /usr/sbin/semodule: Failed! + +Signed-off-by: Vit Mojzis +Acked-by: Petr Lautrbach +--- + python/sepolicy/sepolicy/templates/user.py | 7 +++++++ + 1 file changed, 7 insertions(+) + +diff --git a/python/sepolicy/sepolicy/templates/user.py b/python/sepolicy/sepolicy/templates/user.py +index 1ff9d2ce..7081fbae 100644 +--- a/python/sepolicy/sepolicy/templates/user.py ++++ b/python/sepolicy/sepolicy/templates/user.py +@@ -28,6 +28,8 @@ policy_module(TEMPLATETYPE, 1.0.0) + # + # Declarations + # ++role TEMPLATETYPE_r; ++ + userdom_unpriv_user_template(TEMPLATETYPE) + """ + +@@ -38,6 +40,8 @@ policy_module(TEMPLATETYPE, 1.0.0) + # + # Declarations + # ++role TEMPLATETYPE_r; ++ + userdom_admin_user_template(TEMPLATETYPE) + """ + +@@ -48,6 +52,7 @@ policy_module(TEMPLATETYPE, 1.0.0) + # + # Declarations + # ++role TEMPLATETYPE_r; + + userdom_restricted_user_template(TEMPLATETYPE) + """ +@@ -59,6 +64,7 @@ policy_module(TEMPLATETYPE, 1.0.0) + # + # Declarations + # ++role TEMPLATETYPE_r; + + userdom_restricted_xwindows_user_template(TEMPLATETYPE) + """ +@@ -89,6 +95,7 @@ gen_tunable(TEMPLATETYPE_manage_user_files, false) + # + # Declarations + # ++role TEMPLATETYPE_r; + + userdom_base_user_template(TEMPLATETYPE) + """ +-- +2.40.0 + diff --git a/0014-python-sepolicy-Fix-spec-file-dependencies.patch b/0014-python-sepolicy-Fix-spec-file-dependencies.patch new file mode 100644 index 0000000..0f178b9 --- /dev/null +++ b/0014-python-sepolicy-Fix-spec-file-dependencies.patch @@ -0,0 +1,47 @@ +From 057ea895d85ae8297749778a3dcfc4ff7489ab37 Mon Sep 17 00:00:00 2001 +From: Vit Mojzis +Date: Tue, 30 May 2023 09:07:28 +0200 +Subject: [PATCH] python/sepolicy: Fix spec file dependencies + +semanage is part of policycoreutils-python-utils package, selinuxenabled +is part of libselinux-utils (required by ^^^) and restorecon/load_policy +are part of policycoreutils (also required by policycoreutils-python-utils). + +Signed-off-by: Vit Mojzis +--- + python/sepolicy/sepolicy/templates/spec.py | 12 +++++++----- + 1 file changed, 7 insertions(+), 5 deletions(-) + +diff --git a/python/sepolicy/sepolicy/templates/spec.py b/python/sepolicy/sepolicy/templates/spec.py +index 16a22081..cb3b2f63 100644 +--- a/python/sepolicy/sepolicy/templates/spec.py ++++ b/python/sepolicy/sepolicy/templates/spec.py +@@ -11,18 +11,20 @@ Version: 1.0 + Release: 1%{?dist} + Summary: SELinux policy module for MODULENAME + +-Group: System Environment/Base +-License: GPLv2+ ++Group: System Environment/Base ++License: GPLv2+ + # This is an example. You will need to change it. ++# For a complete guide on packaging your policy ++# see https://fedoraproject.org/wiki/SELinux/IndependentPolicy + URL: http://HOSTNAME + Source0: MODULENAME.pp + Source1: MODULENAME.if + Source2: DOMAINNAME_selinux.8 + Source3: DOMAINNAME_u + +-Requires: policycoreutils, libselinux-utils +-Requires(post): selinux-policy-base >= %{selinux_policyver}, policycoreutils +-Requires(postun): policycoreutils ++Requires: policycoreutils-python-utils, libselinux-utils ++Requires(post): selinux-policy-base >= %{selinux_policyver}, policycoreutils-python-utils ++Requires(postun): policycoreutils-python-utils + """ + + mid_section="""\ +-- +2.40.0 + diff --git a/policycoreutils.spec b/policycoreutils.spec index eb075ab..6cfec73 100644 --- a/policycoreutils.spec +++ b/policycoreutils.spec @@ -11,7 +11,7 @@ Summary: SELinux policy core utilities Name: policycoreutils Version: 3.5 -Release: 4%{?dist} +Release: 5%{?dist} License: GPL-2.0-or-later # https://github.com/SELinuxProject/selinux/wiki/Releases Source0: https://github.com/SELinuxProject/selinux/releases/download/3.5/selinux-3.5.tar.gz @@ -36,6 +36,15 @@ Patch0002: 0002-Don-t-be-verbose-if-you-are-not-on-a-tty.patch Patch0003: 0003-sepolicy-generate-Handle-more-reserved-port-types.patch Patch0004: 0004-sandbox-Use-matchbox-window-manager-instead-of-openb.patch Patch0005: 0005-Use-SHA-2-instead-of-SHA-1.patch +Patch0006: 0006-python-chcat-Improve-man-pages.patch +Patch0007: 0007-python-audit2allow-Add-missing-options-to-man-page.patch +Patch0008: 0008-python-semanage-Improve-man-pages.patch +Patch0009: 0009-python-audit2allow-Remove-unused-debug-option.patch +Patch0010: 0010-policycoreutils-Add-examples-to-man-pages.patch +Patch0011: 0011-python-sepolicy-Improve-man-pages.patch +Patch0012: 0012-sandbox-Add-examples-to-man-pages.patch +Patch0013: 0013-python-sepolicy-Fix-template-for-confined-user-polic.patch +Patch0014: 0014-python-sepolicy-Fix-spec-file-dependencies.patch # Patch list end Obsoletes: policycoreutils < 2.0.61-2 @@ -443,6 +452,11 @@ The policycoreutils-restorecond package contains the restorecond service. %systemd_postun_with_restart restorecond.service %changelog +* Wed Jun 21 2023 Vit Mojzis - 3.5-5 +- python/sepolicy: Fix spec file dependencies +- python/sepolicy: Fix template for confined user policy modules +- Improve man pages and add examples + * Tue Jun 13 2023 Python Maint - 3.5-4 - Rebuilt for Python 3.12