pkg_add.1 (50479) | pkg_add.1 (50741) |
---|---|
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.\" 17.\" @(#)pkg_add.1 | 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.\" 17.\" @(#)pkg_add.1 |
18.\" $FreeBSD: head/usr.sbin/pkg_install/add/pkg_add.1 50479 1999-08-28 01:35:59Z peter $ | 18.\" $FreeBSD: head/usr.sbin/pkg_install/add/pkg_add.1 50741 1999-09-01 10:04:47Z jkh $ |
19.\" 20.Dd November 25, 1994 21.Dt PKG_ADD 1 22.Os FreeBSD 23.Sh NAME 24.Nm pkg_add 25.Nd a utility for installing software package distributions 26.Sh SYNOPSIS --- 4 unchanged lines hidden (view full) --- 31.Ar pkg-name [pkg-name ...] 32.Sh DESCRIPTION 33The 34.Nm 35command is used to extract packages that have been previously created 36with the 37.Xr pkg_create 1 38command. | 19.\" 20.Dd November 25, 1994 21.Dt PKG_ADD 1 22.Os FreeBSD 23.Sh NAME 24.Nm pkg_add 25.Nd a utility for installing software package distributions 26.Sh SYNOPSIS --- 4 unchanged lines hidden (view full) --- 31.Ar pkg-name [pkg-name ...] 32.Sh DESCRIPTION 33The 34.Nm 35command is used to extract packages that have been previously created 36with the 37.Xr pkg_create 1 38command. |
39 | |
40.Sh WARNING 41.Bf -emphasis 42Since the 43.Nm 44command may execute scripts or programs contained within a package file, | 39.Sh WARNING 40.Bf -emphasis 41Since the 42.Nm 43command may execute scripts or programs contained within a package file, |
45your system may be susceptible to ``trojan horses'' or other subtle | 44your system may be susceptible to 45.Dq Em trojan horses 46or other subtle |
46attacks from miscreants who create dangerous package files. 47.Pp 48You are advised to verify the competence and identity of those who 49provide installable package files. For extra protection, use the 50.Fl M 51flag to extract the package file, and inspect its contents and scripts to 52insure it poses no danger to your system's integrity. Pay particular 53attention to any +INSTALL, +POST-INSTALL, +DEINSTALL, +POST-DEINSTALL, --- 64 unchanged lines hidden (view full) --- 118and 119.Fl S 120options). 121.It Fl t Ar template 122Use 123.Ar template 124as the input to 125.Xr mktemp 3 | 47attacks from miscreants who create dangerous package files. 48.Pp 49You are advised to verify the competence and identity of those who 50provide installable package files. For extra protection, use the 51.Fl M 52flag to extract the package file, and inspect its contents and scripts to 53insure it poses no danger to your system's integrity. Pay particular 54attention to any +INSTALL, +POST-INSTALL, +DEINSTALL, +POST-DEINSTALL, --- 64 unchanged lines hidden (view full) --- 119and 120.Fl S 121options). 122.It Fl t Ar template 123Use 124.Ar template 125as the input to 126.Xr mktemp 3 |
126when creating a ``staging area.'' | 127when creating a 128.Dq staging area . |
127By default, this is the string 128.Pa /var/tmp/instmp.XXXXXX , 129but it may be necessary to override it in the situation where 130space in your 131.Pa /var/tmp 132directory is limited. Be sure to leave some number of `X' characters 133for 134.Xr mktemp 3 --- 37 unchanged lines hidden (view full) --- 172in the staging area, the location of which is read as a string 173from stdin. The complete packing list is also read from stdin, 174and the contents then acted on as normal. 175.El 176.Pp 177One or more 178.Ar pkg-name 179arguments may be specified, each being either a file containing the | 129By default, this is the string 130.Pa /var/tmp/instmp.XXXXXX , 131but it may be necessary to override it in the situation where 132space in your 133.Pa /var/tmp 134directory is limited. Be sure to leave some number of `X' characters 135for 136.Xr mktemp 3 --- 37 unchanged lines hidden (view full) --- 174in the staging area, the location of which is read as a string 175from stdin. The complete packing list is also read from stdin, 176and the contents then acted on as normal. 177.El 178.Pp 179One or more 180.Ar pkg-name 181arguments may be specified, each being either a file containing the |
180package (these usually ending with the ``.tgz'' suffix) or a | 182package (these usually ending with the 183.Dq .tgz 184suffix) or a |
181URL pointing at a file available on an ftp site. Thus you may 182extract files directly from their anonymous ftp locations (e.g. 183.Nm 184ftp://ftp.freebsd.org/pub/FreeBSD/packages/shells/bash-1.14.4.tgz). 185Note: If you wish to use 186.Bf -emphasis 187passive mode 188.Ef --- 144 unchanged lines hidden (view full) --- 333.Xr pkg_create 1 ). 334 335Reasoning behind passing keywords such as 336.Ar POST-INSTALL 337and 338.Ar PRE-INSTALL 339is that this allows you to write a single 340.Ar install | 185URL pointing at a file available on an ftp site. Thus you may 186extract files directly from their anonymous ftp locations (e.g. 187.Nm 188ftp://ftp.freebsd.org/pub/FreeBSD/packages/shells/bash-1.14.4.tgz). 189Note: If you wish to use 190.Bf -emphasis 191passive mode 192.Ef --- 144 unchanged lines hidden (view full) --- 337.Xr pkg_create 1 ). 338 339Reasoning behind passing keywords such as 340.Ar POST-INSTALL 341and 342.Ar PRE-INSTALL 343is that this allows you to write a single 344.Ar install |
341script that does both ``before and after'' actions. But, separating the | 345script that does both 346.Dq before and after 347actions. But, separating the |
342functionality is more advantageous and easier from a maintainence viewpoint. 343.It 344After installation is complete, a copy of the packing list, 345.Ar deinstall 346script, description, and display files are copied into 347.Pa /var/db/pkg/<pkg-name> 348for subsequent possible use by 349.Xr pkg_delete 1 . --- 108 unchanged lines hidden --- | 348functionality is more advantageous and easier from a maintainence viewpoint. 349.It 350After installation is complete, a copy of the packing list, 351.Ar deinstall 352script, description, and display files are copied into 353.Pa /var/db/pkg/<pkg-name> 354for subsequent possible use by 355.Xr pkg_delete 1 . --- 108 unchanged lines hidden --- |