| 1 | .TH pkgmk 8 "" "pkgutils #VERSION#" "" |
| 2 | .SH NAME |
| 3 | pkgmk \- make software package |
| 4 | .SH SYNOPSIS |
| 5 | \fBpkgmk [options]\fP |
| 6 | .SH DESCRIPTION |
| 7 | \fBpkgmk\fP is a \fIpackage management\fP utility, which makes |
| 8 | a software package. A \fIpackage\fP is an archive of files (.pkg.tar.gz) |
| 9 | that can be installed using pkgadd(8). |
| 10 | |
| 11 | To prepare to use pkgmk, you must write a file named \fIPkgfile\fP |
| 12 | that describes how the package should be build. Once a suitable |
| 13 | \fIPkgfile\fP file exists, each time you change some source files, |
| 14 | you simply execute pkgmk to bring the package up to date. The pkgmk |
| 15 | program uses the \fIPkgfile\fP file and the last-modification |
| 16 | times of the source files to decide if the package needs to be updated. |
| 17 | |
| 18 | Global build configuration is stored in \fI/etc/pkgmk.conf\fP. This |
| 19 | file is read by pkgmk at startup. |
| 20 | .SH OPTIONS |
| 21 | .TP |
| 22 | .B "\-i, \-\-install" |
| 23 | Install package using pkgadd(8) after successful build. |
| 24 | .TP |
| 25 | .B "\-u, \-\-upgrade" |
| 26 | Install package as an upgrade using pkgadd(8) after successful build. |
| 27 | .TP |
| 28 | .B "\-r, \-\-recursive" |
| 29 | Search for and build packages recursively. |
| 30 | .TP |
| 31 | .B "\-d, \-\-download" |
| 32 | Download missing source file(s). |
| 33 | .TP |
| 34 | .B "\-do, \-\-download\-only" |
| 35 | Do not build, only download missing source file(s). |
| 36 | .TP |
| 37 | .B "\-utd, \-\-up\-to\-date" |
| 38 | Do not build, only check if the package is up to date. |
| 39 | .TP |
| 40 | .B "\-uf, \-\-update\-footprint" |
| 41 | Update footprint and treat last build as successful. |
| 42 | .TP |
| 43 | .B "\-if, \-\-ignore\-footprint" |
| 44 | Build package without checking footprint. |
| 45 | .TP |
| 46 | .B "\-um, \-\-update\-md5sum" |
| 47 | Update md5sum using the current source files. |
| 48 | .TP |
| 49 | .B "\-im, \-\-ignore\-md5sum" |
| 50 | Build package without checking md5sum first. |
| 51 | .TP |
| 52 | .B "\-ns, \-\-no\-strip" |
| 53 | Do not strip executable binaries or libraries. |
| 54 | .TP |
| 55 | .B "\-f, \-\-force" |
| 56 | Build package even if it appears to be up to date. |
| 57 | .TP |
| 58 | .B "\-c, \-\-clean" |
| 59 | Remove the (previously built) package and the downloaded source files. |
| 60 | .TP |
| 61 | .B "\-kw, \-\-keep-work" |
| 62 | Keep temporary working directory. |
| 63 | .TP |
| 64 | .B "\-cf, \-\-config\-file <file>" |
| 65 | Use alternative configuration file (default is /etc/pkgmk.conf). |
| 66 | .TP |
| 67 | .B "\-v, \-\-version" |
| 68 | Print version and exit. |
| 69 | .TP |
| 70 | .B "\-h, \-\-help" |
| 71 | Print help and exit. |
| 72 | .SH FILES |
| 73 | .TP |
| 74 | .B "Pkgfile" |
| 75 | Package build description. |
| 76 | .TP |
| 77 | .B ".footprint" |
| 78 | Package footprint (used for regression testing). |
| 79 | .TP |
| 80 | .B ".md5sum" |
| 81 | MD5 checksum of source files. |
| 82 | .TP |
| 83 | .B "/etc/pkgmk.conf" |
| 84 | Global package make configuration. |
| 85 | .TP |
| 86 | .B "wget" |
| 87 | Used by pkgmk to download source code. |
| 88 | .SH SEE ALSO |
| 89 | pkgadd(8), pkgrm(8), pkginfo(8), rejmerge(8), wget(1) |
| 90 | .SH COPYRIGHT |
| 91 | pkgmk (pkgutils) is Copyright (c) 2000-2005 Per Liden and is licensed through |
| 92 | the GNU General Public License. Read the COPYING file for the complete license. |