.TH PEAR 1 "2013" "The PEAR Group" "User commands"

.SH NAME

pear, pecl, peardev \- PEAR installer

.SH SYNOPSIS

.B pear

[ options ] command [command-options] <parameters>

.LP

.B pecl

[ options ] command [command-options] <parameters>

.LP

.B peardev

[ options ] command [command-options] <parameters>

.LP

.SH DESCRIPTION

\fBPEAR\fP is the PHP Extension and Application Repository, found at

.B http://pear.php.net.

.P

.P

The \fBpear\fP command is used to install PEAR extensions.

.P

The \fBpecl\fP command is used to install PECL extensions.

.P

The \fBpeardev\fP command is a wrapper for the \fBpear\fP command which

removes the normal configured memory limit.

.SH OPTIONS

.TP 15

.B \-v

increase verbosity level (default 1)

.TP

.B \-q

be quiet, decrease verbosity level

.TP

.B \-c \fIfile\fP

find user configuration in \fBfile\fP

.TP

.B \-C \fIfile\fP

find system configuration in \fBfile\fP

.TP

.B \-d \fIfoo=bar\fP

set user config variable \fBfoo\fP to \fBbar\fP

.TP

.B \-D \fIfoo=bar\fP

set system config variable \fBfoo\fP to \fBbar\fP

.TP

.B \-G

start in graphical (Gtk) mode

.TP

.B \-S

store system configuration

.TP

.B \-s

store user configuration

.TP

.B \-y \fIfoo\fP

unset

.B foo

in the user configuration

.TP

.B \-V

version information

.TP

.PD 0

.B \-h

.TP

.PD 1

.B \-?

display help/usage

.SH COMMANDS

.TP 15

.B build

Build an Extension From C Source

.TP

.B bundle

Unpacks a Pecl Package

.TP

.B channel-add

Add a Channel

.TP

.B channel-alias

Specify an alias to a channel name

.TP

.B channel-delete

Remove a Channel From the List

.TP

.B channel-discover

Initialize a Channel from its server

.TP

.B channel-info

Retrieve Information on a Channel

.TP

.TP

.B channel-login

Connects and authenticates to remote channel server

.TP

.B channel-logout

Logs out from the remote channel server

.TP

.B channel-update

Update an Existing Channel

.TP

.B clear-cache

Clear Web Services Cache

.TP

.B config-create

Create a Default configuration file

.TP

.B config-get

Show One Setting

.TP

.B config-help

Show Information About Setting

.TP

.B config-set

Change Setting

.TP

.B config-show

Show All Settings

.TP

.B convert

Convert a package.xml 1.0 to package.xml 2.0 format

.TP

.B cvsdiff

Run a "cvs diff" for all files in a package

.TP

.B cvstag

Set CVS Release Tag

.TP

.B download

Download Package

.TP

.B download-all

Downloads each available package from the default channel

.TP

.B info

Display information about a package

.TP

.B install

Install Package

.TP

.B list

List Installed Packages In The Default Channel

.TP

.B list-all

List All Packages

.TP

.B list-channels

List Available Channels

.TP

.B list-files

List Files In Installed Package

.TP

.B list-upgrades

List Available Upgrades

.TP

.B login

Connects and authenticates to remote server [Deprecated in favor of channel-login]

.TP

.B logout

Logs out from the remote server [Deprecated in favor of channel-logout]

.TP

.B make-rpm-spec

Builds an RPM spec file from a PEAR package

.TP

.B makerpm

Builds an RPM spec file from a PEAR package

.TP

.B package

Build Package

.TP

.B package-dependencies

Show package dependencies

.TP

.B package-validate

Validate Package Consistency

.TP

.B pickle

Build PECL Package

.TP

.B remote-info

Information About Remote Packages

.TP

.B remote-list

List Remote Packages

.TP

.B run-scripts

Run Post-Install Scripts bundled with a package

.TP

.B run-tests

Run Regression Tests

.TP

.B search

Search remote package database

.TP

.B shell-test

Shell Script Test

.TP

.B sign

Sign a package distribution file

.TP

.B svntag

Set SVN Release Tag

.TP

.B uninstall

Un-install Package

.TP

.B update-channels

Update the Channel List

.TP

.B upgrade

Upgrade Package

.TP

.B upgrade-all

Upgrade All Packages [Deprecated in favor of calling upgrade with no parameters]

.SH FILES

.TP 15

.B /etc/pear.conf

The system configuration file.

.TP

.B $HOME/.pearrc

The user configuration.

.SH SEE ALSO

.TP

To list all options, use

.PS

pear help options

.TP

To list all command shortcuts, use

.PS

pear help shortcuts

.TP

to get the help for the specified command, use

.PS

pear help \fIcommand\fP

.TP

Documentation for PEAR can be found at 

.PD 0

.P

.B http://pear.php.net/manual/

.SH COPYRIGHT

Copyright \(co 1997\-2009

Stig Bakken,

Gregory Beaver,

Helgi Þormar Þorbjörnsson,

Tomas V.V.Cox,

Martin Jansen.

.P

All rights reserved.

.P

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions are met:

.P

* Redistributions of source code must retain the above copyright notice,

this list of conditions and the following disclaimer.

.P

* Redistributions in binary form must reproduce the above copyright

notice, this list of conditions and the following disclaimer in the

documentation and/or other materials provided with the distribution.

.SH BUGS

You can view the list of known bugs or report any new bug you found at:

.PD 0

.P

.B http://pear.php.net/bugs/