| @@ -1,20 +1,20 @@ | | | @@ -1,20 +1,20 @@ |
1 | PKG_CREATE(1) NetBSD General Commands Manual PKG_CREATE(1) | | 1 | PKG_CREATE(1) NetBSD General Commands Manual PKG_CREATE(1) |
2 | | | 2 | |
3 | NNAAMMEE | | 3 | NNAAMMEE |
4 | ppkkgg__ccrreeaattee -- a utility for creating software package distributions | | 4 | ppkkgg__ccrreeaattee -- a utility for creating software package distributions |
5 | | | 5 | |
6 | SSYYNNOOPPSSIISS | | 6 | SSYYNNOOPPSSIISS |
7 | ppkkgg__ccrreeaattee [--EEllOORRUUVVvv] [--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 [--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] |
8 | [--CC _c_p_k_g_s] [--DD _d_i_s_p_l_a_y_f_i_l_e] [--gg _g_r_o_u_p] [--II _r_e_a_l_p_r_e_f_i_x] | | 8 | [--CC _c_p_k_g_s] [--DD _d_i_s_p_l_a_y_f_i_l_e] [--gg _g_r_o_u_p] [--II _r_e_a_l_p_r_e_f_i_x] |
9 | [--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] [--LL _S_r_c_D_i_r] | | 9 | [--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] [--LL _S_r_c_D_i_r] |
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] [--TT _b_u_i_l_d_p_k_g_s] [--pp _p_r_e_f_i_x] |
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_-_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] |
12 | --cc _c_o_m_m_e_n_t --dd _d_e_s_c_r_i_p_t_i_o_n --ff _p_a_c_k_l_i_s_t _p_k_g_-_n_a_m_e | | 12 | --cc _c_o_m_m_e_n_t --dd _d_e_s_c_r_i_p_t_i_o_n --ff _p_a_c_k_l_i_s_t _p_k_g_-_n_a_m_e |
13 | | | 13 | |
14 | DDEESSCCRRIIPPTTIIOONN | | 14 | DDEESSCCRRIIPPTTIIOONN |
15 | The ppkkgg__ccrreeaattee command is used to create packages that will subsequently | | 15 | The ppkkgg__ccrreeaattee command is used to create packages that will subsequently |
16 | be fed to one of the package extraction/info utilities. The input | | 16 | be fed to one of the package extraction/info utilities. The input |
17 | description and command line arguments for the creation of a package are | | 17 | description and command line arguments for the creation of a package are |
18 | not really meant to be human-generated, though it is easy enough to do | | 18 | not really meant to be human-generated, though it is easy enough to do |
19 | so. It is more expected that you will use a front-end tool for the job | | 19 | so. It is more expected that you will use a front-end tool for the job |
20 | rather than muddling through it yourself. Nonetheless, a short descrip- | | 20 | rather than muddling through it yourself. Nonetheless, a short descrip- |
| @@ -119,30 +119,26 @@ OOPPTTIIOONNSS | | | @@ -119,30 +119,26 @@ OOPPTTIIOONNSS |
119 | form of @@bbllddddeepp directives. | | 119 | form of @@bbllddddeepp directives. |
120 | | | 120 | |
121 | --TT _b_u_i_l_d_p_k_g_s | | 121 | --TT _b_u_i_l_d_p_k_g_s |
122 | The exact versions of the packages referred to in the _b_u_i_l_d_p_k_g_s | | 122 | The exact versions of the packages referred to in the _b_u_i_l_d_p_k_g_s |
123 | list will be added to the packing list in the form of @@bbllddddeepp | | 123 | list will be added to the packing list in the form of @@bbllddddeepp |
124 | directives. This directives are stored after those created by | | 124 | directives. This directives are stored after those created by |
125 | the --PP option. _b_u_i_l_d_p_k_g_s is assumed to be a whitespace separated | | 125 | the --PP option. _b_u_i_l_d_p_k_g_s is assumed to be a whitespace separated |
126 | list of package names. | | 126 | list of package names. |
127 | | | 127 | |
128 | --pp _p_r_e_f_i_x | | 128 | --pp _p_r_e_f_i_x |
129 | Set _p_r_e_f_i_x as the initial directory (base) to start from in | | 129 | Set _p_r_e_f_i_x as the initial directory (base) to start from in |
130 | selecting files for the package. | | 130 | selecting files for the package. |
131 | | | 131 | |
132 | --RR Re-order any directories in the PLIST file into reverse alpha- | | | |
133 | betic order, so that child directories will automatically be | | | |
134 | removed before parent directories. | | | |
135 | | | | |
136 | --SS _s_i_z_e_-_a_l_l_-_f_i_l_e | | 132 | --SS _s_i_z_e_-_a_l_l_-_f_i_l_e |
137 | Store the given file for later querying with the pkg_info(1) --SS | | 133 | Store the given file for later querying with the pkg_info(1) --SS |
138 | flag. The file is expected to contain the size (in bytes) of all | | 134 | flag. The file is expected to contain the size (in bytes) of all |
139 | files of this package plus any required packages added up and | | 135 | files of this package plus any required packages added up and |
140 | stored as a ASCII string, terminated by a newline. | | 136 | stored as a ASCII string, terminated by a newline. |
141 | | | 137 | |
142 | --ss _s_i_z_e_-_p_k_g_-_f_i_l_e | | 138 | --ss _s_i_z_e_-_p_k_g_-_f_i_l_e |
143 | Store the given file for later querying with the pkg_info(1) --ss | | 139 | Store the given file for later querying with the pkg_info(1) --ss |
144 | flag. The file is expected to contain the size (in bytes) of all | | 140 | flag. The file is expected to contain the size (in bytes) of all |
145 | files of this package added up and stored as a ASCII string, ter- | | 141 | files of this package added up and stored as a ASCII string, ter- |
146 | minated by a newline. | | 142 | minated by a newline. |
147 | | | 143 | |
148 | --tt _t_e_m_p_l_a_t_e | | 144 | --tt _t_e_m_p_l_a_t_e |
| @@ -224,47 +220,41 @@ PPAACCKKIINNGG LLIISSTT DDE | | | @@ -224,47 +220,41 @@ PPAACCKKIINNGG LLIISSTT DDE |
224 | _u_s_e_r. Use without an arg to set back to default (extraction) | | 220 | _u_s_e_r. Use without an arg to set back to default (extraction) |
225 | ownership. | | 221 | ownership. |
226 | @@ggrroouupp _g_r_o_u_p | | 222 | @@ggrroouupp _g_r_o_u_p |
227 | Set default group ownership for all subsequently extracted files | | 223 | Set default group ownership for all subsequently extracted files |
228 | to _g_r_o_u_p. Use without an arg to set back to default (extraction) | | 224 | to _g_r_o_u_p. Use without an arg to set back to default (extraction) |
229 | group ownership. | | 225 | group ownership. |
230 | @@ccoommmmeenntt _s_t_r_i_n_g | | 226 | @@ccoommmmeenntt _s_t_r_i_n_g |
231 | Embed a comment in the packing list. Useful in trying to docu- | | 227 | Embed a comment in the packing list. Useful in trying to docu- |
232 | ment some particularly hairy sequence that may trip someone up | | 228 | ment some particularly hairy sequence that may trip someone up |
233 | later. | | 229 | later. |
234 | @@iiggnnoorree | | 230 | @@iiggnnoorree |
235 | Used internally to tell extraction to ignore the next file (don't | | 231 | Used internally to tell extraction to ignore the next file (don't |
236 | copy it anywhere), as it's used for some special purpose. | | 232 | copy it anywhere), as it's used for some special purpose. |
237 | @@iiggnnoorree__iinnsstt | | | |
238 | Similar to @@iiggnnoorree, but the ignoring of the next file is delayed | | | |
239 | one evaluation cycle. This makes it possible to use this direc- | | | |
240 | tive in the _p_a_c_k_i_n_g_l_i_s_t file, so you can pack a specialized | | | |
241 | datafile in with a distribution for your install script (or some- | | | |
242 | thing) yet have the installer ignore it. | | | |
243 | @@nnaammee _n_a_m_e | | 233 | @@nnaammee _n_a_m_e |
244 | Set the name of the package. This is mandatory and is usually | | 234 | Set the name of the package. This is mandatory and is usually |
245 | put at the top. This name is potentially different than the name | | 235 | put at the top. This name is potentially different than the name |
246 | of the file it came in, and is used when keeping track of the | | 236 | of the file it came in, and is used when keeping track of the |
247 | package for later deinstallation. Note that ppkkgg__ccrreeaattee will | | 237 | package for later deinstallation. Note that ppkkgg__ccrreeaattee will |
248 | derive this field from the _p_k_g_-_n_a_m_e and add it automatically if | | 238 | derive this field from the _p_k_g_-_n_a_m_e and add it automatically if |
249 | none is given. | | 239 | none is given. |
| | | 240 | @@ppkkggddiirr _n_a_m_e |
| | | 241 | Declare directory _n_a_m_e as managed. If it does not exist at |
| | | 242 | installation time, it is created. If this directory is no longer |
| | | 243 | referenced by packages and the last file or directory in it is |
| | | 244 | deleted, the directory is removed as well. |
250 | @@ddiirrrrmm _n_a_m_e | | 245 | @@ddiirrrrmm _n_a_m_e |
251 | Declare directory _n_a_m_e to be deleted at deinstall time. By | | 246 | This command is supported for compatibility only. If directory |
252 | default, directories created by a package installation are not | | 247 | _n_a_m_e exists, it will be deleted at deinstall time. |
253 | deleted when the package is deinstalled; this provides an | | | |
254 | explicit directory cleanup method. This directive should appear | | | |
255 | at the end of the package list. If more than one @@ddiirrrrmm direc- | | | |
256 | tives are used, the directories are removed in the order speci- | | | |
257 | fied. The _n_a_m_e directory will not be removed unless it is empty. | | | |
258 | @@ddiissppllaayy _n_a_m_e | | 248 | @@ddiissppllaayy _n_a_m_e |
259 | Declare _n_a_m_e as the file to be displayed at install time (see --DD | | 249 | Declare _n_a_m_e as the file to be displayed at install time (see --DD |
260 | above). | | 250 | above). |
261 | @@ppkkggddeepp _p_k_g_n_a_m_e | | 251 | @@ppkkggddeepp _p_k_g_n_a_m_e |
262 | Declare a dependency on the _p_k_g_n_a_m_e package. The _p_k_g_n_a_m_e package | | 252 | Declare a dependency on the _p_k_g_n_a_m_e package. The _p_k_g_n_a_m_e package |
263 | must be installed before this package may be installed, and this | | 253 | must be installed before this package may be installed, and this |
264 | package must be deinstalled before the _p_k_g_n_a_m_e package is dein- | | 254 | package must be deinstalled before the _p_k_g_n_a_m_e package is dein- |
265 | stalled. Multiple @@ppkkggddeepp directives may be used if the package | | 255 | stalled. Multiple @@ppkkggddeepp directives may be used if the package |
266 | depends on multiple other packages. | | 256 | depends on multiple other packages. |
267 | @@bbllddddeepp _p_k_g_n_a_m_e | | 257 | @@bbllddddeepp _p_k_g_n_a_m_e |
268 | Declare that this package was built with the exact version of | | 258 | Declare that this package was built with the exact version of |
269 | _p_k_g_n_a_m_e (since the @@ppkkggddeepp directive may contain wildcards or | | 259 | _p_k_g_n_a_m_e (since the @@ppkkggddeepp directive may contain wildcards or |
270 | relational package version information). | | 260 | relational package version information). |
| @@ -279,14 +269,14 @@ SSEEEE AALLSSOO | | | @@ -279,14 +269,14 @@ SSEEEE AALLSSOO |
279 | | | 269 | |
280 | HHIISSTTOORRYY | | 270 | HHIISSTTOORRYY |
281 | The ppkkgg__ccrreeaattee command first appeared in FreeBSD. | | 271 | The ppkkgg__ccrreeaattee command first appeared in FreeBSD. |
282 | | | 272 | |
283 | AAUUTTHHOORRSS | | 273 | AAUUTTHHOORRSS |
284 | Jordan Hubbard | | 274 | Jordan Hubbard |
285 | most of the work | | 275 | most of the work |
286 | John Kohl | | 276 | John Kohl |
287 | refined it for NetBSD | | 277 | refined it for NetBSD |
288 | Hubert Feyrer | | 278 | Hubert Feyrer |
289 | NetBSD wildcard dependency processing, pkgdb, pkg size recording | | 279 | NetBSD wildcard dependency processing, pkgdb, pkg size recording |
290 | etc. | | 280 | etc. |
291 | | | 281 | |
292 | NetBSD 5.0 July 28, 2008 NetBSD 5.0 | | 282 | NetBSD 5.0 April 24, 2009 NetBSD 5.0 |