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 ENVIRONMENT
  47 .Bl -tag -width PKG_DBDIR
  48 .It Ev PKG_DBDIR
  49 Specifies an alternative location for the installed package database.
  50 .It Ev PORTSDIR
  51 Location of the ports tree.
  52 .El
  53 .Sh FILES
  54 .Bl -tag -width /var/db/pkg -compact
  55 .It Pa /var/db/pkg
  56 Default location of the installed package database.
  57 .It Pa /usr/ports
  58 The default ports directory and default location of the UPDATING file.
  59 .El
  60 .Sh EXAMPLES
  61 Shows all entries of all installed ports:
  62 .Dl % pkg_updating
  63 .Pp
  64 Shows all entries of all installed ports since 2007-01-01:
  65 .Dl % pkg_updating -d 20070101
  66 .Pp
  67 Shows all entries for all apache and mysql ports:
  68 .Dl % pkg_updating apache mysql
  69 .Pp
  70 Shows all apache entries since 2006-01-01:
  71 .Dl % pkg_updating -d 20060101 apache
  72 .Pp
  73 Defines that the UPDATING file is in /tmp and shows all entries of all
  74 installed ports:
  75 .Dl % pkg_updating -f /tmp/UPDATING
  76 .Pp
  77 Fetch UPDATING file from ftp mirror and show all entries of all
  78 installed ports:
  79 .Dl % pkg_updating -f ftp://ftp.freebsd.org/pub/FreeBSD/ports/packages/UPDATING
  80 .Sh SEE ALSO
  81 .Xr pkg_add 1 ,
  82 .Xr pkg_create 1 ,
  83 .Xr pkg_delete 1 ,
  84 .Xr pkg_version 1
  85 .Sh AUTHORS
  86 .An Beat G\(:atzi Aq beat@chruetertee.ch
  87 .Sh CONTRIBUTORS
  88 .An Martin Tournoij Aq carpetsmoker@xs4all.nl
  89 .Sh BUGS
  90 Sure to be some.