summaryrefslogtreecommitdiff
path: root/usr.sbin/pkg_add/pkg_create.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin/pkg_add/pkg_create.1')
-rw-r--r--usr.sbin/pkg_add/pkg_create.154
1 files changed, 52 insertions, 2 deletions
diff --git a/usr.sbin/pkg_add/pkg_create.1 b/usr.sbin/pkg_add/pkg_create.1
index 6e5c3ae03a0..73481ef2a45 100644
--- a/usr.sbin/pkg_add/pkg_create.1
+++ b/usr.sbin/pkg_add/pkg_create.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: pkg_create.1,v 1.42 2007/06/14 10:16:37 espie Exp $
+.\" $OpenBSD: pkg_create.1,v 1.43 2007/06/17 10:35:55 espie Exp $
.\"
.\" Documentation and design originally from FreeBSD. All the code has
.\" been rewritten since. We keep the documentation's notice:
@@ -21,7 +21,7 @@
.\" [jkh] Took John's changes back and made some additional extensions for
.\" better integration with FreeBSD's new ports collection.
.\"
-.Dd $Mdocdate: June 14 2007 $
+.Dd $Mdocdate: June 17 2007 $
.Dt PKG_CREATE 1
.Os
.Sh NAME
@@ -339,6 +339,15 @@ Execute
.Ar command
during
.Xr pkg_add 1 .
+Note that
+.Cm @exec
+commands are executed relative to their location in the packing-list,
+so they can rely on any data that have already been extracted,
+but not on anything that is listed after them.
+Some special elements, such as new users and new groups, are always
+created first, so that
+.Cm @exec
+can rely on them.
If
.Ar command
contains any of the following sequences somewhere in it, they will
@@ -376,6 +385,22 @@ in the example case,
.Pa emacs .
.El
.Pp
+.It Cm @exec-always Ar command
+Synonym of
+.Cm @exec .
+.Pp
+.It Cm @exec-add Ar command
+Similar to
+.Cm @exec ,
+except it only gets executed during new installations,
+and not during updates.
+.Pp
+.It Cm @exec-update Ar command
+Similar to
+.Cm @exec ,
+except it only gets executed during updates,
+and not during new installations.
+.Pp
.It Cm @extra Ar filename
Declare extra file
.Pa filename
@@ -652,6 +677,31 @@ Expansion of special
.Cm \&%
sequences is the same as for
.Cm @exec .
+Note that
+.Cm @unexec
+commands are executed relative to their location in the packing-list,
+so they cannot rely on any data that has already been deleted,
+thus they should occur before the files they need to function.
+Some special elements, such as new users and new groups, are always
+deleted last, so that
+.Cm @unexec
+can rely on them.
+.Pp
+.It Cm @unexec-always Ar command
+Synonym of
+.Cm @unexec .
+.Pp
+.It Cm @unexec-delete Ar command
+Similar to
+.Cm @unexec ,
+except it only gets executed during true deletions
+and not while removing an old package during updates.
+.Pp
+.It Cm @unexec-update Ar command
+Similar to
+.Cm @unexec ,
+except it only gets executed while removing an old package during updates,
+and not during true deletions.
.Pp
.It Cm @wantlib Ar libspec
Package needs a shared library to work.