]> pd.if.org Git - zpackage/blob - doc/zpm-log.8
expand verify
[zpackage] / doc / zpm-log.8
1 .TH zpm-log 8 2019-02-15 "ZPM 0.3"
2 .SH NAME
3 zpm-log \- manage the zpm log
4 .SH SYNOPSIS
5 .B zpm log
6 [
7 .BI -f " pkgfile"
8 ]
9 [
10 .BI -t " target"
11 ]
12 [
13 .BI -a " action"
14 ]
15 [
16 .BI -T " timestamp"
17 ]
18 [
19 .B -ijvr
20 ]
21 .RI [ message ...]
22 .SH DESCRIPTION
23 \fBzpm-log\fR
24 prints or inserts into the zpm log, which is stored in the local database,
25 or the database given by the \-f option.
26 .SH OPTIONS
27 .TP
28 .B \-f path
29 specify the database file where the log is stored.  Defaults to
30 $ZPMDB or /var/lib/zpm/local.db
31 .TP
32 .B \-t target
33 Specify the target of the log.  This is generally a package id.
34 When listing, this filters the log to only targets that match.
35 .TP
36 .B \-a action
37 Specify the action taken.  This is intended to be stylized for eazy
38 machine readability.
39 .TP
40 .B \-T timestamp
41 Specify the timestamp of the log message.  By default the current timestamp
42 is used for an insert.  If this option is given when listing log messages,
43 it is used as the earliest time logs are listed from.
44 .TP
45 .B \-i
46 Insert the log message given as arguments.  Non option arguments
47 are concatenated with a space separator and inserted into the log.
48 list package names only
49 .TP
50 .B \-j
51 Output the log in json format.
52 .TP
53 .B \-v
54 Verbose mode.  On insert, print the log message inserted to stdout.
55 .TP
56 .B \-r
57 When listing messages, output them in reverse timestamp order, newest
58 first.
59 .SH EXAMPLES
60 .TP
61 .B zpm log
62 Lists all log messages in the default database.
63 .SH EXIT STATUS
64 0 on success non zero on failure
65 .SH FILES
66 /var/lib/zpm/local.db
67 .SH ENVIRONMENT
68 ZPMDB
69 .SH AUTHOR
70 Nathan Wagner
71 .SH SEE ALSO
72 .BR zpm (8)