aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorGuillaume Rousse <guillomovitch@mandriva.org>2008-01-27 15:14:42 +0000
committerGuillaume Rousse <guillomovitch@mandriva.org>2008-01-27 15:14:42 +0000
commit50ea0b258815261582fdebd6ad40d2a4388ceb7c (patch)
tree95d21da9c3602c1315db1d4e9504a6ea50efabbc /README
parenta492abbc4989159d9174277666966b5d9cd1adcf (diff)
downloadrpm-helper-50ea0b258815261582fdebd6ad40d2a4388ceb7c.tar
rpm-helper-50ea0b258815261582fdebd6ad40d2a4388ceb7c.tar.gz
rpm-helper-50ea0b258815261582fdebd6ad40d2a4388ceb7c.tar.bz2
rpm-helper-50ea0b258815261582fdebd6ad40d2a4388ceb7c.tar.xz
rpm-helper-50ea0b258815261582fdebd6ad40d2a4388ceb7c.zip
document all macros
Diffstat (limited to 'README')
-rw-r--r--README56
1 files changed, 56 insertions, 0 deletions
diff --git a/README b/README
index 5beb4d2..6988331 100644
--- a/README
+++ b/README
@@ -1,3 +1,59 @@
+rpm-helper is a set of helper scripts to be executed at package installation
+time. They are invocated through rpm macros. Here is a list of them, along with
+their usage instructions.
rpm-helper is a set of scripts called by rpm scriptlets.
+
+%_get_password <length>
+Return a random password from given length (default 8).
+%create_ghostfile <file> <owner> <group> <mode>
+Create an empty file, with given owner, group and mode.
+
+%_create_ssl_certificate <name> [-g <group>] [-b]
+Create a ssl key and certificate pair with given name under /etc/pki/tls.
+Optional arguments:
+-b: concatenate certificate with the key file (bundle mode)
+-g: ensure key is readable by given group
+
+%_post_service <service>
+Add given service to boot sequence, by running chkconfig --add on it.
+
+%_preun_service <service>
+Remove given service from boot sequence, by running chkconfig --del on it.
+
+%_pre_useradd <name> <homedir> <shell>
+Add given user, with given homedir and shell.
+
+%_postun_userdel <name>
+Does nothing currently.
+
+%_pre_groupadd <group> [user1,user2,...]
+Add given group, with optional list of coma-separated users as members.
+
+%_postun_groupdel <group>
+Does nothing currently.
+
+%_post_shelladd <shell>
+Add given shell to the list of available system shells.
+
+%_preun_shelldel <shell>
+Remove given shell from the list of available system shells.
+
+%_post_syslogadd <destination> [-s <source>] [-f <facility>] [-m <min>] [-M <max>]
+Add a syslog entry, with given destination (usually a log file), and returns
+used facility. Support sysklogd and syslog-ng.
+Optional arguments:
+-s: ensure given source (usually /dev/log) is readable by syslog daemon.
+-f: use given facility (otherwise first available local one is used).
+-m: use given minimal priority.
+-M: use given maximal priority.
+
+%_preun_syslogdel
+Delete syslog entry created by previous macro. Support sysklogd and syslog-ng.
+
+%_post_webapp
+Handle apache configuration reloading if needed when adding a web application.
+
+%_postun_webapp
+Handle apache configuration reloading if needed when removing a web application.
Comments and new scripts welcome.