sys/man/1/pkg

   1 .TH PKG 1
   2 .SH NAME
   3 create, install, list, local, remove \- 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 .SH DESCRIPTION
  18 .I Pkg
  19 is a simple package management system primarily written in
  20 .IR rc (1).
  21 It can be used to create, install, and remove software packages
  22 from an arbitrary package repository, indicated by the environment
  23 variable
  24 .I $pkgpath.
  25 If
  26 .I $pkgpath
  27 is not set, the system defaults to a hardcoded repository of approved
  28 packages.
  29 .TP
  30 .I Pkg/create
  31 Create builds a new package
  32 .IR name ,
  33 whose source is found in directory
  34 .IR name ,
  35 then packs it into a
  36 .I bzip2 (see
  37 .IR gzip (1))
  38 compressed
  39 .IR tar (1)
  40 archive suitable for upload to a package
  41 repository. The source directory should be provided as a full path.
  42 .TP
  43 .I Pkg/install
  44 Install the package
  45 .I name
  46 from the current repository, unpacking the executables in
  47 .B /$cputype/bin/
  48 or
  49 .B /rc/bin/
  50 and the source in
  51 .B /sys/src/pkg/.
  52 .TP
  53 .I Pkg/list
  54 List packages available from the current repository.
  55 .TP
  56 .I Pkg/local
  57 List locally installed packages.
  58 .TP
  59 .I Pkg/remove
  60 Remove the package
  61 .I name
  62 from the local system.
  63 .SH EXAMPLES
  64 .LP
  65 Create the package
  66 .B irc7-2011.09.21:
  67 .sp 1
  68 .EX
  69 % pkg/create /sys/src/cmd/irc7-2011.09.21
  70 .EE
  71
  72 .LP
  73 Install the
  74 .B Go
  75 programming language:
  76 .sp 1
  77 .EX
  78 % pkg/install go-2011.05.10
  79 .EE
  80 .SH FILES
  81 .TF
  82 .TP
  83 .B /sys/lib/pkg/*
  84 hash files of packages installed locally.
  85 .TP
  86 .B /sys/src/pkg/*
  87 source files of packages installed locally.
  88 .SH SOURCE
  89 .B /sys/src/cmd/pkg/create
  90 .br
  91 .B /sys/src/cmd/pkg/install
  92 .br
  93 .B /sys/src/cmd/pkg/list
  94 .br
  95 .B /sys/src/cmd/pkg/local
  96 .br
  97 .B /sys/src/cmd/pkg/remove
  98 .br
  99 .B /sys/src/cmd/pkg/unpkg.c
 100 .SH SEE ALSO
 101 .IR contrib (1)