Tue Dec 30 15:17:29 2014 UTC ()
regen (using 'mandoc -Ios=pkgsrc')


(wiz)
diff -r1.5 -r1.6 pkgsrc/pkgtools/pkg_install/files/add/pkg_add.cat
diff -r1.2 -r1.3 pkgsrc/pkgtools/pkg_install/files/admin/pkg_admin.cat
diff -r1.2 -r1.3 pkgsrc/pkgtools/pkg_install/files/create/pkg_create.cat
diff -r1.1 -r1.2 pkgsrc/pkgtools/pkg_install/files/delete/pkg_delete.cat
diff -r1.1 -r1.2 pkgsrc/pkgtools/pkg_install/files/info/pkg_info.cat
diff -r1.4 -r1.5 pkgsrc/pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in
diff -r1.1 -r1.2 pkgsrc/pkgtools/pkg_install/files/lib/pkg_summary.cat
diff -r1.1 -r1.2 pkgsrc/pkgtools/pkg_install/files/lib/pkgsrc.cat

cvs diff -r1.5 -r1.6 pkgsrc/pkgtools/pkg_install/files/add/pkg_add.cat (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_install/files/add/pkg_add.cat 2010/09/14 22:26:18 1.5
+++ pkgsrc/pkgtools/pkg_install/files/add/pkg_add.cat 2014/12/30 15:17:28 1.6
@@ -1,93 +1,92 @@ @@ -1,93 +1,92 @@
1PKG_ADD(1) NetBSD General Commands Manual PKG_ADD(1) 1PKG_ADD(1) General Commands Manual PKG_ADD(1)
2 2
3NNAAMMEE 3NNAAMMEE
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
7SSYYNNOOPPSSIISS 7SSYYNNOOPPSSIISS
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
12DDEESSCCRRIIPPTTIIOONN 12DDEESSCCRRIIPPTTIIOONN
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
20WWAARRNNIINNGG 20WWAARRNNIINNGG
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
36OOPPTTIIOONNSS 36OOPPTTIIOONNSS
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
129TTEECCHHNNIICCAALL DDEETTAAIILLSS 123TTEECCHHNNIICCAALL 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
226EENNVVIIRROONNMMEENNTT 218EENNVVIIRROONNMMEENNTT
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
231EEXXAAMMPPLLEESS 222EEXXAAMMPPLLEESS
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
269BBUUGGSS 260BBUUGGSS
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
274NetBSD 5.0 June 16, 2010 NetBSD 5.0 265pkgsrc December 27, 2014 pkgsrc

cvs diff -r1.2 -r1.3 pkgsrc/pkgtools/pkg_install/files/admin/pkg_admin.cat (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_install/files/admin/pkg_admin.cat 2010/06/16 23:02:48 1.2
+++ pkgsrc/pkgtools/pkg_install/files/admin/pkg_admin.cat 2014/12/30 15:17:28 1.3
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1PKG_ADMIN(1) NetBSD General Commands Manual PKG_ADMIN(1) 1PKG_ADMIN(1) General Commands Manual PKG_ADMIN(1)
2 2
3NNAAMMEE 3NNAAMMEE
4 ppkkgg__aaddmmiinn -- perform various administrative tasks to the pkg system 4 ppkkgg__aaddmmiinn -- perform various administrative tasks to the pkg system
5 5
6SSYYNNOOPPSSIISS 6SSYYNNOOPPSSIISS
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
10DDEESSCCRRIIPPTTIIOONN 10DDEESSCCRRIIPPTTIIOONN
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
14OOPPTTIIOONNSS 14OOPPTTIIOONNSS
@@ -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
199EENNVVIIRROONNMMEENNTT 189EENNVVIIRROONNMMEENNTT
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
203FFIILLEESS 193FFIILLEESS
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
207SSEEEE AALLSSOO 197SSEEEE 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
211HHIISSTTOORRYY 201HHIISSTTOORRYY
212 The ppkkgg__aaddmmiinn command first appeared in NetBSD 1.4. 202 The ppkkgg__aaddmmiinn command first appeared in NetBSD 1.4.
213 203
214AAUUTTHHOORRSS 204AAUUTTHHOORRSS
215 The ppkkgg__aaddmmiinn command was written by Hubert Feyrer. 205 The ppkkgg__aaddmmiinn command was written by Hubert Feyrer.
216 206
217NetBSD 5.0 January 22, 2010 NetBSD 5.0 207pkgsrc December 27, 2014 pkgsrc

cvs diff -r1.2 -r1.3 pkgsrc/pkgtools/pkg_install/files/create/pkg_create.cat (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_install/files/create/pkg_create.cat 2010/04/20 00:39:13 1.2
+++ pkgsrc/pkgtools/pkg_install/files/create/pkg_create.cat 2014/12/30 15:17:29 1.3
@@ -1,76 +1,74 @@ @@ -1,76 +1,74 @@
1PKG_CREATE(1) NetBSD General Commands Manual PKG_CREATE(1) 1PKG_CREATE(1) General Commands Manual PKG_CREATE(1)
2 2
3NNAAMMEE 3NNAAMMEE
4 ppkkgg__ccrreeaattee -- a utility for creating software package distributions 4 ppkkgg__ccrreeaattee -- a utility for creating software package distributions
5 5
6SSYYNNOOPPSSIISS 6SSYYNNOOPPSSIISS
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
14DDEESSCCRRIIPPTTIIOONN 14DDEESSCCRRIIPPTTIIOONN
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
23OOPPTTIIOONNSS 23OOPPTTIIOONNSS
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
161PPAACCKKIINNGG LLIISSTT DDEETTAAIILLSS 159PPAACCKKIINNGG 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
264EENNVVIIRROONNMMEENNTT 262EENNVVIIRROONNMMEENNTT
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
268SSEEEE AALLSSOO 266SSEEEE 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
272HHIISSTTOORRYY 270HHIISSTTOORRYY
273 The ppkkgg__ccrreeaattee command first appeared in FreeBSD. 271 The ppkkgg__ccrreeaattee command first appeared in FreeBSD.
274 272
275AAUUTTHHOORRSS 273AAUUTTHHOORRSS
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
284NetBSD 5.0 January 20, 2010 NetBSD 5.0 282pkgsrc December 27, 2014 pkgsrc

cvs diff -r1.1 -r1.2 pkgsrc/pkgtools/pkg_install/files/delete/pkg_delete.cat (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_install/files/delete/pkg_delete.cat 2010/01/22 13:33:30 1.1
+++ pkgsrc/pkgtools/pkg_install/files/delete/pkg_delete.cat 2014/12/30 15:17:29 1.2
@@ -1,165 +1,163 @@ @@ -1,165 +1,163 @@
1PKG_DELETE(1) NetBSD General Commands Manual PKG_DELETE(1) 1PKG_DELETE(1) General Commands Manual PKG_DELETE(1)
2 2
3NNAAMMEE 3NNAAMMEE
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
7SSYYNNOOPPSSIISS 7SSYYNNOOPPSSIISS
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
11DDEESSCCRRIIPPTTIIOONN 11DDEESSCCRRIIPPTTIIOONN
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
21WWAARRNNIINNGG 20WWAARRNNIINNGG
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
34OOPPTTIIOONNSS 33OOPPTTIIOONNSS
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
102TTEECCHHNNIICCAALL DDEETTAAIILLSS 102TTEECCHHNNIICCAALL 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
145EENNVVIIRROONNMMEENNTT 143EENNVVIIRROONNMMEENNTT
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
149SSEEEE AALLSSOO 147SSEEEE 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
153AAUUTTHHOORRSS 151AAUUTTHHOORRSS
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
165NetBSD 5.0 January 20, 2010 NetBSD 5.0 163pkgsrc December 27, 2014 pkgsrc

cvs diff -r1.1 -r1.2 pkgsrc/pkgtools/pkg_install/files/info/pkg_info.cat (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_install/files/info/pkg_info.cat 2010/01/22 13:33:30 1.1
+++ pkgsrc/pkgtools/pkg_install/files/info/pkg_info.cat 2014/12/30 15:17:29 1.2
@@ -1,187 +1,204 @@ @@ -1,187 +1,204 @@
1PKG_INFO(1) NetBSD General Commands Manual PKG_INFO(1) 1PKG_INFO(1) General Commands Manual PKG_INFO(1)
2 2
3NNAAMMEE 3NNAAMMEE
4 ppkkgg__iinnffoo -- a utility for displaying information on software packages 4 ppkkgg__iinnffoo -- a utility for displaying information on software packages
5 5
6SSYYNNOOPPSSIISS 6SSYYNNOOPPSSIISS
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
12DDEESSCCRRIIPPTTIIOONN 12DDEESSCCRRIIPPTTIIOONN
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
130TTEECCHHNNIICCAALL DDEETTAAIILLSS 135TTEECCHHNNIICCAALL 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
141PPAACCKKAAGGEE WWIILLDDCCAARRDDSS 152PPAACCKKAAGGEE 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
170EENNVVIIRROONNMMEENNTT 187EENNVVIIRROONNMMEENNTT
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
174SSEEEE AALLSSOO 191SSEEEE 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
178AAUUTTHHOORRSS 195AAUUTTHHOORRSS
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
187NetBSD 5.0 January 22, 2010 NetBSD 5.0 204pkgsrc December 14, 2012 pkgsrc

cvs diff -r1.4 -r1.5 pkgsrc/pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in 2012/02/22 23:56:03 1.4
+++ pkgsrc/pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in 2014/12/30 15:17:29 1.5
@@ -1,48 +1,48 @@ @@ -1,48 +1,48 @@
1PKG_INSTALL.CONF(5) NetBSD File Formats Manual PKG_INSTALL.CONF(5) 1PKG_INSTALL.CONF(5) File Formats Manual PKG_INSTALL.CONF(5)
2 2
3NNAAMMEE 3NNAAMMEE
4 ppkkgg__iinnssttaallll..ccoonnff -- configuration file for package installation tools 4 ppkkgg__iinnssttaallll..ccoonnff -- configuration file for package installation tools
5 5
6DDEESSCCRRIIPPTTIIOONN 6DDEESSCCRRIIPPTTIIOONN
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
166FFIILLEESS 171FFIILLEESS
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
170SSEEEE AALLSSOO 175SSEEEE 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
173NetBSD 5.0 February 22, 2012 NetBSD 5.0 178pkgsrc October 28, 2014 pkgsrc

cvs diff -r1.1 -r1.2 pkgsrc/pkgtools/pkg_install/files/lib/pkg_summary.cat (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_install/files/lib/pkg_summary.cat 2010/01/22 13:33:31 1.1
+++ pkgsrc/pkgtools/pkg_install/files/lib/pkg_summary.cat 2014/12/30 15:17:29 1.2
@@ -1,75 +1,79 @@ @@ -1,75 +1,79 @@
1PKG_SUMMARY(5) NetBSD File Formats Manual PKG_SUMMARY(5) 1PKG_SUMMARY(5) File Formats Manual PKG_SUMMARY(5)
2 2
3NNAAMMEE 3NNAAMMEE
4 ppkkgg__ssuummmmaarryy -- summary of binary package repository 4 ppkkgg__ssuummmmaarryy -- summary of binary package repository
5 5
6DDEESSCCRRIIPPTTIIOONN 6DDEESSCCRRIIPPTTIIOONN
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
107SSEEEE AALLSSOO 111SSEEEE AALLSSOO
108 pkg_info(1) 112 digest(1), pkg_info(1)
109 113
110HHIISSTTOORRYY 114HHIISSTTOORRYY
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
113NetBSD 5.0 April 11, 2009 NetBSD 5.0 117pkgsrc April 11, 2009 pkgsrc

cvs diff -r1.1 -r1.2 pkgsrc/pkgtools/pkg_install/files/lib/pkgsrc.cat (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_install/files/lib/pkgsrc.cat 2010/01/22 13:33:31 1.1
+++ pkgsrc/pkgtools/pkg_install/files/lib/pkgsrc.cat 2014/12/30 15:17:29 1.2
@@ -1,19 +1,19 @@ @@ -1,19 +1,19 @@
1PKGSRC(7) NetBSD Miscellaneous Information Manual PKGSRC(7) 1PKGSRC(7) Miscellaneous Information Manual PKGSRC(7)
2 2
3NNAAMMEE 3NNAAMMEE
4 ppkkggssrrcc -- NetBSD packages collection (framework for third-party software) 4 ppkkggssrrcc -- NetBSD packages collection (framework for third-party software)
5 5
6DDEESSCCRRIIPPTTIIOONN 6DDEESSCCRRIIPPTTIIOONN
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
15SSEEEE AALLSSOO 15SSEEEE 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
19NetBSD 5.0 March 2, 2007 NetBSD 5.0 19pkgsrc March 2, 2007 pkgsrc