regen (using 'mandoc -Ios=pkgsrc')diff -r1.5 -r1.6 pkgsrc/pkgtools/pkg_install/files/add/pkg_add.cat
(wiz)
@@ -1,93 +1,92 @@ | @@ -1,93 +1,92 @@ | |||
1 | PKG_ADD(1) NetBSD General Commands Manual PKG_ADD(1) | 1 | PKG_ADD(1) General Commands Manual PKG_ADD(1) | |
2 | 2 | |||
3 | NNAAMMEE | 3 | NNAAMMEE | |
4 | ppkkgg__aadddd -- a utility for installing and upgrading software package dis- | 4 | ppkkgg__aadddd -- a utility for installing and upgrading software package | |
5 | tributions | 5 | distributions | |
6 | 6 | |||
7 | SSYYNNOOPPSSIISS | 7 | SSYYNNOOPPSSIISS | |
8 | ppkkgg__aadddd [--AAffIILLnnRRUUuuVVvv] [--CC _c_o_n_f_i_g] [--KK _p_k_g___d_b_d_i_r] [--mm _m_a_c_h_i_n_e] | 8 | ppkkgg__aadddd [--AAffIInnRRUUuuVVvv] [--CC _c_o_n_f_i_g] [--KK _p_k_g___d_b_d_i_r] [--mm _m_a_c_h_i_n_e] [--PP _d_e_s_t_d_i_r] | |
9 | [--PP _d_e_s_t_d_i_r] [--pp _p_r_e_f_i_x] [--WW _v_i_e_w_b_a_s_e] [--ww _v_i_e_w] _f_i_l_e _._._. | 9 | [--pp _p_r_e_f_i_x] | |
10 | [[ftp|http]://[_u_s_e_r][:_p_a_s_s_w_o_r_d]@]_h_o_s_t[:_p_o_r_t][/_p_a_t_h_/]_p_k_g_-_n_a_m_e _._._. | 10 | _f_i_l_e _._._. [[ftp|http]://[_u_s_e_r][:_p_a_s_s_w_o_r_d]@]_h_o_s_t[:_p_o_r_t][/_p_a_t_h_/]_p_k_g_-_n_a_m_e _._._. | |
11 | 11 | |||
12 | DDEESSCCRRIIPPTTIIOONN | 12 | DDEESSCCRRIIPPTTIIOONN | |
13 | The ppkkgg__aadddd command is used to extract and upgrade packages that have | 13 | The ppkkgg__aadddd command is used to extract and upgrade packages that have | |
14 | been previously created with the pkg_create(1) command. Packages are | 14 | been previously created with the pkg_create(1) command. Packages are | |
15 | prepared collections of pre-built binaries, documentation, configura- | 15 | prepared collections of pre-built binaries, documentation, | |
16 | tions, installation instructions and/or other files. ppkkgg__aadddd can recur- | 16 | configurations, installation instructions and/or other files. ppkkgg__aadddd | |
17 | sively install other packages that the current package depends on or | 17 | can recursively install other packages that the current package depends | |
18 | requires from both local disk and via FTP or HTTP. | 18 | on or requires from both local disk and via FTP or HTTP. | |
19 | 19 | |||
20 | WWAARRNNIINNGG | 20 | WWAARRNNIINNGG | |
21 | _S_i_n_c_e _t_h_e ppkkgg__aadddd _c_o_m_m_a_n_d _m_a_y _e_x_e_c_u_t_e _s_c_r_i_p_t_s _o_r _p_r_o_g_r_a_m_s _c_o_n_t_a_i_n_e_d | 21 | _S_i_n_c_e _t_h_e ppkkgg__aadddd _c_o_m_m_a_n_d _m_a_y _e_x_e_c_u_t_e _s_c_r_i_p_t_s _o_r _p_r_o_g_r_a_m_s _c_o_n_t_a_i_n_e_d | |
22 | _w_i_t_h_i_n _a _p_a_c_k_a_g_e _f_i_l_e_, _y_o_u_r _s_y_s_t_e_m _m_a_y _b_e _s_u_s_c_e_p_t_i_b_l_e _t_o _`_`_T_r_o_j_a_n | 22 | _w_i_t_h_i_n _a _p_a_c_k_a_g_e _f_i_l_e_, _y_o_u_r _s_y_s_t_e_m _m_a_y _b_e _s_u_s_c_e_p_t_i_b_l_e _t_o _`_`_T_r_o_j_a_n | |
23 | _h_o_r_s_e_s_'_' _o_r _o_t_h_e_r _s_u_b_t_l_e _a_t_t_a_c_k_s _f_r_o_m _m_i_s_c_r_e_a_n_t_s _w_h_o _c_r_e_a_t_e _d_a_n_g_e_r_o_u_s | 23 | _h_o_r_s_e_s_'_' _o_r _o_t_h_e_r _s_u_b_t_l_e _a_t_t_a_c_k_s _f_r_o_m _m_i_s_c_r_e_a_n_t_s _w_h_o _c_r_e_a_t_e _d_a_n_g_e_r_o_u_s | |
24 | _p_a_c_k_a_g_e _f_i_l_e_s_. | 24 | _p_a_c_k_a_g_e _f_i_l_e_s_. | |
25 | 25 | |||
26 | _Y_o_u _a_r_e _a_d_v_i_s_e_d _t_o _v_e_r_i_f_y _t_h_e _c_o_m_p_e_t_e_n_c_e _a_n_d _i_d_e_n_t_i_t_y _o_f _t_h_o_s_e _w_h_o _p_r_o_- | 26 | _Y_o_u _a_r_e _a_d_v_i_s_e_d _t_o _v_e_r_i_f_y _t_h_e _c_o_m_p_e_t_e_n_c_e _a_n_d _i_d_e_n_t_i_t_y _o_f _t_h_o_s_e _w_h_o | |
27 | _v_i_d_e _i_n_s_t_a_l_l_a_b_l_e _p_a_c_k_a_g_e _f_i_l_e_s_. _F_o_r _e_x_t_r_a _p_r_o_t_e_c_t_i_o_n_, _u_s_e _t_h_e _d_i_g_i_t_a_l | 27 | _p_r_o_v_i_d_e _i_n_s_t_a_l_l_a_b_l_e _p_a_c_k_a_g_e _f_i_l_e_s_. _F_o_r _e_x_t_r_a _p_r_o_t_e_c_t_i_o_n_, _u_s_e _t_h_e _d_i_g_i_t_a_l | |
28 | _s_i_g_n_a_t_u_r_e_s _p_r_o_v_i_d_e_d _w_h_e_r_e _p_o_s_s_i_b_l_e _(_s_e_e _t_h_e pkg_install.conf(_5)_)_, _o_r_, | 28 | _s_i_g_n_a_t_u_r_e_s _p_r_o_v_i_d_e_d _w_h_e_r_e _p_o_s_s_i_b_l_e _(_s_e_e _t_h_e _p_k_g___i_n_s_t_a_l_l_._c_o_n_f_(_5_)_)_, _o_r_, | |
29 | _f_a_i_l_i_n_g _t_h_a_t_, _u_s_e tar(_1) _t_o _e_x_t_r_a_c_t _t_h_e _p_a_c_k_a_g_e _f_i_l_e_, _a_n_d _i_n_s_p_e_c_t _i_t_s | 29 | _f_a_i_l_i_n_g _t_h_a_t_, _u_s_e _t_a_r_(_1_) _t_o _e_x_t_r_a_c_t _t_h_e _p_a_c_k_a_g_e _f_i_l_e_, _a_n_d _i_n_s_p_e_c_t _i_t_s | |
30 | _c_o_n_t_e_n_t_s _a_n_d _s_c_r_i_p_t_s _t_o _e_n_s_u_r_e _i_t _p_o_s_e_s _n_o _d_a_n_g_e_r _t_o _y_o_u_r _s_y_s_t_e_m_'_s | 30 | _c_o_n_t_e_n_t_s _a_n_d _s_c_r_i_p_t_s _t_o _e_n_s_u_r_e _i_t _p_o_s_e_s _n_o _d_a_n_g_e_r _t_o _y_o_u_r _s_y_s_t_e_m_'_s | |
31 | _i_n_t_e_g_r_i_t_y_. _P_a_y _p_a_r_t_i_c_u_l_a_r _a_t_t_e_n_t_i_o_n _t_o _a_n_y _+_I_N_S_T_A_L_L _o_r _+_D_E_I_N_S_T_A_L_L _f_i_l_e_s_, | 31 | _i_n_t_e_g_r_i_t_y_. _P_a_y _p_a_r_t_i_c_u_l_a_r _a_t_t_e_n_t_i_o_n _t_o _a_n_y _+_I_N_S_T_A_L_L _o_r _+_D_E_I_N_S_T_A_L_L _f_i_l_e_s_, | |
32 | _a_n_d _i_n_s_p_e_c_t _t_h_e _+_C_O_N_T_E_N_T_S _f_i_l_e _f_o_r @@ccwwdd_, @@mmooddee _(_c_h_e_c_k _f_o_r _s_e_t_u_i_d_)_, | 32 | _a_n_d _i_n_s_p_e_c_t _t_h_e _+_C_O_N_T_E_N_T_S _f_i_l_e _f_o_r @@ccwwdd_, @@mmooddee _(_c_h_e_c_k _f_o_r _s_e_t_u_i_d_)_, | |
33 | @@ddiirrrrmm_, @@eexxeecc_, _a_n_d @@uunneexxeecc _d_i_r_e_c_t_i_v_e_s_, _a_n_d_/_o_r _u_s_e _t_h_e pkg_info(_1) _c_o_m_m_a_n_d | 33 | @@ddiirrrrmm_, @@eexxeecc_, _a_n_d @@uunneexxeecc _d_i_r_e_c_t_i_v_e_s_, _a_n_d_/_o_r _u_s_e _t_h_e _p_k_g___i_n_f_o_(_1_) _c_o_m_m_a_n_d | |
34 | _t_o _e_x_a_m_i_n_e _t_h_e _p_a_c_k_a_g_e _f_i_l_e_. | 34 | _t_o _e_x_a_m_i_n_e _t_h_e _p_a_c_k_a_g_e _f_i_l_e_. | |
35 | 35 | |||
36 | OOPPTTIIOONNSS | 36 | OOPPTTIIOONNSS | |
37 | The following command line arguments are supported: | 37 | The following command line arguments are supported: | |
38 | 38 | |||
39 | _p_k_g_-_n_a_m_e [_._._.] | 39 | _p_k_g_-_n_a_m_e [_._._.] | |
40 | The named packages are installed. ppkkgg__aadddd will first try to use | 40 | The named packages are installed. ppkkgg__aadddd will first try to use | |
41 | _p_k_g_-_n_a_m_e as full URL or path name without any wildcard process- | 41 | _p_k_g_-_n_a_m_e as full URL or path name without any wildcard | |
42 | ing. If that fails, ppkkgg__aadddd will try to match packages using | 42 | processing. If that fails, ppkkgg__aadddd will try to match packages | |
43 | wildcard processing. If that fails as well and _p_k_g_-_n_a_m_e does not | 43 | using wildcard processing. If that fails as well and _p_k_g_-_n_a_m_e | |
44 | contain any /, the entries of the PKG_PATH variable are searched | 44 | does not contain any /, the entries of the PKG_PATH variable are | |
45 | using the wildcard processing rules. | 45 | searched using the wildcard processing rules. | |
46 | 46 | |||
47 | --AA Mark package as installed automatically, as dependency of another | 47 | --AA Mark package as installed automatically, as dependency of another | |
48 | package. You can use | 48 | package. You can use | |
49 | ppkkgg__aaddmmiinn sseett aauuttoommaattiicc==YYEESS | 49 | ppkkgg__aaddmmiinn sseett aauuttoommaattiicc==YYEESS | |
50 | to mark packages this way after installation, and | 50 | to mark packages this way after installation, and | |
51 | ppkkgg__aaddmmiinn uunnsseett aauuttoommaattiicc | 51 | ppkkgg__aaddmmiinn uunnsseett aauuttoommaattiicc | |
52 | to remove the mark. If you ppkkgg__aadddd a package without specifying | 52 | to remove the mark. If you ppkkgg__aadddd a package without specifying | |
53 | --AA after it had already been automatically installed, the mark is | 53 | --AA after it had already been automatically installed, the mark is | |
54 | removed. | 54 | removed. | |
55 | 55 | |||
56 | --CC _c_o_n_f_i_g | 56 | --CC _c_o_n_f_i_g | |
57 | Read the configuration file from _c_o_n_f_i_g instead of the system | 57 | Read the configuration file from _c_o_n_f_i_g instead of the system | |
58 | default. | 58 | default. | |
59 | 59 | |||
60 | --ff Force installation to proceed even if prerequisite packages are | 60 | --ff Force installation to proceed even if prerequisite packages are | |
61 | not installed or the install script fails. Although ppkkgg__aadddd will | 61 | not installed or the install script fails. Although ppkkgg__aadddd will | |
62 | still try to find and auto-install missing prerequisite packages, | 62 | still try to find and auto-install missing prerequisite packages, | |
63 | a failure to find one will not be fatal. This flag also over- | 63 | a failure to find one will not be fatal. This flag also | |
64 | rides the fatal error when the operating system or architecture | 64 | overrides the fatal error when the operating system or | |
65 | the package was built on differ from that of the host. | 65 | architecture the package was built on differ from that of the | |
66 | host. | |||
66 | 67 | |||
67 | --DD Force updating even if the dependencies of depending packages are | 68 | --DD Force updating even if the dependencies of depending packages are | |
68 | not satisfied by the new package. This is used by "make | 69 | not satisfied by the new package. This is used by "make | |
69 | replace", after which one would typically replace the depending | 70 | replace", after which one would typically replace the depending | |
70 | packages. | 71 | packages. | |
71 | 72 | |||
72 | --II If an installation script exists for a given package, do not exe- | 73 | --II If an installation script exists for a given package, do not | |
73 | cute it. | 74 | execute it. | |
74 | 75 | |||
75 | --KK _p_k_g___d_b_d_i_r | 76 | --KK _p_k_g___d_b_d_i_r | |
76 | Override the value of the PKG_DBDIR configuration option with the | 77 | Override the value of the PKG_DBDIR configuration option with the | |
77 | value _p_k_g___d_b_d_i_r. | 78 | value _p_k_g___d_b_d_i_r. | |
78 | 79 | |||
79 | --LL Don't add the package to any views after installation. | |||
80 | ||||
81 | --mm Override the machine architecture returned by uname with _m_a_c_h_i_n_e. | 80 | --mm Override the machine architecture returned by uname with _m_a_c_h_i_n_e. | |
82 | 81 | |||
83 | --nn Don't actually install a package, just report the steps that | 82 | --nn Don't actually install a package, just report the steps that | |
84 | would be taken if it was. | 83 | would be taken if it was. | |
85 | 84 | |||
86 | --PP _d_e_s_t_d_i_r | 85 | --PP _d_e_s_t_d_i_r | |
87 | Prefix all file and directory names with _d_e_s_t_d_i_r. For packages | 86 | Prefix all file and directory names with _d_e_s_t_d_i_r. For packages | |
88 | without install scripts this has the same behavior as using | 87 | without install scripts this has the same behavior as using | |
89 | chroot(8). | 88 | chroot(8). | |
90 | 89 | |||
91 | --pp _p_r_e_f_i_x | 90 | --pp _p_r_e_f_i_x | |
92 | Override the prefix stored in the package with _p_r_e_f_i_x. | 91 | Override the prefix stored in the package with _p_r_e_f_i_x. | |
93 | 92 | |||
@@ -97,146 +96,138 @@ OOPPTTIIOONNSS | @@ -97,146 +96,138 @@ OOPPTTIIOONNSS | |||
97 | 96 | |||
98 | --UU Replace an already installed version from a package. Implies --uu. | 97 | --UU Replace an already installed version from a package. Implies --uu. | |
99 | 98 | |||
100 | --uu If the package that's being installed is already installed, an | 99 | --uu If the package that's being installed is already installed, an | |
101 | update is performed. Installed dependent packages are updated | 100 | update is performed. Installed dependent packages are updated | |
102 | recursively, if they are too old to fulfill the dependencies of | 101 | recursively, if they are too old to fulfill the dependencies of | |
103 | the to-be-installed version. See below for a more detailed | 102 | the to-be-installed version. See below for a more detailed | |
104 | description of the process. | 103 | description of the process. | |
105 | 104 | |||
106 | --VV Print version number and exit. | 105 | --VV Print version number and exit. | |
107 | 106 | |||
108 | --vv Turn on verbose output. | 107 | --vv Turn on verbose output. | |
109 | 108 | |||
110 | --WW _v_i_e_w_b_a_s_e | |||
111 | Passed down to pkg_view(1) for managed views. | |||
112 | ||||
113 | --ww _v_i_e_w | |||
114 | Passed down to pkg_view(1) for managed views. | |||
115 | ||||
116 | One or more _p_k_g_-_n_a_m_e arguments may be specified, each being either a file | 109 | One or more _p_k_g_-_n_a_m_e arguments may be specified, each being either a file | |
117 | containing the package (these usually ending with the ``.tgz'' suffix) or | 110 | containing the package (these usually ending with the ``.tgz'' suffix) or | |
118 | a URL pointing at a file available on an ftp or web site. Thus you may | 111 | a URL pointing at a file available on an ftp or web site. Thus you may | |
119 | extract files directly from their anonymous ftp or WWW locations (e.g., | 112 | extract files directly from their anonymous ftp or WWW locations (e.g., | |
120 | ppkkgg__aadddd ftp://ftp.NetBSD.org/pub/pkgsrc/pack- | 113 | ppkkgg__aadddd | |
121 | ages/NetBSD/i386/3.1_2007Q2/shells/bash-3.2.9.tgz or ppkkgg__aadddd | 114 | ftp://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/i386/3.1_2007Q2/shells/bash-3.2.9.tgz | |
122 | http://www.example.org/packages/screen-4.0.tbz). Note: For ftp trans- | 115 | or ppkkgg__aadddd http://www.example.org/packages/screen-4.0.tbz). Note: For | |
123 | fers, if you wish to use _p_a_s_s_i_v_e _m_o_d_e ftp in such transfers, set the | 116 | ftp transfers, if you wish to use _p_a_s_s_i_v_e _m_o_d_e ftp in such transfers, set | |
124 | variable _F_T_P___P_A_S_S_I_V_E___M_O_D_E to some value in your environment. Otherwise, | 117 | the variable _F_T_P___P_A_S_S_I_V_E___M_O_D_E to some value in your environment. | |
125 | the more standard ACTIVE mode may be used. If ppkkgg__aadddd consistently fails | 118 | Otherwise, the more standard ACTIVE mode may be used. If ppkkgg__aadddd | |
126 | to fetch a package from a site known to work, it may be because you have | 119 | consistently fails to fetch a package from a site known to work, it may | |
127 | a firewall that demands the usage of _p_a_s_s_i_v_e _m_o_d_e ftp. | 120 | be because you have a firewall that demands the usage of _p_a_s_s_i_v_e _m_o_d_e | |
121 | ftp. | |||
128 | 122 | |||
129 | TTEECCHHNNIICCAALL DDEETTAAIILLSS | 123 | TTEECCHHNNIICCAALL DDEETTAAIILLSS | |
130 | ppkkgg__aadddd extracts each package's meta data (including the ``packing | 124 | ppkkgg__aadddd extracts each package's meta data (including the ``packing | |
131 | list'') to memory and then runs through the following sequence to fully | 125 | list'') to memory and then runs through the following sequence to fully | |
132 | extract the contents of the package: | 126 | extract the contents of the package: | |
133 | 127 | |||
134 | 1. A check is made to determine if the package or another version | 128 | 1. A check is made to determine if the package or another version | |
135 | of it is already recorded as installed. If it is, installa- | 129 | of it is already recorded as installed. If it is, | |
136 | tion is terminated if the --uu or --UU options are not given. | 130 | installation is terminated if the --uu or --UU options are not | |
131 | given. | |||
137 | 132 | |||
138 | If the same version is installed and --UU is not given, it is | 133 | If the same version is installed and --UU is not given, it is | |
139 | marked as manually installed and process stops. If the --uu | 134 | marked as manually installed and process stops. If the --uu | |
140 | option is given, it's assumed the package should be replaced | 135 | option is given, it's assumed the package should be replaced | |
141 | by the new version instead. Before doing so, all packages | 136 | by the new version instead. Before doing so, all packages | |
142 | that depend on the pkg being upgraded are checked if they also | 137 | that depend on the pkg being upgraded are checked if they also | |
143 | work with the new version. If that test is not successful, | 138 | work with the new version. If that test is not successful, | |
144 | the dependent packages are updated first. The replacing is | 139 | the dependent packages are updated first. The replacing is | |
145 | then prepared by moving an existing _+_R_E_Q_U_I_R_E_D___B_Y file aside | 140 | then prepared by moving an existing _+_R_E_Q_U_I_R_E_D___B_Y file aside | |
146 | (if it exists), and running pkg_delete(1) on the installed | 141 | (if it exists), and running pkg_delete(1) on the installed | |
147 | package. Installation then proceeds as if the package was not | 142 | package. Installation then proceeds as if the package was not | |
148 | installed, and restores the _+_R_E_Q_U_I_R_E_D___B_Y file afterwards. | 143 | installed, and restores the _+_R_E_Q_U_I_R_E_D___B_Y file afterwards. | |
149 | 144 | |||
150 | 2. The package build information is extracted from the | 145 | 2. The package build information is extracted from the | |
151 | _+_B_U_I_L_D___I_N_F_O file and compared against the result of uname(3). | 146 | _+_B_U_I_L_D___I_N_F_O file and compared against the result of uname(3). | |
152 | If the operating system or architecture of the package differ | 147 | If the operating system or architecture of the package differ | |
153 | from that of the host, installation is aborted. This behavior | 148 | from that of the host, installation is aborted. This behavior | |
154 | is overridable with the --ff flag. | 149 | is overridable with the --ff flag. | |
155 | 150 | |||
156 | 3. The package build information from _+_B_U_I_L_D___I_N_F_O is then checked | 151 | 3. The package build information from _+_B_U_I_L_D___I_N_F_O is then checked | |
157 | for USE_ABI_DEPENDS=NO (or IGNORE_RECOMMENDED). If the pack- | 152 | for USE_ABI_DEPENDS=NO (or IGNORE_RECOMMENDED). If the | |
158 | age was built with ABI dependency recommendations ignored, a | 153 | package was built with ABI dependency recommendations ignored, | |
159 | warning will be issued. | 154 | a warning will be issued. | |
160 | 155 | |||
161 | 4. A check is made to determine if the package conflicts (from | 156 | 4. A check is made to determine if the package conflicts (from | |
162 | @@ppkkggccffll directives, see pkg_create(1)) with an already | 157 | @@ppkkggccffll directives, see pkg_create(1)) with an already | |
163 | recorded as installed package or if an installed package con- | 158 | recorded as installed package or if an installed package | |
164 | flicts with the package. If it is, installation is termi- | 159 | conflicts with the package. If it is, installation is | |
165 | nated. | 160 | terminated. | |
166 | 161 | |||
167 | 5. The file list of the package is compared to the file lists of | 162 | 5. The file list of the package is compared to the file lists of | |
168 | the installed packages. If there is any overlap, the instal- | 163 | the installed packages. If there is any overlap, the | |
169 | lation is terminated. | 164 | installation is terminated. | |
170 | 165 | |||
171 | 6. All package dependencies (from @@ppkkggddeepp directives, see | 166 | 6. All package dependencies (from @@ppkkggddeepp directives, see | |
172 | pkg_create(1)) are read from the packing list. If any of | 167 | pkg_create(1)) are read from the packing list. If any of | |
173 | these required packages are not currently installed, an | 168 | these required packages are not currently installed, an | |
174 | attempt is made to find and install it; if the missing package | 169 | attempt is made to find and install it; if the missing package | |
175 | cannot be found or installed, the installation is terminated. | 170 | cannot be found or installed, the installation is terminated. | |
176 | 171 | |||
177 | 7. If the package contains an _i_n_s_t_a_l_l script, it is executed with | 172 | 7. If the package contains an _i_n_s_t_a_l_l script, it is executed with | |
178 | the following arguments: | 173 | the following arguments: | |
179 | 174 | |||
180 | _p_k_g_-_n_a_m_e The name of the package being installed. | 175 | _p_k_g_-_n_a_m_e The name of the package being installed. | |
181 | 176 | |||
182 | PPRREE--IINNSSTTAALLLL Keyword denoting that the script is to perform | 177 | PPRREE--IINNSSTTAALLLL Keyword denoting that the script is to perform | |
183 | any actions needed before the package is | 178 | any actions needed before the package is | |
184 | installed. | 179 | installed. | |
185 | 180 | |||
186 | If the _i_n_s_t_a_l_l script exits with a non-zero status code, the | 181 | If the _i_n_s_t_a_l_l script exits with a non-zero status code, the | |
187 | installation is terminated. | 182 | installation is terminated. | |
188 | 183 | |||
189 | 8. The files from the file list are extracted to the chosen pre- | 184 | 8. The files from the file list are extracted to the chosen | |
190 | fix. | 185 | prefix. | |
191 | 186 | |||
192 | 9. If an _i_n_s_t_a_l_l script exists for the package, it is executed | 187 | 9. If an _i_n_s_t_a_l_l script exists for the package, it is executed | |
193 | with the following arguments: | 188 | with the following arguments: | |
194 | 189 | |||
195 | _p_k_g___n_a_m_e The name of the package being installed. | 190 | _p_k_g___n_a_m_e The name of the package being installed. | |
196 | 191 | |||
197 | PPOOSSTT--IINNSSTTAALLLL Keyword denoting that the script is to perform | 192 | PPOOSSTT--IINNSSTTAALLLL Keyword denoting that the script is to perform | |
198 | any actions needed after the package has been | 193 | any actions needed after the package has been | |
199 | installed. | 194 | installed. | |
200 | 195 | |||
201 | 10. After installation is complete, a copy of the packing list, | 196 | 10. After installation is complete, a copy of the packing list, | |
202 | _d_e_i_n_s_t_a_l_l script, description, and display files are copied | 197 | _d_e_i_n_s_t_a_l_l script, description, and display files are copied | |
203 | into _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_> for subsequent possible use by | 198 | into _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_> for subsequent possible use by | |
204 | pkg_delete(1). Any package dependencies are recorded in the | 199 | pkg_delete(1). Any package dependencies are recorded in the | |
205 | other packages' _+_R_E_Q_U_I_R_E_D___B_Y file. | 200 | other packages' _+_R_E_Q_U_I_R_E_D___B_Y file. | |
206 | 201 | |||
207 | 11. If the package is a depoted package, then add it to the regis- | 202 | 11. Finally, if we were upgrading a package, any _+_R_E_Q_U_I_R_E_D___B_Y file | |
208 | tered by calling pkg_view(1) accordingly. | |||
209 | ||||
210 | 12. Finally, if we were upgrading a package, any _+_R_E_Q_U_I_R_E_D___B_Y file | |||
211 | that was moved aside before upgrading was started is now moved | 203 | that was moved aside before upgrading was started is now moved | |
212 | back into place. | 204 | back into place. | |
213 | 205 | |||
214 | The _i_n_s_t_a_l_l script is called with the environment variable PKG_PREFIX set | 206 | The _i_n_s_t_a_l_l script is called with the environment variable PKG_PREFIX set | |
215 | to the installation prefix (see the --pp option above). This allows a | 207 | to the installation prefix (see the --pp option above). This allows a | |
216 | package author to write a script that reliably performs some action on | 208 | package author to write a script that reliably performs some action on | |
217 | the directory where the package is installed, even if the user might | 209 | the directory where the package is installed, even if the user might | |
218 | change it with the --pp flag to ppkkgg__aadddd. The scripts are also called with | 210 | change it with the --pp flag to ppkkgg__aadddd. The scripts are also called with | |
219 | the PKG_METADATA_DIR environment variable set to the location of the _+_* | 211 | the PKG_METADATA_DIR environment variable set to the location of the _+_* | |
220 | meta-data files, and with the PKG_REFCOUNT_DBDIR environment variable set | 212 | meta-data files, and with the PKG_REFCOUNT_DBDIR environment variable set | |
221 | to the location of the package reference counts database directory. If | 213 | to the location of the package reference counts database directory. If | |
222 | the --PP flag was given to ppkkgg__aadddd, PKG_DESTDIR will be set to _d_e_s_t_d_i_r. | 214 | the --PP flag was given to ppkkgg__aadddd, PKG_DESTDIR will be set to _d_e_s_t_d_i_r. | |
223 | Additionally, PKG_METADATA_DIR and PKG_REFCOUNT_DBDIR are prefixed with | 215 | Additionally, PKG_METADATA_DIR and PKG_REFCOUNT_DBDIR are prefixed with | |
224 | _d_e_s_t_d_i_r. | 216 | _d_e_s_t_d_i_r. | |
225 | 217 | |||
226 | EENNVVIIRROONNMMEENNTT | 218 | EENNVVIIRROONNMMEENNTT | |
227 | See pkg_install.conf(5) for options, that can also be specified using the | 219 | See pkg_install.conf(5) for options, that can also be specified using the | |
228 | environment. Packages using views are also affected by the environment | 220 | environment. | |
229 | variables documented for pkg_view(1). | |||
230 | 221 | |||
231 | EEXXAAMMPPLLEESS | 222 | EEXXAAMMPPLLEESS | |
232 | In all cases, ppkkgg__aadddd will try to install binary packages listed in | 223 | In all cases, ppkkgg__aadddd will try to install binary packages listed in | |
233 | dependencies list. | 224 | dependencies list. | |
234 | 225 | |||
235 | You can specify a compiled binary package explicitly on the command line. | 226 | You can specify a compiled binary package explicitly on the command line. | |
236 | 227 | |||
237 | # pkg_add /usr/pkgsrc/packages/All/tcsh-6.14.00.tgz | 228 | # pkg_add /usr/pkgsrc/packages/All/tcsh-6.14.00.tgz | |
238 | 229 | |||
239 | If you omit the version number, ppkkgg__aadddd will install the latest version | 230 | If you omit the version number, ppkkgg__aadddd will install the latest version | |
240 | available. With --vv, ppkkgg__aadddd emits more messages to terminal. | 231 | available. With --vv, ppkkgg__aadddd emits more messages to terminal. | |
241 | 232 | |||
242 | # pkg_add -v /usr/pkgsrc/packages/All/unzip | 233 | # pkg_add -v /usr/pkgsrc/packages/All/unzip | |
@@ -261,14 +252,14 @@ AAUUTTHHOORRSS | @@ -261,14 +252,14 @@ AAUUTTHHOORRSS | |||
261 | NetBSD refinements. | 252 | NetBSD refinements. | |
262 | Hubert Feyrer | 253 | Hubert Feyrer | |
263 | NetBSD wildcard dependency processing, pkgdb, upgrading, etc. | 254 | NetBSD wildcard dependency processing, pkgdb, upgrading, etc. | |
264 | Thomas Klausner | 255 | Thomas Klausner | |
265 | HTTP support. | 256 | HTTP support. | |
266 | Joerg Sonnenberger | 257 | Joerg Sonnenberger | |
267 | Rewrote most of the code base to work without external commands. | 258 | Rewrote most of the code base to work without external commands. | |
268 | 259 | |||
269 | BBUUGGSS | 260 | BBUUGGSS | |
270 | Package upgrading needs a lot more work to be really universal. | 261 | Package upgrading needs a lot more work to be really universal. | |
271 | 262 | |||
272 | Sure to be others. | 263 | Sure to be others. | |
273 | 264 | |||
274 | NetBSD 5.0 June 16, 2010 NetBSD 5.0 | 265 | pkgsrc December 27, 2014 pkgsrc |
@@ -1,14 +1,14 @@ | @@ -1,14 +1,14 @@ | |||
1 | PKG_ADMIN(1) NetBSD General Commands Manual PKG_ADMIN(1) | 1 | PKG_ADMIN(1) General Commands Manual PKG_ADMIN(1) | |
2 | 2 | |||
3 | NNAAMMEE | 3 | NNAAMMEE | |
4 | ppkkgg__aaddmmiinn -- perform various administrative tasks to the pkg system | 4 | ppkkgg__aaddmmiinn -- perform various administrative tasks to the pkg system | |
5 | 5 | |||
6 | SSYYNNOOPPSSIISS | 6 | SSYYNNOOPPSSIISS | |
7 | ppkkgg__aaddmmiinn [--bbqqSSVVvv] [--CC _c_o_n_f_i_g] [--dd _l_s_d_i_r] [--KK _p_k_g___d_b_d_i_r] [--ss _s_f_x___p_a_t_t_e_r_n] | 7 | ppkkgg__aaddmmiinn [--bbqqSSVVvv] [--CC _c_o_n_f_i_g] [--dd _l_s_d_i_r] [--KK _p_k_g___d_b_d_i_r] [--ss _s_f_x___p_a_t_t_e_r_n] | |
8 | _c_o_m_m_a_n_d [args ...] | 8 | _c_o_m_m_a_n_d [args ...] | |
9 | 9 | |||
10 | DDEESSCCRRIIPPTTIIOONN | 10 | DDEESSCCRRIIPPTTIIOONN | |
11 | This command performs various administrative tasks around the NetBSD | 11 | This command performs various administrative tasks around the NetBSD | |
12 | Packages System. | 12 | Packages System. | |
13 | 13 | |||
14 | OOPPTTIIOONNSS | 14 | OOPPTTIIOONNSS | |
@@ -37,147 +37,137 @@ OOPPTTIIOONNSS | @@ -37,147 +37,137 @@ OOPPTTIIOONNSS | |||
37 | package names for llssaallll and llssbbeesstt to be the null suffix. | 37 | package names for llssaallll and llssbbeesstt to be the null suffix. | |
38 | 38 | |||
39 | --ss _s_f_x___p_a_t_t_e_r_n | 39 | --ss _s_f_x___p_a_t_t_e_r_n | |
40 | Set the shell glob pattern for package suffixes when matching | 40 | Set the shell glob pattern for package suffixes when matching | |
41 | package names for llssaallll and llssbbeesstt. The default pattern is | 41 | package names for llssaallll and llssbbeesstt. The default pattern is | |
42 | ".t[bg]z". | 42 | ".t[bg]z". | |
43 | 43 | |||
44 | --VV Print version number and exit. | 44 | --VV Print version number and exit. | |
45 | 45 | |||
46 | --vv Be more verbose. | 46 | --vv Be more verbose. | |
47 | 47 | |||
48 | The following commands are supported: | 48 | The following commands are supported: | |
49 | 49 | |||
50 | aadddd _p_k_g _._._. | |||
51 | For each listed package, write the absolute pathnames of the | |||
52 | files listed in its _+_C_O_N_T_E_N_T_S file together with the package they | |||
53 | belong to into the package database. This should be used only by | |||
54 | pkg_view(1). | |||
55 | ||||
56 | aauuddiitt [--eess] [--tt _t_y_p_e] [_p_k_g] ... | 50 | aauuddiitt [--eess] [--tt _t_y_p_e] [_p_k_g] ... | |
57 | Check the listed installed packages for vulnerabilities. If no | 51 | Check the listed installed packages for vulnerabilities. If no | |
58 | package is given, check all installed packages. If --ee is given, | 52 | package is given, check all installed packages. If --ee is given, | |
59 | override the CHECK_END_OF_LIFE option from pkg_install.conf(5) | 53 | override the CHECK_END_OF_LIFE option from pkg_install.conf(5) | |
60 | with "yes". If --ss is given, check the signature of the pkg-vul- | 54 | with "yes". If --ss is given, check the signature of the pkg- | |
61 | nerabilities file before using it. --tt restricts the reported | 55 | vulnerabilities file before using it. --tt restricts the reported | |
62 | vulnerabilities to type _t_y_p_e. | 56 | vulnerabilities to type _t_y_p_e. | |
63 | 57 | |||
64 | aauuddiitt--ppkkgg [--eess] [--tt _t_y_p_e] [_p_k_g] ... | 58 | aauuddiitt--ppkkgg [--eess] [--tt _t_y_p_e] [_p_k_g] ... | |
65 | Like aauuddiitt, but check only the given package names or patterns. | 59 | Like aauuddiitt, but check only the given package names or patterns. | |
66 | 60 | |||
67 | aauuddiitt--bbaattcchh [--eess] [--tt _t_y_p_e] [_p_k_g_-_l_i_s_t] ... | 61 | aauuddiitt--bbaattcchh [--eess] [--tt _t_y_p_e] [_p_k_g_-_l_i_s_t] ... | |
68 | Like aauuddiitt--ppkkgg, but read the package names or patterns one per | 62 | Like aauuddiitt--ppkkgg, but read the package names or patterns one per | |
69 | line from the given files. | 63 | line from the given files. | |
70 | 64 | |||
71 | aauuddiitt--hhiissttoorryy [--ss] [--tt _t_y_p_e] [_p_k_g_b_a_s_e] ... | 65 | aauuddiitt--hhiissttoorryy [--ss] [--tt _t_y_p_e] [_p_k_g_b_a_s_e] ... | |
72 | Print all vulnerabilities for the given base package names. | 66 | Print all vulnerabilities for the given base package names. | |
73 | 67 | |||
74 | cchheecckk [_p_k_g _._._.] | 68 | cchheecckk [_p_k_g _._._.] | |
75 | Use this command to check the files belonging to some or all of | 69 | Use this command to check the files belonging to some or all of | |
76 | the packages installed on the local machine against the checksum | 70 | the packages installed on the local machine against the checksum | |
77 | which was recorded in the _+_C_O_N_T_E_N_T_S files at package installation | 71 | which was recorded in the _+_C_O_N_T_E_N_T_S files at package installation | |
78 | time. Symbolic links also have their integrity checked against | 72 | time. Symbolic links also have their integrity checked against | |
79 | the recorded value at package installation time. If no addi- | 73 | the recorded value at package installation time. If no | |
80 | tional argument is given, the files of all installed packages are | 74 | additional argument is given, the files of all installed packages | |
81 | checked, else only the named packages will be checked (wildcards | 75 | are checked, else only the named packages will be checked | |
82 | can be used here, see pkg_info(1)). | 76 | (wildcards can be used here, see pkg_info(1)). | |
83 | 77 | |||
84 | The packages' _+_C_O_N_T_E_N_T_S files will be parsed and the checksum | 78 | The packages' _+_C_O_N_T_E_N_T_S files will be parsed and the checksum | |
85 | will be checked for every file found. A warning message is | 79 | will be checked for every file found. A warning message is | |
86 | printed if the expected checksum differs from the checksum of the | 80 | printed if the expected checksum differs from the checksum of the | |
87 | file on disk. Symbolic links are also checked, ensuring that the | 81 | file on disk. Symbolic links are also checked, ensuring that the | |
88 | targets on disk are the same as the contents recorded at package | 82 | targets on disk are the same as the contents recorded at package | |
89 | installation time. | 83 | installation time. | |
90 | 84 | |||
91 | cchheecckk--lliicceennssee _c_o_n_d_i_t_i_o_n | 85 | cchheecckk--lliicceennssee _c_o_n_d_i_t_i_o_n | |
92 | Check if _c_o_n_d_i_t_i_o_n can be fulfilled with the currently set of | 86 | Check if _c_o_n_d_i_t_i_o_n can be fulfilled with the currently set of | |
93 | accepted licenses. Prints either yes or no to stdout if the con- | 87 | accepted licenses. Prints either yes or no to stdout if the | |
94 | dition can be parsed, otherwise it exits with error. | 88 | condition can be parsed, otherwise it exits with error. | |
95 | 89 | |||
96 | cchheecckk--ppkkgg--vvuullnneerraabbiilliittiieess [--ss] _f_i_l_e | 90 | cchheecckk--ppkkgg--vvuullnneerraabbiilliittiieess [--ss] _f_i_l_e | |
97 | Check format and hashes in the pkg-vulnerabilities file _f_i_l_e. If | 91 | Check format and hashes in the pkg-vulnerabilities file _f_i_l_e. If | |
98 | --ss is given, also check the embedded signature. | 92 | --ss is given, also check the embedded signature. | |
99 | 93 | |||
100 | cchheecckk--ssiiggnnaattuurree _f_i_l_e _._._. | 94 | cchheecckk--ssiiggnnaattuurree _f_i_l_e _._._. | |
101 | Reports if _f_i_l_e is a correctly signed package. | 95 | Reports if _f_i_l_e is a correctly signed package. | |
102 | 96 | |||
103 | cchheecckk--ssiinnggllee--lliicceennssee _l_i_c_e_n_s_e | 97 | cchheecckk--ssiinnggllee--lliicceennssee _l_i_c_e_n_s_e | |
104 | Check if _l_i_c_e_n_s_e is a valid license name and if it is in the set | 98 | Check if _l_i_c_e_n_s_e is a valid license name and if it is in the set | |
105 | of acceptable licenses. Prints either yes or no to stdout if the | 99 | of acceptable licenses. Prints either yes or no to stdout if the | |
106 | condition can be parsed, otherwise it exits with error. | 100 | condition can be parsed, otherwise it exits with error. | |
107 | 101 | |||
108 | ccoonnffiigg--vvaarr _v_a_r_i_a_b_l_e | 102 | ccoonnffiigg--vvaarr _v_a_r_i_a_b_l_e | |
109 | Print the current value of _v_a_r_i_a_b_l_e as used after parsing the | 103 | Print the current value of _v_a_r_i_a_b_l_e as used after parsing the | |
110 | configuration file. | 104 | configuration file. | |
111 | 105 | |||
112 | ddeelleettee _p_k_g _._._. | |||
113 | For each listed package, remove all file entries in the package | |||
114 | database that belong to the package. This should be used only by | |||
115 | pkg_view(1). | |||
116 | ||||
117 | dduummpp Dump the contents of the package database, similar to ppkkgg__iinnffoo | 106 | dduummpp Dump the contents of the package database, similar to ppkkgg__iinnffoo | |
118 | --FF. Columns are printed for the key field used in the pkgdb - | 107 | --FF. Columns are printed for the key field used in the pkgdb - | |
119 | the filename -, and the data field - the package the file belongs | 108 | the filename -, and the data field - the package the file belongs | |
120 | to. | 109 | to. | |
121 | 110 | |||
122 | ffeettcchh--ppkkgg--vvuullnneerraabbiilliittiieess [--ssuu] | 111 | ffeettcchh--ppkkgg--vvuullnneerraabbiilliittiieess [--ssuu] | |
123 | Fetch a new pkg-vulnerabilities file, check the format and if --ss | 112 | Fetch a new pkg-vulnerabilities file, check the format and if --ss | |
124 | is given the signature. If all checks are passed, write it to | 113 | is given the signature. If all checks are passed, write it to | |
125 | pkgdb. If --uu is given, the fetch is conditional and the file | 114 | pkgdb. If --uu is given, the fetch is conditional and the file | |
126 | transfer is only done if the remote version is newer than the one | 115 | transfer is only done if the remote version is newer than the one | |
127 | in pkgdb. | 116 | in pkgdb. | |
128 | 117 | |||
129 | ffiinnddbbeesstt _p_a_t_t_e_r_n _._._. | 118 | ffiinnddbbeesstt _p_a_t_t_e_r_n _._._. | |
130 | Search the entries of PKG_PATH for packages matching _p_a_t_t_e_r_n. | 119 | Search the entries of PKG_PATH for packages matching _p_a_t_t_e_r_n. | |
131 | Print the URL of the best matching package to stdout for each | 120 | Print the URL of the best matching package to stdout for each | |
132 | pattern. If a pattern is not matched, it is skipped and the com- | 121 | pattern. If a pattern is not matched, it is skipped and the | |
133 | mand will return a failure. | 122 | command will return a failure. | |
134 | 123 | |||
135 | llssaallll _/_d_i_r_/_p_k_g_p_a_t_t_e_r_n | 124 | llssaallll _/_d_i_r_/_p_k_g_p_a_t_t_e_r_n | |
136 | 125 | |||
137 | llssbbeesstt _/_d_i_r_/_p_k_g_p_a_t_t_e_r_n | 126 | llssbbeesstt _/_d_i_r_/_p_k_g_p_a_t_t_e_r_n | |
138 | List all/best package matching pattern in the given directory | 127 | List all/best package matching pattern in the given directory | |
139 | _/_d_i_r. If the --dd flag is given, then that directory path over- | 128 | _/_d_i_r. If the --dd flag is given, then that directory path | |
140 | rides _/_d_i_r. Can be used to work around limitations of /bin/sh | 129 | overrides _/_d_i_r. Can be used to work around limitations of | |
141 | and other filename globbing mechanisms. This option implements | 130 | /bin/sh and other filename globbing mechanisms. This option | |
142 | matching of pkg-wildcards against arbitrary files and directo- | 131 | implements matching of pkg-wildcards against arbitrary files and | |
143 | ries, useful mainly in the build system itself. See pkg_info(1) | 132 | directories, useful mainly in the build system itself. See | |
144 | for a description of the pattern. | 133 | pkg_info(1) for a description of the pattern. | |
145 | 134 | |||
146 | Example: | 135 | Example: | |
147 | 136 | |||
148 | yui# cd /usr/pkgsrc/packages/i386ELF/All/ | 137 | yui# cd /usr/pkgsrc/packages/i386ELF/All/ | |
149 | yui# ls unzip* | 138 | yui# ls unzip* | |
150 | unzip-5.40.tgz unzip-5.41.tgz | 139 | unzip-5.40.tgz unzip-5.41.tgz | |
151 | yui# pkg_admin lsall 'unzip*' | 140 | yui# pkg_admin lsall 'unzip*' | |
152 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.40.tgz | 141 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.40.tgz | |
153 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | 142 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | |
154 | yui# pkg_admin lsall 'unzip>=5.40' | 143 | yui# pkg_admin lsall 'unzip>=5.40' | |
155 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.40.tgz | 144 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.40.tgz | |
156 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | 145 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | |
157 | yui# pkg_admin lsall 'unzip>=5.41' | 146 | yui# pkg_admin lsall 'unzip>=5.41' | |
158 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | 147 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | |
159 | yui# pkg_admin lsbest 'unzip>=5.40' | 148 | yui# pkg_admin lsbest 'unzip>=5.40' | |
160 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | 149 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | |
161 | yui# pkg_admin lsall /usr/pkgsrc/packages/i386ELF/All/'{mit,unproven}-pthread*' | 150 | yui# pkg_admin lsall /usr/pkgsrc/packages/i386ELF/All/'{mit,unproven}-pthread*' | |
162 | /usr/pkgsrc/packages/i386ELF/All/mit-pthreads-1.60b6.tgz | 151 | /usr/pkgsrc/packages/i386ELF/All/mit-pthreads-1.60b6.tgz | |
163 | /usr/pkgsrc/packages/i386ELF/All/unproven-pthreads-0.15.tgz | 152 | /usr/pkgsrc/packages/i386ELF/All/unproven-pthreads-0.15.tgz | |
164 | 153 | |||
165 | ppmmaattcchh _p_a_t_t_e_r_n _p_k_g | 154 | ppmmaattcchh _p_a_t_t_e_r_n _p_k_g | |
166 | Returns true if _p_k_g matches _p_a_t_t_e_r_n, otherwise returns false. | 155 | Returns true if _p_k_g matches _p_a_t_t_e_r_n, otherwise returns false. | |
167 | 156 | |||
168 | rreebbuuiilldd | 157 | rreebbuuiilldd | |
169 | Rebuild the package database mapping from scratch. This option | 158 | Rebuild the package database mapping from scratch, using the | |
170 | is only intended for recovery after system crashes during package | 159 | _+_C_O_N_T_E_N_T_S files of the installed packages. This option is only | |
160 | intended for recovery after system crashes during package | |||
171 | installation and removal. | 161 | installation and removal. | |
172 | 162 | |||
173 | rreebbuuiilldd--ttrreeee | 163 | rreebbuuiilldd--ttrreeee | |
174 | Rebuild the +REQUIRED_BY files from scratch by reresolving all | 164 | Rebuild the +REQUIRED_BY files from scratch by reresolving all | |
175 | dependencies. | 165 | dependencies. | |
176 | 166 | |||
177 | This option is intended to be used for fixing inconsistencies | 167 | This option is intended to be used for fixing inconsistencies | |
178 | between the records of depending and depended-on packages, such | 168 | between the records of depending and depended-on packages, such | |
179 | as can arise by the use of ppkkgg__ddeelleettee --ff. | 169 | as can arise by the use of ppkkgg__ddeelleettee --ff. | |
180 | 170 | |||
181 | sseett _v_a_r_i_a_b_l_e_=_v_a_l_u_e _p_k_g _._._. | 171 | sseett _v_a_r_i_a_b_l_e_=_v_a_l_u_e _p_k_g _._._. | |
182 | Set variable with information about the installed package. Use | 172 | Set variable with information about the installed package. Use | |
183 | uunnsseett to remove a variable. | 173 | uunnsseett to remove a variable. | |
@@ -191,27 +181,27 @@ OOPPTTIIOONNSS | @@ -191,27 +181,27 @@ OOPPTTIIOONNSS | |||
191 | 181 | |||
192 | xx550099--ssiiggnn--ppaacckkaaggee ppkkgg ssppkkgg kkeeyy cceerrtt | 182 | xx550099--ssiiggnn--ppaacckkaaggee ppkkgg ssppkkgg kkeeyy cceerrtt | |
193 | Sign the binary package _p_k_g using the key _k_e_y and the certificate | 183 | Sign the binary package _p_k_g using the key _k_e_y and the certificate | |
194 | _c_e_r_t, using _s_p_k_g as output file. | 184 | _c_e_r_t, using _s_p_k_g as output file. | |
195 | 185 | |||
196 | uunnsseett _v_a_r_i_a_b_l_e _p_k_g _._._. | 186 | uunnsseett _v_a_r_i_a_b_l_e _p_k_g _._._. | |
197 | Remove an installation variable. | 187 | Remove an installation variable. | |
198 | 188 | |||
199 | EENNVVIIRROONNMMEENNTT | 189 | EENNVVIIRROONNMMEENNTT | |
200 | See pkg_install.conf(5) for options, that can also be specified using the | 190 | See pkg_install.conf(5) for options, that can also be specified using the | |
201 | environment. | 191 | environment. | |
202 | 192 | |||
203 | FFIILLEESS | 193 | FFIILLEESS | |
204 | /var/db/pkg/pkgdb.byfile.db | 194 | _/_v_a_r_/_d_b_/_p_k_g_/_p_k_g_d_b_._b_y_f_i_l_e_._d_b | |
205 | /var/db/pkg/<pkg>/+CONTENTS | 195 | _/_v_a_r_/_d_b_/_p_k_g_/_<_p_k_g_>_/_+_C_O_N_T_E_N_T_S | |
206 | 196 | |||
207 | SSEEEE AALLSSOO | 197 | SSEEEE AALLSSOO | |
208 | pkg_add(1), pkg_create(1), pkg_delete(1), pkg_info(1), pkg_view(1), | 198 | pkg_add(1), pkg_create(1), pkg_delete(1), pkg_info(1), | |
209 | pkg_install.conf(5), pkgsrc(7) | 199 | pkg_install.conf(5), pkgsrc(7) | |
210 | 200 | |||
211 | HHIISSTTOORRYY | 201 | HHIISSTTOORRYY | |
212 | The ppkkgg__aaddmmiinn command first appeared in NetBSD 1.4. | 202 | The ppkkgg__aaddmmiinn command first appeared in NetBSD 1.4. | |
213 | 203 | |||
214 | AAUUTTHHOORRSS | 204 | AAUUTTHHOORRSS | |
215 | The ppkkgg__aaddmmiinn command was written by Hubert Feyrer. | 205 | The ppkkgg__aaddmmiinn command was written by Hubert Feyrer. | |
216 | 206 | |||
217 | NetBSD 5.0 January 22, 2010 NetBSD 5.0 | 207 | pkgsrc December 27, 2014 pkgsrc |
@@ -1,76 +1,74 @@ | @@ -1,76 +1,74 @@ | |||
1 | PKG_CREATE(1) NetBSD General Commands Manual PKG_CREATE(1) | 1 | PKG_CREATE(1) General Commands Manual PKG_CREATE(1) | |
2 | 2 | |||
3 | NNAAMMEE | 3 | NNAAMMEE | |
4 | ppkkgg__ccrreeaattee -- a utility for creating software package distributions | 4 | ppkkgg__ccrreeaattee -- a utility for creating software package distributions | |
5 | 5 | |||
6 | SSYYNNOOPPSSIISS | 6 | SSYYNNOOPPSSIISS | |
7 | ppkkgg__ccrreeaattee [--EEllOOUUVVvv] [--BB _b_u_i_l_d_-_i_n_f_o_-_f_i_l_e] [--bb _b_u_i_l_d_-_v_e_r_s_i_o_n_-_f_i_l_e] | 7 | ppkkgg__ccrreeaattee [--llOOUUVVvv] [--BB _b_u_i_l_d_-_i_n_f_o_-_f_i_l_e] [--bb _b_u_i_l_d_-_v_e_r_s_i_o_n_-_f_i_l_e] | |
8 | [--CC _c_p_k_g_s] [--DD _d_i_s_p_l_a_y_f_i_l_e] [--FF _c_o_m_p_r_e_s_s_i_o_n] [--gg _g_r_o_u_p] | 8 | [--CC _c_p_k_g_s] [--DD _d_i_s_p_l_a_y_f_i_l_e] [--FF _c_o_m_p_r_e_s_s_i_o_n] [--gg _g_r_o_u_p] | |
9 | [--II _r_e_a_l_p_r_e_f_i_x] [--ii _i_s_c_r_i_p_t] [--KK _p_k_g___d_b_d_i_r] [--kk _d_s_c_r_i_p_t] | 9 | [--II _r_e_a_l_p_r_e_f_i_x] [--ii _i_s_c_r_i_p_t] [--KK _p_k_g___d_b_d_i_r] [--kk _d_s_c_r_i_p_t] | |
10 | [--nn _p_r_e_s_e_r_v_e_-_f_i_l_e] [--PP _d_p_k_g_s] [--TT _b_u_i_l_d_p_k_g_s] [--pp _p_r_e_f_i_x] | 10 | [--nn _p_r_e_s_e_r_v_e_-_f_i_l_e] [--PP _d_p_k_g_s] [--pp _p_r_e_f_i_x] [--SS _s_i_z_e_-_a_l_l_-_f_i_l_e] | |
11 | [--SS _s_i_z_e_-_a_l_l_-_f_i_l_e] [--ss _s_i_z_e_-_p_k_g_-_f_i_l_e] [--tt _t_e_m_p_l_a_t_e] [--uu _o_w_n_e_r] | 11 | [--ss _s_i_z_e_-_p_k_g_-_f_i_l_e] [--TT _b_u_i_l_d_p_k_g_s] [--tt _t_e_m_p_l_a_t_e] [--uu _o_w_n_e_r] | |
12 | --cc _c_o_m_m_e_n_t --dd _d_e_s_c_r_i_p_t_i_o_n --ff _p_a_c_k_l_i_s_t _p_k_g_-_n_a_m_e | 12 | --cc _c_o_m_m_e_n_t --dd _d_e_s_c_r_i_p_t_i_o_n --ff _p_a_c_k_l_i_s_t _p_k_g_-_n_a_m_e | |
13 | 13 | |||
14 | DDEESSCCRRIIPPTTIIOONN | 14 | DDEESSCCRRIIPPTTIIOONN | |
15 | The ppkkgg__ccrreeaattee command is used to create packages that will subsequently | 15 | The ppkkgg__ccrreeaattee command is used to create packages that will subsequently | |
16 | be fed to one of the package extraction/info utilities. The input | 16 | be fed to one of the package extraction/info utilities. The input | |
17 | description and command line arguments for the creation of a package are | 17 | description and command line arguments for the creation of a package are | |
18 | not really meant to be human-generated, though it is easy enough to do | 18 | not really meant to be human-generated, though it is easy enough to do | |
19 | so. It is more expected that you will use a front-end tool for the job | 19 | so. It is more expected that you will use a front-end tool for the job | |
20 | rather than muddling through it yourself. Nonetheless, a short descrip- | 20 | rather than muddling through it yourself. Nonetheless, a short | |
21 | tion of the input syntax is included in this document. | 21 | description of the input syntax is included in this document. | |
22 | 22 | |||
23 | OOPPTTIIOONNSS | 23 | OOPPTTIIOONNSS | |
24 | The following command line options are supported: | 24 | The following command line options are supported: | |
25 | 25 | |||
26 | --BB _b_u_i_l_d_-_i_n_f_o_-_f_i_l_e | 26 | --BB _b_u_i_l_d_-_i_n_f_o_-_f_i_l_e | |
27 | Install the file _b_u_i_l_d_-_i_n_f_o_-_f_i_l_e so that users of binary packages | 27 | Install the file _b_u_i_l_d_-_i_n_f_o_-_f_i_l_e so that users of binary packages | |
28 | can see what make(1) definitions were used to control the build | 28 | can see what make(1) definitions were used to control the build | |
29 | when creating the binary package. This allows various build def- | 29 | when creating the binary package. This allows various build | |
30 | initions to be retained in a binary package and viewed wherever | 30 | definitions to be retained in a binary package and viewed | |
31 | it is installed, using pkg_info(1). | 31 | wherever it is installed, using pkg_info(1). | |
32 | 32 | |||
33 | --bb _b_u_i_l_d_-_v_e_r_s_i_o_n_-_f_i_l_e | 33 | --bb _b_u_i_l_d_-_v_e_r_s_i_o_n_-_f_i_l_e | |
34 | Install the file _b_u_i_l_d_-_v_e_r_s_i_o_n_-_f_i_l_e so that users of binary pack- | 34 | Install the file _b_u_i_l_d_-_v_e_r_s_i_o_n_-_f_i_l_e so that users of binary | |
35 | ages can see what versions of the files used to control the build | 35 | packages can see what versions of the files used to control the | |
36 | were used when creating the binary package. This allows some | 36 | build were used when creating the binary package. This allows | |
37 | fine-grained version control information to be retained in a | 37 | some fine-grained version control information to be retained in a | |
38 | binary package and viewed wherever it is installed, using | 38 | binary package and viewed wherever it is installed, using | |
39 | pkg_info(1). | 39 | pkg_info(1). | |
40 | 40 | |||
41 | --CC _c_p_k_g_s | 41 | --CC _c_p_k_g_s | |
42 | Set the initial package conflict list to _c_p_k_g_s. This is assumed | 42 | Set the initial package conflict list to _c_p_k_g_s. This is assumed | |
43 | to be a whitespace separated list of package names and is meant | 43 | to be a whitespace separated list of package names and is meant | |
44 | as a convenient shorthand for specifying multiple @@ppkkggccffll direc- | 44 | as a convenient shorthand for specifying multiple @@ppkkggccffll | |
45 | tives in the packing list (see PACKING LIST DETAILS section | 45 | directives in the packing list (see PACKING LIST DETAILS section | |
46 | below). | 46 | below). | |
47 | 47 | |||
48 | --cc _[_-_]_d_e_s_c | 48 | --cc _[_-_]_d_e_s_c | |
49 | Fetch package (one line description) from file _d_e_s_c or, if pre- | 49 | Fetch package (one line description) from file _d_e_s_c or, if | |
50 | ceded by --, the argument itself. This string should also give | 50 | preceded by --, the argument itself. This string should also give | |
51 | some idea of which version of the product (if any) the package | 51 | some idea of which version of the product (if any) the package | |
52 | represents. | 52 | represents. | |
53 | 53 | |||
54 | --DD _d_i_s_p_l_a_y_f_i_l_e | 54 | --DD _d_i_s_p_l_a_y_f_i_l_e | |
55 | Display the file after installing the package. Useful for things | 55 | Display the file after installing the package. Useful for things | |
56 | like legal notices on almost-free software, etc. | 56 | like legal notices on almost-free software, etc. | |
57 | 57 | |||
58 | --dd _[_-_]_d_e_s_c | 58 | --dd _[_-_]_d_e_s_c | |
59 | Fetch long description for package from file _d_e_s_c or, if preceded | 59 | Fetch long description for package from file _d_e_s_c or, if preceded | |
60 | by --, the argument itself. | 60 | by --, the argument itself. | |
61 | 61 | |||
62 | --EE Add an empty views file to the package. | |||
63 | ||||
64 | --FF _c_o_m_p_r_e_s_s_i_o_n | 62 | --FF _c_o_m_p_r_e_s_s_i_o_n | |
65 | Use _c_o_m_p_r_e_s_s_i_o_n as compression algorithm. This overrides the | 63 | Use _c_o_m_p_r_e_s_s_i_o_n as compression algorithm. This overrides the | |
66 | heuristic to guess the compression type from the output name. | 64 | heuristic to guess the compression type from the output name. | |
67 | Currently supported values are bzip2, gzip, none and xz. | 65 | Currently supported values are bzip2, gzip, none and xz. | |
68 | 66 | |||
69 | --ff _p_a_c_k_l_i_s_t | 67 | --ff _p_a_c_k_l_i_s_t | |
70 | Fetch (packing list) for package from the file _p_a_c_k_l_i_s_t or ssttddiinn | 68 | Fetch (packing list) for package from the file _p_a_c_k_l_i_s_t or ssttddiinn | |
71 | if _p_a_c_k_l_i_s_t is a -- (dash). | 69 | if _p_a_c_k_l_i_s_t is a -- (dash). | |
72 | 70 | |||
73 | --gg _g_r_o_u_p | 71 | --gg _g_r_o_u_p | |
74 | Make _g_r_o_u_p the default group ownership instead of extracting it | 72 | Make _g_r_o_u_p the default group ownership instead of extracting it | |
75 | from the file system. | 73 | from the file system. | |
76 | 74 | |||
@@ -83,28 +81,28 @@ OOPPTTIIOONNSS | @@ -83,28 +81,28 @@ OOPPTTIIOONNSS | |||
83 | can be any executable program (or shell script). It will be | 81 | can be any executable program (or shell script). It will be | |
84 | invoked automatically when the package is later installed. | 82 | invoked automatically when the package is later installed. | |
85 | 83 | |||
86 | --KK _p_k_g___d_b_d_i_r | 84 | --KK _p_k_g___d_b_d_i_r | |
87 | Override the value of the PKG_DBDIR configuration option with the | 85 | Override the value of the PKG_DBDIR configuration option with the | |
88 | value _p_k_g___d_b_d_i_r. | 86 | value _p_k_g___d_b_d_i_r. | |
89 | 87 | |||
90 | --kk _d_s_c_r_i_p_t | 88 | --kk _d_s_c_r_i_p_t | |
91 | Set _d_s_c_r_i_p_t to be the de-install procedure for the package. This | 89 | Set _d_s_c_r_i_p_t to be the de-install procedure for the package. This | |
92 | can be any executable program (or shell script). It will be | 90 | can be any executable program (or shell script). It will be | |
93 | invoked automatically when the package is later (if ever) de- | 91 | invoked automatically when the package is later (if ever) de- | |
94 | installed. | 92 | installed. | |
95 | 93 | |||
96 | --ll Check that any symbolic links which are to be placed in the pack- | 94 | --ll Check that any symbolic links which are to be placed in the | |
97 | age are relative to the current prefix. This means using | 95 | package are relative to the current prefix. This means using | |
98 | unlink(2) and symlink(2) to remove and re-link any symbolic links | 96 | unlink(2) and symlink(2) to remove and re-link any symbolic links | |
99 | which are targeted at full path names. | 97 | which are targeted at full path names. | |
100 | 98 | |||
101 | --nn _p_r_e_s_e_r_v_e_-_f_i_l_e | 99 | --nn _p_r_e_s_e_r_v_e_-_f_i_l_e | |
102 | The file is used to denote that the package should not be | 100 | The file is used to denote that the package should not be | |
103 | deleted. This is intended for use where the deletion of packages | 101 | deleted. This is intended for use where the deletion of packages | |
104 | may present a bootstrap problem. | 102 | may present a bootstrap problem. | |
105 | 103 | |||
106 | --OO Go into a (packing list only) mode. This is used to do (fake | 104 | --OO Go into a (packing list only) mode. This is used to do (fake | |
107 | pkg_add) operations when a package is installed. In such cases, | 105 | pkg_add) operations when a package is installed. In such cases, | |
108 | it is necessary to know what the final, adjusted packing list | 106 | it is necessary to know what the final, adjusted packing list | |
109 | will look like. | 107 | will look like. | |
110 | 108 | |||
@@ -127,158 +125,158 @@ OOPPTTIIOONNSS | @@ -127,158 +125,158 @@ OOPPTTIIOONNSS | |||
127 | --pp _p_r_e_f_i_x | 125 | --pp _p_r_e_f_i_x | |
128 | Set _p_r_e_f_i_x as the initial directory (base) to start from in | 126 | Set _p_r_e_f_i_x as the initial directory (base) to start from in | |
129 | selecting files for the package. | 127 | selecting files for the package. | |
130 | 128 | |||
131 | --SS _s_i_z_e_-_a_l_l_-_f_i_l_e | 129 | --SS _s_i_z_e_-_a_l_l_-_f_i_l_e | |
132 | Store the given file for later querying with the pkg_info(1) --SS | 130 | Store the given file for later querying with the pkg_info(1) --SS | |
133 | flag. The file is expected to contain the size (in bytes) of all | 131 | flag. The file is expected to contain the size (in bytes) of all | |
134 | files of this package plus any required packages added up and | 132 | files of this package plus any required packages added up and | |
135 | stored as a ASCII string, terminated by a newline. | 133 | stored as a ASCII string, terminated by a newline. | |
136 | 134 | |||
137 | --ss _s_i_z_e_-_p_k_g_-_f_i_l_e | 135 | --ss _s_i_z_e_-_p_k_g_-_f_i_l_e | |
138 | Store the given file for later querying with the pkg_info(1) --ss | 136 | Store the given file for later querying with the pkg_info(1) --ss | |
139 | flag. The file is expected to contain the size (in bytes) of all | 137 | flag. The file is expected to contain the size (in bytes) of all | |
140 | files of this package added up and stored as a ASCII string, ter- | 138 | files of this package added up and stored as a ASCII string, | |
141 | minated by a newline. | 139 | terminated by a newline. | |
142 | 140 | |||
143 | --tt _t_e_m_p_l_a_t_e | 141 | --tt _t_e_m_p_l_a_t_e | |
144 | Use _t_e_m_p_l_a_t_e as the input to mktemp(3). By default, this is the | 142 | Use _t_e_m_p_l_a_t_e as the input to mktemp(3). By default, this is the | |
145 | string _/_t_m_p_/_i_n_s_t_m_p_._X_X_X_X_X_X, but it may be necessary to override it | 143 | string _/_t_m_p_/_i_n_s_t_m_p_._X_X_X_X_X_X, but it may be necessary to override it | |
146 | in the situation where space in your _/_t_m_p directory is limited. | 144 | in the situation where space in your _/_t_m_p directory is limited. | |
147 | Be sure to leave some number of `X' characters for mktemp(3) to | 145 | Be sure to leave some number of `X' characters for mktemp(3) to | |
148 | fill in with a unique ID. | 146 | fill in with a unique ID. | |
149 | 147 | |||
150 | --UU Do not update the package file database with any file informa- | 148 | --UU Do not update the package file database with any file | |
151 | tion. | 149 | information. | |
152 | 150 | |||
153 | --uu _o_w_n_e_r | 151 | --uu _o_w_n_e_r | |
154 | Make _o_w_n_e_r the default owner instead of extracting it from the | 152 | Make _o_w_n_e_r the default owner instead of extracting it from the | |
155 | file system. | 153 | file system. | |
156 | 154 | |||
157 | --VV Print version number and exit. | 155 | --VV Print version number and exit. | |
158 | 156 | |||
159 | --vv Turn on verbose output. | 157 | --vv Turn on verbose output. | |
160 | 158 | |||
161 | PPAACCKKIINNGG LLIISSTT DDEETTAAIILLSS | 159 | PPAACCKKIINNGG LLIISSTT DDEETTAAIILLSS | |
162 | The (packing list) format (see --ff) is fairly simple, being nothing more | 160 | The (packing list) format (see --ff) is fairly simple, being nothing more | |
163 | than a single column of filenames to include in the package. However, | 161 | than a single column of filenames to include in the package. However, | |
164 | since absolute pathnames are generally a bad idea for a package that | 162 | since absolute pathnames are generally a bad idea for a package that | |
165 | could be installed potentially anywhere, there is another method of spec- | 163 | could be installed potentially anywhere, there is another method of | |
166 | ifying where things are supposed to go and, optionally, what ownership | 164 | specifying where things are supposed to go and, optionally, what | |
167 | and mode information they should be installed with. This is done by | 165 | ownership and mode information they should be installed with. This is | |
168 | embedding specialized command sequences in the packing list. Briefly | 166 | done by embedding specialized command sequences in the packing list. | |
169 | described, these sequences are: | 167 | Briefly described, these sequences are: | |
170 | @@ccwwdd _d_i_r_e_c_t_o_r_y | 168 | @@ccwwdd _d_i_r_e_c_t_o_r_y | |
171 | Set the internal directory pointer to point to _d_i_r_e_c_t_o_r_y. All | 169 | Set the internal directory pointer to point to _d_i_r_e_c_t_o_r_y. All | |
172 | subsequent filenames will be assumed relative to this directory. | 170 | subsequent filenames will be assumed relative to this directory. | |
173 | Note: @@ccdd is also an alias for this command. | 171 | Note: @@ccdd is also an alias for this command. | |
174 | @@ssrrcc _d_i_r_e_c_t_o_r_y | 172 | @@ssrrcc _d_i_r_e_c_t_o_r_y | |
175 | This command is supported for compatibility only. It was for- | 173 | This command is supported for compatibility only. It was | |
176 | merly used to override @@ccwwdd during package creation. | 174 | formerly used to override @@ccwwdd during package creation. | |
177 | @@eexxeecc _c_o_m_m_a_n_d | 175 | @@eexxeecc _c_o_m_m_a_n_d | |
178 | Execute _c_o_m_m_a_n_d as part of the unpacking process. If _c_o_m_m_a_n_d | 176 | Execute _c_o_m_m_a_n_d as part of the unpacking process. If _c_o_m_m_a_n_d | |
179 | contains any of the following sequences somewhere in it, they | 177 | contains any of the following sequences somewhere in it, they | |
180 | will be expanded inline. For the following examples, assume that | 178 | will be expanded inline. For the following examples, assume that | |
181 | @@ccwwdd is set to _/_u_s_r_/_l_o_c_a_l and the last extracted file was | 179 | @@ccwwdd is set to _/_u_s_r_/_l_o_c_a_l and the last extracted file was | |
182 | _b_i_n_/_e_m_a_c_s. | 180 | _b_i_n_/_e_m_a_c_s. | |
183 | %%FF Expands to the last filename extracted (as specified), in | 181 | %%FF Expands to the last filename extracted (as specified), in | |
184 | the example case _b_i_n_/_e_m_a_c_s | 182 | the example case _b_i_n_/_e_m_a_c_s | |
185 | %%DD Expand to the current directory prefix, as set with @@ccwwdd, | 183 | %%DD Expand to the current directory prefix, as set with @@ccwwdd, | |
186 | in the example case _/_u_s_r_/_l_o_c_a_l. | 184 | in the example case _/_u_s_r_/_l_o_c_a_l. | |
187 | %%BB Expand to the (basename) of the fully qualified filename, | 185 | %%BB Expand to the (basename) of the fully qualified filename, | |
188 | that is the current directory prefix, plus the last file- | 186 | that is the current directory prefix, plus the last | |
189 | spec, minus the trailing filename. In the example case, | 187 | filespec, minus the trailing filename. In the example | |
190 | that would be _/_u_s_r_/_l_o_c_a_l_/_b_i_n. | 188 | case, that would be _/_u_s_r_/_l_o_c_a_l_/_b_i_n. | |
191 | %%ff Expand to the (filename) part of the fully qualified | 189 | %%ff Expand to the (filename) part of the fully qualified | |
192 | name, or the converse of %%BB, being in the example case, | 190 | name, or the converse of %%BB, being in the example case, | |
193 | _e_m_a_c_s. | 191 | _e_m_a_c_s. | |
194 | @@uunneexxeecc _c_o_m_m_a_n_d | 192 | @@uunneexxeecc _c_o_m_m_a_n_d | |
195 | Execute _c_o_m_m_a_n_d as part of the deinstallation process. Expansion | 193 | Execute _c_o_m_m_a_n_d as part of the deinstallation process. Expansion | |
196 | of special %% sequences is the same as for @@eexxeecc. This command is | 194 | of special %% sequences is the same as for @@eexxeecc. This command is | |
197 | not executed during the package add, as @@eexxeecc is, but rather when | 195 | not executed during the package add, as @@eexxeecc is, but rather when | |
198 | the package is deleted. This is useful for deleting links and | 196 | the package is deleted. This is useful for deleting links and | |
199 | other ancillary files that were created as a result of adding the | 197 | other ancillary files that were created as a result of adding the | |
200 | package, but not directly known to the package's table of con- | 198 | package, but not directly known to the package's table of | |
201 | tents (and hence not automatically removable). The advantage of | 199 | contents (and hence not automatically removable). The advantage | |
202 | using @@uunneexxeecc over a deinstallation script is that you can use | 200 | of using @@uunneexxeecc over a deinstallation script is that you can use | |
203 | the (special sequence expansion) to get at files regardless of | 201 | the (special sequence expansion) to get at files regardless of | |
204 | where they've been potentially redirected (see --pp). | 202 | where they've been potentially redirected (see --pp). | |
205 | @@mmooddee _m_o_d_e | 203 | @@mmooddee _m_o_d_e | |
206 | Set default permission for all subsequently extracted files to | 204 | Set default permission for all subsequently extracted files to | |
207 | _m_o_d_e. Format is the same as that used by the cchhmmoodd command | 205 | _m_o_d_e. Format is the same as that used by the cchhmmoodd command | |
208 | (well, considering that it's later handed off to it, that's no | 206 | (well, considering that it's later handed off to it, that's no | |
209 | surprise). Use without an arg to set back to default (extrac- | 207 | surprise). Use without an arg to set back to default | |
210 | tion) permissions. | 208 | (extraction) permissions. | |
211 | @@ooppttiioonn _o_p_t_i_o_n | 209 | @@ooppttiioonn _o_p_t_i_o_n | |
212 | Set internal package options, the only currently supported one | 210 | Set internal package options, the only currently supported one | |
213 | being _p_r_e_s_e_r_v_e, which tells pkg_add to move any existing files | 211 | being _p_r_e_s_e_r_v_e, which tells pkg_add to move any existing files | |
214 | out of the way, preserving the previous contents (which are also | 212 | out of the way, preserving the previous contents (which are also | |
215 | resurrected on pkg_delete, so caveat emptor). | 213 | resurrected on pkg_delete, so caveat emptor). | |
216 | @@oowwnneerr _u_s_e_r | 214 | @@oowwnneerr _u_s_e_r | |
217 | Set default ownership for all subsequently extracted files to | 215 | Set default ownership for all subsequently extracted files to | |
218 | _u_s_e_r. Use without an arg to set back to default (extraction) | 216 | _u_s_e_r. Use without an arg to set back to default (extraction) | |
219 | ownership. | 217 | ownership. | |
220 | @@ggrroouupp _g_r_o_u_p | 218 | @@ggrroouupp _g_r_o_u_p | |
221 | Set default group ownership for all subsequently extracted files | 219 | Set default group ownership for all subsequently extracted files | |
222 | to _g_r_o_u_p. Use without an arg to set back to default (extraction) | 220 | to _g_r_o_u_p. Use without an arg to set back to default (extraction) | |
223 | group ownership. | 221 | group ownership. | |
224 | @@ccoommmmeenntt _s_t_r_i_n_g | 222 | @@ccoommmmeenntt _s_t_r_i_n_g | |
225 | Embed a comment in the packing list. Useful in trying to docu- | 223 | Embed a comment in the packing list. Useful in trying to | |
226 | ment some particularly hairy sequence that may trip someone up | 224 | document some particularly hairy sequence that may trip someone | |
227 | later. | 225 | up later. | |
228 | @@iiggnnoorree | 226 | @@iiggnnoorree | |
229 | Used internally to tell extraction to ignore the next file (don't | 227 | Used internally to tell extraction to ignore the next file (don't | |
230 | copy it anywhere), as it's used for some special purpose. | 228 | copy it anywhere), as it's used for some special purpose. | |
231 | @@nnaammee _n_a_m_e | 229 | @@nnaammee _n_a_m_e | |
232 | Set the name of the package. This is mandatory and is usually | 230 | Set the name of the package. This is mandatory and is usually | |
233 | put at the top. This name is potentially different than the name | 231 | put at the top. This name is potentially different than the name | |
234 | of the file it came in, and is used when keeping track of the | 232 | of the file it came in, and is used when keeping track of the | |
235 | package for later deinstallation. Note that ppkkgg__ccrreeaattee will | 233 | package for later deinstallation. Note that ppkkgg__ccrreeaattee will | |
236 | derive this field from the _p_k_g_-_n_a_m_e and add it automatically if | 234 | derive this field from the _p_k_g_-_n_a_m_e and add it automatically if | |
237 | none is given. | 235 | none is given. | |
238 | @@ppkkggddiirr _n_a_m_e | 236 | @@ppkkggddiirr _n_a_m_e | |
239 | Declare directory _n_a_m_e as managed. If it does not exist at | 237 | Declare directory _n_a_m_e as managed. If it does not exist at | |
240 | installation time, it is created. If this directory is no longer | 238 | installation time, it is created. If this directory is no longer | |
241 | referenced by packages and the last file or directory in it is | 239 | referenced by packages and the last file or directory in it is | |
242 | deleted, the directory is removed as well. | 240 | deleted, the directory is removed as well. | |
243 | @@ddiirrrrmm _n_a_m_e | 241 | @@ddiirrrrmm _n_a_m_e | |
244 | This command is supported for compatibility only. If directory | 242 | This command is supported for compatibility only. If directory | |
245 | _n_a_m_e exists, it will be deleted at deinstall time. | 243 | _n_a_m_e exists, it will be deleted at deinstall time. | |
246 | @@ddiissppllaayy _n_a_m_e | 244 | @@ddiissppllaayy _n_a_m_e | |
247 | Declare _n_a_m_e as the file to be displayed at install time (see --DD | 245 | Declare _n_a_m_e as the file to be displayed at install time (see --DD | |
248 | above). | 246 | above). | |
249 | @@ppkkggddeepp _p_k_g_n_a_m_e | 247 | @@ppkkggddeepp _p_k_g_n_a_m_e | |
250 | Declare a dependency on the _p_k_g_n_a_m_e package. The _p_k_g_n_a_m_e package | 248 | Declare a dependency on the _p_k_g_n_a_m_e package. The _p_k_g_n_a_m_e package | |
251 | must be installed before this package may be installed, and this | 249 | must be installed before this package may be installed, and this | |
252 | package must be deinstalled before the _p_k_g_n_a_m_e package is dein- | 250 | package must be deinstalled before the _p_k_g_n_a_m_e package is | |
253 | stalled. Multiple @@ppkkggddeepp directives may be used if the package | 251 | deinstalled. Multiple @@ppkkggddeepp directives may be used if the | |
254 | depends on multiple other packages. | 252 | package depends on multiple other packages. | |
255 | @@bbllddddeepp _p_k_g_n_a_m_e | 253 | @@bbllddddeepp _p_k_g_n_a_m_e | |
256 | Declare that this package was built with the exact version of | 254 | Declare that this package was built with the exact version of | |
257 | _p_k_g_n_a_m_e (since the @@ppkkggddeepp directive may contain wildcards or | 255 | _p_k_g_n_a_m_e (since the @@ppkkggddeepp directive may contain wildcards or | |
258 | relational package version information). | 256 | relational package version information). | |
259 | @@ppkkggccffll _p_k_g_c_f_l_n_a_m_e | 257 | @@ppkkggccffll _p_k_g_c_f_l_n_a_m_e | |
260 | Declare a conflict with the _p_k_g_c_f_l_n_a_m_e package, as the two pack- | 258 | Declare a conflict with the _p_k_g_c_f_l_n_a_m_e package, as the two | |
261 | ages contain references to the same files, and so cannot co-exist | 259 | packages contain references to the same files, and so cannot co- | |
262 | on the same system. | 260 | exist on the same system. | |
263 | 261 | |||
264 | EENNVVIIRROONNMMEENNTT | 262 | EENNVVIIRROONNMMEENNTT | |
265 | See pkg_install.conf(5) for options, that can also be specified using the | 263 | See pkg_install.conf(5) for options, that can also be specified using the | |
266 | environment. | 264 | environment. | |
267 | 265 | |||
268 | SSEEEE AALLSSOO | 266 | SSEEEE AALLSSOO | |
269 | pkg_add(1), pkg_admin(1), pkg_delete(1), pkg_info(1), pkg_install.conf(5) | 267 | pkg_add(1), pkg_admin(1), pkg_delete(1), pkg_info(1), pkg_install.conf(5) | |
270 | pkgsrc(7) | 268 | pkgsrc(7) | |
271 | 269 | |||
272 | HHIISSTTOORRYY | 270 | HHIISSTTOORRYY | |
273 | The ppkkgg__ccrreeaattee command first appeared in FreeBSD. | 271 | The ppkkgg__ccrreeaattee command first appeared in FreeBSD. | |
274 | 272 | |||
275 | AAUUTTHHOORRSS | 273 | AAUUTTHHOORRSS | |
276 | Jordan Hubbard | 274 | Jordan Hubbard | |
277 | most of the work | 275 | most of the work | |
278 | John Kohl | 276 | John Kohl | |
279 | refined it for NetBSD | 277 | refined it for NetBSD | |
280 | Hubert Feyrer | 278 | Hubert Feyrer | |
281 | NetBSD wildcard dependency processing, pkgdb, pkg size recording | 279 | NetBSD wildcard dependency processing, pkgdb, pkg size recording | |
282 | etc. | 280 | etc. | |
283 | 281 | |||
284 | NetBSD 5.0 January 20, 2010 NetBSD 5.0 | 282 | pkgsrc December 27, 2014 pkgsrc |
@@ -1,165 +1,163 @@ | @@ -1,165 +1,163 @@ | |||
1 | PKG_DELETE(1) NetBSD General Commands Manual PKG_DELETE(1) | 1 | PKG_DELETE(1) General Commands Manual PKG_DELETE(1) | |
2 | 2 | |||
3 | NNAAMMEE | 3 | NNAAMMEE | |
4 | ppkkgg__ddeelleettee -- a utility for deleting previously installed software pack- | 4 | ppkkgg__ddeelleettee -- a utility for deleting previously installed software | |
5 | age distributions | 5 | package distributions | |
6 | 6 | |||
7 | SSYYNNOOPPSSIISS | 7 | SSYYNNOOPPSSIISS | |
8 | ppkkgg__ddeelleettee [--AADDFFffkkNNnnOORRrrVVvv] [--KK _p_k_g___d_b_d_i_r] [--PP _d_e_s_t_d_i_r] [--pp _p_r_e_f_i_x] | 8 | ppkkgg__ddeelleettee [--AADDFFffkkNNnnOORRrrVVvv] [--KK _p_k_g___d_b_d_i_r] [--PP _d_e_s_t_d_i_r] [--pp _p_r_e_f_i_x] | |
9 | _p_k_g_-_n_a_m_e _._._. | 9 | _p_k_g_-_n_a_m_e _._._. | |
10 | 10 | |||
11 | DDEESSCCRRIIPPTTIIOONN | 11 | DDEESSCCRRIIPPTTIIOONN | |
12 | The ppkkgg__ddeelleettee command is used to delete packages that have been previ- | 12 | The ppkkgg__ddeelleettee command is used to delete packages that have been | |
13 | ously installed with the pkg_add(1) command. The given packages are | 13 | previously installed with the pkg_add(1) command. The given packages are | |
14 | sorted, so that the dependencies of a package are deleted after the pack- | 14 | sorted, so that the dependencies needed by a package are deleted after | |
15 | age. Before any action is executed, ppkkgg__ddeelleettee checks for packages that | 15 | the package. Before any action is executed, ppkkgg__ddeelleettee checks for | |
16 | are marked as pprreesseerrvveedd or have depending packages left. If the --kk flag | 16 | packages that are marked as pprreesseerrvveedd or have depending packages left. | |
17 | is given, preserved packages are removed from the list of packages to | 17 | If the --kk flag is given, preserved packages are skipped and not removed. | |
18 | remove. Unless the --ff flag is given, ppkkgg__ddeelleettee stops on the first | 18 | Unless the --ff flag is given, ppkkgg__ddeelleettee stops on the first error. | |
19 | error. | |||
20 | 19 | |||
21 | WWAARRNNIINNGG | 20 | WWAARRNNIINNGG | |
22 | _S_i_n_c_e _t_h_e ppkkgg__ddeelleettee _c_o_m_m_a_n_d _m_a_y _e_x_e_c_u_t_e _s_c_r_i_p_t_s _o_r _p_r_o_g_r_a_m_s _p_r_o_v_i_d_e_d _b_y | 21 | _S_i_n_c_e _t_h_e ppkkgg__ddeelleettee _c_o_m_m_a_n_d _m_a_y _e_x_e_c_u_t_e _s_c_r_i_p_t_s _o_r _p_r_o_g_r_a_m_s _p_r_o_v_i_d_e_d _b_y | |
23 | _a _p_a_c_k_a_g_e _f_i_l_e_, _y_o_u_r _s_y_s_t_e_m _m_a_y _b_e _s_u_s_c_e_p_t_i_b_l_e _t_o _`_`_T_r_o_j_a_n _h_o_r_s_e_s_'_' _o_r | 22 | _a _p_a_c_k_a_g_e _f_i_l_e_, _y_o_u_r _s_y_s_t_e_m _m_a_y _b_e _s_u_s_c_e_p_t_i_b_l_e _t_o _`_`_T_r_o_j_a_n _h_o_r_s_e_s_'_' _o_r | |
24 | _o_t_h_e_r _s_u_b_t_l_e _a_t_t_a_c_k_s _f_r_o_m _m_i_s_c_r_e_a_n_t_s _w_h_o _c_r_e_a_t_e _d_a_n_g_e_r_o_u_s _p_a_c_k_a_g_e _f_i_l_e_s_. | 23 | _o_t_h_e_r _s_u_b_t_l_e _a_t_t_a_c_k_s _f_r_o_m _m_i_s_c_r_e_a_n_t_s _w_h_o _c_r_e_a_t_e _d_a_n_g_e_r_o_u_s _p_a_c_k_a_g_e _f_i_l_e_s_. | |
25 | 24 | |||
26 | _Y_o_u _a_r_e _a_d_v_i_s_e_d _t_o _v_e_r_i_f_y _t_h_e _c_o_m_p_e_t_e_n_c_e _a_n_d _i_d_e_n_t_i_t_y _o_f _t_h_o_s_e _w_h_o _p_r_o_- | 25 | _Y_o_u _a_r_e _a_d_v_i_s_e_d _t_o _v_e_r_i_f_y _t_h_e _c_o_m_p_e_t_e_n_c_e _a_n_d _i_d_e_n_t_i_t_y _o_f _t_h_o_s_e _w_h_o | |
27 | _v_i_d_e _i_n_s_t_a_l_l_a_b_l_e _p_a_c_k_a_g_e _f_i_l_e_s_. _F_o_r _e_x_t_r_a _p_r_o_t_e_c_t_i_o_n_, _e_x_a_m_i_n_e _a_l_l _t_h_e | 26 | _p_r_o_v_i_d_e _i_n_s_t_a_l_l_a_b_l_e _p_a_c_k_a_g_e _f_i_l_e_s_. _F_o_r _e_x_t_r_a _p_r_o_t_e_c_t_i_o_n_, _e_x_a_m_i_n_e _a_l_l _t_h_e | |
28 | _p_a_c_k_a_g_e _c_o_n_t_r_o_l _f_i_l_e_s _i_n _t_h_e _p_a_c_k_a_g_e _r_e_c_o_r_d _d_i_r_e_c_t_o_r_y | 27 | _p_a_c_k_a_g_e _c_o_n_t_r_o_l _f_i_l_e_s _i_n _t_h_e _p_a_c_k_a_g_e _r_e_c_o_r_d _d_i_r_e_c_t_o_r_y | |
29 | _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_>_/_)_. _P_a_y _p_a_r_t_i_c_u_l_a_r _a_t_t_e_n_t_i_o_n _t_o _a_n_y _+_I_N_S_T_A_L_L _o_r | 28 | _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_>_/_)_. _P_a_y _p_a_r_t_i_c_u_l_a_r _a_t_t_e_n_t_i_o_n _t_o _a_n_y _+_I_N_S_T_A_L_L _o_r | |
30 | _+_D_E_I_N_S_T_A_L_L _f_i_l_e_s_, _a_n_d _i_n_s_p_e_c_t _t_h_e _+_C_O_N_T_E_N_T_S _f_i_l_e _f_o_r @@ccwwdd_, @@mmooddee _(_c_h_e_c_k | 29 | _+_D_E_I_N_S_T_A_L_L _f_i_l_e_s_, _a_n_d _i_n_s_p_e_c_t _t_h_e _+_C_O_N_T_E_N_T_S _f_i_l_e _f_o_r @@ccwwdd_, @@mmooddee _(_c_h_e_c_k | |
31 | _f_o_r _s_e_t_u_i_d_)_, @@ddiirrrrmm_, @@eexxeecc_, _a_n_d @@uunneexxeecc _d_i_r_e_c_t_i_v_e_s_, _a_n_d_/_o_r _u_s_e _t_h_e | 30 | _f_o_r _s_e_t_u_i_d_)_, @@ddiirrrrmm_, @@eexxeecc_, _a_n_d @@uunneexxeecc _d_i_r_e_c_t_i_v_e_s_, _a_n_d_/_o_r _u_s_e _t_h_e | |
32 | pkg_info(_1) _c_o_m_m_a_n_d _t_o _e_x_a_m_i_n_e _t_h_e _i_n_s_t_a_l_l_e_d _p_a_c_k_a_g_e _c_o_n_t_r_o_l _f_i_l_e_s_. | 31 | _p_k_g___i_n_f_o_(_1_) _c_o_m_m_a_n_d _t_o _e_x_a_m_i_n_e _t_h_e _i_n_s_t_a_l_l_e_d _p_a_c_k_a_g_e _c_o_n_t_r_o_l _f_i_l_e_s_. | |
33 | 32 | |||
34 | OOPPTTIIOONNSS | 33 | OOPPTTIIOONNSS | |
35 | The following command line options are supported: | 34 | The following command line options are supported: | |
36 | 35 | |||
37 | _p_k_g_-_n_a_m_e _._._. | 36 | _p_k_g_-_n_a_m_e _._._. | |
38 | The named packages are deinstalled, wildcards can be used, see | 37 | The named packages are deinstalled, wildcards can be used, see | |
39 | pkg_info(1). If no version is given, the one currently installed | 38 | pkg_info(1). If no version is given, the one currently installed | |
40 | will be removed. If the --FF flag is given, one or more (absolute) | 39 | will be removed. If the --FF flag is given, one or more (absolute) | |
41 | filenames may be specified and the Package Database will be con- | 40 | filenames may be specified and the package database will be | |
42 | sulted for the package to which the given file belongs. These | 41 | consulted for the package to which the given file belongs. These | |
43 | packages are then deinstalled. | 42 | packages are then deinstalled. | |
44 | 43 | |||
45 | --AA Recursively remove all automatically installed packages that were | 44 | --AA Recursively remove all automatically installed packages that were | |
46 | needed by the given packages and are no longer required. See | 45 | needed by the given packages and are no longer required. Does | |
47 | also the --RR flag. | 46 | not remove manually installed packages; see also the --RR flag. | |
48 | 47 | |||
49 | --DD If a deinstallation script exists for a given package, do not | 48 | --DD If a deinstallation script exists for a given package, do not | |
50 | execute it. | 49 | execute it. | |
51 | 50 | |||
52 | --FF Any pkg-name given will be interpreted as pathname which is sub- | 51 | --FF Any _p_k_g_-_n_a_m_e given will be interpreted as pathname which is | |
53 | sequently transformed in a (real) package name via the Package | 52 | subsequently transformed in a (real) package name via the package | |
54 | Database. That way, packages can be deleted by giving a filename | 53 | database. That way, packages can be deleted by giving a filename | |
55 | instead of the package-name. | 54 | instead of the package-name. | |
56 | 55 | |||
57 | --ff Force removal of the package, even if a dependency is recorded or | 56 | --ff Force removal of the package, even if a dependency is recorded or | |
58 | the deinstall script fails. | 57 | the deinstall script fails. This might break the package | |
58 | database; see pkg_admin(1) on how to repair it. | |||
59 | 59 | |||
60 | --ffff Force removal of the package, even if the package is marked as a | 60 | --ffff Force removal of the package, even if the package is marked as a | |
61 | pprreesseerrvveedd package. Note that this is a dangerous operation. See | 61 | pprreesseerrvveedd package. Note that this is a dangerous operation. See | |
62 | also the --kk option. | 62 | also the --kk option. | |
63 | 63 | |||
64 | --KK _p_k_g___d_b_d_i_r | 64 | --KK _p_k_g___d_b_d_i_r | |
65 | Override the value of the PKG_DBDIR configuration option with the | 65 | Override the value of the PKG_DBDIR configuration option with the | |
66 | value _p_k_g___d_b_d_i_r. | 66 | value _p_k_g___d_b_d_i_r. | |
67 | 67 | |||
68 | --kk Silently skip all packages that are marked as pprreesseerrvveedd. | 68 | --kk Silently skip all packages that are marked as pprreesseerrvveedd. | |
69 | 69 | |||
70 | --NN Remove the package's registration and its entries from the pack- | 70 | --NN Remove the package's registration and its entries from the | |
71 | age database, but leave the files installed. Don't run any dein- | 71 | package database, but leave the files installed. Don't run any | |
72 | stall scripts or @unexec lines either. | 72 | deinstall scripts or @@uunneexxeecc lines either. | |
73 | 73 | |||
74 | --nn Don't actually deinstall a package, just report the steps that | 74 | --nn Don't actually deinstall a package, just report the steps that | |
75 | would be taken if it were. | 75 | would be taken. | |
76 | 76 | |||
77 | --OO Only delete the package's entries from the package database, do | 77 | --OO Only delete the package's entries from the package database; do | |
78 | not touch the package or its files itself. | 78 | not touch the package or its files itself. | |
79 | 79 | |||
80 | --pp _d_e_s_t_d_i_r | 80 | --PP _d_e_s_t_d_i_r | |
81 | Prefix all file and directory names with _d_e_s_t_d_i_r. For packages | 81 | Prefix all file and directory names with _d_e_s_t_d_i_r. For packages | |
82 | without install scripts this has the same behavior as using | 82 | without install scripts this has the same behavior as using | |
83 | chroot. | 83 | chroot(8). | |
84 | 84 | |||
85 | --pp _p_r_e_f_i_x | 85 | --pp _p_r_e_f_i_x | |
86 | Set _p_r_e_f_i_x as the directory in which to delete files from any | 86 | Set _p_r_e_f_i_x as the directory in which to delete files from any | |
87 | installed packages which do not explicitly set theirs. For most | 87 | installed packages which do not explicitly set theirs. For most | |
88 | packages, the prefix will be set automatically to the installed | 88 | packages, the prefix will be set automatically to the installed | |
89 | location by pkg_add(1). | 89 | location by pkg_add(1). | |
90 | 90 | |||
91 | --RR Recursively remove all packages that were needed by the given | 91 | --RR Recursively remove all packages that were needed by the given | |
92 | packages and that have no other dependencies left. This option | 92 | packages and are no longer required. This option overrides the | |
93 | overrides the --AA flag. | 93 | --AA flag. | |
94 | 94 | |||
95 | --rr Recursively remove all packages that require one of the packages | 95 | --rr Recursively remove all packages that require one of the packages | |
96 | given. | 96 | given. | |
97 | 97 | |||
98 | --VV Print version number and exit. | 98 | --VV Print version number and exit. | |
99 | 99 | |||
100 | --vv Turn on verbose output. | 100 | --vv Turn on verbose output. | |
101 | 101 | |||
102 | TTEECCHHNNIICCAALL DDEETTAAIILLSS | 102 | TTEECCHHNNIICCAALL DDEETTAAIILLSS | |
103 | ppkkgg__ddeelleettee does pretty much what it says. It examines installed package | 103 | ppkkgg__ddeelleettee does pretty much what it says. It examines installed package | |
104 | records in _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_>, deletes the package contents, and | 104 | records in _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_>, deletes the package contents, and | |
105 | finally removes the package records. | 105 | finally removes the package records. | |
106 | 106 | |||
107 | If a package is required by other installed packages, ppkkgg__ddeelleettee will | 107 | If a package is required by other installed packages, ppkkgg__ddeelleettee will | |
108 | list those dependent packages and refuse to delete the package (unless | 108 | list those dependent packages and refuse to delete the package (unless | |
109 | the --ff option is given). | 109 | the --ff option is given). | |
110 | 110 | |||
111 | If a package has been marked as a pprreesseerrvveedd package, it will not be able | 111 | If a package has been marked as a pprreesseerrvveedd package, it will not be able | |
112 | to be deleted (unless more than one occurrence of the --ff option is | 112 | to be deleted (unless more than one occurrence of the --ff option is | |
113 | given). | 113 | given). | |
114 | 114 | |||
115 | If a filename is given instead of a package name, the package of which | 115 | If a filename is given instead of a package name, the package of which | |
116 | the given file belongs to can be deleted if the --FF Flag is given. The | 116 | the given file belongs to can be deleted if the --FF flag is given. The | |
117 | filename needs to be absolute, see the output produced by the pkg_info | 117 | filename needs to be absolute, see the output produced by the pkg_info(1) | |
118 | --aaFF command. | 118 | --aaFF command. | |
119 | 119 | |||
120 | If a ddeeiinnssttaallll script exists for the package, it is executed before and | 120 | If a ddeeiinnssttaallll script exists for the package, it is executed before and | |
121 | after any files are removed. It is this script's responsibility to clean | 121 | after any files are removed. It is this script's responsibility to clean | |
122 | up any additional messy details around the package's installation, since | 122 | up any additional messy details around the package's installation, since | |
123 | all ppkkgg__ddeelleettee knows how to do is delete the files created in the origi- | 123 | all ppkkgg__ddeelleettee knows how to do is delete the files created in the | |
124 | nal distribution. The ddeeiinnssttaallll script is called as: | 124 | original distribution. The ddeeiinnssttaallll script is called as: | |
125 | ddeeiinnssttaallll <_p_k_g_-_n_a_m_e> _V_I_E_W_-_D_E_I_N_S_T_A_L_L | |||
126 | before removing the package from a view, and as: | |||
127 | ddeeiinnssttaallll <_p_k_g_-_n_a_m_e> _D_E_I_N_S_T_A_L_L | 125 | ddeeiinnssttaallll <_p_k_g_-_n_a_m_e> _D_E_I_N_S_T_A_L_L | |
128 | before deleting all files and as: | 126 | before deleting all files and as: | |
129 | ddeeiinnssttaallll <_p_k_g_-_n_a_m_e> _P_O_S_T_-_D_E_I_N_S_T_A_L_L | 127 | ddeeiinnssttaallll <_p_k_g_-_n_a_m_e> _P_O_S_T_-_D_E_I_N_S_T_A_L_L | |
130 | after deleting them. Passing the keywords _V_I_E_W_-_D_E_I_N_S_T_A_L_L, _D_E_I_N_S_T_A_L_L and | 128 | after deleting them. Passing the keywords _D_E_I_N_S_T_A_L_L and _P_O_S_T_-_D_E_I_N_S_T_A_L_L | |
131 | _P_O_S_T_-_D_E_I_N_S_T_A_L_L lets you potentially write only one program/script that | 129 | lets you potentially write only one program/script that handles all | |
132 | handles all aspects of installation and deletion. | 130 | aspects of installation and deletion. | |
133 | 131 | |||
134 | All scripts are called with the environment variable PKG_PREFIX set to | 132 | All scripts are called with the environment variable PKG_PREFIX set to | |
135 | the installation prefix (see the --pp option above). This allows a package | 133 | the installation prefix (see the --pp option above). This allows a package | |
136 | author to write a script that reliably performs some action on the direc- | 134 | author to write a script that reliably performs some action on the | |
137 | tory where the package is installed, even if the user might have changed | 135 | directory where the package is installed, even if the user might have | |
138 | it by specifying the --pp option when running ppkkgg__ddeelleettee or pkg_add(1). | 136 | changed it by specifying the --pp option when running ppkkgg__ddeelleettee or | |
139 | The scripts are also called with the PKG_METADATA_DIR environment vari- | 137 | pkg_add(1). The scripts are also called with the PKG_METADATA_DIR | |
140 | able set to the location of the _+_* meta-data files, and with the | 138 | environment variable set to the location of the _+_* meta-data files, and | |
141 | PKG_REFCOUNT_DBDIR environment variable set to the location of the pack- | 139 | with the PKG_REFCOUNT_DBDIR environment variable set to the location of | |
142 | age reference counts database directory. If the --PP flag was given to | 140 | the package reference counts database directory. If the --PP flag was | |
143 | ppkkgg__ddeelleettee, PKG_DESTDIR will be set to _d_e_s_t_d_i_r. | 141 | given to ppkkgg__ddeelleettee, PKG_DESTDIR will be set to _d_e_s_t_d_i_r. | |
144 | 142 | |||
145 | EENNVVIIRROONNMMEENNTT | 143 | EENNVVIIRROONNMMEENNTT | |
146 | See pkg_install.conf(5) for options, that can also be specified using the | 144 | See pkg_install.conf(5) for options, that can also be specified using the | |
147 | environment. | 145 | environment. | |
148 | 146 | |||
149 | SSEEEE AALLSSOO | 147 | SSEEEE AALLSSOO | |
150 | pkg_add(1), pkg_admin(1), pkg_create(1), pkg_info(1), pkg_install.conf(5) | 148 | pkg_add(1), pkg_admin(1), pkg_create(1), pkg_info(1), pkg_install.conf(5) | |
151 | pkgsrc(7) | 149 | pkgsrc(7) | |
152 | 150 | |||
153 | AAUUTTHHOORRSS | 151 | AAUUTTHHOORRSS | |
154 | Jordan Hubbard | 152 | Jordan Hubbard | |
155 | most of the work | 153 | most of the work | |
156 | John Kohl | 154 | John Kohl | |
157 | refined it for NetBSD | 155 | refined it for NetBSD | |
158 | Hubert Feyrer | 156 | Hubert Feyrer | |
159 | NetBSD wildcard dependency processing, pkgdb, recursive "down" | 157 | NetBSD wildcard dependency processing, pkgdb, recursive "down" | |
160 | delete, etc. | 158 | delete, etc. | |
161 | Joerg Sonnenberger | 159 | Joerg Sonnenberger | |
162 | Rewrote most of the code to compute correct order of deinstalla- | 160 | Rewrote most of the code to compute correct order of | |
163 | tion and to improve error handling. | 161 | deinstallation and to improve error handling. | |
164 | 162 | |||
165 | NetBSD 5.0 January 20, 2010 NetBSD 5.0 | 163 | pkgsrc December 27, 2014 pkgsrc |
@@ -1,187 +1,204 @@ | @@ -1,187 +1,204 @@ | |||
1 | PKG_INFO(1) NetBSD General Commands Manual PKG_INFO(1) | 1 | PKG_INFO(1) General Commands Manual PKG_INFO(1) | |
2 | 2 | |||
3 | NNAAMMEE | 3 | NNAAMMEE | |
4 | ppkkgg__iinnffoo -- a utility for displaying information on software packages | 4 | ppkkgg__iinnffoo -- a utility for displaying information on software packages | |
5 | 5 | |||
6 | SSYYNNOOPPSSIISS | 6 | SSYYNNOOPPSSIISS | |
7 | ppkkgg__iinnffoo [--BBbbccDDddFFffhhIIiikkLLmmNNnnppqqrrRRSSssVVvvXX] [--ee _p_a_c_k_a_g_e] [--EE _p_a_c_k_a_g_e] | 7 | ppkkgg__iinnffoo [--BBbbccDDddFFffhhIIiikkLLmmNNnnppqqRRrrSSssVVvvXX] [--EE _p_k_g_-_n_a_m_e] [--ee _p_k_g_-_n_a_m_e] | |
8 | [--KK _p_k_g___d_b_d_i_r] [--ll _p_r_e_f_i_x] _p_k_g_-_n_a_m_e _._._. | 8 | [--KK _p_k_g___d_b_d_i_r] [--ll _p_r_e_f_i_x] _p_k_g_-_n_a_m_e _._._. | |
9 | ppkkgg__iinnffoo [--aa | --uu] [flags] | 9 | ppkkgg__iinnffoo [--aa | --uu] [flags] | |
10 | ppkkgg__iinnffoo [--QQ _v_a_r_i_a_b_l_e] _p_k_g_-_n_a_m_e _._._. | 10 | ppkkgg__iinnffoo [--QQ _v_a_r_i_a_b_l_e] _p_k_g_-_n_a_m_e _._._. | |
11 | 11 | |||
12 | DDEESSCCRRIIPPTTIIOONN | 12 | DDEESSCCRRIIPPTTIIOONN | |
13 | The ppkkgg__iinnffoo command is used to dump out information for packages, which | 13 | The ppkkgg__iinnffoo command is used to dump out information for packages, which | |
14 | may be either packed up in files or already installed on the system with | 14 | may be either packed up in files or already installed on the system with | |
15 | the pkg_create(1) command. | 15 | the pkg_create(1) command. | |
16 | 16 | |||
17 | The _p_k_g_-_n_a_m_e may be the name of an installed package (with our without | 17 | The _p_k_g_-_n_a_m_e may be the name of an installed package (with or without | |
18 | version), a pattern matching several installed packages (see the _P_A_C_K_A_G_E | 18 | version), a pattern matching several installed packages (see the _P_A_C_K_A_G_E | |
19 | _W_I_L_D_C_A_R_D_S section for a description of possible patterns), the pathname | 19 | _W_I_L_D_C_A_R_D_S section for a description of possible patterns), the pathname | |
20 | to a binary package, a filename belonging to an installed package (if --FF | 20 | to a binary package, a filename belonging to an installed package (with | |
21 | is also given), or a URL to an ftp-available package. | 21 | --FF), or a URL to an FTP-available package. | |
22 | 22 | |||
23 | The following command-line options are supported: | 23 | The following command line options are available: | |
24 | 24 | |||
25 | --aa Show information for all currently installed packages. See also | 25 | --aa Show information for all currently installed packages. See also | |
26 | --uu. | 26 | --uu. When neither --aa nor --uu is given, the former is assumed. | |
27 | 27 | |||
28 | --BB Show some of the important definitions used when building the | 28 | --BB Show some of the important definitions used when building the | |
29 | binary package (the ``Build information'') for each package. | 29 | binary package (the ``Build information'') for each package. | |
30 | Additionally, any installation information variables (lowercase) | 30 | Additionally, any installation information variables (lowercase) | |
31 | can be queried, too. In particular, _a_u_t_o_m_a_t_i_c tells if a package | 31 | can be queried, too. In particular, _a_u_t_o_m_a_t_i_c tells if a package | |
32 | was installed automatically as a dependency of another package. | 32 | was installed automatically as a dependency of another package. | |
33 | 33 | |||
34 | --bb Show the NetBSD RCS Id strings from the files used in the con- | 34 | --bb Show the NetBSD RCS Id strings from the files used in the | |
35 | struction of the binary package (the "Build version") for each | 35 | construction of the binary package (the ``Build version'') for | |
36 | package. These files are the package Makefile, any patch files, | 36 | each package. These files are the package Makefile, any patch | |
37 | any checksum files, and the packing list file. | 37 | files, any checksum files, and the packing list file. | |
38 | 38 | |||
39 | --cc Show the one-line comment field for each package. | 39 | --cc Show the one-line comment field for each package. | |
40 | 40 | |||
41 | --DD Show the install-message file (if any) for each package. | 41 | --DD Show the install-message file (if any) for each package. | |
42 | 42 | |||
43 | --dd Show the long-description field for each package. | 43 | --dd Show the long-description field for each package. | |
44 | 44 | |||
45 | --EE _p_k_g_-_n_a_m_e | 45 | --EE _p_k_g_-_n_a_m_e | |
46 | This option allows you to test for the existence of a given pack- | 46 | This option allows you to test for the existence of a given | |
47 | age. If a package identified by _p_k_g_-_n_a_m_e is currently installed, | 47 | package. If a package identified by _p_k_g_-_n_a_m_e is currently | |
48 | return code is 0, otherwise 1. The name of the best matching | 48 | installed, return code is 0, otherwise 1. The name of the best | |
49 | package found installed is printed to stdout unless turned off | 49 | matching package found installed is printed to stdout unless | |
50 | using the --qq option. _p_k_g_-_n_a_m_e can contain wildcards (see the | 50 | turned off using the --qq option. _p_k_g_-_n_a_m_e can contain wildcards | |
51 | _P_A_C_K_A_G_E _W_I_L_D_C_A_R_D_S section below). | 51 | (see the _P_A_C_K_A_G_E _W_I_L_D_C_A_R_D_S section below). | |
52 | 52 | |||
53 | --ee _p_k_g_-_n_a_m_e | 53 | --ee _p_k_g_-_n_a_m_e | |
54 | This option allows you to test for the existence of a given pack- | 54 | This option allows you to test for the existence of a given | |
55 | age. If a package identified by _p_k_g_-_n_a_m_e is currently installed, | 55 | package. If a package identified by _p_k_g_-_n_a_m_e is currently | |
56 | return code is 0, otherwise 1. The names of any package(s) found | 56 | installed, return code is 0, otherwise 1. The names of any | |
57 | installed are printed to stdout unless turned off using the --qq | 57 | package(s) found installed are printed to stdout unless turned | |
58 | option. _p_k_g_-_n_a_m_e can contain wildcards (see the _P_A_C_K_A_G_E | 58 | off using the --qq option. _p_k_g_-_n_a_m_e can contain wildcards (see the | |
59 | _W_I_L_D_C_A_R_D_S section below). | 59 | _P_A_C_K_A_G_E _W_I_L_D_C_A_R_D_S section below). | |
60 | 60 | |||
61 | --FF Interpret any pkg-name given as filename, and translate it to a | 61 | --FF Interpret any _p_k_g_-_n_a_m_e given as filename, and query information | |
62 | package name using the Package Database. This can be used to | 62 | on the package that file belongs to. This can be used to query | |
63 | query information on a per-file basis, e.g. in conjunction with | 63 | information on a per-file basis. See the _T_E_C_H_N_I_C_A_L _D_E_T_A_I_L_S | |
64 | the --ee flag to find out which package a file belongs to. | 64 | section below for more information. | |
65 | 65 | |||
66 | --ff Show the packing list instructions for each package. | 66 | --ff Show the packing list instructions for each package. | |
67 | 67 | |||
68 | --II Show the index entry for each package. | 68 | --hh Print usage message and exit. | |
69 | ||||
70 | --II Show the index entry for each package. This option is assumed | |||
71 | when no arguments or relevant flags are specified. | |||
69 | 72 | |||
70 | --ii Show the install script (if any) for each package. | 73 | --ii Show the install script (if any) for each package. | |
71 | 74 | |||
72 | --KK _p_k_g___d_b_d_i_r | 75 | --KK _p_k_g___d_b_d_i_r | |
73 | Override the value of the PKG_DBDIR configuration option with the | 76 | Override the value of the PKG_DBDIR configuration option with the | |
74 | value _p_k_g___d_b_d_i_r. | 77 | value _p_k_g___d_b_d_i_r. | |
75 | 78 | |||
76 | --kk Show the de-install script (if any) for each package. | 79 | --kk Show the de-install script (if any) for each package. | |
77 | 80 | |||
78 | --LL Show the files within each package. This is different from just | 81 | --LL Show the files within each package. This is different from just | |
79 | viewing the packing list, since full pathnames for everything are | 82 | viewing the packing list, since full pathnames for everything are | |
80 | generated. Files that were created dynamically during installa- | 83 | generated. Files that were created dynamically during | |
81 | tion of the package are not listed. | 84 | installation of the package are not listed. | |
82 | 85 | |||
83 | --ll _s_t_r Prefix each information category header (see --qq) shown with _s_t_r. | 86 | --ll _p_r_e_f_i_x | |
84 | This is primarily of use to front-end programs that want to | 87 | Prefix each information category header (see --qq) shown with | |
85 | request a lot of different information fields at once for a pack- | 88 | _p_r_e_f_i_x. This is primarily of use to front-end programs that want | |
86 | age, but don't necessary want the output intermingled in such a | 89 | to request a lot of different information fields at once for a | |
87 | way that they can't organize it. This lets you add a special | 90 | package, but don't necessary want the output intermingled in such | |
91 | a way that they can't organize it. This lets you add a special | |||
88 | token to the start of each field. | 92 | token to the start of each field. | |
89 | 93 | |||
90 | --mm Show the mtree file (if any) for each package. | 94 | --mm Show the mtree file (if any) for each package. | |
91 | 95 | |||
92 | --NN Show which packages each package was built with (exact dependen- | 96 | --NN Show which packages each package was built with (exact | |
93 | cies), if any. | 97 | dependencies), if any. | |
94 | 98 | |||
95 | --nn Show which packages each package needs (depends upon), if any. | 99 | --nn Show which packages each package needs (depends upon), if any. | |
96 | 100 | |||
97 | --pp Show the installation prefix for each package. | 101 | --pp Show the installation prefix for each package. | |
98 | 102 | |||
99 | --QQ Show the definition of _v_a_r_i_a_b_l_e from the build information for | 103 | --QQ _v_a_r_i_a_b_l_e | |
104 | Show the definition of _v_a_r_i_a_b_l_e from the build information for | |||
100 | each package. An empty string is returned if no such variable | 105 | each package. An empty string is returned if no such variable | |
101 | definition is found for the package(s). | 106 | definition is found for the package(s). | |
102 | 107 | |||
103 | --qq Be ``quiet'' in emitting report headers and such, just dump the | 108 | --qq Be ``quiet'' in emitting report headers and such, just dump the | |
104 | raw info (basically, assume a non-human reading). | 109 | raw info (basically, assume a non-human reading). | |
105 | 110 | |||
106 | --RR For each package, show the packages that require it. | 111 | --RR For each package, show the packages that require it. | |
107 | 112 | |||
108 | --rr For each package, show the packages that require it. Continue | 113 | --rr For each package, show the packages that require it. Continue | |
109 | recursively to show all dependents. | 114 | recursively to show all dependents. | |
110 | 115 | |||
111 | --SS Show the size of this package and all the packages it requires, | 116 | --SS Show the size of this package and all the packages it requires, | |
112 | in bytes. | 117 | in bytes. | |
113 | 118 | |||
114 | --ss Show the size of this package in bytes. The size is calculated | 119 | --ss Show the size of this package in bytes. The size is calculated | |
115 | by adding up the size of each file of the package. | 120 | by adding up the size of each file of the package. | |
116 | 121 | |||
117 | --uu Show information for all user-installed packages. Automatically | 122 | --uu Show information for all user-installed packages: automatically | |
118 | installed packages (as dependencies of other packages) are not | 123 | installed packages (as dependencies of other packages) are not | |
119 | displayed. See also --aa. | 124 | displayed. See also --aa. | |
120 | 125 | |||
121 | --VV Print version number and exit. | 126 | --VV Print version number and exit. | |
122 | 127 | |||
123 | --vv Turn on verbose output. | 128 | --vv Turn on verbose output. | |
124 | 129 | |||
125 | --XX Print summary information for each package. The summary format | 130 | --XX Print summary information for each package. The summary format | |
126 | is described in pkg_summary(5). Its primary use is to contain | 131 | is described in pkg_summary(5). Its primary use is to contain | |
127 | all information about the contents of a (remote) binary package | 132 | all information about the contents of a (remote) binary package | |
128 | repository needed by package managing software. | 133 | repository needed by package managing software. | |
129 | 134 | |||
130 | TTEECCHHNNIICCAALL DDEETTAAIILLSS | 135 | TTEECCHHNNIICCAALL DDEETTAAIILLSS | |
131 | Package info is either extracted from package files named on the command | 136 | Package info is either extracted from package files named on the command | |
132 | line, or from already installed package information in | 137 | line, or from already installed package information in | |
133 | _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_>. | 138 | _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_>. | |
134 | 139 | |||
135 | A filename can be given instead of a (installed) package name to query | 140 | When the --FF option is used, a filename can be given instead of a package | |
136 | information on the package this file belongs to. This filename is then | 141 | name to query information on the (installed) package that file belongs | |
137 | resolved to a package name using the Package Database. For this transla- | 142 | to. The filename is resolved to a package name using the package | |
138 | tion to take place, the --FF flag must be given. The filename must be | 143 | database. The filename must be absolute, as in the output of | |
139 | absolute, compare the output of pkg_info --aaFF. | 144 | pkg_info -aF. | |
145 | For example, | |||
146 | pkg_info -eF /path/to/file | |||
147 | can be used to display the package the given file belongs to, and | |||
148 | pkg_info -LF /path/to/file | |||
149 | can be used to display all files belonging to the package the given file | |||
150 | belongs to. | |||
140 | 151 | |||
141 | PPAACCKKAAGGEE WWIILLDDCCAARRDDSS | 152 | PPAACCKKAAGGEE WWIILLDDCCAARRDDSS | |
142 | In the places where a package name/version is expected, e.g. for the --ee | 153 | In the places where a package name/version is expected, e.g., for the --ee | |
143 | switch, several forms can be used. Either use a package name with or | 154 | option, several forms can be used. Either use a package name with or | |
144 | without version, or specify a package wildcard that gets matched against | 155 | without version, or specify a package wildcard that gets matched against | |
145 | all installed packages. | 156 | all installed packages. | |
146 | 157 | |||
147 | Package wildcards use fnmatch(3). In addition, csh(1) style {,} alter- | 158 | Package wildcards use fnmatch(3). In addition, csh(1) style {,} | |
148 | nates have been implemented. Package version numbers can also be matched | 159 | alternates have been implemented. Package version numbers can also be | |
149 | in a relational manner using the _>_=, _<_=, _>, and _< operators. For exam- | 160 | matched in a relational manner using the ``>='', ``<='', ``>'', and ``<'' | |
150 | ple, _p_k_g___i_n_f_o _-_e _'_n_a_m_e_>_=_1_._3_' will match versions 1.3 and later of the | 161 | operators. For example, | |
151 | _n_a_m_e package. Additionally, ranges can be defined by giving a lower | 162 | pkg_info -e 'name>=1.3' | |
152 | bound with > or >= and an upper bound with < or <=. The lower bound has | 163 | will match versions 1.3 and later of the ``name'' package. (Make sure to | |
153 | to come first. For example, _p_k_g___i_n_f_o _-_e _'_n_a_m_e_>_=_1_._3_<_2_._0_' will match ver- | 164 | use shell quoting.) Additionally, ranges can be defined, by giving both | |
154 | sions 1.3 (inclusive) to 2.0 (exclusive) of package _n_a_m_e. | 165 | a lower bound (with ``>'' or ``>='') as well as an upper bound (with | |
166 | ``<'' or ``<=''). The lower bound has to come first. For example, | |||
167 | pkg_info -e 'name>=1.3<2.0' | |||
168 | will match versions 1.3 (inclusive) to 2.0 (exclusive) of package | |||
169 | ``name''. | |||
155 | 170 | |||
156 | The collating sequence of the various package version numbers is unusual, | 171 | The collating sequence of the various package version numbers is unusual, | |
157 | but strives to be consistent. The magic string ``alpha'' equates to | 172 | but strives to be consistent. The magic string ``alpha'' equates to | |
158 | _a_l_p_h_a _v_e_r_s_i_o_n and sorts before a beta version. The magic string ``beta'' | 173 | ``alpha version'', and sorts before a beta version. The magic string | |
159 | equates to _b_e_t_a _v_e_r_s_i_o_n and sorts before a release candidate. The magic | 174 | ``beta'' equates to ``beta version'', and sorts before a release | |
160 | string ``rc'' equates to _r_e_l_e_a_s_e _c_a_n_d_i_d_a_t_e and sorts before a release. | 175 | candidate. The magic string ``rc'' equates to ``release candidate'', and | |
161 | The magic string ``pre'', short for ``pre-release'', is a synonym for | 176 | sorts before a release. The magic string ``pre'', short for | |
162 | ``rc''. For example, _n_a_m_e_-_1_._3_r_c_3 will sort before _n_a_m_e_-_1_._3 and after | 177 | ``pre-release'', is a synonym for ``rc''. For example, | |
163 | _n_a_m_e_-_1_._2_._9. Similarly _n_a_m_e_-_1_._3_a_l_p_h_a_2 will sort before _n_a_m_e_-_1_._3_b_e_t_a_1 and | 178 | ``name-1.3alpha2'' will sort before ``name-1.3beta1'', and they both sort | |
164 | they both sort before _n_a_m_e_-_1_._3_r_c_1. In addition, alphabetic characters | 179 | before ``name-1.3rc1''. Similarly, ``name-1.3rc3'' will sort before | |
165 | sort in the same place as their numeric counterparts, so that _n_a_m_e_-_1_._2_e | 180 | ``name-1.3'', and after ``name-1.2.9''. The magic string ``pl'' equates | |
166 | has the same sorting value as _n_a_m_e_-_1_._2_._5 The magic string ``pl'' equates | 181 | to ``patch level'', and has the same value as a dot (`.') in the dewey- | |
167 | to a _p_a_t_c_h _l_e_v_e_l and has the same value as a dot in the dewey-decimal | 182 | decimal ordering schemes, as does the underscore (`_'). Additionally, | |
168 | ordering schemes. | 183 | alphabetic characters sort in the same place as their numeric | |
184 | counterparts, so that ``name-1.2e'' has the same sorting value as | |||
185 | ``name-1.2.5''. | |||
169 | 186 | |||
170 | EENNVVIIRROONNMMEENNTT | 187 | EENNVVIIRROONNMMEENNTT | |
171 | See pkg_install.conf(5) for options, that can also be specified using the | 188 | See pkg_install.conf(5) for options, that can also be specified using the | |
172 | environment. | 189 | environment. | |
173 | 190 | |||
174 | SSEEEE AALLSSOO | 191 | SSEEEE AALLSSOO | |
175 | pkg_add(1), pkg_admin(1), pkg_create(1), pkg_delete(1), | 192 | pkg_add(1), pkg_admin(1), pkg_create(1), pkg_delete(1), | |
176 | pkg_install.conf(5) pkgsrc(7) | 193 | pkg_install.conf(5) pkgsrc(7) | |
177 | 194 | |||
178 | AAUUTTHHOORRSS | 195 | AAUUTTHHOORRSS | |
179 | Jordan Hubbard | 196 | Jordan Hubbard | |
180 | most of the work | 197 | most of the work | |
181 | John Kohl | 198 | John Kohl | |
182 | refined it for NetBSD | 199 | refined it for NetBSD | |
183 | Hubert Feyrer | 200 | Hubert Feyrer | |
184 | NetBSD wildcard dependency processing, pkgdb, depends displaying, | 201 | NetBSD wildcard dependency processing, pkgdb, depends displaying, | |
185 | pkg size display etc. | 202 | pkg size display, and more. | |
186 | 203 | |||
187 | NetBSD 5.0 January 22, 2010 NetBSD 5.0 | 204 | pkgsrc December 14, 2012 pkgsrc |
@@ -1,48 +1,48 @@ | @@ -1,48 +1,48 @@ | |||
1 | PKG_INSTALL.CONF(5) NetBSD File Formats Manual PKG_INSTALL.CONF(5) | 1 | PKG_INSTALL.CONF(5) File Formats Manual PKG_INSTALL.CONF(5) | |
2 | 2 | |||
3 | NNAAMMEE | 3 | NNAAMMEE | |
4 | ppkkgg__iinnssttaallll..ccoonnff -- configuration file for package installation tools | 4 | ppkkgg__iinnssttaallll..ccoonnff -- configuration file for package installation tools | |
5 | 5 | |||
6 | DDEESSCCRRIIPPTTIIOONN | 6 | DDEESSCCRRIIPPTTIIOONN | |
7 | The file ppkkgg__iinnssttaallll..ccoonnff contains system defaults for the package | 7 | The file ppkkgg__iinnssttaallll..ccoonnff contains system defaults for the package | |
8 | installation tools as a list of variable-value pairs. Each line has the | 8 | installation tools as a list of variable-value pairs. Each line has the | |
9 | format VARIABLE=VALUE. If the value consists of more than one line, each | 9 | format VARIABLE=VALUE. If the value consists of more than one line, each | |
10 | line is prefixed with VARIABLE=. | 10 | line is prefixed with VARIABLE=. | |
11 | 11 | |||
12 | The current value of a variable can be checked by running | 12 | The current value of a variable can be checked by running | |
13 | ppkkgg__aaddmmiinn ccoonnffiigg--vvaarr VVAARRIIAABBLLEE | 13 | ppkkgg__aaddmmiinn ccoonnffiigg--vvaarr VVAARRIIAABBLLEE | |
14 | 14 | |||
15 | Some variables are overriden by environmental variables of the same name. | 15 | Some variables are overriden by environmental variables of the same name. | |
16 | Those are marked by (*). | 16 | Those are marked by (*). | |
17 | 17 | |||
18 | The following variables are supported: | 18 | The following variables are supported: | |
19 | 19 | |||
20 | ACCEPTABLE_LICENSES | 20 | ACCEPTABLE_LICENSES | |
21 | Space-separared list of licenses packages are allowed to carry. | 21 | Space-separated list of licenses packages are allowed to carry. | |
22 | License names are case-sensitive. | 22 | License names are case-sensitive. | |
23 | 23 | |||
24 | ACTIVE_FTP | 24 | ACTIVE_FTP | |
25 | Force the use of active FTP. | 25 | Force the use of active FTP. | |
26 | 26 | |||
27 | CACHE_INDEX | 27 | CACHE_INDEX | |
28 | Cache directory listenings in memory. This avoids retransfers of | 28 | Cache directory listings in memory. This avoids retransfers of | |
29 | the large directory index for HTTP and is enabled by default. | 29 | the large directory index for HTTP and is enabled by default. | |
30 | 30 | |||
31 | CERTIFICATE_ANCHOR_PKGS | 31 | CERTIFICATE_ANCHOR_PKGS | |
32 | Path to the file containing the certificates used for validating | 32 | Path to the file containing the certificates used for validating | |
33 | binary packages. A package is trusted when a certificate chain | 33 | binary packages. A package is trusted when a certificate chain | |
34 | ends in one of the certificates contained in this file. The cer- | 34 | ends in one of the certificates contained in this file. The | |
35 | tificates must be PEM-encoded. | 35 | certificates must be PEM-encoded. | |
36 | 36 | |||
37 | CERTIFICATE_ANCHOR_PKGVULN | 37 | CERTIFICATE_ANCHOR_PKGVULN | |
38 | Analogous to CERTIFICATE_ANCHOR_PKGS. The _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s is | 38 | Analogous to CERTIFICATE_ANCHOR_PKGS. The _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s is | |
39 | trusted when a certificate chain ends in one of the certificates | 39 | trusted when a certificate chain ends in one of the certificates | |
40 | contained in this file. | 40 | contained in this file. | |
41 | 41 | |||
42 | CERTIFICATE_CHAIN | 42 | CERTIFICATE_CHAIN | |
43 | Path to a file containing additional certificates that can be | 43 | Path to a file containing additional certificates that can be | |
44 | used for completing certificate chains when validating binary | 44 | used for completing certificate chains when validating binary | |
45 | packages or pkg-vulnerabilities files. | 45 | packages or pkg-vulnerabilities files. | |
46 | 46 | |||
47 | CHECK_LICENSE | 47 | CHECK_LICENSE | |
48 | Check the license conditions of packages before installing them. | 48 | Check the license conditions of packages before installing them. | |
@@ -50,124 +50,129 @@ DDEESSCCRRIIPPTTIIOONN | @@ -50,124 +50,129 @@ DDEESSCCRRIIPPTTIIOONN | |||
50 | 50 | |||
51 | no The check is not performed. | 51 | no The check is not performed. | |
52 | 52 | |||
53 | yes The check is performed if the package has license | 53 | yes The check is performed if the package has license | |
54 | conditions set. | 54 | conditions set. | |
55 | 55 | |||
56 | always Passing the license check is required. Missing | 56 | always Passing the license check is required. Missing | |
57 | license conditions are considered an error. | 57 | license conditions are considered an error. | |
58 | 58 | |||
59 | CHECK_END_OF_LIFE | 59 | CHECK_END_OF_LIFE | |
60 | During vulnerability checks, consider packages that have reached | 60 | During vulnerability checks, consider packages that have reached | |
61 | end-of-life as vulnerable. This option is enabled by default. | 61 | end-of-life as vulnerable. This option is enabled by default. | |
62 | 62 | |||
63 | CHECK_OSABI | |||
64 | If "no", osabi package does not check OS version. The default is | |||
65 | "yes". | |||
66 | ||||
63 | CHECK_VULNERABILITIES | 67 | CHECK_VULNERABILITIES | |
64 | Check for vulnerabilities when installing packages. Supported | 68 | Check for vulnerabilities when installing packages. Supported | |
65 | values are: | 69 | values are: | |
66 | 70 | |||
67 | never No check is performed. | 71 | never No check is performed. | |
68 | 72 | |||
69 | always Passing the vulnerability check is required. A | 73 | always Passing the vulnerability check is required. A | |
70 | missing pkg-vulnerabilities file is considered an | 74 | missing pkg-vulnerabilities file is considered an | |
71 | error. | 75 | error. | |
72 | 76 | |||
73 | interactive The user is always asked to confirm installation | 77 | interactive The user is always asked to confirm installation | |
74 | of vulnerable packages. | 78 | of vulnerable packages. | |
75 | 79 | |||
76 | CONFIG_CACHE_CONNECTIONS | 80 | CONFIG_CACHE_CONNECTIONS | |
77 | Limit the global connection cache to this value. For FTP this is | 81 | Limit the global connection cache to this value. For FTP, this | |
78 | the number of sessions without active command. For HTTP this is | 82 | is the number of sessions without active command. For HTTP, this | |
79 | the number of connections open with keep-alive. | 83 | is the number of connections open with keep-alive. | |
80 | 84 | |||
81 | CONFIG_CACHE_CONNECTIONS_HOST | 85 | CONFIG_CACHE_CONNECTIONS_HOST | |
82 | Like CONFIG_CACHE_CONNECTIONS, but limit the number of connec- | 86 | Like CONFIG_CACHE_CONNECTIONS, but limit the number of | |
83 | tions to the host as well. See fetch(3) for further details | 87 | connections to the host as well. See fetch(3) for further | |
88 | details | |||
84 | 89 | |||
85 | DEFAULT_ACCEPTABLE_LICENSES | 90 | DEFAULT_ACCEPTABLE_LICENSES | |
86 | Space-separated list of common Free and Open Source licenses | 91 | Space-separated list of common Free and Open Source licenses | |
87 | packages are allowed to carry. The default value contains all | 92 | packages are allowed to carry. The default value contains all | |
88 | OSI approved licenses in pkgsrc on the date pkg_install was | 93 | OSI approved licenses in pkgsrc on the date pkg_install was | |
89 | released. License names are case-sensitive. | 94 | released. License names are case-sensitive. | |
90 | 95 | |||
91 | GPG Path to gpg(1), which can be used to verify the signature in the | 96 | GPG Path to gpg(1), which can be used to verify the signature in the | |
92 | _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file when running | 97 | _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file when running | |
93 | ppkkgg__aaddmmiinn cchheecckk--ppkkgg--vvuullnneerraabbiilliittiieess --ss | 98 | ppkkgg__aaddmmiinn cchheecckk--ppkkgg--vvuullnneerraabbiilliittiieess --ss | |
94 | or | 99 | or | |
95 | ppkkgg__aaddmmiinn ffeettcchh--ppkkgg--vvuullnneerraabbiilliittiieess --ss | 100 | ppkkgg__aaddmmiinn ffeettcchh--ppkkgg--vvuullnneerraabbiilliittiieess --ss | |
96 | It can also be used to verify and sign binary packages. | 101 | It can also be used to verify and sign binary packages. | |
97 | 102 | |||
98 | GPG_KEYRING_PKGVULN | 103 | GPG_KEYRING_PKGVULN | |
99 | Non-default keyring to use for verifying GPG signatures of | 104 | Non-default keyring to use for verifying GPG signatures of | |
100 | _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s. | 105 | _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s. | |
101 | 106 | |||
102 | GPG_KEYRING_SIGN | 107 | GPG_KEYRING_SIGN | |
103 | Non-default keyring to use for signing packages with GPG. | 108 | Non-default keyring to use for signing packages with GPG. | |
104 | 109 | |||
105 | GPG_KEYRING_VERIFY | 110 | GPG_KEYRING_VERIFY | |
106 | Non-default keyring to use for verifying GPG signature of pack- | 111 | Non-default keyring to use for verifying GPG signature of | |
107 | ages. | 112 | packages. | |
108 | 113 | |||
109 | GPG_SIGN_AS | 114 | GPG_SIGN_AS | |
110 | User-id to use for signing packages. | 115 | User-id to use for signing packages. | |
111 | 116 | |||
112 | IGNORE_PROXY | 117 | IGNORE_PROXY | |
113 | Use direct connections and ignore FTP_PROXY and HTTP_PROXY. | 118 | Use direct connections and ignore FTP_PROXY and HTTP_PROXY. | |
114 | 119 | |||
115 | IGNORE_URL | 120 | IGNORE_URL | |
116 | One line per advisory which should be ignored when running | 121 | One line per advisory which should be ignored when running | |
117 | ppkkgg__aaddmmiinn aauuddiitt | 122 | ppkkgg__aaddmmiinn aauuddiitt | |
118 | The URL from the _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file should be used as | 123 | The URL from the _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file should be used as | |
119 | value. | 124 | value. | |
120 | 125 | |||
121 | PKG_DBDIR (*) | 126 | PKG_DBDIR (*) | |
122 | Location of the packages database. This option is always overri- | 127 | Location of the packages database. This option is always | |
123 | den by the argument of the --KK option. | 128 | overriden by the argument of the --KK option. | |
124 | 129 | |||
125 | PKG_PATH (*) | 130 | PKG_PATH (*) | |
126 | Search path for packages. The entries are separated by semi- | 131 | Search path for packages. The entries are separated by | |
127 | colon. Each entry specifies a directory or URL to search for | 132 | semicolon. Each entry specifies a directory or URL to search for | |
128 | packages. | 133 | packages. | |
129 | 134 | |||
130 | PKG_REFCOUNT_DBDIR (*) | 135 | PKG_REFCOUNT_DBDIR (*) | |
131 | Location of the package reference counts database directory. The | 136 | Location of the package reference counts database directory. The | |
132 | default value is _$_{_P_K_G___D_B_D_I_R_}_._r_e_f_c_o_u_n_t. | 137 | default value is _$_{_P_K_G___D_B_D_I_R_}_._r_e_f_c_o_u_n_t. | |
133 | 138 | |||
134 | PKGVULNDIR | 139 | PKGVULNDIR | |
135 | Directory name in which the _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file resides. | 140 | Directory name in which the _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file resides. | |
136 | Default is _$_{_P_K_G___D_B_D_I_R_}. | 141 | Default is _$_{_P_K_G___D_B_D_I_R_}. | |
137 | 142 | |||
138 | PKGVULNURL | 143 | PKGVULNURL | |
139 | URL which is used for updating the local _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file | 144 | URL which is used for updating the local _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file | |
140 | when running | 145 | when running | |
141 | ppkkgg__aaddmmiinn ffeettcchh--ppkkgg--vvuullnneerraabbiilliittiieess | 146 | ppkkgg__aaddmmiinn ffeettcchh--ppkkgg--vvuullnneerraabbiilliittiieess | |
142 | The default location is ftp.NetBSD.org using HTTP. _N_o_t_e: Usu- | 147 | The default location is ftp.NetBSD.org using HTTP. _N_o_t_e: | |
143 | ally, only the compression type should be changed. Currently | 148 | Usually, only the compression type should be changed. Currently | |
144 | supported are uncompressed files and files compressed by bzip2(1) | 149 | supported are uncompressed files and files compressed by bzip2(1) | |
145 | (_._b_z_2) or gzip(1) (_._g_z). | 150 | (_._b_z_2) or gzip(1) (_._g_z). | |
146 | 151 | |||
147 | VERBOSE_NETIO | 152 | VERBOSE_NETIO | |
148 | Log details of network IO to stderr. | 153 | Log details of network IO to stderr. | |
149 | 154 | |||
150 | VERIFIED_INSTALLATION | 155 | VERIFIED_INSTALLATION | |
151 | Set trust level used when installation. Supported values are: | 156 | Set trust level used when installation. Supported values are: | |
152 | 157 | |||
153 | never No signature checks are performed. | 158 | never No signature checks are performed. | |
154 | 159 | |||
155 | always A valid signature is required. If the binary | 160 | always A valid signature is required. If the binary | |
156 | package can not be verified, the installation is | 161 | package can not be verified, the installation is | |
157 | terminated | 162 | terminated | |
158 | 163 | |||
159 | trusted A valid signature is required. If the binary | 164 | trusted A valid signature is required. If the binary | |
160 | package can not be verified, the user is asked | 165 | package can not be verified, the user is asked | |
161 | interactively. | 166 | interactively. | |
162 | 167 | |||
163 | interactive The user is always asked interactively when | 168 | interactive The user is always asked interactively when | |
164 | installing a package. | 169 | installing a package. | |
165 | 170 | |||
166 | FFIILLEESS | 171 | FFIILLEESS | |
167 | @SYSCONFDIR@/pkg_install.conf Default location for the file described in | 172 | _@_S_Y_S_C_O_N_F_D_I_R_@_/_p_k_g___i_n_s_t_a_l_l_._c_o_n_f Default location for the file | |
168 | this manual page. | 173 | described in this manual page. | |
169 | 174 | |||
170 | SSEEEE AALLSSOO | 175 | SSEEEE AALLSSOO | |
171 | pkg_add(1), pkg_admin(1) pkg_create(1), pkg_delete(1), pkg_info(1) | 176 | pkg_add(1), pkg_admin(1), pkg_create(1), pkg_delete(1), pkg_info(1) | |
172 | 177 | |||
173 | NetBSD 5.0 February 22, 2012 NetBSD 5.0 | 178 | pkgsrc October 28, 2014 pkgsrc |
@@ -1,75 +1,79 @@ | @@ -1,75 +1,79 @@ | |||
1 | PKG_SUMMARY(5) NetBSD File Formats Manual PKG_SUMMARY(5) | 1 | PKG_SUMMARY(5) File Formats Manual PKG_SUMMARY(5) | |
2 | 2 | |||
3 | NNAAMMEE | 3 | NNAAMMEE | |
4 | ppkkgg__ssuummmmaarryy -- summary of binary package repository | 4 | ppkkgg__ssuummmmaarryy -- summary of binary package repository | |
5 | 5 | |||
6 | DDEESSCCRRIIPPTTIIOONN | 6 | DDEESSCCRRIIPPTTIIOONN | |
7 | The file ppkkgg__ssuummmmaarryy contains information about each package in a binary | 7 | The file ppkkgg__ssuummmmaarryy contains information about each package in a binary | |
8 | package repository as a list of variable-value pairs. The variables | 8 | package repository as a list of variable-value pairs. The variables | |
9 | describing different packages are separated by one empty line. Each line | 9 | describing different packages are separated by one empty line. Each line | |
10 | has the format VARIABLE=VALUE. If the value consists of more than one | 10 | has the format VARIABLE=VALUE. If the value consists of more than one | |
11 | line, each line is prefixed with VARIABLE=. Multi-line variables are | 11 | line, each line is prefixed with VARIABLE=. Multi-line variables are | |
12 | guaranteed to be in consecutive lines. | 12 | guaranteed to be in consecutive lines. | |
13 | 13 | |||
14 | The following variables are used: | 14 | The following variables are used: | |
15 | 15 | |||
16 | BUILD_DATE | 16 | BUILD_DATE | |
17 | (required) The date and time when the package was built. | 17 | (required) The date and time when the package was built. | |
18 | 18 | |||
19 | CATEGORIES | 19 | CATEGORIES | |
20 | (required) A list of categories which this package fits in, sepa- | 20 | (required) A list of categories which this package fits in, | |
21 | rated by space. | 21 | separated by space. | |
22 | 22 | |||
23 | COMMENT | 23 | COMMENT | |
24 | (required) A one-line description of the package. | 24 | (required) A one-line description of the package. | |
25 | 25 | |||
26 | CONFLICTS | 26 | CONFLICTS | |
27 | (optional) A list of dewey patterns of packages the package con- | 27 | (optional) A list of dewey patterns of packages the package | |
28 | flicts with, one per line. If missing, this package has no con- | 28 | conflicts with, one per line. If missing, this package has no | |
29 | flicts. | 29 | conflicts. | |
30 | 30 | |||
31 | DEPENDS | 31 | DEPENDS | |
32 | (optional) A list of dewey patterns of packages the package | 32 | (optional) A list of dewey patterns of packages the package | |
33 | depends on, one per line. If missing, this package has no depen- | 33 | depends on, one per line. If missing, this package has no | |
34 | dencies. | 34 | dependencies. | |
35 | 35 | |||
36 | DESCRIPTION | 36 | DESCRIPTION | |
37 | (required) A more detailed description of the package. | 37 | (required) A more detailed description of the package. | |
38 | 38 | |||
39 | FILE_CKSUM | |||
40 | (optional) A checksum type supported by digest(1) and checksum | |||
41 | separated by space character. | |||
42 | ||||
39 | FILE_NAME | 43 | FILE_NAME | |
40 | (optional) The name of the binary package file. If not given, | 44 | (optional) The name of the binary package file. If not given, | |
41 | _P_K_G_N_A_M_E_._t_g_z can be assumed. | 45 | _P_K_G_N_A_M_E_._t_g_z can be assumed. | |
42 | 46 | |||
43 | FILE_SIZE | 47 | FILE_SIZE | |
44 | (optional) The size of the binary package file, in bytes. | 48 | (optional) The size of the binary package file, in bytes. | |
45 | 49 | |||
46 | HOMEPAGE | 50 | HOMEPAGE | |
47 | (optional) A URL where more information about the package can be | 51 | (optional) A URL where more information about the package can be | |
48 | found. | 52 | found. | |
49 | 53 | |||
50 | LICENSE | 54 | LICENSE | |
51 | (optional) The type of license this package is distributed under. | 55 | (optional) The type of license this package is distributed under. | |
52 | If empty or missing, it is OSI-approved. | 56 | If empty or missing, it is OSI-approved. | |
53 | 57 | |||
54 | MACHINE_ARCH | 58 | MACHINE_ARCH | |
55 | (required) The architecture on which the package was compiled. | 59 | (required) The architecture on which the package was compiled. | |
56 | 60 | |||
57 | OPSYS (required) The operating system on which the package was com- | 61 | OPSYS (required) The operating system on which the package was | |
58 | piled. | 62 | compiled. | |
59 | 63 | |||
60 | OS_VERSION | 64 | OS_VERSION | |
61 | (required) The version of the operating system on which the pack- | 65 | (required) The version of the operating system on which the | |
62 | age was compiled. | 66 | package was compiled. | |
63 | 67 | |||
64 | PKG_OPTIONS | 68 | PKG_OPTIONS | |
65 | (optional) Any options selected to compile this package. If | 69 | (optional) Any options selected to compile this package. If | |
66 | missing, the package does not support options. | 70 | missing, the package does not support options. | |
67 | 71 | |||
68 | PKGNAME | 72 | PKGNAME | |
69 | (required) The name of the package. | 73 | (required) The name of the package. | |
70 | 74 | |||
71 | PKGPATH | 75 | PKGPATH | |
72 | (required) The path of the package directory within pkgsrc. | 76 | (required) The path of the package directory within pkgsrc. | |
73 | 77 | |||
74 | PKGTOOLS_VERSION | 78 | PKGTOOLS_VERSION | |
75 | (required) The version of the package tools used to create the | 79 | (required) The version of the package tools used to create the | |
@@ -85,29 +89,29 @@ DDEESSCCRRIIPPTTIIOONN | @@ -85,29 +89,29 @@ DDEESSCCRRIIPPTTIIOONN | |||
85 | including major version number, one per line. If missing, this | 89 | including major version number, one per line. If missing, this | |
86 | package does not provide shared libraries. | 90 | package does not provide shared libraries. | |
87 | 91 | |||
88 | REQUIRES | 92 | REQUIRES | |
89 | (optional) A list of shared libraries needed by the package, | 93 | (optional) A list of shared libraries needed by the package, | |
90 | including major version number, one per line. If missing, this | 94 | including major version number, one per line. If missing, this | |
91 | package does not require shared libraries. | 95 | package does not require shared libraries. | |
92 | 96 | |||
93 | SIZE_PKG | 97 | SIZE_PKG | |
94 | (required) The size of the package when installed, in bytes. | 98 | (required) The size of the package when installed, in bytes. | |
95 | 99 | |||
96 | SUPERSEDES | 100 | SUPERSEDES | |
97 | (optional) A list of dewey patterns of previous packages this | 101 | (optional) A list of dewey patterns of previous packages this | |
98 | package replaces, one per line. This is used for package renam- | 102 | package replaces, one per line. This is used for package | |
99 | ing. | 103 | renaming. | |
100 | 104 | |||
101 | The ppkkgg__ssuummmmaarryy file can be generated using the pkg_info(1) --XX option. | 105 | The ppkkgg__ssuummmmaarryy file can be generated using the pkg_info(1) --XX option. | |
102 | For example, the following will list this data for all installed pack- | 106 | For example, the following will list this data for all installed | |
103 | ages: | 107 | packages: | |
104 | 108 | |||
105 | pkg_info -X -a | 109 | pkg_info -X -a | |
106 | 110 | |||
107 | SSEEEE AALLSSOO | 111 | SSEEEE AALLSSOO | |
108 | pkg_info(1) | 112 | digest(1), pkg_info(1) | |
109 | 113 | |||
110 | HHIISSTTOORRYY | 114 | HHIISSTTOORRYY | |
111 | The ppkkgg__ssuummmmaarryy format was first officially documented in April 2006. | 115 | The ppkkgg__ssuummmmaarryy format was first officially documented in April 2006. | |
112 | 116 | |||
113 | NetBSD 5.0 April 11, 2009 NetBSD 5.0 | 117 | pkgsrc April 11, 2009 pkgsrc |
@@ -1,19 +1,19 @@ | @@ -1,19 +1,19 @@ | |||
1 | PKGSRC(7) NetBSD Miscellaneous Information Manual PKGSRC(7) | 1 | PKGSRC(7) Miscellaneous Information Manual PKGSRC(7) | |
2 | 2 | |||
3 | NNAAMMEE | 3 | NNAAMMEE | |
4 | ppkkggssrrcc -- NetBSD packages collection (framework for third-party software) | 4 | ppkkggssrrcc -- NetBSD packages collection (framework for third-party software) | |
5 | 5 | |||
6 | DDEESSCCRRIIPPTTIIOONN | 6 | DDEESSCCRRIIPPTTIIOONN | |
7 | The NetBSD Packages Collection (pkgsrc) is a framework for building and | 7 | The NetBSD Packages Collection (pkgsrc) is a framework for building and | |
8 | maintaining third-party software on NetBSD and other UNIX-like systems. | 8 | maintaining third-party software on NetBSD and other UNIX-like systems. | |
9 | It is used to enable freely available software to be configured and built | 9 | It is used to enable freely available software to be configured and built | |
10 | easily on supported platforms. | 10 | easily on supported platforms. | |
11 | 11 | |||
12 | Tools are available to install ready-to-use packages and to perform vari- | 12 | Tools are available to install ready-to-use packages and to perform | |
13 | ous administrative tasks for the package system. | 13 | various administrative tasks for the package system. | |
14 | 14 | |||
15 | SSEEEE AALLSSOO | 15 | SSEEEE AALLSSOO | |
16 | pkg_add(1), pkg_delete(1), pkg_info(1), | 16 | pkg_add(1), pkg_delete(1), pkg_info(1), | |
17 | _h_t_t_p_:_/_/_w_w_w_._n_e_t_b_s_d_._o_r_g_/_d_o_c_s_/_p_k_g_s_r_c_/ | 17 | _h_t_t_p_:_/_/_w_w_w_._n_e_t_b_s_d_._o_r_g_/_d_o_c_s_/_p_k_g_s_r_c_/ | |
18 | 18 | |||
19 | NetBSD 5.0 March 2, 2007 NetBSD 5.0 | 19 | pkgsrc March 2, 2007 pkgsrc |