diff options
author | wiz <wiz@pkgsrc.org> | 2014-12-30 15:17:28 +0000 |
---|---|---|
committer | wiz <wiz@pkgsrc.org> | 2014-12-30 15:17:28 +0000 |
commit | 099bc08b6a02019279e120c27472a56d2d0471ec (patch) | |
tree | eede2b55595f1109720b430cf27416f255ea9417 /pkgtools | |
parent | c847f599fae4c8f3ee0a5d8469a7564bab932fc0 (diff) | |
download | pkgsrc-099bc08b6a02019279e120c27472a56d2d0471ec.tar.gz |
regen (using 'mandoc -Ios=pkgsrc')
Diffstat (limited to 'pkgtools')
-rw-r--r-- | pkgtools/pkg_install/files/add/pkg_add.cat | 111 | ||||
-rw-r--r-- | pkgtools/pkg_install/files/admin/pkg_admin.cat | 58 | ||||
-rw-r--r-- | pkgtools/pkg_install/files/create/pkg_create.cat | 98 | ||||
-rw-r--r-- | pkgtools/pkg_install/files/delete/pkg_delete.cat | 100 | ||||
-rw-r--r-- | pkgtools/pkg_install/files/info/pkg_info.cat | 155 | ||||
-rw-r--r-- | pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in | 55 | ||||
-rw-r--r-- | pkgtools/pkg_install/files/lib/pkg_summary.cat | 40 | ||||
-rw-r--r-- | pkgtools/pkg_install/files/lib/pkgsrc.cat | 8 |
8 files changed, 314 insertions, 311 deletions
diff --git a/pkgtools/pkg_install/files/add/pkg_add.cat b/pkgtools/pkg_install/files/add/pkg_add.cat index 246953fb628..9836941194f 100644 --- a/pkgtools/pkg_install/files/add/pkg_add.cat +++ b/pkgtools/pkg_install/files/add/pkg_add.cat @@ -1,21 +1,21 @@ -PKG_ADD(1) NetBSD General Commands Manual PKG_ADD(1) +PKG_ADD(1) General Commands Manual PKG_ADD(1) NNAAMMEE - ppkkgg__aadddd -- a utility for installing and upgrading software package dis- - tributions + ppkkgg__aadddd -- a utility for installing and upgrading software package + distributions SSYYNNOOPPSSIISS - 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] - [--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 _._._. - [[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 _._._. + 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] + [--pp _p_r_e_f_i_x] + _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 _._._. DDEESSCCRRIIPPTTIIOONN The ppkkgg__aadddd command is used to extract and upgrade packages that have been previously created with the pkg_create(1) command. Packages are - prepared collections of pre-built binaries, documentation, configura- - tions, installation instructions and/or other files. ppkkgg__aadddd can recur- - sively install other packages that the current package depends on or - requires from both local disk and via FTP or HTTP. + prepared collections of pre-built binaries, documentation, + configurations, installation instructions and/or other files. ppkkgg__aadddd + can recursively install other packages that the current package depends + on or requires from both local disk and via FTP or HTTP. WWAARRNNIINNGG _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 @@ -23,14 +23,14 @@ WWAARRNNIINNGG _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 _p_a_c_k_a_g_e _f_i_l_e_s_. - _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_- - _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 - _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_, - _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 + _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_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 + _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_, + _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 _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 _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_, _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_)_, - @@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 + @@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 _t_o _e_x_a_m_i_n_e _t_h_e _p_a_c_k_a_g_e _f_i_l_e_. OOPPTTIIOONNSS @@ -38,11 +38,11 @@ OOPPTTIIOONNSS _p_k_g_-_n_a_m_e [_._._.] The named packages are installed. ppkkgg__aadddd will first try to use - _p_k_g_-_n_a_m_e as full URL or path name without any wildcard process- - ing. If that fails, ppkkgg__aadddd will try to match packages using - wildcard processing. If that fails as well and _p_k_g_-_n_a_m_e does not - contain any /, the entries of the PKG_PATH variable are searched - using the wildcard processing rules. + _p_k_g_-_n_a_m_e as full URL or path name without any wildcard + processing. If that fails, ppkkgg__aadddd will try to match packages + using wildcard processing. If that fails as well and _p_k_g_-_n_a_m_e + does not contain any /, the entries of the PKG_PATH variable are + searched using the wildcard processing rules. --AA Mark package as installed automatically, as dependency of another package. You can use @@ -60,24 +60,23 @@ OOPPTTIIOONNSS --ff Force installation to proceed even if prerequisite packages are not installed or the install script fails. Although ppkkgg__aadddd will still try to find and auto-install missing prerequisite packages, - a failure to find one will not be fatal. This flag also over- - rides the fatal error when the operating system or architecture - the package was built on differ from that of the host. + a failure to find one will not be fatal. This flag also + overrides the fatal error when the operating system or + architecture the package was built on differ from that of the + host. --DD Force updating even if the dependencies of depending packages are not satisfied by the new package. This is used by "make replace", after which one would typically replace the depending packages. - --II If an installation script exists for a given package, do not exe- - cute it. + --II If an installation script exists for a given package, do not + execute it. --KK _p_k_g___d_b_d_i_r Override the value of the PKG_DBDIR configuration option with the value _p_k_g___d_b_d_i_r. - --LL Don't add the package to any views after installation. - --mm Override the machine architecture returned by uname with _m_a_c_h_i_n_e. --nn Don't actually install a package, just report the steps that @@ -107,24 +106,19 @@ OOPPTTIIOONNSS --vv Turn on verbose output. - --WW _v_i_e_w_b_a_s_e - Passed down to pkg_view(1) for managed views. - - --ww _v_i_e_w - Passed down to pkg_view(1) for managed views. - One or more _p_k_g_-_n_a_m_e arguments may be specified, each being either a file containing the package (these usually ending with the ``.tgz'' suffix) or a URL pointing at a file available on an ftp or web site. Thus you may extract files directly from their anonymous ftp or WWW locations (e.g., - ppkkgg__aadddd ftp://ftp.NetBSD.org/pub/pkgsrc/pack- - ages/NetBSD/i386/3.1_2007Q2/shells/bash-3.2.9.tgz or ppkkgg__aadddd - http://www.example.org/packages/screen-4.0.tbz). Note: For ftp trans- - fers, if you wish to use _p_a_s_s_i_v_e _m_o_d_e ftp in such transfers, set the - variable _F_T_P___P_A_S_S_I_V_E___M_O_D_E to some value in your environment. Otherwise, - the more standard ACTIVE mode may be used. If ppkkgg__aadddd consistently fails - to fetch a package from a site known to work, it may be because you have - a firewall that demands the usage of _p_a_s_s_i_v_e _m_o_d_e ftp. + ppkkgg__aadddd + ftp://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/i386/3.1_2007Q2/shells/bash-3.2.9.tgz + or ppkkgg__aadddd http://www.example.org/packages/screen-4.0.tbz). Note: For + ftp transfers, if you wish to use _p_a_s_s_i_v_e _m_o_d_e ftp in such transfers, set + the variable _F_T_P___P_A_S_S_I_V_E___M_O_D_E to some value in your environment. + Otherwise, the more standard ACTIVE mode may be used. If ppkkgg__aadddd + consistently fails to fetch a package from a site known to work, it may + be because you have a firewall that demands the usage of _p_a_s_s_i_v_e _m_o_d_e + ftp. TTEECCHHNNIICCAALL DDEETTAAIILLSS ppkkgg__aadddd extracts each package's meta data (including the ``packing @@ -132,8 +126,9 @@ TTEECCHHNNIICCAALL DDEETTAAIILLSS extract the contents of the package: 1. A check is made to determine if the package or another version - of it is already recorded as installed. If it is, installa- - tion is terminated if the --uu or --UU options are not given. + of it is already recorded as installed. If it is, + installation is terminated if the --uu or --UU options are not + given. If the same version is installed and --UU is not given, it is marked as manually installed and process stops. If the --uu @@ -154,19 +149,19 @@ TTEECCHHNNIICCAALL DDEETTAAIILLSS is overridable with the --ff flag. 3. The package build information from _+_B_U_I_L_D___I_N_F_O is then checked - for USE_ABI_DEPENDS=NO (or IGNORE_RECOMMENDED). If the pack- - age was built with ABI dependency recommendations ignored, a - warning will be issued. + for USE_ABI_DEPENDS=NO (or IGNORE_RECOMMENDED). If the + package was built with ABI dependency recommendations ignored, + a warning will be issued. 4. A check is made to determine if the package conflicts (from @@ppkkggccffll directives, see pkg_create(1)) with an already - recorded as installed package or if an installed package con- - flicts with the package. If it is, installation is termi- - nated. + recorded as installed package or if an installed package + conflicts with the package. If it is, installation is + terminated. 5. The file list of the package is compared to the file lists of - the installed packages. If there is any overlap, the instal- - lation is terminated. + the installed packages. If there is any overlap, the + installation is terminated. 6. All package dependencies (from @@ppkkggddeepp directives, see pkg_create(1)) are read from the packing list. If any of @@ -186,8 +181,8 @@ TTEECCHHNNIICCAALL DDEETTAAIILLSS If the _i_n_s_t_a_l_l script exits with a non-zero status code, the installation is terminated. - 8. The files from the file list are extracted to the chosen pre- - fix. + 8. The files from the file list are extracted to the chosen + prefix. 9. If an _i_n_s_t_a_l_l script exists for the package, it is executed with the following arguments: @@ -204,10 +199,7 @@ TTEECCHHNNIICCAALL DDEETTAAIILLSS pkg_delete(1). Any package dependencies are recorded in the other packages' _+_R_E_Q_U_I_R_E_D___B_Y file. - 11. If the package is a depoted package, then add it to the regis- - tered by calling pkg_view(1) accordingly. - - 12. Finally, if we were upgrading a package, any _+_R_E_Q_U_I_R_E_D___B_Y file + 11. Finally, if we were upgrading a package, any _+_R_E_Q_U_I_R_E_D___B_Y file that was moved aside before upgrading was started is now moved back into place. @@ -225,8 +217,7 @@ TTEECCHHNNIICCAALL DDEETTAAIILLSS EENNVVIIRROONNMMEENNTT See pkg_install.conf(5) for options, that can also be specified using the - environment. Packages using views are also affected by the environment - variables documented for pkg_view(1). + environment. EEXXAAMMPPLLEESS In all cases, ppkkgg__aadddd will try to install binary packages listed in @@ -271,4 +262,4 @@ BBUUGGSS Sure to be others. -NetBSD 5.0 June 16, 2010 NetBSD 5.0 +pkgsrc December 27, 2014 pkgsrc diff --git a/pkgtools/pkg_install/files/admin/pkg_admin.cat b/pkgtools/pkg_install/files/admin/pkg_admin.cat index 768433633c3..4e751d493ff 100644 --- a/pkgtools/pkg_install/files/admin/pkg_admin.cat +++ b/pkgtools/pkg_install/files/admin/pkg_admin.cat @@ -1,4 +1,4 @@ -PKG_ADMIN(1) NetBSD General Commands Manual PKG_ADMIN(1) +PKG_ADMIN(1) General Commands Manual PKG_ADMIN(1) NNAAMMEE ppkkgg__aaddmmiinn -- perform various administrative tasks to the pkg system @@ -47,18 +47,12 @@ OOPPTTIIOONNSS The following commands are supported: - aadddd _p_k_g _._._. - For each listed package, write the absolute pathnames of the - files listed in its _+_C_O_N_T_E_N_T_S file together with the package they - belong to into the package database. This should be used only by - pkg_view(1). - aauuddiitt [--eess] [--tt _t_y_p_e] [_p_k_g] ... Check the listed installed packages for vulnerabilities. If no package is given, check all installed packages. If --ee is given, override the CHECK_END_OF_LIFE option from pkg_install.conf(5) - with "yes". If --ss is given, check the signature of the pkg-vul- - nerabilities file before using it. --tt restricts the reported + with "yes". If --ss is given, check the signature of the pkg- + vulnerabilities file before using it. --tt restricts the reported vulnerabilities to type _t_y_p_e. aauuddiitt--ppkkgg [--eess] [--tt _t_y_p_e] [_p_k_g] ... @@ -76,10 +70,10 @@ OOPPTTIIOONNSS the packages installed on the local machine against the checksum which was recorded in the _+_C_O_N_T_E_N_T_S files at package installation time. Symbolic links also have their integrity checked against - the recorded value at package installation time. If no addi- - tional argument is given, the files of all installed packages are - checked, else only the named packages will be checked (wildcards - can be used here, see pkg_info(1)). + the recorded value at package installation time. If no + additional argument is given, the files of all installed packages + are checked, else only the named packages will be checked + (wildcards can be used here, see pkg_info(1)). The packages' _+_C_O_N_T_E_N_T_S files will be parsed and the checksum will be checked for every file found. A warning message is @@ -90,8 +84,8 @@ OOPPTTIIOONNSS cchheecckk--lliicceennssee _c_o_n_d_i_t_i_o_n Check if _c_o_n_d_i_t_i_o_n can be fulfilled with the currently set of - accepted licenses. Prints either yes or no to stdout if the con- - dition can be parsed, otherwise it exits with error. + accepted licenses. Prints either yes or no to stdout if the + condition can be parsed, otherwise it exits with error. cchheecckk--ppkkgg--vvuullnneerraabbiilliittiieess [--ss] _f_i_l_e Check format and hashes in the pkg-vulnerabilities file _f_i_l_e. If @@ -109,11 +103,6 @@ OOPPTTIIOONNSS Print the current value of _v_a_r_i_a_b_l_e as used after parsing the configuration file. - ddeelleettee _p_k_g _._._. - For each listed package, remove all file entries in the package - database that belong to the package. This should be used only by - pkg_view(1). - dduummpp Dump the contents of the package database, similar to ppkkgg__iinnffoo --FF. Columns are printed for the key field used in the pkgdb - the filename -, and the data field - the package the file belongs @@ -129,19 +118,19 @@ OOPPTTIIOONNSS ffiinnddbbeesstt _p_a_t_t_e_r_n _._._. Search the entries of PKG_PATH for packages matching _p_a_t_t_e_r_n. Print the URL of the best matching package to stdout for each - pattern. If a pattern is not matched, it is skipped and the com- - mand will return a failure. + pattern. If a pattern is not matched, it is skipped and the + command will return a failure. llssaallll _/_d_i_r_/_p_k_g_p_a_t_t_e_r_n llssbbeesstt _/_d_i_r_/_p_k_g_p_a_t_t_e_r_n List all/best package matching pattern in the given directory - _/_d_i_r. If the --dd flag is given, then that directory path over- - rides _/_d_i_r. Can be used to work around limitations of /bin/sh - and other filename globbing mechanisms. This option implements - matching of pkg-wildcards against arbitrary files and directo- - ries, useful mainly in the build system itself. See pkg_info(1) - for a description of the pattern. + _/_d_i_r. If the --dd flag is given, then that directory path + overrides _/_d_i_r. Can be used to work around limitations of + /bin/sh and other filename globbing mechanisms. This option + implements matching of pkg-wildcards against arbitrary files and + directories, useful mainly in the build system itself. See + pkg_info(1) for a description of the pattern. Example: @@ -166,8 +155,9 @@ OOPPTTIIOONNSS Returns true if _p_k_g matches _p_a_t_t_e_r_n, otherwise returns false. rreebbuuiilldd - Rebuild the package database mapping from scratch. This option - is only intended for recovery after system crashes during package + Rebuild the package database mapping from scratch, using the + _+_C_O_N_T_E_N_T_S files of the installed packages. This option is only + intended for recovery after system crashes during package installation and removal. rreebbuuiilldd--ttrreeee @@ -201,11 +191,11 @@ EENNVVIIRROONNMMEENNTT environment. FFIILLEESS - /var/db/pkg/pkgdb.byfile.db - /var/db/pkg/<pkg>/+CONTENTS + _/_v_a_r_/_d_b_/_p_k_g_/_p_k_g_d_b_._b_y_f_i_l_e_._d_b + _/_v_a_r_/_d_b_/_p_k_g_/_<_p_k_g_>_/_+_C_O_N_T_E_N_T_S SSEEEE AALLSSOO - pkg_add(1), pkg_create(1), pkg_delete(1), pkg_info(1), pkg_view(1), + pkg_add(1), pkg_create(1), pkg_delete(1), pkg_info(1), pkg_install.conf(5), pkgsrc(7) HHIISSTTOORRYY @@ -214,4 +204,4 @@ HHIISSTTOORRYY AAUUTTHHOORRSS The ppkkgg__aaddmmiinn command was written by Hubert Feyrer. -NetBSD 5.0 January 22, 2010 NetBSD 5.0 +pkgsrc December 27, 2014 pkgsrc diff --git a/pkgtools/pkg_install/files/create/pkg_create.cat b/pkgtools/pkg_install/files/create/pkg_create.cat index 31c45b7075d..c884c7e0449 100644 --- a/pkgtools/pkg_install/files/create/pkg_create.cat +++ b/pkgtools/pkg_install/files/create/pkg_create.cat @@ -1,14 +1,14 @@ -PKG_CREATE(1) NetBSD General Commands Manual PKG_CREATE(1) +PKG_CREATE(1) General Commands Manual PKG_CREATE(1) NNAAMMEE ppkkgg__ccrreeaattee -- a utility for creating software package distributions SSYYNNOOPPSSIISS - 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] + 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] [--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] [--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] - [--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] - [--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] + [--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] + [--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] --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 DDEESSCCRRIIPPTTIIOONN @@ -17,8 +17,8 @@ DDEESSCCRRIIPPTTIIOONN description and command line arguments for the creation of a package are not really meant to be human-generated, though it is easy enough to do so. It is more expected that you will use a front-end tool for the job - rather than muddling through it yourself. Nonetheless, a short descrip- - tion of the input syntax is included in this document. + rather than muddling through it yourself. Nonetheless, a short + description of the input syntax is included in this document. OOPPTTIIOONNSS The following command line options are supported: @@ -26,28 +26,28 @@ OOPPTTIIOONNSS --BB _b_u_i_l_d_-_i_n_f_o_-_f_i_l_e Install the file _b_u_i_l_d_-_i_n_f_o_-_f_i_l_e so that users of binary packages can see what make(1) definitions were used to control the build - when creating the binary package. This allows various build def- - initions to be retained in a binary package and viewed wherever - it is installed, using pkg_info(1). + when creating the binary package. This allows various build + definitions to be retained in a binary package and viewed + wherever it is installed, using pkg_info(1). --bb _b_u_i_l_d_-_v_e_r_s_i_o_n_-_f_i_l_e - 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- - ages can see what versions of the files used to control the build - were used when creating the binary package. This allows some - fine-grained version control information to be retained in a + Install the file _b_u_i_l_d_-_v_e_r_s_i_o_n_-_f_i_l_e so that users of binary + packages can see what versions of the files used to control the + build were used when creating the binary package. This allows + some fine-grained version control information to be retained in a binary package and viewed wherever it is installed, using pkg_info(1). --CC _c_p_k_g_s Set the initial package conflict list to _c_p_k_g_s. This is assumed to be a whitespace separated list of package names and is meant - as a convenient shorthand for specifying multiple @@ppkkggccffll direc- - tives in the packing list (see PACKING LIST DETAILS section + as a convenient shorthand for specifying multiple @@ppkkggccffll + directives in the packing list (see PACKING LIST DETAILS section below). --cc _[_-_]_d_e_s_c - Fetch package (one line description) from file _d_e_s_c or, if pre- - ceded by --, the argument itself. This string should also give + Fetch package (one line description) from file _d_e_s_c or, if + preceded by --, the argument itself. This string should also give some idea of which version of the product (if any) the package represents. @@ -59,8 +59,6 @@ OOPPTTIIOONNSS Fetch long description for package from file _d_e_s_c or, if preceded by --, the argument itself. - --EE Add an empty views file to the package. - --FF _c_o_m_p_r_e_s_s_i_o_n Use _c_o_m_p_r_e_s_s_i_o_n as compression algorithm. This overrides the heuristic to guess the compression type from the output name. @@ -93,8 +91,8 @@ OOPPTTIIOONNSS invoked automatically when the package is later (if ever) de- installed. - --ll Check that any symbolic links which are to be placed in the pack- - age are relative to the current prefix. This means using + --ll Check that any symbolic links which are to be placed in the + package are relative to the current prefix. This means using unlink(2) and symlink(2) to remove and re-link any symbolic links which are targeted at full path names. @@ -137,8 +135,8 @@ OOPPTTIIOONNSS --ss _s_i_z_e_-_p_k_g_-_f_i_l_e Store the given file for later querying with the pkg_info(1) --ss flag. The file is expected to contain the size (in bytes) of all - files of this package added up and stored as a ASCII string, ter- - minated by a newline. + files of this package added up and stored as a ASCII string, + terminated by a newline. --tt _t_e_m_p_l_a_t_e Use _t_e_m_p_l_a_t_e as the input to mktemp(3). By default, this is the @@ -147,8 +145,8 @@ OOPPTTIIOONNSS Be sure to leave some number of `X' characters for mktemp(3) to fill in with a unique ID. - --UU Do not update the package file database with any file informa- - tion. + --UU Do not update the package file database with any file + information. --uu _o_w_n_e_r Make _o_w_n_e_r the default owner instead of extracting it from the @@ -162,18 +160,18 @@ PPAACCKKIINNGG LLIISSTT DDEETTAAIILLSS The (packing list) format (see --ff) is fairly simple, being nothing more than a single column of filenames to include in the package. However, since absolute pathnames are generally a bad idea for a package that - could be installed potentially anywhere, there is another method of spec- - ifying where things are supposed to go and, optionally, what ownership - and mode information they should be installed with. This is done by - embedding specialized command sequences in the packing list. Briefly - described, these sequences are: + could be installed potentially anywhere, there is another method of + specifying where things are supposed to go and, optionally, what + ownership and mode information they should be installed with. This is + done by embedding specialized command sequences in the packing list. + Briefly described, these sequences are: @@ccwwdd _d_i_r_e_c_t_o_r_y Set the internal directory pointer to point to _d_i_r_e_c_t_o_r_y. All subsequent filenames will be assumed relative to this directory. Note: @@ccdd is also an alias for this command. @@ssrrcc _d_i_r_e_c_t_o_r_y - This command is supported for compatibility only. It was for- - merly used to override @@ccwwdd during package creation. + This command is supported for compatibility only. It was + formerly used to override @@ccwwdd during package creation. @@eexxeecc _c_o_m_m_a_n_d Execute _c_o_m_m_a_n_d as part of the unpacking process. If _c_o_m_m_a_n_d contains any of the following sequences somewhere in it, they @@ -185,9 +183,9 @@ PPAACCKKIINNGG LLIISSTT DDEETTAAIILLSS %%DD Expand to the current directory prefix, as set with @@ccwwdd, in the example case _/_u_s_r_/_l_o_c_a_l. %%BB Expand to the (basename) of the fully qualified filename, - that is the current directory prefix, plus the last file- - spec, minus the trailing filename. In the example case, - that would be _/_u_s_r_/_l_o_c_a_l_/_b_i_n. + that is the current directory prefix, plus the last + filespec, minus the trailing filename. In the example + case, that would be _/_u_s_r_/_l_o_c_a_l_/_b_i_n. %%ff Expand to the (filename) part of the fully qualified name, or the converse of %%BB, being in the example case, _e_m_a_c_s. @@ -197,17 +195,17 @@ PPAACCKKIINNGG LLIISSTT DDEETTAAIILLSS not executed during the package add, as @@eexxeecc is, but rather when the package is deleted. This is useful for deleting links and other ancillary files that were created as a result of adding the - package, but not directly known to the package's table of con- - tents (and hence not automatically removable). The advantage of - using @@uunneexxeecc over a deinstallation script is that you can use + package, but not directly known to the package's table of + contents (and hence not automatically removable). The advantage + of using @@uunneexxeecc over a deinstallation script is that you can use the (special sequence expansion) to get at files regardless of where they've been potentially redirected (see --pp). @@mmooddee _m_o_d_e Set default permission for all subsequently extracted files to _m_o_d_e. Format is the same as that used by the cchhmmoodd command (well, considering that it's later handed off to it, that's no - surprise). Use without an arg to set back to default (extrac- - tion) permissions. + surprise). Use without an arg to set back to default + (extraction) permissions. @@ooppttiioonn _o_p_t_i_o_n Set internal package options, the only currently supported one being _p_r_e_s_e_r_v_e, which tells pkg_add to move any existing files @@ -222,9 +220,9 @@ PPAACCKKIINNGG LLIISSTT DDEETTAAIILLSS to _g_r_o_u_p. Use without an arg to set back to default (extraction) group ownership. @@ccoommmmeenntt _s_t_r_i_n_g - Embed a comment in the packing list. Useful in trying to docu- - ment some particularly hairy sequence that may trip someone up - later. + Embed a comment in the packing list. Useful in trying to + document some particularly hairy sequence that may trip someone + up later. @@iiggnnoorree Used internally to tell extraction to ignore the next file (don't copy it anywhere), as it's used for some special purpose. @@ -249,17 +247,17 @@ PPAACCKKIINNGG LLIISSTT DDEETTAAIILLSS @@ppkkggddeepp _p_k_g_n_a_m_e Declare a dependency on the _p_k_g_n_a_m_e package. The _p_k_g_n_a_m_e package must be installed before this package may be installed, and this - package must be deinstalled before the _p_k_g_n_a_m_e package is dein- - stalled. Multiple @@ppkkggddeepp directives may be used if the package - depends on multiple other packages. + package must be deinstalled before the _p_k_g_n_a_m_e package is + deinstalled. Multiple @@ppkkggddeepp directives may be used if the + package depends on multiple other packages. @@bbllddddeepp _p_k_g_n_a_m_e Declare that this package was built with the exact version of _p_k_g_n_a_m_e (since the @@ppkkggddeepp directive may contain wildcards or relational package version information). @@ppkkggccffll _p_k_g_c_f_l_n_a_m_e - Declare a conflict with the _p_k_g_c_f_l_n_a_m_e package, as the two pack- - ages contain references to the same files, and so cannot co-exist - on the same system. + Declare a conflict with the _p_k_g_c_f_l_n_a_m_e package, as the two + packages contain references to the same files, and so cannot co- + exist on the same system. EENNVVIIRROONNMMEENNTT See pkg_install.conf(5) for options, that can also be specified using the @@ -281,4 +279,4 @@ AAUUTTHHOORRSS NetBSD wildcard dependency processing, pkgdb, pkg size recording etc. -NetBSD 5.0 January 20, 2010 NetBSD 5.0 +pkgsrc December 27, 2014 pkgsrc diff --git a/pkgtools/pkg_install/files/delete/pkg_delete.cat b/pkgtools/pkg_install/files/delete/pkg_delete.cat index 3cded7fdca4..771b7d3d1b5 100644 --- a/pkgtools/pkg_install/files/delete/pkg_delete.cat +++ b/pkgtools/pkg_install/files/delete/pkg_delete.cat @@ -1,35 +1,34 @@ -PKG_DELETE(1) NetBSD General Commands Manual PKG_DELETE(1) +PKG_DELETE(1) General Commands Manual PKG_DELETE(1) NNAAMMEE - ppkkgg__ddeelleettee -- a utility for deleting previously installed software pack- - age distributions + ppkkgg__ddeelleettee -- a utility for deleting previously installed software + package distributions SSYYNNOOPPSSIISS 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] _p_k_g_-_n_a_m_e _._._. DDEESSCCRRIIPPTTIIOONN - The ppkkgg__ddeelleettee command is used to delete packages that have been previ- - ously installed with the pkg_add(1) command. The given packages are - sorted, so that the dependencies of a package are deleted after the pack- - age. Before any action is executed, ppkkgg__ddeelleettee checks for packages that - are marked as pprreesseerrvveedd or have depending packages left. If the --kk flag - is given, preserved packages are removed from the list of packages to - remove. Unless the --ff flag is given, ppkkgg__ddeelleettee stops on the first - error. + The ppkkgg__ddeelleettee command is used to delete packages that have been + previously installed with the pkg_add(1) command. The given packages are + sorted, so that the dependencies needed by a package are deleted after + the package. Before any action is executed, ppkkgg__ddeelleettee checks for + packages that are marked as pprreesseerrvveedd or have depending packages left. + If the --kk flag is given, preserved packages are skipped and not removed. + Unless the --ff flag is given, ppkkgg__ddeelleettee stops on the first error. WWAARRNNIINNGG _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 _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 _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_. - _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_- - _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 + _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_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 _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 _<_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 _+_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 _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 - 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_. + _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_. OOPPTTIIOONNSS The following command line options are supported: @@ -38,24 +37,25 @@ OOPPTTIIOONNSS The named packages are deinstalled, wildcards can be used, see pkg_info(1). If no version is given, the one currently installed will be removed. If the --FF flag is given, one or more (absolute) - filenames may be specified and the Package Database will be con- - sulted for the package to which the given file belongs. These + filenames may be specified and the package database will be + consulted for the package to which the given file belongs. These packages are then deinstalled. --AA Recursively remove all automatically installed packages that were - needed by the given packages and are no longer required. See - also the --RR flag. + needed by the given packages and are no longer required. Does + not remove manually installed packages; see also the --RR flag. --DD If a deinstallation script exists for a given package, do not execute it. - --FF Any pkg-name given will be interpreted as pathname which is sub- - sequently transformed in a (real) package name via the Package - Database. That way, packages can be deleted by giving a filename + --FF Any _p_k_g_-_n_a_m_e given will be interpreted as pathname which is + subsequently transformed in a (real) package name via the package + database. That way, packages can be deleted by giving a filename instead of the package-name. --ff Force removal of the package, even if a dependency is recorded or - the deinstall script fails. + the deinstall script fails. This might break the package + database; see pkg_admin(1) on how to repair it. --ffff Force removal of the package, even if the package is marked as a pprreesseerrvveedd package. Note that this is a dangerous operation. See @@ -67,20 +67,20 @@ OOPPTTIIOONNSS --kk Silently skip all packages that are marked as pprreesseerrvveedd. - --NN Remove the package's registration and its entries from the pack- - age database, but leave the files installed. Don't run any dein- - stall scripts or @unexec lines either. + --NN Remove the package's registration and its entries from the + package database, but leave the files installed. Don't run any + deinstall scripts or @@uunneexxeecc lines either. --nn Don't actually deinstall a package, just report the steps that - would be taken if it were. + would be taken. - --OO Only delete the package's entries from the package database, do + --OO Only delete the package's entries from the package database; do not touch the package or its files itself. - --pp _d_e_s_t_d_i_r + --PP _d_e_s_t_d_i_r Prefix all file and directory names with _d_e_s_t_d_i_r. For packages without install scripts this has the same behavior as using - chroot. + chroot(8). --pp _p_r_e_f_i_x Set _p_r_e_f_i_x as the directory in which to delete files from any @@ -89,8 +89,8 @@ OOPPTTIIOONNSS location by pkg_add(1). --RR Recursively remove all packages that were needed by the given - packages and that have no other dependencies left. This option - overrides the --AA flag. + packages and are no longer required. This option overrides the + --AA flag. --rr Recursively remove all packages that require one of the packages given. @@ -113,34 +113,32 @@ TTEECCHHNNIICCAALL DDEETTAAIILLSS given). If a filename is given instead of a package name, the package of which - the given file belongs to can be deleted if the --FF Flag is given. The - filename needs to be absolute, see the output produced by the pkg_info + the given file belongs to can be deleted if the --FF flag is given. The + filename needs to be absolute, see the output produced by the pkg_info(1) --aaFF command. If a ddeeiinnssttaallll script exists for the package, it is executed before and after any files are removed. It is this script's responsibility to clean up any additional messy details around the package's installation, since - all ppkkgg__ddeelleettee knows how to do is delete the files created in the origi- - nal distribution. The ddeeiinnssttaallll script is called as: - ddeeiinnssttaallll <_p_k_g_-_n_a_m_e> _V_I_E_W_-_D_E_I_N_S_T_A_L_L - before removing the package from a view, and as: + all ppkkgg__ddeelleettee knows how to do is delete the files created in the + original distribution. The ddeeiinnssttaallll script is called as: ddeeiinnssttaallll <_p_k_g_-_n_a_m_e> _D_E_I_N_S_T_A_L_L before deleting all files and as: ddeeiinnssttaallll <_p_k_g_-_n_a_m_e> _P_O_S_T_-_D_E_I_N_S_T_A_L_L - 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 - _P_O_S_T_-_D_E_I_N_S_T_A_L_L lets you potentially write only one program/script that - handles all aspects of installation and deletion. + 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 + lets you potentially write only one program/script that handles all + aspects of installation and deletion. All scripts are called with the environment variable PKG_PREFIX set to the installation prefix (see the --pp option above). This allows a package - author to write a script that reliably performs some action on the direc- - tory where the package is installed, even if the user might have changed - it by specifying the --pp option when running ppkkgg__ddeelleettee or pkg_add(1). - The scripts are also called with the PKG_METADATA_DIR environment vari- - able set to the location of the _+_* meta-data files, and with the - PKG_REFCOUNT_DBDIR environment variable set to the location of the pack- - age reference counts database directory. If the --PP flag was given to - ppkkgg__ddeelleettee, PKG_DESTDIR will be set to _d_e_s_t_d_i_r. + author to write a script that reliably performs some action on the + directory where the package is installed, even if the user might have + changed it by specifying the --pp option when running ppkkgg__ddeelleettee or + pkg_add(1). The scripts are also called with the PKG_METADATA_DIR + environment variable set to the location of the _+_* meta-data files, and + with the PKG_REFCOUNT_DBDIR environment variable set to the location of + the package reference counts database directory. If the --PP flag was + given to ppkkgg__ddeelleettee, PKG_DESTDIR will be set to _d_e_s_t_d_i_r. EENNVVIIRROONNMMEENNTT See pkg_install.conf(5) for options, that can also be specified using the @@ -159,7 +157,7 @@ AAUUTTHHOORRSS NetBSD wildcard dependency processing, pkgdb, recursive "down" delete, etc. Joerg Sonnenberger - Rewrote most of the code to compute correct order of deinstalla- - tion and to improve error handling. + Rewrote most of the code to compute correct order of + deinstallation and to improve error handling. -NetBSD 5.0 January 20, 2010 NetBSD 5.0 +pkgsrc December 27, 2014 pkgsrc diff --git a/pkgtools/pkg_install/files/info/pkg_info.cat b/pkgtools/pkg_install/files/info/pkg_info.cat index ce94095d145..0d1885ff132 100644 --- a/pkgtools/pkg_install/files/info/pkg_info.cat +++ b/pkgtools/pkg_install/files/info/pkg_info.cat @@ -1,10 +1,10 @@ -PKG_INFO(1) NetBSD General Commands Manual PKG_INFO(1) +PKG_INFO(1) General Commands Manual PKG_INFO(1) NNAAMMEE ppkkgg__iinnffoo -- a utility for displaying information on software packages SSYYNNOOPPSSIISS - ppkkgg__iinnffoo [--BBbbccDDddFFffhhIIiikkLLmmNNnnppqqrrRRSSssVVvvXX] [--ee _p_a_c_k_a_g_e] [--EE _p_a_c_k_a_g_e] + ppkkgg__iinnffoo [--BBbbccDDddFFffhhIIiikkLLmmNNnnppqqRRrrSSssVVvvXX] [--EE _p_k_g_-_n_a_m_e] [--ee _p_k_g_-_n_a_m_e] [--KK _p_k_g___d_b_d_i_r] [--ll _p_r_e_f_i_x] _p_k_g_-_n_a_m_e _._._. ppkkgg__iinnffoo [--aa | --uu] [flags] ppkkgg__iinnffoo [--QQ _v_a_r_i_a_b_l_e] _p_k_g_-_n_a_m_e _._._. @@ -14,16 +14,16 @@ DDEESSCCRRIIPPTTIIOONN may be either packed up in files or already installed on the system with the pkg_create(1) command. - The _p_k_g_-_n_a_m_e may be the name of an installed package (with our without + The _p_k_g_-_n_a_m_e may be the name of an installed package (with or without version), a pattern matching several installed packages (see the _P_A_C_K_A_G_E _W_I_L_D_C_A_R_D_S section for a description of possible patterns), the pathname - to a binary package, a filename belonging to an installed package (if --FF - is also given), or a URL to an ftp-available package. + to a binary package, a filename belonging to an installed package (with + --FF), or a URL to an FTP-available package. - The following command-line options are supported: + The following command line options are available: --aa Show information for all currently installed packages. See also - --uu. + --uu. When neither --aa nor --uu is given, the former is assumed. --BB Show some of the important definitions used when building the binary package (the ``Build information'') for each package. @@ -31,10 +31,10 @@ DDEESSCCRRIIPPTTIIOONN can be queried, too. In particular, _a_u_t_o_m_a_t_i_c tells if a package was installed automatically as a dependency of another package. - --bb Show the NetBSD RCS Id strings from the files used in the con- - struction of the binary package (the "Build version") for each - package. These files are the package Makefile, any patch files, - any checksum files, and the packing list file. + --bb Show the NetBSD RCS Id strings from the files used in the + construction of the binary package (the ``Build version'') for + each package. These files are the package Makefile, any patch + files, any checksum files, and the packing list file. --cc Show the one-line comment field for each package. @@ -43,29 +43,32 @@ DDEESSCCRRIIPPTTIIOONN --dd Show the long-description field for each package. --EE _p_k_g_-_n_a_m_e - This option allows you to test for the existence of a given pack- - age. If a package identified by _p_k_g_-_n_a_m_e is currently installed, - return code is 0, otherwise 1. The name of the best matching - package found installed is printed to stdout unless turned off - using the --qq option. _p_k_g_-_n_a_m_e can contain wildcards (see the - _P_A_C_K_A_G_E _W_I_L_D_C_A_R_D_S section below). + This option allows you to test for the existence of a given + package. If a package identified by _p_k_g_-_n_a_m_e is currently + installed, return code is 0, otherwise 1. The name of the best + matching package found installed is printed to stdout unless + turned off using the --qq option. _p_k_g_-_n_a_m_e can contain wildcards + (see the _P_A_C_K_A_G_E _W_I_L_D_C_A_R_D_S section below). --ee _p_k_g_-_n_a_m_e - This option allows you to test for the existence of a given pack- - age. If a package identified by _p_k_g_-_n_a_m_e is currently installed, - return code is 0, otherwise 1. The names of any package(s) found - installed are printed to stdout unless turned off using the --qq - option. _p_k_g_-_n_a_m_e can contain wildcards (see the _P_A_C_K_A_G_E - _W_I_L_D_C_A_R_D_S section below). - - --FF Interpret any pkg-name given as filename, and translate it to a - package name using the Package Database. This can be used to - query information on a per-file basis, e.g. in conjunction with - the --ee flag to find out which package a file belongs to. + This option allows you to test for the existence of a given + package. If a package identified by _p_k_g_-_n_a_m_e is currently + installed, return code is 0, otherwise 1. The names of any + package(s) found installed are printed to stdout unless turned + off using the --qq option. _p_k_g_-_n_a_m_e can contain wildcards (see the + _P_A_C_K_A_G_E _W_I_L_D_C_A_R_D_S section below). + + --FF Interpret any _p_k_g_-_n_a_m_e given as filename, and query information + on the package that file belongs to. This can be used to query + information on a per-file basis. See the _T_E_C_H_N_I_C_A_L _D_E_T_A_I_L_S + section below for more information. --ff Show the packing list instructions for each package. - --II Show the index entry for each package. + --hh Print usage message and exit. + + --II Show the index entry for each package. This option is assumed + when no arguments or relevant flags are specified. --ii Show the install script (if any) for each package. @@ -77,26 +80,28 @@ DDEESSCCRRIIPPTTIIOONN --LL Show the files within each package. This is different from just viewing the packing list, since full pathnames for everything are - generated. Files that were created dynamically during installa- - tion of the package are not listed. - - --ll _s_t_r Prefix each information category header (see --qq) shown with _s_t_r. - This is primarily of use to front-end programs that want to - request a lot of different information fields at once for a pack- - age, but don't necessary want the output intermingled in such a - way that they can't organize it. This lets you add a special + generated. Files that were created dynamically during + installation of the package are not listed. + + --ll _p_r_e_f_i_x + Prefix each information category header (see --qq) shown with + _p_r_e_f_i_x. This is primarily of use to front-end programs that want + to request a lot of different information fields at once for a + package, but don't necessary want the output intermingled in such + a way that they can't organize it. This lets you add a special token to the start of each field. --mm Show the mtree file (if any) for each package. - --NN Show which packages each package was built with (exact dependen- - cies), if any. + --NN Show which packages each package was built with (exact + dependencies), if any. --nn Show which packages each package needs (depends upon), if any. --pp Show the installation prefix for each package. - --QQ Show the definition of _v_a_r_i_a_b_l_e from the build information for + --QQ _v_a_r_i_a_b_l_e + Show the definition of _v_a_r_i_a_b_l_e from the build information for each package. An empty string is returned if no such variable definition is found for the package(s). @@ -114,7 +119,7 @@ DDEESSCCRRIIPPTTIIOONN --ss Show the size of this package in bytes. The size is calculated by adding up the size of each file of the package. - --uu Show information for all user-installed packages. Automatically + --uu Show information for all user-installed packages: automatically installed packages (as dependencies of other packages) are not displayed. See also --aa. @@ -132,40 +137,52 @@ TTEECCHHNNIICCAALL DDEETTAAIILLSS line, or from already installed package information in _<_P_K_G___D_B_D_I_R_>_/_<_p_k_g_-_n_a_m_e_>. - A filename can be given instead of a (installed) package name to query - information on the package this file belongs to. This filename is then - resolved to a package name using the Package Database. For this transla- - tion to take place, the --FF flag must be given. The filename must be - absolute, compare the output of pkg_info --aaFF. + When the --FF option is used, a filename can be given instead of a package + name to query information on the (installed) package that file belongs + to. The filename is resolved to a package name using the package + database. The filename must be absolute, as in the output of + pkg_info -aF. + For example, + pkg_info -eF /path/to/file + can be used to display the package the given file belongs to, and + pkg_info -LF /path/to/file + can be used to display all files belonging to the package the given file + belongs to. PPAACCKKAAGGEE WWIILLDDCCAARRDDSS - In the places where a package name/version is expected, e.g. for the --ee - switch, several forms can be used. Either use a package name with or + In the places where a package name/version is expected, e.g., for the --ee + option, several forms can be used. Either use a package name with or without version, or specify a package wildcard that gets matched against all installed packages. - Package wildcards use fnmatch(3). In addition, csh(1) style {,} alter- - nates have been implemented. Package version numbers can also be matched - in a relational manner using the _>_=, _<_=, _>, and _< operators. For exam- - ple, _p_k_g___i_n_f_o _-_e _'_n_a_m_e_>_=_1_._3_' will match versions 1.3 and later of the - _n_a_m_e package. Additionally, ranges can be defined by giving a lower - bound with > or >= and an upper bound with < or <=. The lower bound has - to come first. For example, _p_k_g___i_n_f_o _-_e _'_n_a_m_e_>_=_1_._3_<_2_._0_' will match ver- - sions 1.3 (inclusive) to 2.0 (exclusive) of package _n_a_m_e. + Package wildcards use fnmatch(3). In addition, csh(1) style {,} + alternates have been implemented. Package version numbers can also be + matched in a relational manner using the ``>='', ``<='', ``>'', and ``<'' + operators. For example, + pkg_info -e 'name>=1.3' + will match versions 1.3 and later of the ``name'' package. (Make sure to + use shell quoting.) Additionally, ranges can be defined, by giving both + a lower bound (with ``>'' or ``>='') as well as an upper bound (with + ``<'' or ``<=''). The lower bound has to come first. For example, + pkg_info -e 'name>=1.3<2.0' + will match versions 1.3 (inclusive) to 2.0 (exclusive) of package + ``name''. The collating sequence of the various package version numbers is unusual, but strives to be consistent. The magic string ``alpha'' equates to - _a_l_p_h_a _v_e_r_s_i_o_n and sorts before a beta version. The magic string ``beta'' - equates to _b_e_t_a _v_e_r_s_i_o_n and sorts before a release candidate. The magic - 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. - The magic string ``pre'', short for ``pre-release'', is a synonym for - ``rc''. For example, _n_a_m_e_-_1_._3_r_c_3 will sort before _n_a_m_e_-_1_._3 and after - _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 - they both sort before _n_a_m_e_-_1_._3_r_c_1. In addition, alphabetic characters - sort in the same place as their numeric counterparts, so that _n_a_m_e_-_1_._2_e - has the same sorting value as _n_a_m_e_-_1_._2_._5 The magic string ``pl'' equates - to a _p_a_t_c_h _l_e_v_e_l and has the same value as a dot in the dewey-decimal - ordering schemes. + ``alpha version'', and sorts before a beta version. The magic string + ``beta'' equates to ``beta version'', and sorts before a release + candidate. The magic string ``rc'' equates to ``release candidate'', and + sorts before a release. The magic string ``pre'', short for + ``pre-release'', is a synonym for ``rc''. For example, + ``name-1.3alpha2'' will sort before ``name-1.3beta1'', and they both sort + before ``name-1.3rc1''. Similarly, ``name-1.3rc3'' will sort before + ``name-1.3'', and after ``name-1.2.9''. The magic string ``pl'' equates + to ``patch level'', and has the same value as a dot (`.') in the dewey- + decimal ordering schemes, as does the underscore (`_'). Additionally, + alphabetic characters sort in the same place as their numeric + counterparts, so that ``name-1.2e'' has the same sorting value as + ``name-1.2.5''. EENNVVIIRROONNMMEENNTT See pkg_install.conf(5) for options, that can also be specified using the @@ -182,6 +199,6 @@ AAUUTTHHOORRSS refined it for NetBSD Hubert Feyrer NetBSD wildcard dependency processing, pkgdb, depends displaying, - pkg size display etc. + pkg size display, and more. -NetBSD 5.0 January 22, 2010 NetBSD 5.0 +pkgsrc December 14, 2012 pkgsrc diff --git a/pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in b/pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in index 2d28008c147..294e8c2a26a 100644 --- a/pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in +++ b/pkgtools/pkg_install/files/lib/pkg_install.conf.cat.in @@ -1,4 +1,4 @@ -PKG_INSTALL.CONF(5) NetBSD File Formats Manual PKG_INSTALL.CONF(5) +PKG_INSTALL.CONF(5) File Formats Manual PKG_INSTALL.CONF(5) NNAAMMEE ppkkgg__iinnssttaallll..ccoonnff -- configuration file for package installation tools @@ -18,21 +18,21 @@ DDEESSCCRRIIPPTTIIOONN The following variables are supported: ACCEPTABLE_LICENSES - Space-separared list of licenses packages are allowed to carry. + Space-separated list of licenses packages are allowed to carry. License names are case-sensitive. ACTIVE_FTP Force the use of active FTP. CACHE_INDEX - Cache directory listenings in memory. This avoids retransfers of + Cache directory listings in memory. This avoids retransfers of the large directory index for HTTP and is enabled by default. CERTIFICATE_ANCHOR_PKGS Path to the file containing the certificates used for validating binary packages. A package is trusted when a certificate chain - ends in one of the certificates contained in this file. The cer- - tificates must be PEM-encoded. + ends in one of the certificates contained in this file. The + certificates must be PEM-encoded. CERTIFICATE_ANCHOR_PKGVULN 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 @@ -60,6 +60,10 @@ DDEESSCCRRIIPPTTIIOONN During vulnerability checks, consider packages that have reached end-of-life as vulnerable. This option is enabled by default. + CHECK_OSABI + If "no", osabi package does not check OS version. The default is + "yes". + CHECK_VULNERABILITIES Check for vulnerabilities when installing packages. Supported values are: @@ -74,19 +78,20 @@ DDEESSCCRRIIPPTTIIOONN of vulnerable packages. CONFIG_CACHE_CONNECTIONS - Limit the global connection cache to this value. For FTP this is - the number of sessions without active command. For HTTP this is - the number of connections open with keep-alive. + Limit the global connection cache to this value. For FTP, this + is the number of sessions without active command. For HTTP, this + is the number of connections open with keep-alive. CONFIG_CACHE_CONNECTIONS_HOST - Like CONFIG_CACHE_CONNECTIONS, but limit the number of connec- - tions to the host as well. See fetch(3) for further details + Like CONFIG_CACHE_CONNECTIONS, but limit the number of + connections to the host as well. See fetch(3) for further + details DEFAULT_ACCEPTABLE_LICENSES Space-separated list of common Free and Open Source licenses - packages are allowed to carry. The default value contains all - OSI approved licenses in pkgsrc on the date pkg_install was - released. License names are case-sensitive. + packages are allowed to carry. The default value contains all + OSI approved licenses in pkgsrc on the date pkg_install was + released. License names are case-sensitive. GPG Path to gpg(1), which can be used to verify the signature in the _p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s file when running @@ -103,8 +108,8 @@ DDEESSCCRRIIPPTTIIOONN Non-default keyring to use for signing packages with GPG. GPG_KEYRING_VERIFY - Non-default keyring to use for verifying GPG signature of pack- - ages. + Non-default keyring to use for verifying GPG signature of + packages. GPG_SIGN_AS User-id to use for signing packages. @@ -119,12 +124,12 @@ DDEESSCCRRIIPPTTIIOONN value. PKG_DBDIR (*) - Location of the packages database. This option is always overri- - den by the argument of the --KK option. + Location of the packages database. This option is always + overriden by the argument of the --KK option. PKG_PATH (*) - Search path for packages. The entries are separated by semi- - colon. Each entry specifies a directory or URL to search for + Search path for packages. The entries are separated by + semicolon. Each entry specifies a directory or URL to search for packages. PKG_REFCOUNT_DBDIR (*) @@ -139,8 +144,8 @@ DDEESSCCRRIIPPTTIIOONN 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 when running ppkkgg__aaddmmiinn ffeettcchh--ppkkgg--vvuullnneerraabbiilliittiieess - The default location is ftp.NetBSD.org using HTTP. _N_o_t_e: Usu- - ally, only the compression type should be changed. Currently + The default location is ftp.NetBSD.org using HTTP. _N_o_t_e: + Usually, only the compression type should be changed. Currently supported are uncompressed files and files compressed by bzip2(1) (_._b_z_2) or gzip(1) (_._g_z). @@ -164,10 +169,10 @@ DDEESSCCRRIIPPTTIIOONN installing a package. FFIILLEESS - @SYSCONFDIR@/pkg_install.conf Default location for the file described in - this manual page. + _@_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 + described in this manual page. SSEEEE AALLSSOO - pkg_add(1), pkg_admin(1) pkg_create(1), pkg_delete(1), pkg_info(1) + pkg_add(1), pkg_admin(1), pkg_create(1), pkg_delete(1), pkg_info(1) -NetBSD 5.0 February 22, 2012 NetBSD 5.0 +pkgsrc October 28, 2014 pkgsrc diff --git a/pkgtools/pkg_install/files/lib/pkg_summary.cat b/pkgtools/pkg_install/files/lib/pkg_summary.cat index ff89376e8e3..680127c1a54 100644 --- a/pkgtools/pkg_install/files/lib/pkg_summary.cat +++ b/pkgtools/pkg_install/files/lib/pkg_summary.cat @@ -1,4 +1,4 @@ -PKG_SUMMARY(5) NetBSD File Formats Manual PKG_SUMMARY(5) +PKG_SUMMARY(5) File Formats Manual PKG_SUMMARY(5) NNAAMMEE ppkkgg__ssuummmmaarryy -- summary of binary package repository @@ -17,25 +17,29 @@ DDEESSCCRRIIPPTTIIOONN (required) The date and time when the package was built. CATEGORIES - (required) A list of categories which this package fits in, sepa- - rated by space. + (required) A list of categories which this package fits in, + separated by space. COMMENT (required) A one-line description of the package. CONFLICTS - (optional) A list of dewey patterns of packages the package con- - flicts with, one per line. If missing, this package has no con- - flicts. + (optional) A list of dewey patterns of packages the package + conflicts with, one per line. If missing, this package has no + conflicts. DEPENDS (optional) A list of dewey patterns of packages the package - depends on, one per line. If missing, this package has no depen- - dencies. + depends on, one per line. If missing, this package has no + dependencies. DESCRIPTION (required) A more detailed description of the package. + FILE_CKSUM + (optional) A checksum type supported by digest(1) and checksum + separated by space character. + FILE_NAME (optional) The name of the binary package file. If not given, _P_K_G_N_A_M_E_._t_g_z can be assumed. @@ -54,12 +58,12 @@ DDEESSCCRRIIPPTTIIOONN MACHINE_ARCH (required) The architecture on which the package was compiled. - OPSYS (required) The operating system on which the package was com- - piled. + OPSYS (required) The operating system on which the package was + compiled. OS_VERSION - (required) The version of the operating system on which the pack- - age was compiled. + (required) The version of the operating system on which the + package was compiled. PKG_OPTIONS (optional) Any options selected to compile this package. If @@ -95,19 +99,19 @@ DDEESSCCRRIIPPTTIIOONN SUPERSEDES (optional) A list of dewey patterns of previous packages this - package replaces, one per line. This is used for package renam- - ing. + package replaces, one per line. This is used for package + renaming. The ppkkgg__ssuummmmaarryy file can be generated using the pkg_info(1) --XX option. - For example, the following will list this data for all installed pack- - ages: + For example, the following will list this data for all installed + packages: pkg_info -X -a SSEEEE AALLSSOO - pkg_info(1) + digest(1), pkg_info(1) HHIISSTTOORRYY The ppkkgg__ssuummmmaarryy format was first officially documented in April 2006. -NetBSD 5.0 April 11, 2009 NetBSD 5.0 +pkgsrc April 11, 2009 pkgsrc diff --git a/pkgtools/pkg_install/files/lib/pkgsrc.cat b/pkgtools/pkg_install/files/lib/pkgsrc.cat index efccdf46ca9..48902ff7cf0 100644 --- a/pkgtools/pkg_install/files/lib/pkgsrc.cat +++ b/pkgtools/pkg_install/files/lib/pkgsrc.cat @@ -1,4 +1,4 @@ -PKGSRC(7) NetBSD Miscellaneous Information Manual PKGSRC(7) +PKGSRC(7) Miscellaneous Information Manual PKGSRC(7) NNAAMMEE ppkkggssrrcc -- NetBSD packages collection (framework for third-party software) @@ -9,11 +9,11 @@ DDEESSCCRRIIPPTTIIOONN It is used to enable freely available software to be configured and built easily on supported platforms. - Tools are available to install ready-to-use packages and to perform vari- - ous administrative tasks for the package system. + Tools are available to install ready-to-use packages and to perform + various administrative tasks for the package system. SSEEEE AALLSSOO pkg_add(1), pkg_delete(1), pkg_info(1), _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_/ -NetBSD 5.0 March 2, 2007 NetBSD 5.0 +pkgsrc March 2, 2007 pkgsrc |