data: add xbps.hook manpage

Author: Duncaen

data/Makefile

@@ -13,6 +13,7 @@ all:
 install:
 	install -d $(DESTDIR)$(MANDIR)/man5
 	install -m644 xbps.d.5 $(DESTDIR)$(MANDIR)/man5
+	install -m644 xbps.hook.5 $(DESTDIR)$(MANDIR)/man5
 	install -d $(DESTDIR)$(MANDIR)/man7
 	install -m644 xbps.7 $(DESTDIR)$(MANDIR)/man7
 	install -d $(DESTDIR)$(PKGCONFIGDIR)

data/xbps.hook.5

@@ -0,0 +1,102 @@
+.Dd December 22, 2025
+.Dt XBPS.HOOK 5
+.Os
+.Sh NAME
+.Nm xbps.hook
+.Nd XBPS hook configuration
+.Sh SYNOPSIS
+.Bl -item -compact
+.It
+/etc/xbps.d/hooks/*.conf
+.It
+/usr/share/xbps.d/hooks/*.conf
+.El
+.Sh DESCRIPTION
+The
+.Nm
+are
+.So .ini Sc Ns -style
+configuration files to define hooks.
+Comments can be put anywhere in the file
+and using hashmarks
+.Pq Sq # ,
+or
+semicolons
+.Pq Sq ; ,
+and are continue to the end of the line.
+.Sh [HOOK] SECTION OPTIONS
+.Bl -tag -width -x
+.It Sy Name=
+Set the hook name used used for logging.
+.It Sy Exec= Ar command Op Ar args ...
+The command executed by the hook.
+The value is split into words,
+and passed to
+.Xr execv 3 ,
+spaces and tabs can be escaped using a
+backslash
+.Pq Sq \e .
+.It Ic When Ns = Oo Ic PreTransaction | Ic PostTransaction Oc
+Defines when the hook is executed.
+The following values are supported
+and multiple values can be set by
+separating them with a space or defining
+the
+.Sy When
+option multiple times.
+Possible values are:
+.Bl -tag -width -x
+.It Ic PreTransaction
+Before packages are installed,
+updated,
+or removed.
+.It Ic PostTransaction
+After package are installed,
+updated,
+or removed.
+.El
+.El
+.Sh [MATCH] SECTION OPTIONS
+The
+.Sy Match
+section can be defined multiple times.
+.Bl -tag -width -x
+.It Ic Action Ns = Oo Ic Install | Ic Remove | Ic Update | Ic Configure Oc
+Set the hook name used used for logging.
+.It Ic Path Ns = Oo Ar path ... | Ar pattern ... Oc
+.It Ic Package Ns = Oo Ar pkgname ... | Ar pkgpattern ... Oc
+.Sh EXAMPLES
+The following example restarts the
+.Ic sshd
+service after the
+.Ic ssh
+package was updated.
+.Pp
+.Pp
+.Bd -literal -offset indent
+[Hook]
+Name = Restart sshd.
+When = PostTransaction
+Exec = sv restart /var/service/sshd
+
+[Match]
+Action = Update
+Package = ssh
+.Ed
+.Pp
+This example hook will sign the
+.Pa systemd-bootx64.efi
+file whenever it is being updated or installed.
+.Bd -literal -offset indent
+[Hook]
+Name = Sign the bootloader file.
+When = PostTransaction
+Exec = sbsign --key /etc/kernel/secure-boot.key.pem \e
+	--cert /etc/kernel/secure-boot.cert.pem \e
+	--output /usr/lib/systemd/boot/efi/systemd-bootx64.efi.signed \e
+	/usr/lib/systemd/boot/efi/systemd-bootx64.efi
+
+[Match]
+Action = Install Update
+Path = /usr/lib/systemd/boot/efi/systemd-bootx64.efi
+.Ed