pd.if.org Git - zpackage/blob - 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)