Difference between revisions of "PBI Manager/10.1"

From PC-BSD Wiki
Jump to: navigation, search
Line 9: Line 9:
 
This chapter provides an overview of the commands that are installed by PBI Manager. When using these commands, note that single character options can not be stacked. As an example, you must type '''pbi_add -i -v''' as '''pbi_add -iv''' will fail with a syntax error.
 
This chapter provides an overview of the commands that are installed by PBI Manager. When using these commands, note that single character options can not be stacked. As an example, you must type '''pbi_add -i -v''' as '''pbi_add -iv''' will fail with a syntax error.
  
=== pbi === <!--T:105-->
+
=== pbi ===  
  
 
The '''pbi''' meta-command can be used to install, uninstall, and get information about PBIs. Unlike the other '''pbi_*''' commands, it uses a space instead of an underscore. For example, '''pbi add''' is equivalent to '''pbi_add''' and either command can be used to install a PBI.
 
The '''pbi''' meta-command can be used to install, uninstall, and get information about PBIs. Unlike the other '''pbi_*''' commands, it uses a space instead of an underscore. For example, '''pbi add''' is equivalent to '''pbi_add''' and either command can be used to install a PBI.

Revision as of 12:28, 8 June 2014


Contents


PBI Manager is a suite of command line utilities which can be used to install, remove, and manage PBIs.

This chapter provides an overview of the commands that are installed by PBI Manager. When using these commands, note that single character options can not be stacked. As an example, you must type pbi_add -i -v as pbi_add -iv will fail with a syntax error.

pbi

The pbi meta-command can be used to install, uninstall, and get information about PBIs. Unlike the other pbi_* commands, it uses a space instead of an underscore. For example, pbi add is equivalent to pbi_add and either command can be used to install a PBI.

This meta-command expects to be given a sub-command, and then a suitable option for that sub-command. To see the available options for a sub-command, use the built-in help system. For example, to see the available options for the add sub-command, type pkg help add. Table 7.3a summarizes the available sub-commands.

Table 7.3a: pbi Sub-Commands [tables 1]
Sub-Command Description
add installs the specified PBI
delete uninstalls the specified PBI
help shows the options for the specified sub-command
icon adds or deletes the PBI's desktop icon, menu icon, or MIME registration
info shows all available PBIs or lists the packages installed into a specified jail
install equivalent to add

pbi_add

The pbi_add command is used to install a specified PBI. Table 7.3b summarizes the available options.

Table 7.3b: pbi_add Options [tables 2]
Switch Description
-f force installation, overwriting an already installed copy of the application
-i display information about specified PBI; if combined with -v, will display all of the files that will be installed with the PBI
-j <jailname> installs the PBI into the specified jail
-l display LICENSE text for specified PBI
-v enable verbose output

The following example installs the alpine PBI. When prompted, input your password.

sudo pbi_add alpine

Password: Updating repository catalogue Installing: alpine The following 2 packages will be installed:

       Installing pico-alpine: 2.00_1
       Installing alpine: 2.00_4

The installation will require 9 MB more space 2 MB to be downloaded pico-alpine-2.00_1.txz 100% 314KB 313.9KB/s 313.9KB/s 00:01 alpine-2.00_4.txz 100% 1701KB 1.7MB/s 1.4MB/s 00:01 Checking integrity... done The following 2 packages will be installed:

       Installing pico-alpine: 2.00_1
       Installing alpine: 2.00_4

The installation will require 9 MB more space 0 B to be downloaded Checking integrity... done [1/2] Installing pico-alpine-2.00_1... done [2/2] Installing alpine-2.00_4... done ******************************************************************************* *** To use GnuPG with Alpine, take a look at the mail/pine-pgp-filters port ***

*******************************************************************************

pbi.conf

The pbi_* commands support several environment variables which can be stored in the ASCII text configuration file, /usr/local/etc/pbi.conf. These proxy variables are only needed if the system uses a proxy server to access the Internet. Table 7.3c lists the supported variables.

Table 7.3c: pbi.conf Variables [tables 3]
Variable Description
PBI_PROXYURL proxy server IP address
PBI_PROXYPORT proxy server port number
PBI_PROXYTYPE can be HTTP or SOCKS5
PBI_PROXYUSER username used to authenticate with proxy server
PBI_PROXYPASS password used to authenticate with proxy server
PBI_FBSDMAJOR can be set to the major FreeBSD version when running -CURRENT or some other version with no PBIs

pbi_delete

The pbi_delete command removes an installed PBI from the system. Table 7.3d summarizes its one available option:

Table 7.3d: pbi_delete Options [tables 4]
Switch Description
-v enable verbose output

The following example uninstalls the previously installed alpine PBI:

sudo pbi_delete alpine

Password: Updating repository catalogue Deinstallation has been requested for the following 1 packages:

       alpine-2.00_4

The deinstallation will free 8 MB [1/1] Deleting alpine-2.00_4... done Deinstallation has been requested for the following 2 packages:

       openjpeg-2.1.0
       pico-alpine-2.00_1

The deinstallation will free 2 MB [1/2] Deleting openjpeg-2.1.0... done

[2/2] Deleting pico-alpine-2.00_1... done

pbi_icon

The pbi_icon command provides a number of options for adding desktop icons, menu entries, and MIME data for an installed PBI. Not all PBIs will contain desktop/menu/MIME data. Additionally, the window manager must be XDG[1]-compliant to understand a PBI's icon and mime settings. Table 7.3e summarizes this command's options:

Table 7.3e: pbi_icon Options [tables 5]
Switch Description
add-desktop installs desktop icon; should be run as regular user
add-mime installs mime information; should be run as root
add-menu installs menu icons; should be run as root
del-desktop removes desktop icon; should be run as regular user
del-menu removes menu icons; should be run as root
del-mime removes mime information; should be run as root

pbi_info

The pbi_info command is used to determine which PBIs are currently installed. Table 7.3f summarizes the available options:

Table 7.3f: pbi_info Options [tables 6]
Switch Description
-a list all PBIs installed on the system; same as running pbi_info without an argument
-j <jailname> list PBIs installed in the specified jail
-v includes verbose information about each PBI

pbi_update_makeindex

This command is used to make the INDEX for a custom PBI repository which can then be used in AppCafe®. Refer to Create Your Own PBI Repository for instructions on how to create a custom repository.

pbi_updateindex

To check for a newer version of the PC-BSD® PBI-INDEX.txz file, type sudo pbi_updateindex and input your password when prompted. If a newer version is available, this command fetches and extracts it so that the system has the most recent list of available PBIs.


References


  1. http://en.wikipedia.org/wiki/Xdg

List of Tables


  1. Table 7.3a: pbi Sub-Commands
  2. Table 7.3b: pbi_add Options
  3. Table 7.3c: pbi.conf Variables
  4. Table 7.3d: pbi_delete Options
  5. Table 7.3e: pbi_icon Options
  6. Table 7.3f: pbi_info Options
Other languages:German 11% • ‎English 100%