fppkg: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ## Introduction | |
| 2 | 2 | ||
| 3 | 3 | Fppkg is the Free Pascal package manager. It is used to compile and install Free Pascal packages which are based on [[FPMake]]. It also resolves dependencies between packages and can fetch the packages from a central repository. | |
| 4 | 4 | ||
| 5 | 5 | ## Fppkg walk-through | |
| 6 | 6 | ||
| 7 | 7 | ### Step 1, install package | |
| 8 | 8 | ||
| 9 | 9 | To install a package, just run 'fppkg install \<packagename\>'. This will look like this: | |
| 10 | 10 | ||
| 11 | - | ||
| 12 | - | ||
| 13 | - | ||
| 14 | - | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 18 | - | ||
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 22 | - | ||
| 23 | - | ||
| 11 | + | ```text | |
| 12 | + | $ fppkg install cnocasn1 | |
| 13 | + | Downloading package cnocASN1 version 0.9.0 | |
| 14 | + | Start compiling package cnocASN1 for target x86_64-linux. | |
| 15 | + | Compiling cnocasn1.pas | |
| 16 | + | Compiling cnocasn1decoder.pas | |
| 17 | + | Compiling cnocasn1tagfactory.pas | |
| 18 | + | Compiling cnocasn1tagfactory.pas | |
| 19 | + | Compiling cnocasn1encoder.pas | |
| 20 | + | Compiling cnocasn1element.pas | |
| 21 | + | Compiling cnocasn1decoder.pas | |
| 22 | + | [100%] Compiled package cnocASN1 | |
| 23 | + | Installing package cnocASN1 | |
| 24 | + | Installation package cnocASN1 for target x86_64-linux succeeded | |
| 25 | + | ``` | |
| 24 | 26 | ||
| 25 | 27 | First the cnocasn1 package is downloaded from a central repository. Then it is compiled and installed. Now with the package installed it is possible to use it's units (like cnocasn1, cnocasn1encoder etc) into any Free Pascal application. | |
| 26 | 28 | ||
| 27 | 29 | When installing the package does not work for you, take a look at the troubleshooting section. | |
| 28 | 30 | ||
| 29 | 31 | ### Step 2, list installed packages | |
| 30 | 32 | ||
| 31 | 33 | Fppkg can give a list of all installed packages, and the packages which are available for installation. This could be that they could be downloaded, or the source might be available locally. Below a (cropped) list of all packages after the installation of cnocasn1. | |
| 32 | 34 | ||
| 33 | - | ||
| 34 | - | ||
| 35 | - | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 41 | - | ||
| 42 | - | ||
| 43 | - | ||
| 44 | - | ||
| 35 | + | ```text | |
| 36 | + | $ fppkg list | |
| 37 | + | Name Installed Available | |
| 38 | + | a52 3.3.1 - | |
| 39 | + | aspell 3.3.1 - | |
| 40 | + | bfd 3.3.1 - | |
| 41 | + | bzip2 3.3.1 - | |
| 42 | + | cairo 3.3.1 - | |
| 43 | + | cdrom 3.3.1 - | |
| 44 | + | chm 3.3.1 - | |
| 45 | + | cnocASN1 0.9.0 0.9.0 | |
| 46 | + | codetools 1.0.1 - | |
| 47 | + | dblib 3.3.1 - | |
| 48 | + | ``` | |
| 45 | 49 | ||
| 46 | 50 | The packages which are part of fpc itself, like chm, are installed but not (online) available. This is because fpc version 3.3.1 is a moving target. When an official version of fpc is being used, all the packages are also available in the online repository. | |
| 47 | 51 | ||
| 48 | 52 | ### Step 3, install package with a dependency | |
| 49 | 53 | ||
| 50 | 54 | All (maybe except the RTL) packages have dependencies on other packages. When fppkg is used to install a package, it will check all dependencies before compilation. When a dependency is not available locally, fppkg will lookup the package in the central repository and, if available, download and install them. See for example: | |
| 51 | 55 | ||
| 52 | - | ||
| 53 | - | ||
| 54 | - | ||
| 55 | - | ||
| 56 | - | ||
| 57 | - | ||
| 58 | - | ||
| 59 | - | ||
| 60 | - | ||
| 61 | - | ||
| 62 | - | ||
| 63 | - | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 56 | + | ```text | |
| 57 | + | $ fppkg install cnocoidc | |
| 58 | + | Downloading package cnocOIDC version 0.9.0 | |
| 59 | + | Install dependencies | |
| 60 | + | Downloading package cnocRSA version 0.9.0 | |
| 61 | + | Start compiling package cnocRSA for target x86_64-linux. | |
| 62 | + | Compiling cnocrsa.pas | |
| 63 | + | [100%] Compiled package cnocRSA | |
| 64 | + | Installing package cnocRSA | |
| 65 | + | Installation package cnocRSA for target x86_64-linux succeeded | |
| 66 | + | Dependencies installed | |
| 67 | + | Start compiling package cnocOIDC for target x86_64-linux. | |
| 68 | + | Compiling cnocopenidconnect.pas | |
| 69 | + | Compiling cnocoidcidtoken.pas | |
| 70 | + | Compiling cnocoidcidtoken.pas | |
| 71 | + | [100%] Compiled package cnocOIDC | |
| 72 | + | Installing package cnocOIDC | |
| 73 | + | Installation package cnocOIDC for target x86_64-linux succeeded | |
| 74 | + | ``` | |
| 69 | 75 | ||
| 70 | 76 | Before installing cnocOIDC, the missing dependency cnocRSA is downloaded and installed. Note that the cnocRSA package depends on the cnocasn1 package, but this package is already installed during step 1 and is therefore not installed again. | |
| 71 | 77 | ||
| 72 | 78 | ### Step 4, re-install an already installed package | |
| 73 | 79 | ||
| 74 | 80 | Fppkg will not only install dependencies, but will also re-compile all packages that depend on a newly installed package. Suppose you want to have debug-information for the cnocasn1 package. This is possible as follows: | |
| 75 | 81 | ||
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 79 | - | ||
| 80 | - | ||
| 81 | - | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 89 | - | ||
| 90 | - | ||
| 91 | - | ||
| 92 | - | ||
| 93 | - | ||
| 94 | - | ||
| 95 | - | ||
| 96 | - | ||
| 97 | - | ||
| 82 | + | ```text | |
| 83 | + | $ fppkg install -o -gl cnocasn1 | |
| 84 | + | Start compiling package cnocASN1 for target x86_64-linux. | |
| 85 | + | Compiling cnocasn1.pas | |
| 86 | + | Compiling cnocasn1decoder.pas | |
| 87 | + | Compiling cnocasn1tagfactory.pas | |
| 88 | + | Compiling cnocasn1encoder.pas | |
| 89 | + | Compiling cnocasn1element.pas | |
| 90 | + | [100%] Compiled package cnocASN1 | |
| 91 | + | Installing package cnocASN1 | |
| 92 | + | Installation package cnocASN1 for target x86_64-linux succeeded | |
| 93 | + | Re-install packages which are dependent on just installed packages | |
| 94 | + | Start compiling package cnocRSA for target x86_64-linux. | |
| 95 | + | Compiling cnocrsa.pas | |
| 96 | + | [100%] Compiled package cnocRSA | |
| 97 | + | Installing package cnocRSA | |
| 98 | + | Installation package cnocRSA for target x86_64-linux succeeded | |
| 99 | + | Start compiling package cnocOIDC for target x86_64-linux. | |
| 100 | + | Compiling cnocopenidconnect.pas | |
| 101 | + | Compiling cnocoidcidtoken.pas | |
| 102 | + | [100%] Compiled package cnocOIDC | |
| 103 | + | Installing package cnocOIDC | |
| 104 | + | Installation package cnocOIDC for target x86_64-linux succeeded | |
| 105 | + | ``` | |
| 98 | 106 | ||
| 99 | 107 | This will re-install the cnocasn1 package with the -gl option passed to the compiler. (-gl means build with debug-information) But this is not the only thing Fppkg does. It will also re-build cnocrsa and cnocoidc, because cnocrsa depends on cnocasn1 and cnocoidc depends on cnocrsa. Note that in this case recompiling both packages is not necessary, because the -gl option does not change the interface of the package. But Fppkg can not detect this and will rebuild and reinstall the packages. | |
| 100 | 108 | ||
| 101 | 109 | ### Step 5, install a package from source | |
| 102 | 110 | ||
| 103 | 111 | In the previous steps a package was installed from a central repository. But it is also possible to install a package from a local harddisk. To do this, change the current directory to the source-directory of the package. This is the directory that contains the fpmake.pp file. Then just call fppkg but omit the package-name from the command line. All dependencies will be resolved automatically in this case also. | |
| 104 | 112 | ||
| 105 | 113 | Hint: If you want to test this but do not have the sources of a fpmake-package available, most Free Pascal users do have the sources of the packages that come with the compiler installed onto their machine. Below is the cropped output of the installation of the fcl-db package: | |
| 106 | 114 | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 111 | - | ||
| 115 | + | ```text | |
| 116 | + | $ fppkg install | |
| 117 | + | Start compiling package fcl-db for target x86_64-linux. | |
| 118 | + | Compiling src/base/dbconst.pas | |
| 119 | + | Compiling src/base/db.pas | |
| 120 | + | Compiling src/dbase/dbf_prssupp.pas | |
| 121 | + | ``` | |
| 112 | 122 | ||
| 113 | - | ||
| 114 | - | ||
| 115 | - | ||
| 116 | - | ||
| 117 | - | ||
| 118 | - | ||
| 119 | - | ||
| 120 | - | ||
| 121 | - | ||
| 122 | - | ||
| 123 | - | ||
| 124 | - | ||
| 125 | - | ||
| 126 | - | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 130 | - | ||
| 131 | - | ||
| 132 | - | ||
| 133 | - | ||
| 123 | + | ```text | |
| 124 | + | Warning: Circular dependency detected when compiling target dbf_fields with target dbf_dbffile | |
| 125 | + | Compiling src/dbase/dbf_fields.pas | |
| 126 | + | Warning: Circular dependency detected when compiling target dbf_memo with target dbf_dbffile | |
| 127 | + | Compiling src/dbase/dbf_memo.pas | |
| 128 | + | Warning: Circular dependency detected when compiling target dbf_parser with target dbf | |
| 129 | + | Warning: Circular dependency detected when compiling target dbf_parser with target dbf_dbffile | |
| 130 | + | Compiling src/dbase/dbf_parser.pas | |
| 131 | + | Compiling src/dbase/dbf_parser.pas | |
| 132 | + | Compiling src/dbase/dbf_lang.pas | |
| 133 | + | Compiling src/dbase/dbf_collate.pas | |
| 134 | + | Warning: Circular dependency detected when compiling target dbf_idxfile with target dbf_dbffile | |
| 135 | + | Compiling src/dbase/dbf_idxfile.pas | |
| 136 | + | [100%] Compiled package fcl-db | |
| 137 | + | Installing package fcl-db | |
| 138 | + | Installation package fcl-db for target x86_64-linux succeeded | |
| 139 | + | Re-install packages which are dependent on just installed packages | |
| 140 | + | Start compiling package fpindexer for target x86_64-linux. | |
| 141 | + | Compiling src/fpmasks.pp | |
| 142 | + | Compiling src/fpindexer.pp | |
| 143 | + | Compiling src/memindexdb.pp | |
| 144 | + | Compiling src/ireaderhtml.pp | |
| 145 | + | ``` | |
| 134 | 146 | ||
| 135 | - | ||
| 136 | - | ||
| 137 | - | ||
| 138 | - | ||
| 139 | - | ||
| 140 | - | ||
| 141 | - | ||
| 142 | - | ||
| 147 | + | ```text | |
| 148 | + | Installing package cnocRSA | |
| 149 | + | Installation package cnocRSA for target x86_64-linux succeeded | |
| 150 | + | Start compiling package cnocOIDC for target x86_64-linux. | |
| 151 | + | Compiling cnocopenidconnect.pas | |
| 152 | + | Compiling cnocoidcidtoken.pas | |
| 153 | + | [100%] Compiled package cnocOIDC | |
| 154 | + | Installing package cnocOIDC | |
| 155 | + | Installation package cnocOIDC for target x86_64-linux succeeded | |
| 156 | + | ``` | |
| 143 | 157 | ||
| 144 | 158 | ### Step 6, uninstall a package | |
| 145 | 159 | ||
| 146 | 160 | Uninstalling a package is as simple as 'fppkg uninstall \<packagename\>'. | |
| 147 | 161 | ||
| 148 | - | ||
| 149 | - | ||
| 162 | + | ```text | |
| 163 | + | $ fppkg uninstall cnocasn1 | |
| 164 | + | Uninstalling package cnocASN1 | |
| 165 | + | ``` | |
| 150 | 166 | ||
| 151 | 167 | Fppkg does not do any dependency checks, so use with care. It is possible to leave your configuration in a broken state, when some other installed packages depend on the uninstalled package. (This will probably change in the future, not checking for dependencies on uninstall seems like a bug to me) | |
| 152 | 168 | ||
| 153 | 169 | ### Step 7, fix broken dependencies | |
| 154 | 170 | ||
| 155 | 171 | It might be that the dependencies between the packages get broken. This might happen when a package has been deleted, while some other packages still depend on it. (See step 6) Another way dependencies might get broken is when Free Pascal has been re-installed. | |
| 156 | 172 | ||
| 157 | 173 | Broken packages are marked (B) in the list of available packages. Running 'fppkg list' with the -v option gives some hints why a packages is broken: | |
| 158 | 174 | ||
| 159 | - | ||
| 160 | - | ||
| 161 | - | ||
| 175 | + | ```text | |
| 176 | + | $ fppkg list -v | |
| 177 | + | Start loading configuration file "/home/joost/.config/fppkg.cfg" | |
| 178 | + | Loaded global configuration from "/home/joost/.config/fppkg.cfg" | |
| 179 | + | ``` | |
| 162 | 180 | ||
| 163 | - | ||
| 164 | - | ||
| 165 | - | ||
| 166 | - | ||
| 167 | - | ||
| 168 | - | ||
| 169 | - | ||
| 170 | - | ||
| 171 | - | ||
| 172 | - | ||
| 173 | - | ||
| 174 | - | ||
| 175 | - | ||
| 176 | - | ||
| 177 | - | ||
| 181 | + | ```text | |
| 182 | + | Name Installed Available | |
| 183 | + | a52 3.3.1 - | |
| 184 | + | aspell 3.3.1 - | |
| 185 | + | bfd 3.3.1 - | |
| 186 | + | bzip2 3.3.1 - | |
| 187 | + | cairo 3.3.1 - | |
| 188 | + | cdrom 3.3.1 - | |
| 189 | + | chm 3.3.1 - | |
| 190 | + | cnocASN1 - 0.9.0 | |
| 191 | + | Package cnocRSA depends on package cnocASN1 which is not installed anymore | |
| 192 | + | Package cnocOIDC (user) needs to be rebuild, dependency cnocRSA (user) is broken | |
| 193 | + | cnocOIDC 0.9.0 (B) 0.9.0 | |
| 194 | + | Package cnocRSA depends on package cnocASN1 which is not installed anymore | |
| 195 | + | cnocRSA 0.9.0 (B) 0.9.0 | |
| 196 | + | dblib 3.3.1 - | |
| 197 | + | ``` | |
| 178 | 198 | ||
| 179 | 199 | To fix all broken dependencies, use 'fppkg fixbroken': | |
| 180 | 200 | ||
| 181 | - | ||
| 182 | - | ||
| 183 | - | ||
| 184 | - | ||
| 185 | - | ||
| 186 | - | ||
| 187 | - | ||
| 188 | - | ||
| 189 | - | ||
| 190 | - | ||
| 191 | - | ||
| 192 | - | ||
| 193 | - | ||
| 194 | - | ||
| 195 | - | ||
| 196 | - | ||
| 197 | - | ||
| 198 | - | ||
| 199 | - | ||
| 200 | - | ||
| 201 | - | ||
| 202 | - | ||
| 203 | - | ||
| 204 | - | ||
| 205 | - | ||
| 206 | - | ||
| 201 | + | ```text | |
| 202 | + | $ fppkg fixbroken | |
| 203 | + | Re-install packages which are dependent on just installed packages | |
| 204 | + | Install dependencies | |
| 205 | + | Start compiling package cnocASN1 for target x86_64-linux. | |
| 206 | + | Compiling cnocasn1.pas | |
| 207 | + | Compiling cnocasn1decoder.pas | |
| 208 | + | Compiling cnocasn1tagfactory.pas | |
| 209 | + | Compiling cnocasn1tagfactory.pas | |
| 210 | + | Compiling cnocasn1encoder.pas | |
| 211 | + | Compiling cnocasn1element.pas | |
| 212 | + | Compiling cnocasn1decoder.pas | |
| 213 | + | [100%] Compiled package cnocASN1 | |
| 214 | + | Installing package cnocASN1 | |
| 215 | + | Installation package cnocASN1 for target x86_64-linux succeeded | |
| 216 | + | Dependencies installed | |
| 217 | + | Start compiling package cnocRSA for target x86_64-linux. | |
| 218 | + | Compiling cnocrsa.pas | |
| 219 | + | [100%] Compiled package cnocRSA | |
| 220 | + | Installing package cnocRSA | |
| 221 | + | Installation package cnocRSA for target x86_64-linux succeeded | |
| 222 | + | Start compiling package cnocOIDC for target x86_64-linux. | |
| 223 | + | Compiling cnocopenidconnect.pas | |
| 224 | + | Compiling cnocoidcidtoken.pas | |
| 225 | + | [100%] Compiled package cnocOIDC | |
| 226 | + | Installing package cnocOIDC | |
| 227 | + | Installation package cnocOIDC for target x86_64-linux succeeded | |
| 228 | + | ``` | |
| 207 | 229 | ||
| 208 | 230 | ### Step 8, fix broken dependencies manually | |
| 209 | 231 | ||
| 210 | 232 | When some packages are broken, it is not possible to run any fppkg commands. Doing so will give messages like these: | |
| 211 | 233 | ||
| 212 | - | ||
| 213 | - | ||
| 214 | - | ||
| 234 | + | ```text | |
| 235 | + | $ fppkg install cnocasn1 | |
| 236 | + | The FPC Package tool encountered the following error: | |
| 237 | + | Found broken packages, run "fppkg fixbroken" first | |
| 238 | + | ``` | |
| 215 | 239 | ||
| 216 | 240 | To install the missing package, use the -b parameter: | |
| 217 | 241 | ||
| 218 | - | ||
| 219 | - | ||
| 220 | - | ||
| 221 | - | ||
| 222 | - | ||
| 223 | - | ||
| 224 | - | ||
| 225 | - | ||
| 226 | - | ||
| 227 | - | ||
| 228 | - | ||
| 229 | - | ||
| 230 | - | ||
| 242 | + | ```text | |
| 243 | + | $ fppkg install -b cnocasn1 | |
| 244 | + | Start compiling package cnocASN1 for target x86_64-linux. | |
| 245 | + | Compiling cnocasn1.pas | |
| 246 | + | Compiling cnocasn1decoder.pas | |
| 247 | + | Compiling cnocasn1tagfactory.pas | |
| 248 | + | Compiling cnocasn1tagfactory.pas | |
| 249 | + | Compiling cnocasn1encoder.pas | |
| 250 | + | Compiling cnocasn1element.pas | |
| 251 | + | Compiling cnocasn1decoder.pas | |
| 252 | + | [100%] Compiled package cnocASN1 | |
| 253 | + | Installing package cnocASN1 | |
| 254 | + | Installation package cnocASN1 for target x86_64-linux succeeded | |
| 255 | + | Re-install packages which are dependent on just installed packages | |
| 256 | + | ``` | |
| 231 | 257 | ||
| 232 | 258 | ## Quick-start guide | |
| 233 | 259 | ||
| 234 | 260 | Note: this section is only valid for fppkg from fpc version 2.5.1 or higher. | |
| 235 | 261 | ||
| 236 | 262 | ### Setting up | |
| 237 | 263 | ||
| 238 | 264 | When you run fppkg for the first time, it will create new configuration files with the default values. To check if these values are ok, run 'fppkg list' in a console window. You should see something like this: | |
| 239 | 265 | ||
| 240 | - | ||
| 241 | - | ||
| 242 | - | ||
| 243 | - | ||
| 244 | - | ||
| 266 | + | ```text | |
| 267 | + | Name Installed Available | |
| 268 | + | a52 2.5.1-1 - | |
| 269 | + | aspell 2.5.1-1 - | |
| 270 | + | bfd 2.5.1-1 - | |
| 271 | + | lnet - 0.6.3-0 | |
| 272 | + | ``` | |
| 245 | 273 | ||
| 246 | 274 | A list with all packages which are installed and the packages which are available for download are showed. You can see which version of each package is available and/or installed. | |
| 247 | 275 | ||
| 248 | 276 | If fppkg only shows available packages but not any installed packages, you have to adapt your fppkg configuration. Run 'fppkg listsettings' to see the current settings and the location of the configuration files. Locate the compiler configuration file and open it in a text-editor. Now change the 'GlobalPrefix' setting to the location where fpc is installed. For example: 'GlobalPrefix=/usr/lib/fpc' or 'c:\pp'. Save the file and run 'fppkg list' again. | |
| 249 | 277 | ||
| 250 | 278 | If you have still problems please read the section about configuring fppkg. | |
| 251 | 279 | ||
| 252 | 280 | #### Configuring the compiler | |
| 253 | 281 | ||
| 254 | 282 | The last step is configuring the Free Pascal compiler in such a way that it finds the installed packages. By default the packages are installed in a user-specific location and this location is by default not searched by the compiler. Run 'fppkg listsettings' to see where fppkg installs the user-specific packages. This location is listed as the 'LocalInstallDir'. | |
| 255 | 283 | ||
| 256 | 284 | Now add this line to your Free Pascal compiler configuration file fpc.cfg: | |
| 257 | 285 | ||
| 258 | - | ||
| 286 | + | ```text | |
| 287 | + | -Fu<LocalInstallDir>/units/$fpctarget/* | |
| 288 | + | ``` | |
| 259 | 289 | ||
| 260 | 290 | Replace \<LocalInstallDir\> with the value of the 'LocalInstallDir' setting as showed by 'fppkg list'. For example: | |
| 261 | 291 | ||
| 262 | 292 | Linux: (/etc/fpc.cfg or ~/.fpc.cfg) | |
| 263 | 293 | ||
| 264 | - | ||
| 294 | + | ```text | |
| 295 | + | -Fu~/.fppkg/lib/fpc/$fpcversion/units/$fpctarget/* | |
| 296 | + | ``` | |
| 265 | 297 | ||
| 266 | 298 | Windows: (fpc.cfg) | |
| 267 | 299 | ||
| 268 | - | ||
| 300 | + | ```text | |
| 301 | + | -Fuc:\users\username\AppData\Local\FreePascal\fppkg\units\$fpctarget* | |
| 302 | + | ``` | |
| 269 | 303 | ||
| 270 | 304 | Now you can use the units from the installed packages in all your programs. If you place the line at the bottom of the fpc.cfg, you are sure that the compiler will prefer the (locally) installed packages above the globally installed ones. This way you can install newer versions of packages locally (specific for one user), without having to change the global setup. | |
| 271 | 305 | ||
| 272 | 306 | ### Installing a package | |
| 273 | 307 | ||
| 274 | 308 | Installing a package is as simple as 'fppkg install \[packagename\]'. This will download, compile and install the package. When no error appears, use 'fppkg list' to check if the package is correctly installed. By default the package is installed for the current user only, if you want to force a system-wide installation, use the '-g' parameter. Note however that in that case you need to have the proper rights. | |
| 275 | 309 | ||
| 276 | 310 | ## Commandline arguments | |
| 277 | 311 | ||
| 278 | 312 | Output of fppkg -h | |
| 279 | 313 | ||
| 280 | 314 | Usage: fppkg [options] <action> <package> | |
| 281 | 315 | Options: | |
| 282 | 316 | -C --config-file Specify the configuration file to use | |
| 283 | 317 | -c --config Set compiler configuration to use | |
| 284 | 318 | -g --global Prefer global configuration file over local configuration file. | |
| 285 | 319 | -h --help This help | |
| 286 | 320 | -V --version Show version and exit | |
| 287 | 321 | -v --verbose Show more information | |
| 288 | 322 | -d --debug Show debugging information | |
| 289 | 323 | -f --force Force installation also if the package is already installed | |
| 290 | 324 | -r --recovery Recovery mode, use always internal fpmkunit | |
| 291 | 325 | -b --broken Do not stop on broken packages | |
| 292 | 326 | -l --showlocation Show in which repository the the packages are installed | |
| 293 | 327 | -o --options=value Pass extra options to the compiler | |
| 294 | 328 | -n Do not read the default configuration files | |
| 295 | 329 | -p --prefix=value Specify the prefix | |
| 296 | 330 | -s --skipbroken Skip the rebuild of depending packages after installation | |
| 297 | 331 | -i --installlocation Specify the repository to install packages intoallation | |
| 298 | 332 | --compiler=value Specify the compiler-executable | |
| 299 | 333 | --cpu=value Specify the target cpu to compile for | |
| 300 | 334 | --os=value Specify the target operating system to compile for | |
| 301 | 335 | Actions: | |
| 302 | 336 | update Update packages list | |
| 303 | 337 | list List available and installed packages | |
| 304 | 338 | build Build package | |
| 305 | 339 | compile Compile package | |
| 306 | 340 | install Install package | |
| 307 | 341 | uninstall Uninstall package | |
| 308 | 342 | clean Clean package | |
| 309 | 343 | archive Create archive of package | |
| 310 | 344 | download Download package | |
| 311 | 345 | convertmk Convert Makefile.fpc to fpmake.pp | |
| 312 | 346 | info Show more information about a package | |
| 313 | 347 | fixbroken Recompile all (broken) packages with changed dependencies | |
| 314 | 348 | listsettings Show the values for all fppkg settings | |
| 315 | 349 | config Get/Set configuration file values | |
| 316 | 350 | Config commands: | |
| 317 | 351 | config get a.b Get setting from config file, section a, key b | |
| 318 | 352 | config get a b Get setting from config file, section a, key b | |
| 319 | 353 | config set a.b c Set setting from config file, section a, key b to value c | |
| 320 | 354 | config set a b c Set setting from config file, section a, key b to value c | |
| 321 | 355 | ||
| 322 | 356 | All the actions are described below. | |
| 323 | 357 | ||
| 324 | 358 | The package parameter can mean the following: | |
| 325 | 359 | ||
| 326 | 360 | - *Packagename:*The package name as it appears on the used repository. All available package names are listed by 'fppkg list'. | |
| 327 | 361 | - *Zipfile:* The full name of a zip-file (including the .zip extension) which contains a package. | |
| 328 | 362 | - *Current directory:* When there is no package parameter, fppkg looks for a file called 'fpmake.pp' in the current directory, and if it is found, use the package defined by that file. In this case the compiled files are not placed elsewhere (See the 'BuildDir' setting) but within the 'units' directory in the current directory. | |
| 329 | 363 | ||
| 330 | 364 | ## Actions | |
| 331 | 365 | ||
| 332 | 366 | ### Update | |
| 333 | 367 | ||
| 334 | 368 | Update packages list | |
| 335 | 369 | ||
| 336 | 370 | ### List | |
| 337 | 371 | ||
| 338 | 372 | List available and installed packages | |
| 339 | 373 | ||
| 340 | 374 | ### Build | |
| 341 | 375 | ||
| 342 | 376 | Build package | |
| 343 | 377 | ||
| 344 | 378 | ### Install | |
| 345 | 379 | ||
| 346 | 380 | Install package | |
| 347 | 381 | ||
| 348 | 382 | ### Download | |
| 349 | 383 | ||
| 350 | 384 | Download package | |
| 351 | 385 | ||
| 352 | 386 | ### Convertmk | |
| 353 | 387 | ||
| 354 | 388 | Convert Makefile.fpc to fpmake.pp | |
| 355 | 389 | ||
| 356 | 390 | ### Config | |
| 357 | 391 | ||
| 358 | 392 | Use this to quickly get or set configuration settings. | |
| 359 | 393 | ||
| 360 | 394 | ## Configuration | |
| 361 | 395 | ||
| 362 | 396 | ### General configuration | |
| 363 | 397 | ||
| 364 | 398 | On startup fppkg reads it's settings from fppkg.cfg. If it can not find it, it will try to create one with some default values. In this configuration file the location of the local repository is set. Normally this is in the user's home-directory. It is also possible to add custom options which are always passed when fpmake is called. This can be used by fpmake-addins. For all other options see the global configuration file. | |
| 365 | 399 | ||
| 366 | 400 | Besides the global configuration file, there is also a file which is specific for a compiler version. You can add as much of these files as you want, using different compiler versions or compiler options. A common use is for cross-compiling. You can specify which configuration file to use on the fppkg command line with the '-c' option. The location of these configuration files is set in fppkg.cfg. when no configuration file is specified, the file called 'default' is used. (This can be set in fppkg.cfg) | |
| 367 | 401 | ||
| 368 | 402 | Most important settings in these configuration files are the locations of where the packages have to be installed. Fppkg supports two different locations for installed packages. One 'global' location, which normally can be used by all users of the computer. And a 'local' location which in most cases is in a user's home-directory. These locations can be set with the 'localprefix' and 'globalprefix' settings. If you want that fppkg detects which packages are installed by fpc itself, the 'globalprefix' has to be set to match the prefix of your fpc-installation. It is common to use the location of the local repository (set in fppkg.cfg) as setting for the localprefix. For a better explanation of all options see the compiler configuration files. | |
| 369 | 403 | ||
| 370 | 404 | The 'fppkg listsettings' command will show the values for all settings and the names of the used configuration files. From settings that allow macros the value as it is set by the user and the value when all macros are evaluated are both shown. | |
| 371 | 405 | ||
| 372 | 406 | ### The global configuration file | |
| 373 | 407 | ||
| 374 | 408 | The global configuration file contains general information for fppkg, like the repository to download from and where to place the temporary files. A typical global configuration file looks like this: (linux) | |
| 375 | 409 | ||
| 376 | - | ||
| 377 | - | ||
| 378 | - | ||
| 379 | - | ||
| 380 | - | ||
| 381 | - | ||
| 382 | - | ||
| 383 | - | ||
| 384 | - | ||
| 385 | - | ||
| 386 | - | ||
| 410 | + | ```text | |
| 411 | + | [Defaults] | |
| 412 | + | ConfigVersion=4 | |
| 413 | + | LocalRepository={UserDir}.fppkg/ | |
| 414 | + | BuildDir={LocalRepository}build/ | |
| 415 | + | ArchivesDir={LocalRepository}archives/ | |
| 416 | + | CompilerConfigDir={LocalRepository}config/ | |
| 417 | + | RemoteMirrors=http://www.freepascal.org/repository/mirrors.xml | |
| 418 | + | RemoteRepository=auto | |
| 419 | + | CompilerConfig=default | |
| 420 | + | FPMakeCompilerConfig=default | |
| 421 | + | Downloader=lnet | |
| 422 | + | ``` | |
| 387 | 423 | ||
| 388 | 424 | When fppkg is started it first tries to load fppkg.cfg from a user-specific location. If a user-specific version can not be found fppkg searches for a system-wide fppkg.cfg. See the table for the exact location of these files. If both files do not exist a configuration file is created. When the current user is a superuser, a system-wide configuration file is made, else a user-specific one. When creating the configuration file fppkg tries some reasonable defaults for all settings. When you set the location of the fpc-installation in the enviroment-option FPCDIR, fppkg will use this location in the generated configuration files. | |
| 389 | 425 | ||
| 390 | 426 | When you have the installed FPC packages used from FPC instalation or from Lazarus instalation that you need also write repository sections into the global configuration file. A typical global configuration file looks like this: (Windows) | |
| 391 | 427 | ||
| 392 | - | ||
| 393 | - | ||
| 394 | - | ||
| 395 | - | ||
| 396 | - | ||
| 397 | - | ||
| 398 | - | ||
| 399 | - | ||
| 400 | - | ||
| 401 | - | ||
| 402 | - | ||
| 403 | - | ||
| 404 | - | ||
| 428 | + | ```text | |
| 429 | + | [Global] | |
| 430 | + | ConfigVersion=5 | |
| 431 | + | RemoteMirrors=https://www.freepascal.org/repository/mirrors.xml | |
| 432 | + | LocalRepository=C:\Users\UserName\AppData\Local\FreePascal\fppkg\ | |
| 433 | + | BuildDir={LocalRepository}build\ | |
| 434 | + | ArchivesDir={LocalRepository}archives\ | |
| 435 | + | CompilerConfigDir={LocalRepository}config\ | |
| 436 | + | CompilerConfig=default | |
| 437 | + | FPMakeCompilerConfig=default | |
| 438 | + | RemoteRepository=auto | |
| 439 | + | FPMakeOptions=--lazarusdir=C:\lazarus | |
| 440 | + | Downloader=FPC | |
| 441 | + | InstallRepository=user | |
| 405 | 442 | ||
| 406 | - | ||
| 407 | - | ||
| 408 | - | ||
| 409 | - | ||
| 410 | - | ||
| 443 | + | [Repository] | |
| 444 | + | Name=lazarus_fpc | |
| 445 | + | Description=Packages which are installed along with the Lazarus Free Pascal Compiler | |
| 446 | + | Path=C:\lazarus\fpc\3.2.0 | |
| 447 | + | Prefix=C:\lazarus\fpc\3.2.0 | |
| 411 | 448 | ||
| 412 | - | ||
| 413 | - | ||
| 414 | - | ||
| 415 | - | ||
| 416 | - | ||
| 449 | + | [Repository] | |
| 450 | + | Name=user | |
| 451 | + | Description=User-installed packages | |
| 452 | + | Path={LocalRepository}units/{CompilerVersion} | |
| 453 | + | Prefix={LocalRepository} | |
| 454 | + | ``` | |
| 417 | 455 | ||
| 418 | 456 | When you want to know for sure which configuration files fppkg uses, use the 'listsettings' action. It will list which configuration files are used plus the values for all settings. | |
| 419 | 457 | ||
| 420 | 458 | | OS | User-specific configuration file | System-wide configuration file | | |
| 421 | 459 | |----|----|----| | |
| 422 | 460 | | Unix/Linux | ~/.config/fppkg.cfg | /etc/fppkg.cfg | | |
| 423 | 461 | | Windows | %localsettings%\FreePascal\fppkg\fppkg.cfg | | | |
| 424 | 462 | ||
| 425 | 463 | Location of configuration files on different OS'es | |
| 426 | 464 | ||
| 427 | 465 | The following settings are available: | |
| 428 | 466 | ||
| 429 | 467 | LocalRepository | |
| 430 | 468 | The location where local repository information is stored. Supports macros. | |
| 431 | 469 | ||
| 432 | 470 | BuildDir | |
| 433 | 471 | The location where packages are build when a package is supplied. When the package in the current directory is used, this setting is ignored. Supports macros. | |
| 434 | 472 | ||
| 435 | 473 | ArchivesDir | |
| 436 | 474 | Place where packages downloaded from a remote repository are stored. Supports macros. | |
| 437 | 475 | ||
| 438 | 476 | CompilerConfigDir | |
| 439 | 477 | Place where the compiler-configuration files can be found. Supports macros. | |
| 440 | 478 | ||
| 441 | 479 | RemoteMirrors | |
| 442 | 480 | The URL to a file which contains all mirrors for a remote repository. | |
| 443 | 481 | ||
| 444 | 482 | RemoteRepository | |
| 445 | 483 | Contains the repository which has to be used. Selecting 'auto' will result in a random repository selected from the mirror list. | |
| 446 | 484 | ||
| 447 | 485 | Compilerconfig | |
| 448 | 486 | The filename of the compiler-configuration file which has to be used by default. | |
| 449 | 487 | ||
| 450 | 488 | FPMakeCompilerconfig | |
| 451 | 489 | The filename of the compiler-configuration file which has to be used by default for compiling the fpmake.pp files. | |
| 452 | 490 | ||
| 453 | 491 | Downloader | |
| 454 | 492 | Select the download-mechanism. lnet is the default. | |
| 455 | 493 | ||
| 456 | 494 | FPMakeOptions | |
| 457 | 495 | Specifies options which have to be added to each call to fpmake. Use this if you have fpmake-addons installed that need some specific settings. An example is the lazmkunit-addin, which needs the lazarusdir setting. (FPMakeOptions=--lazarusdir=/path/to/lazarus) | |
| 458 | 496 | ||
| 459 | 497 | ConfigVersion | |
| 460 | 498 | The version number of the used configuration-file format. Is used internally to check if the configuration file is in the format fppkg expects. Do not change. | |
| 461 | 499 | ||
| 462 | 500 | InstallRepository | |
| 463 | 501 | Repository name for update and install the packages. | |
| 464 | 502 | ||
| 465 | 503 | #### Configuration for use with Lazarus | |
| 466 | 504 | ||
| 467 | 505 | Some packages use the lazmkunit to integrate with Lazarus. When these packages are installed they need to know where Lazarus is installed. Add the following line with the path to your lazarus installation to fppkg.cfg: | |
| 468 | 506 | ||
| 469 | - | ||
| 507 | + | ```text | |
| 508 | + | FPMakeOptions=--lazarusdir=/path/to/lazarus | |
| 509 | + | ``` | |
| 470 | 510 | ||
| 471 | 511 | ### Compiler configuration files | |
| 472 | 512 | ||
| 473 | 513 | A compiler configuration file contains all information necessary to select which fpc-compiler to use. A typical compiler-configuration file looks like this: | |
| 474 | 514 | ||
| 475 | - | ||
| 476 | - | ||
| 477 | - | ||
| 478 | - | ||
| 479 | - | ||
| 480 | - | ||
| 481 | - | ||
| 482 | - | ||
| 483 | - | ||
| 515 | + | ```text | |
| 516 | + | [Defaults] | |
| 517 | + | ConfigVersion=4 | |
| 518 | + | GlobalPrefix=/usr/local/lib/fpc | |
| 519 | + | LocalPrefix={LocalRepository} | |
| 520 | + | Compiler=/usr/local/bin/fpc | |
| 521 | + | OS=linux | |
| 522 | + | CPU=i386 | |
| 523 | + | Version=2.5.1 | |
| 524 | + | CompilerOptions=-XR/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk -WM10.14 | |
| 525 | + | ``` | |
| 484 | 526 | ||
| 485 | 527 | The following settings are available: | |
| 486 | 528 | ||
| 487 | 529 | GlobalPrefix | |
| 488 | 530 | The prefix which has to be used when installing global packages. Normally this is the prefix of where fpc is installed, so that the packages which are installed by fpc are recognised. Supports macros. | |
| 489 | 531 | ||
| 490 | 532 | LocalPrefix | |
| 491 | 533 | Supports macros. | |
| 492 | 534 | ||
| 493 | 535 | GlobalInstallDir | |
| 494 | 536 | This is the location where the global packages are installed. The default value is {GlobalPrefix}lib/fpc/{compilerversion}/ on unices, and {globalprefix} on other operating systems. Supports macros. | |
| 495 | 537 | ||
| 496 | 538 | LocalInstallDir | |
| 497 | 539 | This is the location where the user-specifig (local) packages are installed. Add this path to the search path of the compiler if you want to use one of the packages installed into this location. The default value is {LocalPrefix}lib/fpc/{compilerversion}/ on unices, and {LocalPrefix} on other operating systems. Supports macros. | |
| 498 | 540 | ||
| 499 | 541 | Compiler | |
| 500 | 542 | The executable name of the compiler which has to be used. | |
| 501 | 543 | ||
| 502 | 544 | OS | |
| 503 | 545 | The target OS. | |
| 504 | 546 | ||
| 505 | 547 | CPU | |
| 506 | 548 | The target CPU-family. | |
| 507 | 549 | ||
| 508 | 550 | Version | |
| 509 | 551 | The version of the used compiler. | |
| 510 | 552 | ||
| 511 | 553 | ConfigVersion | |
| 512 | 554 | The version number of the used configuration-file format. Is used internally to check if the configuration file is in the format fppkg expects. | |
| 513 | 555 | ||
| 514 | 556 | CompilerOptions | |
| 515 | 557 | Additional compiler options to be used when compiling fpmake and/or other packages. All compiler invocations are done with the -n command-line, causing the compiler not to read your fpc config file. This means that if your system needs additional options to work correctly (such as the MacOS development kit location) then you must set them here. | |
| 516 | 558 | ||
| 517 | 559 | ### Using macros in the configuration files | |
| 518 | 560 | ||
| 519 | 561 | To make life easier you can use macros within the configuration-files. Macro's are between accolades '{}' and they are substituted on by some dynamic values. The following macros are available: | |
| 520 | 562 | ||
| 521 | 563 | AppConfigDir | |
| 522 | 564 | Returns the location where fppkg stores it's user-specific configuration files. In fact it calls [GetAppConfigDir](http://www.freepascal.org/docs-html/rtl/sysutils/getappconfigdir.html) with Global=false. | |
| 523 | 565 | ||
| 524 | 566 | UserDir | |
| 525 | 567 | Returns the location of the user's home-directory. ([GetUserDir](http://www.freepascal.org/docs-html/rtl/sysutils/getuserdir.html)) | |
| 526 | 568 | ||
| 527 | 569 | LocalRepository | |
| 528 | 570 | The value of LocalRepository in the global configuration file | |
| 529 | 571 | ||
| 530 | 572 | CompilerVersion | |
| 531 | 573 | The version of the compiler as set in the compile configuration file, or the version detected from the compiler executable. This macro is not available in the global configuration file. | |
| 532 | 574 | ||
| 533 | 575 | ## Upgrade | |
| 534 | 576 | ||
| 535 | 577 | After upgrading the compiler your old fppkg directory is outdated. | |
| 536 | 578 | ||
| 537 | 579 | - If you use only one compiler version remove your **~/.fppkg/config/default** directory and do **fppkg update**. | |
| 538 | 580 | - If you use multiple compiler versions copy the **~/.fppkg/config/default** to **~/.fppkg/config/3.1.1** and then use **fppkg -c 3.1.1**. | |
| 539 | 581 | ||
| 540 | 582 | --- | |
| 541 | 583 | *From the Free Pascal wiki, page "fppkg", as it stood on 2020-11-13 after a change by SeniorAndre, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 542 | 584 | Category: FPC | |
| 543 | 585 | Category: Packages |