From cd40b800f322ef9f2f7c3b444dc0de07a6f08c00 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vladim=C3=ADr=20Chlup?= Date: Thu, 4 Jul 2024 11:29:10 +0200 Subject: [PATCH] Tweak READMEs and use markdown --- native/advertise/README | 17 ----------------- native/advertise/README.md | 23 +++++++++++++++++++++++ native/selinux/README | 25 ------------------------- native/selinux/README.md | 37 +++++++++++++++++++++++++++++++++++++ 4 files changed, 60 insertions(+), 42 deletions(-) delete mode 100644 native/advertise/README create mode 100644 native/advertise/README.md delete mode 100644 native/selinux/README create mode 100644 native/selinux/README.md diff --git a/native/advertise/README b/native/advertise/README deleted file mode 100644 index e9f519564..000000000 --- a/native/advertise/README +++ /dev/null @@ -1,17 +0,0 @@ -The source could be in httpd-2.2.x source tree. -The ./buildconf must be run again and the configure need at least: -./configure --enable-advertise - -The source could build with a installed version of httpd-2-2.x: -sh buildconf -./configure --with-apache=apache_installation_directory. -make -The mod_advertise.so need to be copied to apache_installation_directory/modules - -Configuration use something like the following in httpd.conf: -LoadModule advertise_module modules/mod_advertise.so -ServerAdvertise on -AdvertiseGroup 232.0.0.2 -AdvertiseFrequency 30 - -Note default port is 23364. diff --git a/native/advertise/README.md b/native/advertise/README.md new file mode 100644 index 000000000..f551c3f91 --- /dev/null +++ b/native/advertise/README.md @@ -0,0 +1,23 @@ +# Using mod_advertise + +The source can be build with an installed version of httpd-2.4.x, please make +sure it's configured with `--enable-advertise` flag. + +```bash +sh buildconf +./configure --with-apache=apache_installation_directory +make +``` + +The `mod_advertise.so` needs to be copied to `apache_installation_directory/modules` + +Configuration use something like the following in httpd.conf: + +``` +LoadModule advertise_module modules/mod_advertise.so +ServerAdvertise on +AdvertiseGroup 232.0.0.2 +AdvertiseFrequency 30 +``` + +Note: default port is 23364. diff --git a/native/selinux/README b/native/selinux/README deleted file mode 100644 index 1634729fe..000000000 --- a/native/selinux/README +++ /dev/null @@ -1,25 +0,0 @@ -to compile: -make -f /usr/share/selinux/devel/Makefile -to install: -semodule -i mod_cluster.pp -to remove: -semodule -r mod_cluster - -for the listen and the advertise: -to add: - semanage port -a -t http_port_t -p udp 23364 - semanage port -a -t http_port_t -p tcp 6666 -to remove - semanage port -d -t http_port_t -p udp 23364 - semanage port -d -t http_port_t -p tcp 6666 - -for the shared memory tables: -MemManagerFile /var/cache/mod_cluster -mkdir /var/cache/mod_cluster -chcon -v --type=httpd_cache_t /var/cache/mod_cluster -chcon -v --user=system_u /var/cache/mod_cluster - -Note that the permissions should follow the notice you find in error_log: -+++ -[Wed Jun 13 09:35:59 2012] [notice] SELinux policy enabled; httpd running as context unconfined_u:system_r:httpd_t:s0 -+++ diff --git a/native/selinux/README.md b/native/selinux/README.md new file mode 100644 index 000000000..3a05d011d --- /dev/null +++ b/native/selinux/README.md @@ -0,0 +1,37 @@ +# SELinux policies + +To compile policies run `make -f /usr/share/selinux/devel/Makefile` + +To install policies run `semodule -i mod_cluster.pp` + +To remove them run `semodule -r mod_cluster` + +In order to be able to listen and advertise on the default port execute + +```bash +semanage port -a -t http_port_t -p udp 23364 +semanage port -a -t http_port_t -p tcp 6666 +``` + +To revert the previous run + +```bash +semanage port -d -t http_port_t -p udp 23364 +semanage port -d -t http_port_t -p tcp 6666 +``` + +For the shared memory tables + +```bash +MemManagerFile /var/cache/mod_cluster +mkdir /var/cache/mod_cluster +chcon -v --type=httpd_cache_t /var/cache/mod_cluster +chcon -v --user=system_u /var/cache/mod_cluster +``` + +Note that the permissions should follow the notice you find in error_log: +``` ++++ +[Wed Jun 13 09:35:59 2012] [notice] SELinux policy enabled; httpd running as context unconfined_u:system_r:httpd_t:s0 ++++ +```