Changes between Version 23 and Version 24 of RpmHowToPackagers

Timestamp:

Oct 1, 2011, 9:56:36 PM (13 years ago)

Author:

dmik

Comment:

Added WPS object creation section

RpmHowToPackagers

@@ -157 +157 @@
 Note that it doesn't make much sense to use cp -dp in packages which you build from sources, since the original timestamp in this case is the build time which won't differ too much from the install time (as the %install stage happens right after the %build stage).
 
+=== WPS object creation ===
+
+RPM provides a number of macros to create WPS objects for your package from %post and %postun scriplets. These macros start with {{{%wps_object_}}}. All WPS objects created using these macros are associated with the package and recorded in a special database. Each object also has a reference count (which is increased when the object is created and decreased when it is deleted). The physical object deletion only happens when the reference count drops to zero. This is useful for objects (e.g. application folders) shared between several packages since it allows to keep them alive as long as there is one or more packages referencing them installed and automatically remove these shared objects once all of the referencing packages are removed.
+
+Here is an example:
+{{{
+%post
+if [ "$1" -ge 1 ]; then # (upon update)
+    %wps_object_delete_all
+fi
+%wps_object_create_begin
+MYAPP_EXE:WPProgram|My App|<WP_DESKTOP>|EXENAME=((%{_bindir}/myapp.exe))
+%wps_object_create_end
+
+%postun
+if [ "$1" -e 0 ]; then # (upon removal)
+    %wps_object_delete_all
+fi
+}}}
+
+For a sub-package named "extras", the scriptlets will look as follows:
+{{{
+%post extras
+if [ "$1" -ge 1 ]; then # (upon update)
+    %wps_object_delete_all -n %{name}-extras
+fi
+%wps_object_create_begin -n %{name}-extras
+MYAPP_EXTRAS_FOLDER:WPFolder|My App Extras|<WP_DESKTOP>
+MYAPP_FOOBAR_EXE:WPProgram|My App FooBar|<MYAPP_EXTRAS_FOLDER>|EXENAME=((%{_bindir}/myapp-foobar.exe))
+%wps_object_create_end
+
+%postun
+if [ "$1" -e 0 ]; then # (upon removal)
+    %wps_object_delete_all -n %{name}-extras
+fi
+}}}
+
 === CONFIG.SYS changes ===
 It is sometimes necessary to modify the CONFIG.SYS file during installation, even when using RPM. One of the examples is when your package installs a device driver that needs to be loaded at boot time or when a global environment variable needs to be set. This can be done from the {{{%post}}} section using the special macro {{{%cube}}} which is based on the CUBE tool.