development / pkgutils-cross.git / blame
| Commit | Line | Data |
|---|---|---|
| 9ac667e6 SR |
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. |