expand docs

[zpackage] / doc / zpm-extract.8

diff --git a/doc/zpm-extract.8 b/doc/zpm-extract.8
new file mode 100644 (file)
index 0000000..05d26bb
--- /dev/null
+++ b/doc/zpm-extract.8
@@ -0,0 +1,33 @@
+.TH zpm-extract 8 2019-02-14 "ZPM 0.3"
+.SH NAME
+zpm-extract \- extract files from a zpm database
+.SH SYNOPSIS
+.B zpm extract
+[
+.BI -f " pkgfile"
+]
+.I hash path
+.SH DESCRIPTION
+\fBzpm-extract\fR
+extracts file content specified by hash, or a unique prefix of a hash,
+to the path specified.  The permissions are set to 0600, and the
+owner and group will be the current user and group.
+.SH OPTIONS
+.TP
+\-f
+specify the package file to find packages in
+.SH EXAMPLES
+.TP
+zpm extract abcdef012 /tmp/out
+Extract from $ZPMDB the contents of a file whose sha256 hash begins with
+abcdef012 to /tmp/out. 
+.SH EXIT STATUS
+0 on success non zero on failure
+.SH FILES
+/var/lib/zpm/local.db
+.SH ENVIRONMENT
+ZPMDB
+.SH AUTHOR
+Nathan Wagner
+.SH SEE ALSO
+.BR zpm (8)