| @@ -1,137 +1,137 @@ | | | @@ -1,137 +1,137 @@ |
1 | | | 1 | LINTPKGSRC(1) General Commands Manual LINTPKGSRC(1) |
2 | LINTPKGSRC(1) BSD General Commands Manual LINTPKGSRC(1) | | | |
3 | | | 2 | |
4 | NNAAMMEE | | 3 | NNAAMMEE |
5 | lliinnttppkkggssrrcc -- verifier for the pkgsrc tree | | 4 | lliinnttppkkggssrrcc -- verifier for the pkgsrc tree |
6 | | | 5 | |
7 | SSYYNNOOPPSSIISS | | 6 | SSYYNNOOPPSSIISS |
8 | lliinnttppkkggssrrcc [--BBDDLLOORRSSVVddhhiillmmoopprruuyyzz] [--EE _f_i_l_e] [--gg _p_k_g_s_r_c_m_a_p] [--II _f_i_l_e] | | 7 | lliinnttppkkggssrrcc [--BBDDddLLllmmOOooppRRrrSSuuVVyyzz] [--EE _f_i_l_e] [--gg _p_k_g_s_r_c_m_a_p] [--II _f_i_l_e] |
9 | [--KK _P_A_C_K_A_G_E_S] [--MM _D_I_S_T_D_I_R] [--PP _P_K_G_S_R_C_D_I_R] [_m_a_k_e_f_i_l_e _._._.] | | 8 | [--KK _P_A_C_K_A_G_E_S] [--MM _D_I_S_T_D_I_R] [--PP _P_K_G_S_R_C_D_I_R] [_m_a_k_e_f_i_l_e _._._.] |
10 | | | 9 | |
11 | DDEESSCCRRIIPPTTIIOONN | | 10 | DDEESSCCRRIIPPTTIIOONN |
12 | lliinnttppkkggssrrcc tries to verify the entire contents of the pkgsrc tree. | | 11 | lliinnttppkkggssrrcc tries to verify the entire contents of the pkgsrc tree. |
13 | lliinnttppkkggssrrcc uses simple regular-expression matching for verifying files | | 12 | lliinnttppkkggssrrcc uses simple regular-expression matching for verifying files |
14 | that make up a pkgsrc directory. Note that it does NOT implement com- | | 13 | that make up a pkgsrc directory. Note that it does NOT implement a |
15 | plete Makefile parser. | | 14 | complete Makefile parser. |
16 | | | 15 | |
17 | OOppttiioonnss | | 16 | OOppttiioonnss |
18 | --BB List packages marked as BROKEN. | | 17 | --BB List packages marked as BROKEN. |
19 | | | 18 | |
20 | --DD _p_a_t_h_s Parse Makefiles and output contents (useful for debugging). | | 19 | --DD _p_a_t_h_s Parse Makefiles and output contents (useful for debugging). |
21 | | | 20 | |
22 | --dd Extract the `DEPENDS' listing from each pkgsrc package | | 21 | --dd Extract the `DEPENDS' listing from each pkgsrc package |
23 | Makefile, then verify the version specified in each DEPEND | | 22 | Makefile, then verify the version specified in each DEPEND |
24 | correctly matches a current pkgsrc package. | | 23 | correctly matches a current pkgsrc package. |
25 | | | 24 | |
26 | --EE _f_i_l_e Exports the internal database generated from the pkgsrc | | 25 | --EE _f_i_l_e Exports the internal database generated from the pkgsrc |
27 | Makefiles to a file for faster loading at a later time. | | 26 | Makefiles to a file for faster loading at a later time. |
28 | Note that some of the stored data is, in all likelihood, | | 27 | Note that some of the stored data is, in all likelihood, |
29 | dependent on the architecture and operating system of the | | 28 | dependent on the architecture and operating system of the |
30 | machine where it is generated. However, the database does | | 29 | machine where it is generated. However, the database does |
31 | make the task of, eg, checking for out of date packages on | | 30 | make the task of, eg, checking for out of date packages on |
32 | a set of similarly configured machines (in the absence of | | 31 | a set of similarly configured machines (in the absence of |
33 | extra copies of the pkgsrc tree) both quick and possible. | | 32 | extra copies of the pkgsrc tree) both quick and possible. |
34 | | | 33 | |
35 | --gg _p_k_g_s_r_c_m_a_p Generate pkgsrcmap file containing an entry for each pack- | | 34 | --gg _p_k_g_s_r_c_m_a_p Generate pkgsrcmap file containing an entry for each |
36 | age of `pkgname pkgdir pkgver'. | | 35 | package of `pkgname pkgdir pkgver'. |
37 | | | 36 | |
38 | --hh Basic help and usage. | | 37 | --hh Basic help and usage. |
39 | | | 38 | |
40 | --II _f_i_l_e Imports the data to construct the internal database for | | 39 | --II _f_i_l_e Imports the data to construct the internal database for |
41 | checking the installed versions of packages, among other | | 40 | checking the installed versions of packages, among other |
42 | things, against the current version found in pkgsrc. This | | 41 | things, against the current version found in pkgsrc. This |
43 | database provides most or all of the data required for run- | | 42 | database provides most or all of the data required for |
44 | ning lliinnttppkkggssrrcc with any combination of --BB, --OO, --RR, --SS, --VV, | | 43 | running lliinnttppkkggssrrcc with any combination of --BB, --OO, --RR, --SS, |
45 | --dd, --gg, --ii, --pp, or --uu. | | 44 | --VV, --dd, --gg, --ii, --pp, or --uu. |
46 | | | 45 | |
47 | --ii Check the version of each installed package against the | | 46 | --ii Check the version of each installed package against the |
48 | current version in pkgsrc. | | 47 | current version in pkgsrc. |
49 | | | 48 | |
50 | --KK _P_A_C_K_A_G_E_S Override binary packages base directory, normally set from | | 49 | --KK _P_A_C_K_A_G_E_S Override binary packages base directory, normally set from |
51 | _/_e_t_c_/_m_k_._c_o_n_f or defaulted to _$_{_P_K_G_S_R_C_D_I_R_}_/_p_a_c_k_a_g_e_s. | | 50 | _/_e_t_c_/_m_k_._c_o_n_f or defaulted to _$_{_P_K_G_S_R_C_D_I_R_}_/_p_a_c_k_a_g_e_s. |
52 | | | 51 | |
53 | Note: lintpkgsrc treats _P_A_C_K_A_G_E_S slightly differently to | | 52 | Note: lintpkgsrc treats _P_A_C_K_A_G_E_S slightly differently to |
54 | the pkgsrc build system. --pp, --RR and --VV check for binary | | 53 | the pkgsrc build system. --pp, --RR, and --VV check for binary |
55 | packages in any depth of PACKAGES subdirs - this allows | | 54 | packages in any depth of PACKAGES subdirs - this allows |
56 | packages for all architectures/OS versions to be checked | | 55 | packages for all architectures/OS versions to be checked |
57 | simultaneously with an _/_e_t_c_/_m_k_._c_o_n_f construct of the form: | | 56 | simultaneously with an _/_e_t_c_/_m_k_._c_o_n_f construct of the form: |
58 | | | 57 | |
59 | .ifdef LINTPKGSRC | | 58 | .ifdef LINTPKGSRC |
60 | PACKAGES=${PKGSRCDIR}/packages | | 59 | PACKAGES=${PKGSRCDIR}/packages |
61 | .else | | 60 | .else |
62 | PACKAGES=${PKGSRCDIR}/packages/${OS_VERSION}/${MACHINE_ARCH} | | 61 | PACKAGES=${PKGSRCDIR}/packages/${OS_VERSION}/${MACHINE_ARCH} |
63 | .endif | | 62 | .endif |
64 | | | 63 | |
65 | Which would be an alternative to --KK. | | 64 | Which would be an alternative to --KK. |
66 | | | 65 | |
67 | --LL List the filenames of Makefiles as they are parsed (for | | 66 | --LL List the filenames of Makefiles as they are parsed (for |
68 | debugging). | | 67 | debugging). |
69 | | | 68 | |
70 | --MM _D_I_S_T_D_I_R Set directory for distfiles, defaults to | | 69 | --MM _D_I_S_T_D_I_R Set directory for distfiles, defaults to |
71 | _$_{_P_K_G_S_R_C_D_I_R_}_/_d_i_s_t_f_i_l_e_s. | | 70 | _$_{_P_K_G_S_R_C_D_I_R_}_/_d_i_s_t_f_i_l_e_s. |
72 | | | 71 | |
73 | --mm For each current distfile, verify its checksum against the | | 72 | --mm For each current distfile, verify its checksum against the |
74 | appropriate package's distinfo file. Also report if any | | 73 | appropriate package's distinfo file. Also report if any |
75 | package's distinfo file references the same distfile with a | | 74 | package's distinfo file references the same distfile with a |
76 | different distinfo checksum. | | 75 | different distinfo checksum. |
77 | | | 76 | |
78 | --OO Report any binary packages in any subdirs of _P_A_C_K_A_G_E_S, for | | 77 | --OO Report any binary packages in any subdirs of _P_A_C_K_A_G_E_S, for |
79 | whom the source Makefile lists _O_S_V_E_R_S_I_O_N___S_P_E_C_I_F_I_C. This is | | 78 | whom the source Makefile lists _O_S_V_E_R_S_I_O_N___S_P_E_C_I_F_I_C. This is |
80 | intended to help those making binary packages available for | | 79 | intended to help those making binary packages available for |
81 | ftp. | | 80 | ftp. |
82 | | | 81 | |
83 | --oo Report any old distfiles (not referenced by any package's | | 82 | --oo Report any old distfiles (not referenced by any package's |
84 | distinfo file). | | 83 | distinfo file). |
85 | | | 84 | |
86 | --PP _P_K_G_S_R_C_D_I_R Set base of pkgsrc tree, normally set from _/_e_t_c_/_m_k_._c_o_n_f or | | 85 | --PP _P_K_G_S_R_C_D_I_R Set base of pkgsrc tree, normally set from _/_e_t_c_/_m_k_._c_o_n_f or |
87 | defaulted to _/_u_s_r_/_p_k_g_s_r_c. | | 86 | defaulted to _/_u_s_r_/_p_k_g_s_r_c. |
88 | | | 87 | |
89 | --pp Report any old binary packages in any subdirs of _P_A_C_K_A_G_E_S. | | 88 | --pp Report any old binary packages in any subdirs of _P_A_C_K_A_G_E_S. |
90 | | | 89 | |
91 | --RR Report any binary packages in any subdirs of _P_A_C_K_A_G_E_S, for | | 90 | --RR Report any binary packages in any subdirs of _P_A_C_K_A_G_E_S, for |
92 | whom the source Makefile lists _N_O___B_I_N___O_N___F_T_P or _R_E_S_T_R_I_C_T_E_D. | | 91 | whom the source Makefile lists _N_O___B_I_N___O_N___F_T_P or _R_E_S_T_R_I_C_T_E_D. |
93 | This is intended to help those making binary packages | | 92 | This is intended to help those making binary packages |
94 | available for ftp. | | 93 | available for ftp. |
95 | | | 94 | |
96 | --rr Remove distfiles which are not referenced from any pack- | | 95 | --rr Remove distfiles which are not referenced from any |
97 | age's distinfo file, or have an incorrect checksum (usually | | 96 | package's distinfo file, or have an incorrect checksum |
98 | due to an interrupted download), and any old binary pack- | | 97 | (usually due to an interrupted download), and any old |
99 | ages. To remove any given type, additionally specify the | | 98 | binary packages. To remove any given type, additionally |
100 | --oo, --mm, or --pp flags respectively. | | 99 | specify the --oo, --mm, or --pp flags respectively. |
101 | | | 100 | |
102 | --SS List packages missing from category _S_U_B_D_I_R lists. | | 101 | --SS List packages missing from category _S_U_B_D_I_R lists. |
103 | | | 102 | |
104 | --uu As --ii plus for mismatched packages, display REQUIRED | | 103 | --uu As --ii plus for mismatched packages, display REQUIRED |
105 | details and run `@MAKE@ fetch-list | sh' to ensure all the | | 104 | details and run `@MAKE@ fetch-list | sh' to ensure all the |
106 | distfiles needed for the latest version are present. | | 105 | distfiles needed for the latest version are present. |
107 | | | 106 | |
108 | Warning: The behaviour of this command may change in a | | 107 | Warning: The behaviour of this command may change in a |
109 | later version. | | 108 | later version. |
110 | | | 109 | |
111 | --VV List any prebuilt packages in any subdirs of _P_A_C_K_A_G_E_S with | | 110 | --VV List any prebuilt packages in any subdirs of _P_A_C_K_A_G_E_S with |
112 | known vulnerabilities, based on the data in | | 111 | known vulnerabilities, based on the data in |
113 | _$_{_P_K_G_S_R_C_D_I_R_}_/_d_i_s_t_f_i_l_e_s_/_p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s. | | 112 | _$_{_P_K_G_S_R_C_D_I_R_}_/_d_i_s_t_f_i_l_e_s_/_p_k_g_-_v_u_l_n_e_r_a_b_i_l_i_t_i_e_s. |
114 | | | 113 | |
115 | --yy Remove orphaned distfiles, i.e. those that do not belong to | | 114 | --yy Remove orphaned distfiles, i.e., those that do not belong |
116 | any currently installed package. | | 115 | to any currently installed package. |
117 | | | 116 | |
118 | --zz Remove distfiles for currently installed packages. | | 117 | --zz Remove distfiles for currently installed packages. |
119 | | | 118 | |
120 | AAUUTTHHOORRSS | | 119 | AAUUTTHHOORRSS |
121 | David Brownlee <_a_b_s_@_n_e_t_b_s_d_._o_r_g> | | 120 | David Brownlee <_a_b_s_@_n_e_t_b_s_d_._o_r_g> |
122 | | | 121 | |
123 | BBUUGGSS | | 122 | BBUUGGSS |
124 | The --RR, --VV, and --pp options default to using _P_A_C_K_A_G_E_S as the base direc- | | 123 | The --RR, --VV, and --pp options default to using _P_A_C_K_A_G_E_S as the base |
125 | tory from which to search for binary packages. If this includes OS or | | 124 | directory from which to search for binary packages. If this includes OS |
126 | architecture information then packages for other OS/architecture combina- | | 125 | or architecture information then packages for other OS/architecture |
127 | tions will be missed. In this case _P_A_C_K_A_G_E_S can be overridden with --KK or | | 126 | combinations will be missed. In this case _P_A_C_K_A_G_E_S can be overridden |
128 | set conditionally in _/_e_t_c_/_m_k_._c_o_n_f based on the value of _L_I_N_T_P_K_G_S_R_C. | | 127 | with --KK or set conditionally in _/_e_t_c_/_m_k_._c_o_n_f based on the value of |
| | | 128 | _L_I_N_T_P_K_G_S_R_C. |
129 | | | 129 | |
130 | The `Makefile parsing' algorithm used to obtain package versions and | | 130 | The `Makefile parsing' algorithm used to obtain package versions and |
131 | DEPENDS information is geared towards speed rather than perfection, | | 131 | DEPENDS information is geared towards speed rather than perfection, |
132 | though it has got somewhat better over time, it only parses the simplest | | 132 | though it has got somewhat better over time, it only parses the simplest |
133 | Makefile conditionals. (a == b, no && etc). | | 133 | Makefile conditionals. (a == b, no && etc). |
134 | | | 134 | |
135 | Potentially others, but non serious to date. | | 135 | Potentially others, but non serious to date. |
136 | | | 136 | |
137 | November 8, 2005 | | 137 | LOCAL November 24, 2014 LOCAL |