summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorIvy Foster <ivy.foster@gmail.com>2017-09-22 13:01:09 -0500
committerAllan McRae <allan@archlinux.org>2017-12-07 14:55:35 +1000
commitab2be5794de8a57426ec3fc0f631cc766a0b8227 (patch)
tree6a4b32e810ece8a8806cb2df578713f8e79ef107 /doc
parent67ce123457cf9c0ee9d4298776ae563202214c69 (diff)
downloadpacman-ab2be5794de8a57426ec3fc0f631cc766a0b8227.tar.xz
makepkg: implement error codes
For your convenience, makepkg now has 16 distinct ways to fail. Also closes FS#54204. Signed-off-by: Ivy Foster <iff@escondida.tk> Signed-off-by: Allan McRae <allan@archlinux.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/makepkg.8.txt57
1 files changed, 57 insertions, 0 deletions
diff --git a/doc/makepkg.8.txt b/doc/makepkg.8.txt
index e1d50775..460c4e26 100644
--- a/doc/makepkg.8.txt
+++ b/doc/makepkg.8.txt
@@ -288,6 +288,63 @@ See linkman:makepkg.conf[5] for more details on configuring makepkg using the
'makepkg.conf' file.
+Errors
+------
+On exit, makepkg will return one of the following error codes.
+
+0::
+ Normal exit condition.
+
+1::
+ Unknown cause of failure.
+
+2::
+ Error in configuration file.
+
+3::
+ User specified an invalid option
+
+4::
+ Error in user-supplied function in PKGBUILD.
+
+5::
+ Failed to create a viable package.
+
+6::
+ A source or auxiliary file specified in the PKGBUILD is
+ missing.
+
+7::
+ The PKGDIR is missing.
+
+8::
+ Failed to install dependencies.
+
+9::
+ Failed to remove dependencies.
+
+10::
+ User attempted to run makepkg as root.
+
+11::
+ User lacks permissions to build or install to a given
+ location.
+
+12::
+ Error parsing PKGBUILD.
+
+13::
+ A package has already been built.
+
+14::
+ The package failed to install.
+
+15::
+ Programs necessary to run makepkg are missing.
+
+16::
+ Specified GPG key does not exist.
+
See Also
--------
linkman:makepkg.conf[5], linkman:PKGBUILD[5], linkman:pacman[8]