|
|
2fd457 |
.TH PEAR 1 "2013" "The PEAR Group" "User commands"
|
|
|
2fd457 |
.SH NAME
|
|
|
2fd457 |
pear, pecl, peardev \- PEAR installer
|
|
|
2fd457 |
|
|
|
2fd457 |
.SH SYNOPSIS
|
|
|
2fd457 |
.B pear
|
|
|
2fd457 |
[ options ] command [command-options] <parameters>
|
|
|
2fd457 |
.LP
|
|
|
2fd457 |
.B pecl
|
|
|
2fd457 |
[ options ] command [command-options] <parameters>
|
|
|
2fd457 |
.LP
|
|
|
2fd457 |
.B peardev
|
|
|
2fd457 |
[ options ] command [command-options] <parameters>
|
|
|
2fd457 |
.LP
|
|
|
2fd457 |
|
|
|
2fd457 |
.SH DESCRIPTION
|
|
|
2fd457 |
\fBPEAR\fP is the PHP Extension and Application Repository, found at
|
|
|
2fd457 |
.B http://pear.php.net.
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
The \fBpear\fP command is used to install PEAR extensions.
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
The \fBpecl\fP command is used to install PECL extensions.
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
The \fBpeardev\fP command is a wrapper for the \fBpear\fP command which
|
|
|
2fd457 |
removes the normal configured memory limit.
|
|
|
2fd457 |
|
|
|
2fd457 |
.SH OPTIONS
|
|
|
2fd457 |
.TP 15
|
|
|
2fd457 |
.B \-v
|
|
|
2fd457 |
increase verbosity level (default 1)
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-q
|
|
|
2fd457 |
be quiet, decrease verbosity level
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-c \fIfile\fP
|
|
|
2fd457 |
find user configuration in \fBfile\fP
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-C \fIfile\fP
|
|
|
2fd457 |
find system configuration in \fBfile\fP
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-d \fIfoo=bar\fP
|
|
|
2fd457 |
set user config variable \fBfoo\fP to \fBbar\fP
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-D \fIfoo=bar\fP
|
|
|
2fd457 |
set system config variable \fBfoo\fP to \fBbar\fP
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-G
|
|
|
2fd457 |
start in graphical (Gtk) mode
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-S
|
|
|
2fd457 |
store system configuration
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-s
|
|
|
2fd457 |
store user configuration
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-y \fIfoo\fP
|
|
|
2fd457 |
unset
|
|
|
2fd457 |
.B foo
|
|
|
2fd457 |
in the user configuration
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B \-V
|
|
|
2fd457 |
version information
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.PD 0
|
|
|
2fd457 |
.B \-h
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.PD 1
|
|
|
2fd457 |
.B \-?
|
|
|
2fd457 |
display help/usage
|
|
|
2fd457 |
|
|
|
2fd457 |
.SH COMMANDS
|
|
|
2fd457 |
.TP 15
|
|
|
2fd457 |
.B build
|
|
|
2fd457 |
Build an Extension From C Source
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B bundle
|
|
|
2fd457 |
Unpacks a Pecl Package
|
|
|
2fd457 |
.B channel-add
|
|
|
2fd457 |
Add a Channel
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B channel-alias
|
|
|
2fd457 |
Specify an alias to a channel name
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B channel-delete
|
|
|
2fd457 |
Remove a Channel From the List
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B channel-discover
|
|
|
2fd457 |
Initialize a Channel from its server
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B channel-info
|
|
|
2fd457 |
Retrieve Information on a Channel
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B channel-login
|
|
|
2fd457 |
Connects and authenticates to remote channel server
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B channel-logout
|
|
|
2fd457 |
Logs out from the remote channel server
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B channel-update
|
|
|
2fd457 |
Update an Existing Channel
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B clear-cache
|
|
|
2fd457 |
Clear Web Services Cache
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B config-create
|
|
|
2fd457 |
Create a Default configuration file
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B config-get
|
|
|
2fd457 |
Show One Setting
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B config-help
|
|
|
2fd457 |
Show Information About Setting
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B config-set
|
|
|
2fd457 |
Change Setting
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B config-show
|
|
|
2fd457 |
Show All Settings
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B convert
|
|
|
2fd457 |
Convert a package.xml 1.0 to package.xml 2.0 format
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B cvsdiff
|
|
|
2fd457 |
Run a "cvs diff" for all files in a package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B cvstag
|
|
|
2fd457 |
Set CVS Release Tag
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B download
|
|
|
2fd457 |
Download Package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B download-all
|
|
|
2fd457 |
Downloads each available package from the default channel
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B info
|
|
|
2fd457 |
Display information about a package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B install
|
|
|
2fd457 |
Install Package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B list
|
|
|
2fd457 |
List Installed Packages In The Default Channel
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B list-all
|
|
|
2fd457 |
List All Packages
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B list-channels
|
|
|
2fd457 |
List Available Channels
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B list-files
|
|
|
2fd457 |
List Files In Installed Package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B list-upgrades
|
|
|
2fd457 |
List Available Upgrades
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B login
|
|
|
2fd457 |
Connects and authenticates to remote server [Deprecated in favor of channel-login]
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B logout
|
|
|
2fd457 |
Logs out from the remote server [Deprecated in favor of channel-logout]
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B make-rpm-spec
|
|
|
2fd457 |
Builds an RPM spec file from a PEAR package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B makerpm
|
|
|
2fd457 |
Builds an RPM spec file from a PEAR package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B package
|
|
|
2fd457 |
Build Package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B package-dependencies
|
|
|
2fd457 |
Show package dependencies
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B package-validate
|
|
|
2fd457 |
Validate Package Consistency
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B pickle
|
|
|
2fd457 |
Build PECL Package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B remote-info
|
|
|
2fd457 |
Information About Remote Packages
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B remote-list
|
|
|
2fd457 |
List Remote Packages
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B run-scripts
|
|
|
2fd457 |
Run Post-Install Scripts bundled with a package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B run-tests
|
|
|
2fd457 |
Run Regression Tests
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B search
|
|
|
2fd457 |
Search remote package database
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B shell-test
|
|
|
2fd457 |
Shell Script Test
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B sign
|
|
|
2fd457 |
Sign a package distribution file
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B svntag
|
|
|
2fd457 |
Set SVN Release Tag
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B uninstall
|
|
|
2fd457 |
Un-install Package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B update-channels
|
|
|
2fd457 |
Update the Channel List
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B upgrade
|
|
|
2fd457 |
Upgrade Package
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B upgrade-all
|
|
|
2fd457 |
Upgrade All Packages [Deprecated in favor of calling upgrade with no parameters]
|
|
|
2fd457 |
|
|
|
2fd457 |
.SH FILES
|
|
|
2fd457 |
.TP 15
|
|
|
2fd457 |
.B /etc/pear.conf
|
|
|
2fd457 |
The system configuration file.
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
.B $HOME/.pearrc
|
|
|
2fd457 |
The user configuration.
|
|
|
2fd457 |
|
|
|
2fd457 |
.SH SEE ALSO
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
To list all options, use
|
|
|
2fd457 |
.PS
|
|
|
2fd457 |
pear help options
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
To list all command shortcuts, use
|
|
|
2fd457 |
.PS
|
|
|
2fd457 |
pear help shortcuts
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
to get the help for the specified command, use
|
|
|
2fd457 |
.PS
|
|
|
2fd457 |
pear help \fIcommand\fP
|
|
|
2fd457 |
.TP
|
|
|
2fd457 |
Documentation for PEAR can be found at
|
|
|
2fd457 |
.PD 0
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
.B http://pear.php.net/manual/
|
|
|
2fd457 |
|
|
|
2fd457 |
.SH COPYRIGHT
|
|
|
2fd457 |
Copyright \(co 1997\-2009
|
|
|
2fd457 |
Stig Bakken,
|
|
|
2fd457 |
Gregory Beaver,
|
|
|
2fd457 |
Helgi Þormar Þorbjörnsson,
|
|
|
2fd457 |
Tomas V.V.Cox,
|
|
|
2fd457 |
Martin Jansen.
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
All rights reserved.
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
Redistribution and use in source and binary forms, with or without
|
|
|
2fd457 |
modification, are permitted provided that the following conditions are met:
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
* Redistributions of source code must retain the above copyright notice,
|
|
|
2fd457 |
this list of conditions and the following disclaimer.
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
* Redistributions in binary form must reproduce the above copyright
|
|
|
2fd457 |
notice, this list of conditions and the following disclaimer in the
|
|
|
2fd457 |
documentation and/or other materials provided with the distribution.
|
|
|
2fd457 |
|
|
|
2fd457 |
.SH BUGS
|
|
|
2fd457 |
You can view the list of known bugs or report any new bug you found at:
|
|
|
2fd457 |
.PD 0
|
|
|
2fd457 |
.P
|
|
|
2fd457 |
.B http://pear.php.net/bugs/
|
|
|
2fd457 |
|