external/bsd/pkg_install/dist/bpm/bpm.1

   1 .\" $NetBSD: bpm.1,v 1.5 2014/03/18 18:20:36 riastradh Exp $ */
   2 .\"
   3 .\" Copyright (c) 2003,2009 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Alistair Crooks (agc@NetBSD.org)
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd August 3, 2007
  31 .Dt BPM 1
  32 .Os
  33 .Sh NAME
  34 .Nm bpm
  35 .Nd menu-based binary package manager
  36 .Sh SYNOPSIS
  37 .Nm
  38 .Op Fl hnVv
  39 .Op Fl b Ar baseURL
  40 .Op Fl m Ar machine
  41 .Op Fl r Ar release
  42 .Op Fl w Ar seconds
  43 .Sh DESCRIPTION
  44 The
  45 .Nm
  46 command is used to locate and install binary packages from any
  47 reachable URL.
  48 .Pp
  49 The following command-line options are supported:
  50 .Bl -tag -width indent
  51 .It Fl b Ar baseURL
  52 Specify a base URL from which to download binary packages.
  53 The default URL is
  54 .Pa ftp://ftp.NetBSD.org/pub/pkgsrc/packages .
  55 .It Fl h
  56 Print a help message and then exit.
  57 .It Fl m Ar machine
  58 Use
  59 .Ar machine
  60 as the machine architecture to be used, instead of that returned by
  61 .Xr uname 1 .
  62 .It Fl n
  63 Don't actually execute the commands to add the package.
  64 .It Fl r Ar release
  65 Use
  66 .Ar release
  67 as the operating system release to be used, instead of that returned by
  68 .Xr uname 1 .
  69 .It Fl V
  70 Print version number and exit.
  71 .It Fl v
  72 Turn on verbose output.
  73 .It Fl w Ar seconds
  74 The number of
  75 .Ar seconds
  76 to wait after displaying an error message and returning to
  77 normal menu operations.
  78 .El
  79 .Pp
  80 .Nm
  81 provides a menu-based binary package manager for
  82 .Nx .
  83 .Nm
  84 first connects to the URL using
  85 .Xr ftp 1 ,
  86 and displays a list of categories for which binary packages exist.
  87 If no categories are displayed, it could
  88 be that the machine architecture or operating system release string
  89 have been wrongly interpreted, and that it will be necessary to override
  90 this values by means of the command line options.
  91 Within a category, a list of packages will be displayed, and by selecting
  92 one using the number assigned to it, the package will be downloaded
  93 automatically, and installed, using the
  94 .Xr pkg_add 1
  95 utility.
  96 It is also possible to change the category currently being examined,
  97 and to quit from the utility, simply by selecting the appropriate choices
  98 on the menu.
  99 .Sh ENVIRONMENT
 100 The environment variables which govern the behavior of
 101 .Xr ftp 1
 102 and
 103 .Xr pkg_add 1
 104 are valid for
 105 .Nm .
 106 .Sh SEE ALSO
 107 .Xr ftp 1 ,
 108 .Xr pkg_add 1 ,
 109 .Xr uname 1
 110 .Sh AUTHORS
 111 The
 112 .Nm
 113 utility was written by
 114 .An Alistair Crooks Aq Mt agc@NetBSD.org .