usr.sbin/pkg_install/updating/pkg_updating.1

   1 .\"
   2 .\" FreeBSD updating - Scan the installed ports and show all UPDATING entries
   3 .\"     that affect one of the installed ports. Alternative a list of portnames
   4 .\" could be passed to pkg_updating
   5 .\"
   6 .\" "THE BEER-WARE LICENSE" (Revision 42):
   7 .\" <beat@chruetertee.ch> wrote this file. As long as you retain this notice you
   8 .\" can do whatever you want with this stuff. If we meet some day, and you think
   9 .\" this stuff is worth it, you can buy me a beer in return.          Beat Gätzi
  10 .\"
  11 .\" $FreeBSD$
  12 .\"
  13 .Dd May 30, 2008
  14 .Dt PKG_UPDATING 1
  15 .Os
  16 .Sh NAME
  17 .Nm pkg_updating
  18 .Nd a utility for displaying UPDATING entries of software packages
  19 .Sh SYNOPSIS
  20 .Nm
  21 .Op Fl h
  22 .Op Fl d Ar date
  23 .Op Fl f Ar file
  24 .Op Ar pkg-name ...
  25 .Nm
  26 .Sh DESCRIPTION
  27 The
  28 .Nm
  29 command scans the installed ports and show all UPDATING entries that affect one
  30 of the installed ports. Alternative a list of pkg-names could be passed.
  31 .Sh OPTIONS
  32 The following command line options are supported:
  33 .Bl -tag -width indent
  34 .It Ar pkg-name ...
  35 UPDATING entries for the named packages are displayed.
  36 .It Fl d , -date Ar date
  37 Only entries newer than
  38 .Ar date
  39 are shown. Use a YYYYMMDD date format.
  40 .It Fl f , -file Ar file
  41 Defines a alternative location of the UPDATING
  42 .Ar file .
  43 .It Fl h , -help
  44 Print help message.
  45 .El
  46 .Sh EXAMPLES
  47 .Bl -tag -width indent
  48 .Dl pkg_updating
  49 .Pp
  50 Shows all entries of all installed ports.
  51 .Pp
  52 .Dl pkg_updating -d 20070101
  53 .Pp
  54 Shows all entries of all installed ports since 2007-01-01.
  55 .Pp
  56 .Dl pkg_updating apache mysql
  57 .Pp
  58 Shows all entries for all apache and mysql ports.
  59 .Pp
  60 .Dl pkg_updating -d 20060101 apache
  61 .Pp
  62 Shows all apache entries since 2006-01-01.
  63 .Pp
  64 .Dl pkg_updating -f /tmp/UPDATING
  65 .Pp
  66 Defines that the UPDATING file is in /tmp and shows all entries of all
  67 installed ports
  68 .Pp
  69 .El
  70 .Sh ENVIRONMENT
  71 .Bl -tag -width PKG_DBDIR
  72 .It Ev PKG_DBDIR
  73 Specifies an alternative location for the installed package database.
  74 .It Ev PORTSDIR
  75 Location of the ports tree.
  76 .El
  77 .Sh FILES
  78 .Bl -tag -width /var/db/pkg -compact
  79 .It Pa /var/db/pkg
  80 Default location of the installed package database.
  81 .It Pa /usr/ports
  82 The default ports directory and default location of the UPDATING file
  83 .El
  84 .Sh SEE ALSO
  85 .Xr pkg_add 1 ,
  86 .Xr pkg_create 1 ,
  87 .Xr pkg_delete 1 ,
  88 .Xr pkg_version 1
  89 .Sh AUTHORS
  90 .An Beat Gätzi Aq beat@chruetertee.ch
  91 .Sh CONTRIBUTORS
  92 .An Martin Tournoij Aq carpetsmoker@xs4all.nl
  93 .Sh BUGS
  94 Sure to be some.