sys/man/1/pkg

   1 .TH PKG 1
   2 .SH NAME
   3 create, install, list, local, remove, unpkg \- trivial package management
   4 .SH SYNOPSIS
   5 .B pkg/create
   6 .I name
   7 .br
   8 .B pkg/install
   9 .I name
  10 .br
  11 .B pkg/list
  12 .br
  13 .B pkg/local
  14 .br
  15 .B pkg/remove
  16 .I name
  17 .br
  18 .B pkg/unpkg
  19 .SH DESCRIPTION
  20 .I Pkg
  21 is a simple package management system primarily written in
  22 .IR rc (1).
  23 It can be used to create, install, and remove software packages
  24 from an arbitrary package repository, indicated by the environment
  25 variable
  26 .I $pkgpath.
  27 If
  28 .I $pkgpath
  29 is not set, the system defaults to a hardcoded repository of approved
  30 packages.
  31 .TP
  32 .I Pkg/create
  33 Create builds a new package
  34 .IR name ,
  35 whose source is found in directory
  36 .IR name ,
  37 then packs it into a
  38 .I bzip2 (see
  39 .IR gzip (1))
  40 compressed
  41 .IR tar (1)
  42 archive suitable for upload to a package
  43 repository. The source directory should be provided as a full path.
  44 .TP
  45 .I Pkg/install
  46 Install the package
  47 .I name
  48 from the current repository, unpacking the executables in
  49 .B /$cputype/bin/
  50 or
  51 .B /rc/bin/
  52 and the source in
  53 .B /sys/src/pkg/.
  54 .TP
  55 .I Pkg/list
  56 List packages available from the current repository.
  57 .TP
  58 .I Pkg/local
  59 List locally installed packages.
  60 .TP
  61 .I Pkg/remove
  62 Remove the package
  63 .I name
  64 from the local system.
  65 .TP
  66 .I Pkg/unpkg
  67 A modified
  68 .IR tar (1)
  69 used by
  70 .B pkg/install
  71 to generate checksums for every unpacked file.
  72 .SH EXAMPLES
  73 .LP
  74 Create the package
  75 .B irc7-2012.06.22:
  76 .sp 1
  77 .EX
  78 % pkg/create /sys/src/pkg/irc7-2012.06.22
  79 .EE
  80
  81 .LP
  82 Install the
  83 .B mpm
  84 troff macros:
  85 .sp 1
  86 .EX
  87 % pkg/install mpm-2011.05.14
  88 .EE
  89 .SH FILES
  90 .TF
  91 .TP
  92 .B /sys/lib/pkg/*
  93 hash files of packages installed locally.
  94 .TP
  95 .B /sys/src/pkg/*
  96 source files of packages installed locally.
  97 .SH SOURCE
  98 .B /sys/src/cmd/pkg/create
  99 .br
 100 .B /sys/src/cmd/pkg/install
 101 .br
 102 .B /sys/src/cmd/pkg/list
 103 .br
 104 .B /sys/src/cmd/pkg/local
 105 .br
 106 .B /sys/src/cmd/pkg/remove
 107 .br
 108 .B /sys/src/cmd/pkg/unpkg.c
 109 .SH REPOSITORIES
 110 .B http://9front.org/pkg/386
 111 .br
 112 .B https://offblast.org/pkg/386
 113 .br
 114 .B https://offblast.org/pkg/amd64
 115 .br
 116 .B http://plan9.bell-labs.com/sources/contrib/staal1978/pkg
 117 .SH SEE ALSO
 118 .IR gzip (1) ,
 119 .IR tar (1)
 120 .SH HISTORY
 121 .I Pkg
 122 first appeared in 9front (May, 2011).