1.\"
2.\" FreeBSD install - a package for the installation and maintainance
3.\" of non-core utilities.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution.
13.\"
14.\" Jordan K. Hubbard
15.\"
16.\" $FreeBSD: head/usr.sbin/pkg_install/add/pkg_add.1 141846 2005-02-13 22:25:33Z ru $
17.\"
18.Dd March 1, 2004
19.Dt PKG_ADD 1
20.Os
21.Sh NAME
22.Nm pkg_add
23.Nd a utility for installing software package distributions
24.Sh SYNOPSIS
25.Nm
26.Op Fl vInfrRMS
27.Op Fl t Ar template
28.Op Fl p Ar prefix
29.Op Fl C Ar chrootdir
30.Ar pkg-name Op Ar pkg-name ...
31.Sh DESCRIPTION
32The
33.Nm
34command is used to extract packages that have been previously created
35with the
36.Xr pkg_create 1
--- 85 unchanged lines hidden (view full) ---
122may then wish to look into the use of
123.Cm MASTER
124and
125.Cm SLAVE
126modes (see the
127.Fl M
128and
129.Fl S
130options).
131.It Fl t Ar template
132Use
133.Ar template
134as the input to
135.Xr mktemp 3
136when creating a
137.Dq staging area .
138By default, this is the string
--- 214 unchanged lines hidden (view full) ---
353.Fl e
354.Fl p
355.Pa prefix
356.Ed
357where
358.Pa prefix
359is either the prefix specified with the
360.Fl p
361flag or, if no
362.Fl p
363flag was specified, the name of the first directory named by a
364.Cm @cwd
365directive within this package.
366.It
367If a
368.Ar post-install
369script exists for the package, it is then executed as
370.Bd -ragged -offset indent -compact
371.Cm script
--- 44 unchanged lines hidden (view full) ---
416.It
417Finally, the staging area is deleted and the program terminates.
418.El
419.Pp
420All the scripts are called with the environment variable
421.Ev PKG_PREFIX
422set to the installation prefix (see the
423.Fl p
424option above).
425This allows a package author to write a script
426that reliably performs some action on the directory where the package
427is installed, even if the user might change it with the
428.Fl p
429flag to
430.Cm pkg_add .
431.Sh ENVIRONMENT
432The value of the
433.Ev PKG_PATH
434is used if a given package cannot be found.
435The environment variable
436should be a series of entries separated by colons.
437Each entry
--- 102 unchanged lines hidden ---
2.\" FreeBSD install - a package for the installation and maintainance
3.\" of non-core utilities.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution.
13.\"
14.\" Jordan K. Hubbard
15.\"
16.\" $FreeBSD: head/usr.sbin/pkg_install/add/pkg_add.1 141846 2005-02-13 22:25:33Z ru $
17.\"
18.Dd March 1, 2004
19.Dt PKG_ADD 1
20.Os
21.Sh NAME
22.Nm pkg_add
23.Nd a utility for installing software package distributions
24.Sh SYNOPSIS
25.Nm
26.Op Fl vInfrRMS
27.Op Fl t Ar template
28.Op Fl p Ar prefix
29.Op Fl C Ar chrootdir
30.Ar pkg-name Op Ar pkg-name ...
31.Sh DESCRIPTION
32The
33.Nm
34command is used to extract packages that have been previously created
35with the
36.Xr pkg_create 1
--- 85 unchanged lines hidden (view full) ---
122may then wish to look into the use of
123.Cm MASTER
124and
125.Cm SLAVE
126modes (see the
127.Fl M
128and
129.Fl S
130options).
131.It Fl t Ar template
132Use
133.Ar template
134as the input to
135.Xr mktemp 3
136when creating a
137.Dq staging area .
138By default, this is the string
--- 214 unchanged lines hidden (view full) ---
353.Fl e
354.Fl p
355.Pa prefix
356.Ed
357where
358.Pa prefix
359is either the prefix specified with the
360.Fl p
361flag or, if no
362.Fl p
363flag was specified, the name of the first directory named by a
364.Cm @cwd
365directive within this package.
366.It
367If a
368.Ar post-install
369script exists for the package, it is then executed as
370.Bd -ragged -offset indent -compact
371.Cm script
--- 44 unchanged lines hidden (view full) ---
416.It
417Finally, the staging area is deleted and the program terminates.
418.El
419.Pp
420All the scripts are called with the environment variable
421.Ev PKG_PREFIX
422set to the installation prefix (see the
423.Fl p
424option above).
425This allows a package author to write a script
426that reliably performs some action on the directory where the package
427is installed, even if the user might change it with the
428.Fl p
429flag to
430.Cm pkg_add .
431.Sh ENVIRONMENT
432The value of the
433.Ev PKG_PATH
434is used if a given package cannot be found.
435The environment variable
436should be a series of entries separated by colons.
437Each entry
--- 102 unchanged lines hidden ---