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