tpm.1 - pm - barely a pack manager
 (HTM) git clone git://z3bra.org/pm
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       tpm.1 (2108B)
       ---
            1 .Dd 2016-01-13
            2 .Dt PM 1
            3 .Os POSIX.1-2008
            4 .Sh NAME
            5 .Nm pm
            6 .Nd pack manager
            7 .Sh SYNOPSIS
            8 .Nm pm
            9 .Op Fl adfiuv
           10 .Op Ar PACK..
           11 .Sh DESCRIPTION
           12 .Nm
           13 installs, deletes, inspects and updates packs on a POSIX operating system.
           14 .Bl -tag -width Ds
           15 .It Fl a Ar <file>
           16 Add pack(s) under $ROOT. This action will fail if a file from the pack already
           17 exists under $ROOT (See
           18 .Fl f
           19 flag)
           20 .It Fl d Ar <arg>
           21 Delete a pack from the system based on informations loaded from either a
           22 filename or a pack name. In case of a pack name, the information is loaded
           23 from $DATA/<arg>
           24 .It Fl u Ar <file>
           25 Update pack by first deleting it, and reinstalling it. If the version
           26 of the pack provided is the same as the installed one, do nothing.
           27 .It Fl i Ar [name]
           28 If a name is provided, print the list of files installed for
           29 .Em name .
           30 Otherwise, list all packs installed on the system (increase verbosity with
           31 .Fl v
           32 to see the version).
           33 .It Fl v
           34 Increase verbosity by one level. There are three levels of logging, as follow:
           35 .Bl -enum -compact
           36 .It
           37 write out which action has been done (INFO)
           38 .It
           39 detail all tasks being executed (VERBOSE)
           40 .It
           41 report every change made to the filesystem (DEBUG)
           42 .El
           43 .Pp
           44 Each level includes the messages of the previous ones.
           45 .It Fl f
           46 Force overwriting files during installation. This shouldn't be needed, so take
           47 extra care when using it.
           48 .El
           49 .Sh EXAMPLES
           50 To install a pack to
           51 .Pa ~/.local ,
           52 upgrade and then delete it:
           53 .Bd -literal
           54   export ROOT=~/.local
           55   export DATA=~/.cache/pmdb
           56 
           57   pm -a name@1.0.tbz
           58   pm -u name@1.1.tbz
           59   pm -d name
           60 .Ed
           61 .Pp
           62 See
           63 .Xr pack 5
           64 for details on how to create a valid pack.
           65 .Pp
           66 To get a list of packs installed, and their current version can be inspected
           67 with the
           68 .Fl i
           69 switch. The files installed by a pack are listed if a name is provided.
           70 .Bd -literal
           71   pm -iv
           72   pm -i name
           73   
           74 .Ed
           75 .Sh ENVIRONMENT
           76 .Bl -tag -width "ROOT"
           77 .It Ev ROOT
           78 Specifies the directory to use as the rootfs for packs installation
           79 (default: /).
           80 .It Ev DATA
           81 Directory where the pack metadata will be stored (default: /var/db/pm).
           82 .El
           83 .Sh SEE ALSO
           84 .Xr pack 5 ,
           85 .Sh AUTHORS
           86